alex/esp-idf
alex/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2024-10-05 20:47:46 -04:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Add translation for ESP32-WROVER-KIT Getting Started Guides

Browse Source
This commit is contained in:
Natasha 2019-05-27 07:53:20 +08:00 committed by Krzysztof Budzynski
parent 0685a2e9f6
commit 440c42693d
13 changed files with 1780 additions and 257 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/en/get-started-cmake/get-started-wrover-kit-v2.rst
View File

@ -9,7 +9,7 @@ What You Need
-------------
* ESP-WROVER-KIT V2 board
* USB 2.0 A to Micro B Cable
* USB 2.0 cable（A to Micro-B）
* Computer running Windows, Linux, or macOS
You can skip the introduction sections and go directly to Section `Start Application Development`_.
@ -114,7 +114,7 @@ RGB Red, green and blue (RGB) light emitting diodes (LEDs), can
I/O All the pins on the ESP32 module are broken out to pin headers. You can program ESP32 to enable multiple functions, such as PWM, ADC, DAC, I2C, I2S, SPI, etc.
Micro SD Card Micro SD card slot for data storage: when ESP32 enters the download mode, GPIO2 cannot be held high. However, a pull-up resistor is required on GPIO2 to enable the Micro SD Card. By default, GPIO2 and the pull-up resistor R153 are disconnected. To enable the SD Card, use jumpers on JP1 as shown in Section `Setup Options`_.
MicroSD Card MicroSD card slot for data storage: when ESP32 enters the download mode, GPIO2 cannot be held high. However, a pull-up resistor is required on GPIO2 to enable the MicroSD Card. By default, GPIO2 and the pull-up resistor R153 are disconnected. To enable the SD Card, use jumpers on JP1 as shown in Section `Setup Options`_.
LCD Support for mounting and interfacing a 3.2” SPI (standard 4-wire Serial Peripheral Interface) LCD, as shown on figure :ref:`get-started-esp-wrover-kit-v2-board-back-cmake`.
================== =================================================================================================================================
@ -130,7 +130,7 @@ There are five jumper blocks available to set up the board functionality. The mo
======= ================ =========================================================
Header Jumper Setting Description of Functionality
======= ================ =========================================================
JP1 |jp1-sd_io2| Enable pull up for the Micro SD Card
JP1 |jp1-sd_io2| Enable pull up for the MicroSD Card
JP1 |jp1-both| Assert GPIO2 low during each download (by jumping it to GPIO0)
JP7 |jp7-ext_5v| Power ESP-WROVER-KIT via an external power supply
JP7 |jp7-usb_5v| Power ESP-WROVER-KIT via USB
@ -192,4 +192,4 @@ Related Documents
.. |jp11-tx-rx| image:: ../../_static/wrover-jp11-tx-rx.png
.. |jp14| image:: ../../_static/wrover-jp14.png
.. _ESP-WROVER-KIT V2 schematic: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-2.pdf
.. _ESP-WROVER-KIT V2 schematic: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-2.pdf

6
docs/en/get-started-cmake/get-started-wrover-kit-v3.rst
View File

@ -9,7 +9,7 @@ What You Need
-------------
* :ref:`ESP-WROVER-KIT V3 board <get-started-esp-wrover-kit-v3-board-front-cmake>`
* USB 2.0 A to Micro B Cable
* USB 2.0 cable（A to Micro-B）
* Computer running Windows, Linux, or macOS
You can skip the introduction sections and go directly to Section `Start Application Development`_.
@ -116,7 +116,7 @@ RGB LED Red, green and blue (RGB) light emitting diodes (LEDs), can
I/O All the pins on the ESP32 module are broken out to pin headers. You can program ESP32 to enable multiple functions, such as PWM, ADC, DAC, I2C, I2S, SPI, etc.
Micro SD Card Slot Useful for developing applications that access Micro SD card for data storage and retrieval.
MicroSD Card Slot Useful for developing applications that access MicroSD card for data storage and retrieval.
LCD Support for mounting and interfacing a 3.2” SPI (standard 4-wire Serial Peripheral Interface) LCD, as shown on figure :ref:`get-started-esp-wrover-kit-v3-board-back-cmake`.
================== =================================================================================================================================
@ -377,4 +377,4 @@ Related Documents
.. toctree::
:hidden:
get-started-wrover-kit-v2.rst
get-started-wrover-kit-v2.rst

12
docs/en/get-started-cmake/get-started-wrover-kit.rst
View File

@ -9,7 +9,7 @@ What You Need
-------------
* :ref:`ESP-WROVER-KIT V4.1 board <get-started-esp-wrover-kit-v4.1-board-front-cmake>`
* USB 2.0 A to Micro B Cable
* USB 2.0 cable（A to Micro-B）
* Computer running Windows, Linux, or macOS
You can skip the introduction sections and go directly to Section `Start Application Development`_.
@ -87,7 +87,7 @@ FT2232 The FT2232 chip serves as a multi-protocol USB-to-serial bri
0R Zero-ohm resistor intended as a placeholder for a current shunt, can be desoldered or replaced with a current shunt to facilitate the measurement of ESP32's current consumption in different modes.
ESP32-WROVER This EPS32 module features 64-Mbit PSRAM for flexible extended storage and data processing capabilities.
ESP32-WROVER-B This EPS32 module features 64-Mbit PSRAM for flexible extended storage and data processing capabilities.
Diagnostic LEDs Four red LEDs connected to the GPIO pins of FT2232. Intended for future use.
@ -121,9 +121,9 @@ RGB LED Red, green and blue (RGB) light emitting diodes (LEDs), can
I/O Connector All the pins on the ESP32 module are broken out to pin headers. You can program ESP32 to enable multiple functions, such as PWM, ADC, DAC, I2C, I2S, SPI, etc.
Micro SD Card Slot Useful for developing applications that access Micro SD card for data storage and retrieval.
MicroSD Card Slot Useful for developing applications that access MicroSD card for data storage and retrieval.
LCD Support for mounting and interfacing a 3.2” SPI (standard 4-wire Serial Peripheral Interface) LCD, as shown on figure :ref:`get-started-esp-wrover-kit-v4.1-board-back`.
LCD Support for mounting and interfacing a 3.2” SPI (standard 4-wire Serial Peripheral Interface) LCD, as shown on figure :ref:`get-started-esp-wrover-kit-v4.1-board-back-cmake`.
================== =================================================================================================================================
@ -358,7 +358,7 @@ Turn the **Power Switch** to ON, the **5V Power On LED** should light up.
Now to Development
^^^^^^^^^^^^^^^^^^
Please proceed to :doc:`index`, where Section :ref:`get-started-step-by-step` will quickly help you set up the development environment and then flash an example project onto your board.
Please proceed to :doc:`index`, where Section :ref:`get-started-step-by-step-cmake` will quickly help you set up the development environment and then flash an example project onto your board.
Related Documents
@ -382,4 +382,4 @@ Related Documents
:hidden:
get-started-wrover-kit-v3.rst
get-started-wrover-kit-v2.rst
get-started-wrover-kit-v2.rst

12
docs/en/get-started/get-started-wrover-kit-v2.rst
View File

@ -1,5 +1,5 @@
ESP-WROVER-KIT V2 Getting Started Guide (CMake)
===============================================
ESP-WROVER-KIT V2 Getting Started Guide
=======================================
:link_to_translation:`zh_CN:[中文]`
This guide shows how to get started with the ESP-WROVER-KIT V2 development board and also provides information about its functionality and configuration options. For the description of other ESP-WROVER-KIT versions, please check :doc:`../hw-reference/index`.
@ -9,7 +9,7 @@ What You Need
-------------
* ESP-WROVER-KIT V2 board
* USB 2.0 A to Micro B Cable
* USB 2.0 cable（A to Micro-B）
* Computer running Windows, Linux, or macOS
You can skip the introduction sections and go directly to Section `Start Application Development`_.
@ -114,7 +114,7 @@ RGB Red, green and blue (RGB) light emitting diodes (LEDs), can
I/O All the pins on the ESP32 module are broken out to pin headers. You can program ESP32 to enable multiple functions, such as PWM, ADC, DAC, I2C, I2S, SPI, etc.
Micro SD Card Micro SD card slot for data storage: when ESP32 enters the download mode, GPIO2 cannot be held high. However, a pull-up resistor is required on GPIO2 to enable the Micro SD Card. By default, GPIO2 and the pull-up resistor R153 are disconnected. To enable the SD Card, use jumpers on JP1 as shown in Section `Setup Options`_.
MicroSD Card MicroSD card slot for data storage: when ESP32 enters the download mode, GPIO2 cannot be held high. However, a pull-up resistor is required on GPIO2 to enable the MicroSD Card. By default, GPIO2 and the pull-up resistor R153 are disconnected. To enable the SD Card, use jumpers on JP1 as shown in Section `Setup Options`_.
LCD Support for mounting and interfacing a 3.2” SPI (standard 4-wire Serial Peripheral Interface) LCD, as shown on figure :ref:`get-started-esp-wrover-kit-v2-board-back`.
================== =================================================================================================================================
@ -130,7 +130,7 @@ There are five jumper blocks available to set up the board functionality. The mo
======= ================ =========================================================
Header Jumper Setting Description of Functionality
======= ================ =========================================================
JP1 |jp1-sd_io2| Enable pull up for the Micro SD Card
JP1 |jp1-sd_io2| Enable pull up for the MicroSD Card
JP1 |jp1-both| Assert GPIO2 low during each download (by jumping it to GPIO0)
JP7 |jp7-ext_5v| Power ESP-WROVER-KIT via an external power supply
JP7 |jp7-usb_5v| Power ESP-WROVER-KIT via USB
@ -192,4 +192,4 @@ Related Documents
.. |jp11-tx-rx| image:: ../../_static/wrover-jp11-tx-rx.png
.. |jp14| image:: ../../_static/wrover-jp14.png
.. _ESP-WROVER-KIT V2 schematic: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-2.pdf
.. _ESP-WROVER-KIT V2 schematic: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-2.pdf

7
docs/en/get-started/get-started-wrover-kit-v3.rst
View File

@ -1,3 +1,4 @@
ESP-WROVER-KIT V3 Getting Started Guide
=======================================
:link_to_translation:`zh_CN:[中文]`
@ -9,7 +10,7 @@ What You Need
-------------
* :ref:`ESP-WROVER-KIT V3 board <get-started-esp-wrover-kit-v3-board-front>`
* USB 2.0 A to Micro B Cable
* USB 2.0 cable（A to Micro-B）
* Computer running Windows, Linux, or macOS
You can skip the introduction sections and go directly to Section `Start Application Development`_.
@ -116,7 +117,7 @@ RGB LED Red, green and blue (RGB) light emitting diodes (LEDs), can
I/O All the pins on the ESP32 module are broken out to pin headers. You can program ESP32 to enable multiple functions, such as PWM, ADC, DAC, I2C, I2S, SPI, etc.
Micro SD Card Slot Useful for developing applications that access Micro SD card for data storage and retrieval.
MicroSD Card Slot Useful for developing applications that access MicroSD card for data storage and retrieval.
LCD Support for mounting and interfacing a 3.2” SPI (standard 4-wire Serial Peripheral Interface) LCD, as shown on figure :ref:`get-started-esp-wrover-kit-v3-board-back`.
================== =================================================================================================================================
@ -377,4 +378,4 @@ Related Documents
.. toctree::
:hidden:
get-started-wrover-kit-v2.rst
get-started-wrover-kit-v2.rst

8
docs/en/get-started/get-started-wrover-kit.rst
View File

@ -9,7 +9,7 @@ What You Need
-------------
* :ref:`ESP-WROVER-KIT V4.1 board <get-started-esp-wrover-kit-v4.1-board-front>`
* USB 2.0 A to Micro B Cable
* USB 2.0 cable（A to Micro-B）
* Computer running Windows, Linux, or macOS
You can skip the introduction sections and go directly to Section `Start Application Development`_.
@ -87,7 +87,7 @@ FT2232 The FT2232 chip serves as a multi-protocol USB-to-serial bri
0R Zero-ohm resistor intended as a placeholder for a current shunt, can be desoldered or replaced with a current shunt to facilitate the measurement of ESP32's current consumption in different modes.
ESP32-WROVER This EPS32 module features 64-Mbit PSRAM for flexible extended storage and data processing capabilities.
ESP32-WROVER-B This EPS32 module features 64-Mbit PSRAM for flexible extended storage and data processing capabilities.
Diagnostic LEDs Four red LEDs connected to the GPIO pins of FT2232. Intended for future use.
@ -121,7 +121,7 @@ RGB LED Red, green and blue (RGB) light emitting diodes (LEDs), can
I/O Connector All the pins on the ESP32 module are broken out to pin headers. You can program ESP32 to enable multiple functions, such as PWM, ADC, DAC, I2C, I2S, SPI, etc.
Micro SD Card Slot Useful for developing applications that access Micro SD card for data storage and retrieval.
MicroSD Card Slot Useful for developing applications that access MicroSD card for data storage and retrieval.
LCD Support for mounting and interfacing a 3.2” SPI (standard 4-wire Serial Peripheral Interface) LCD, as shown on figure :ref:`get-started-esp-wrover-kit-v4.1-board-back`.
================== =================================================================================================================================
@ -382,4 +382,4 @@ Related Documents
:hidden:
get-started-wrover-kit-v3.rst
get-started-wrover-kit-v2.rst
get-started-wrover-kit-v2.rst

193
docs/zh_CN/get-started-cmake/get-started-wrover-kit-v2.rst
View File

@ -1 +1,192 @@
.. include:: ../../en/get-started-cmake/get-started-wrover-kit-v2.rst
ESP-WROVER-KIT V2 入门指南（CMake）
===========================================
:link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V2 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。
准备工作
-------------
* ESP-WROVER-KIT V2 开发板
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
--------
ESP-WROVER-KIT 是 `乐鑫 <https://espressif.com>`_ 一款基于 ESP32 的开发板，集成了 LCD 屏幕和 MicroSD 卡槽。
ESP-WROVER-KIT 可选贴以下 ESP32 模组：
- :ref:`esp-modules-and-boards-esp32-wroom-32`
- :ref:`ESP32-WROVER <esp-modules-and-boards-esp32-wrover>`
此外，ESP-WROVER-KIT 的独特之处在于集成了一款先进多协议 USB 桥接器 (FTDI FT2232HL)，允许开发人员直接通过 USB 接口，使用 JTAG 对 ESP32 进行调试，无需额外的 JTAG 调试器。ESP-WROVER-KIT 可为开发人员提供简单、便捷且极具成本效益的开发体验。
为了便于使用，板上模组的绝大部分管脚均已引出至开发板的引脚。
.. note::
ESP-WROVER-KIT V2 板载 ESP32-WROVER 模组的 GPIO16 和 GPIO17 管脚用作 PSRAM 的片选和时钟信号。默认情况下，为了给用户提供可靠的性能，这两个 GPIO 管脚不引出至开发板引脚。
功能概述
----------------------
ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT 功能框图
:figclass: align-center
ESP-WROVER-KIT 功能框图
功能说明
----------------------
ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v2-board-front-cmake:
.. figure:: ../../_static/esp-wrover-kit-v2-layout-front.png
:align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 俯视图
:figclass: align-center
ESP-WROVER-KIT 开发板布局 -- 俯视图
.. _get-started-esp-wrover-kit-v2-board-back-cmake:
.. figure:: ../../_static/esp-wrover-kit-v2-layout-back.png
:align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 仰视图
:figclass: align-center
ESP-WROVER-KIT 开发板布局 -- 仰视图
下表从图片右上角开始，以顺时针顺序介绍了图 1 中的主要组件，然后以同样的顺序介绍了图 2 中的主要组件。
==================== ======================================================================================================================================================================================================================================================================================================================================
主要组件 基本介绍
==================== ======================================================================================================================================================================================================================================================================================================================================
32.768 kHz 外接 32.768 kHz 晶振，可提供 Deep-sleep 下使用的低功耗时钟。
ESP32 模组 可选贴 ESP32-WROOM-32 或 ESP32-WROVER。ESP32-WROVER 模组完整集成了 ESP32-WROOM-32 的所有功能，且内置 32-Mbit PSRAM，可提供灵活的额外存储空间和数据处理能力。
CTS/RTS 串口流控信号。管脚默认不连接至电路。为了使能该功能，必须用跳线帽短路掉 JP14 的相应管脚。
UART 串口。FT2232HL 和 ESP32 的串行 TX/RX 信号已引出至 JP11 的两端。默认情况下，这两路信号由跳线帽连接。如果要跳过 FT2232 使用 ESP32 模组串口，则可移除相关跳线帽，将模组连接至其他外部串口设备。
SPI 默认情况下，ESP32 使用 SPI 接口访问内置 flash 和 PSRAM。使用这些引脚连接 ESP32 和其他 SPI 设备。这种情况下，需增加额外的片选 (CS) 信号。注意，选贴 ESP32-WROVER 模组时，该接口的工作电压为 1.8 V；选贴 ESP32-WROOM-32 时，该接口的工作电压为 3.3V。
JTAG JTAG 接口。FT2232HL 和 ESP32 的 JTAG 信号已引出至 JP8 的两端。默认情况下，这两路信号不连接。如需使能 JTAG，请按照 `设置选项`_ 的介绍，连接跳线帽。
FT2232 FT2232 多协议 USB 转串口桥接器。开发人员可通过 USB 接口对 FT2232 芯片进行控制和编程，与 ESP32 建立连接。FT2232 具有 USB-to-UART 和 USB-to-JTAG 功能。
EN 复位按键。
Boot 下载按键。按下 **Boot** 键并保持，同时按一下 **EN** 键（此时不要松开 **Boot** 键）进入“固件下载”模式，通过串口下载固件。
USB USB 接口。可用作开发板的供电电源，或连接 PC 和开发板的通信接口。
电源选择开关 ESP-WROVER-KIT 开发板可通过 USB 端口或 5V 输入接口供电。用户可使用跳线帽在两种供电模式中进行选择。更多详细信息，请见章节 `设置选项`_ 中有关 JP7 连接器的描述。
电源开关 拨向 **USB** 按键一侧，开发板上电；拨离 **USB** 按键一侧，开发板掉电。
5V Input 5V 电源接口建议仅在开发板自动运行（未连接 PC）时使用。仅用于全负荷工作下的后备电源。
LDO 5V-to-3.3V 低压差线型稳压器 NCP1117(1A)。NCP1117 最大电流输出为 1 A。板上 LDO 为固定输出电压，但用户也可以选用具有可变输出电压的 LDO。更多信息，请见 `ESP-WROVER-KIT V2 原理图`_。
摄像头 摄像头接口，支持标准 OV7670 摄像头模块。
RGB LED 红绿蓝发光二极管，可由 PWM（脉冲宽度调制）控制。
I/O 板上模组的所有管脚均已引出至开发板的排针。用户可以对 ESP32 进行编程，实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。
MicroSD 卡槽 MicroSD 卡槽，可扩充存储空间：当 ESP32 进入下载模式时，GPIO2 不可处于高电平。然而，为了使能 MicroSD 卡功能，需为 GPIO2 增加一个上拉电阻。默认情况下，GPIO2 和上拉电阻 R153 处于断开状态。为了使能 MicroSD 卡，请按照 `设置选项`_ 章节的要求，连接 JP1 连接器。
LCD 显示屏 支持贴装一款 3.2” 的 SPI（标准四线串行外设接口）LCD 显示器，请见 :ref:`get-started-esp-wrover-kit-v2-board-back-cmake`。
==================== ======================================================================================================================================================================================================================================================================================================================================
.. _get-started-esp-wrover-kit-v2-setup-options-cmake:
设置选项
-------------
用户可通过 5 组排针，设置开发板功能，其中常见功能见下表：
======= ================ =====================================================================================
排针 跳线设置 功能描述
======= ================ =====================================================================================
JP1 |jp1-sd_io2| 使能 MicroSD Card 功能的上拉电阻
JP1 |jp1-both| 确保开发板处于下载模式时，GPIO2 时钟处于低位（将 JP1 连接至 GPIO0）
JP7 |jp7-ext_5v| 使用外部电源为 ESP-WROVER-KIT 开发板供电
JP7 |jp7-usb_5v| 使用 USB 端口为 ESP-WROVER-KIT 开发板供电
JP8 |jp8| 使能 JTAG 功能
JP11 |jp11-tx-rx| 使能 UART 通信
JP14 |jp14| 使能 RTS/CTS 串口流控
======= ================ =====================================================================================
.. _get-started-esp-wrover-kit-v2-start-development-cmake:
应用程序开发
-----------------------------
ESP-WROVER-KIT 上电前，请首先确认开发板完好无损。
初始设置
^^^^^^^^^^^^^
请严格按照下图所示连接跳线帽，注意不要额外连接其他跳线帽。
- 使用 JP7 连接器，选择 USB 为开发板供电。
- 使用 JP11 连接器，使能 UART 通信。
======================== ==========================
USB 供电 使能 UART 通信
======================== ==========================
|jp7-usb_5v| |jp11-tx-rx|
======================== ==========================
注意不要连接其他跳线帽。
打开 **电源开关**，**5V Power On LED** 应点亮。
正式开始开发
^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step-cmake` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
相关文档
-----------------
* `ESP-WROVER-KIT V2 原理图`_ (PDF)
* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (PDF)
* `《ESP32-WROVER 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32_wrover_datasheet_cn.pdf>`_ (PDF)
* `《ESP32-WROOM-32 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_cn.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index`
.. |jp1-sd_io2| image:: ../../_static/wrover-jp1-sd_io2.png
.. |jp1-both| image:: ../../_static/wrover-jp1-both.png
.. |jp7-ext_5v| image:: ../../_static/wrover-jp7-ext_5v.png
.. |jp7-usb_5v| image:: ../../_static/wrover-jp7-usb_5v.png
.. |jp8| image:: ../../_static/wrover-jp8.png
.. |jp11-tx-rx| image:: ../../_static/wrover-jp11-tx-rx.png
.. |jp14| image:: ../../_static/wrover-jp14.png
.. _ESP-WROVER-KIT V2 原理图: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-2.pdf

379
docs/zh_CN/get-started-cmake/get-started-wrover-kit-v3.rst
View File

@ -1 +1,378 @@
.. include:: ../../en/get-started-cmake/get-started-wrover-kit-v3.rst
ESP-WROVER-KIT V3 入门指南（CMake）
=======================================
:link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V3 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。
准备工作
-------------
* :ref:`ESP-WROVER-KIT V3 开发板 <get-started-esp-wrover-kit-v3-board-front-cmake>`
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
--------
ESP-WROVER-KIT 是 `乐鑫 <https://espressif.com>`_ 一款基于 ESP32 的开发板，集成了 LCD 屏幕和 MicroSD 卡槽。
ESP-WROVER-KIT 可选贴以下 ESP32 模组：
- :ref:`esp-modules-and-boards-esp32-wroom-32`
- :ref:`ESP32-WROVER <esp-modules-and-boards-esp32-wrover>`
此外，ESP-WROVER-KIT 的独特之处在于集成了一款先进多协议 USB 桥接器 (FTDI FT2232HL)，允许开发人员直接通过 USB 接口，使用 JTAG 对 ESP32 进行调试，无需额外的 JTAG 调试器。ESP-WROVER-KIT 可为开发人员提供简单、便捷且极具成本效益的开发体验。
为了便于使用，板上模组的绝大部分管脚均已引出至开发板的引脚。
.. note::
该版本 ESP32-WROVER 模组 的 GPIO16 和 GPIO17 管脚用作 PSRAM 的片选和时钟信号。默认情况下，为了给用户提供可靠的性能，这两个 GPIO 管脚不引出至开发板引脚。
功能概述
----------------------
ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT 功能框图
:figclass: align-center
ESP-WROVER-KIT 功能框图
功能说明
----------------------
ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v3-board-front-cmake:
.. figure:: ../../_static/esp-wrover-kit-v3-layout-front.jpg
:align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 俯视图
:figclass: align-center
ESP-WROVER-KIT 开发板布局 -- 俯视图
.. _get-started-esp-wrover-kit-v3-board-back-cmake:
.. figure:: ../../_static/esp-wrover-kit-v3-layout-back.jpg
:align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 仰视图
:figclass: align-center
ESP-WROVER-KIT 开发板布局 -- 仰视图
下表从图片右上角开始，以顺时针顺序介绍了图 1 中的主要组件，然后以同样的顺序介绍图 2 中的主要组件。
==================== ======================================================================================================================================================================================================================================================================================================================================
主要组件 基本介绍
==================== ======================================================================================================================================================================================================================================================================================================================================
32.768 kHz 外接 32.768 kHz 晶振，可提供 Deep-sleep 下使用的低功耗时钟。
0 欧电阻 ESP-WROVER-KIT 开发板设计了一个 0 欧电阻，可在测量 ESP32 系列模组在不同功耗模式下的电流时，直接移除或替换为分流器。
ESP32 模组 可选贴 ESP32-WROOM-32 或 ESP32-WROVER。ESP32-WROVER 模组完整集成了 ESP32-WROOM-32 的所有功能，且内置 32-Mbit PSRAM，可提供灵活的额外存储空间和数据处理能力。
FT2232 FT2232 多协议 USB 转串口桥接器。开发人员可通过 USB 接口对 FT2232 芯片进行控制和编程，与 ESP32 建立连接。FT2232 芯片可在通道 A 提供 USB-to-JTAG 接口功能，并在通道 B 提供 USB-to-Serial 接口功能，便利开发人员的应用开发与调试。见 `ESP-WROVER-KIT V3 原理图`_。
UART 串口。FT2232HL 和 ESP32 的串行 TX/RX 信号已引出至 JP11 的两端。默认情况下，这两路信号由跳线帽连接。如果要跳过 FT2232 使用 ESP32 模组串口，则可移除相关跳线帽，将模组连接至其他外部串口设备。
SPI 默认情况下，ESP32 使用 SPI 接口访问内置 flash 和 PSRAM。使用这些引脚连接 ESP32 和其他 SPI 设备。这种情况下，需增加额外的片选 (CS) 信号。注意，选贴 ESP32-WROVER 模组时，该接口的工作电压为 1.8 V；选贴 ESP32-WROOM-32 时，该接口的工作电压为 3.3V。
CTS/RTS 串口流控信号。管脚默认不连接至电路。为了使能该功能，必须用跳线帽短路掉 JP14 的相应管脚。
JTAG JTAG 接口。FT2232HL 和 ESP32 的 JTAG 信号已引出至 JP8 的两端。默认情况下，这两路信号不连接。如需使能 JTAG，请按照 `设置选项`_ 的介绍，连接跳线帽。
EN 复位按键。
Boot 下载按键。按下 **Boot** 键并保持，同时按一下 **EN** 键（此时不要松开 **Boot** 键）进入“固件下载”模式，通过串口下载固件。
USB USB 接口。可用作开发板的供电电源，或连接 PC 和开发板的通信接口。
电源开关 拨向 **USB** 按键一侧，开发板上电；拨离 **USB** 按键一侧，开发板掉电。
电源选择开关 ESP-WROVER-KIT 开发板可通过 USB 端口或 5V 输入接口供电。用户可使用跳线帽在两种供电模式中进行选择。更多详细信息，请见章节 `设置选项`_ 中有关 JP7 连接器的描述。
5V Input 5V 电源接口建议仅在开发板自动运行（未连接 PC）时使用。仅用于全负荷工作下的后备电源。
LDO 5V-to-3.3V 低压差线型稳压器 NCP1117(1A)。NCP1117 最大电流输出为 1 A。板上 LDO 为固定输出电压，但用户也可以选用具有可变输出电压的 LDO。更多信息，请见 `ESP-WROVER-KIT V3 原理图`_。
摄像头 摄像头接口，支持标准 OV7670 摄像头模块。
RGB LED 红绿蓝发光二极管，可由 PWM（脉冲宽度调制）控制。
I/O 板上模组的所有管脚均已引出至开发板的排针。用户可以对 ESP32 进行编程，实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。
MicroSD 卡槽 适用于需要扩充数据存储空间或进行备份的应用开发场景。
LCD 显示屏 支持贴装一款 3.2” 的 SPI（标准四线串行外设接口）LCD 显示器，请见 :ref:`get-started-esp-wrover-kit-v3-board-back-cmake`。
==================== ======================================================================================================================================================================================================================================================================================================================================
.. _get-started-esp-wrover-kit-v3-setup-options-cmake:
设置选项
-------------
用户可通过 5 组排针，设置开发板功能，其中常见功能见下表：
======= ================ =========================================================================
排针 跳线设置 功能描述
======= ================ =========================================================================
JP7 |jp7-ext_5v| 使用外部电源为 ESP-WROVER-KIT 开发板供电
JP7 |jp7-usb_5v| 使用 USB 端口为 ESP-WROVER-KIT 开发板供电
JP8 |jp8| 使能 JTAG 功能
JP11 |jp11-tx-rx| 使能 UART 通信
JP14 |jp14| 使能 RTS/CTS 串口流控
======= ================ =========================================================================
ESP32 管脚分配
------------------------
ESP32 模组的部分管脚/终端已被板上组件占用或用于外部硬件设备。如果某管脚对应的特定硬件未连接，则该管脚可用作他用。比如，摄像头/JP4 排针未连接相应硬件，则这些 GPIO 可用于其他用途。
部分管脚具备多个功能，可供板上组件或外部硬件设备同时使用，比如 GPIO0 和 GPIO2。由于管脚限制，一些外围设备不可同时使用，比如，由于 JTAG 和 SD 卡槽需共用部分管脚，因此一些使用 SD 卡功能的应用无法同时进行 JTAG 调试。
其他情况下，不同外设可同时使用。比如，LCD 屏幕和 SD 卡仅共用一个 GPIO21 管脚，可以同时使用。该管脚可为 LCD 屏幕提供 D/C（数据/控制）信号，并用于读取来自 SD 卡槽的 CD 信号（卡检测信号）。如无需使用卡检测功能，开发人员还可以通过移除 R167 来禁用该功能。此时，LCD 和 SD 卡槽可同时使用。
更多外设共享管脚的介绍，请见下一章节中的表格。
主要 I/O 连接器 / JP1
^^^^^^^^^^^^^^^^^^^^^^^^
JP1 连接器包括 14 x 2 个排针，具体功能可见下表中间 “I/O” 列的介绍。两侧的“共用”列则介绍了这些管脚在板上的其他用途。
===================== ===== ===== =====================
共用 I/O I/O 共用
===================== ===== ===== =====================
n/a 3.3V GND n/a
NC/XTAL IO32 IO33 NC/XTAL
JTAG, MicroSD IO12 IO13 JTAG, MicroSD
JTAG, MicroSD IO14 IO27 摄像头
摄像头 IO26 IO25 摄像头，LCD
摄像头 IO35 IO34 摄像头
摄像头 IO39 IO36 摄像头
JTAG EN IO23 摄像头，LCD
摄像头，LCD IO22 IO21 摄像头，LCD，MicroSD
摄像头，LCD IO19 IO18 摄像头，LCD
摄像头，LCD IO5 IO17 PSRAM
PSRAM IO16 IO4 LED，摄像头，MicroSD
摄像头，LED，Boot IO0 IO2 LED，MicroSD
JTAG，MicroSD IO15 5V
===================== ===== ===== =====================
说明：
* NC/XTAL - :ref:`32.768 kHz Oscillator <get-started-esp-wrover-kit-v3-xtal-cmake>`
* JTAG - :ref:`JTAG / JP8 <get-started-esp-wrover-kit-v3-jtag-header-cmake>`
* Boot - Boot 按键 / SW2
* 摄像头 - :ref:`摄像头 / JP4 <get-started-esp-wrover-kit-v3-camera-header-cmake>`
* LED - :ref:`RGB LED <get-started-esp-wrover-kit-v3-rgb-led-connections-cmake>`
* MicroSD - :ref:`MicroSD Card / J4 <get-started-esp-wrover-kit-v3-microsd-card-slot-cmake>`
* LCD - :ref:`LCD / U5 <get-started-esp-wrover-kit-v3-lcd-connector-cmake>`
* PSRAM - 仅适用于选贴 ESP32-WROVER 的情况。
.. _get-started-esp-wrover-kit-v3-xtal-cmake:
32.768 kHz 晶振
^^^^^^^^^^^^^^^^^^^^^
==== ==========
. ESP32 管脚
==== ==========
1. GPIO32
2. GPIO33
==== ==========
.. note::
默认情况下，管脚 GPIO32 和 GPIO33 已连接至晶振。因此，为了保证信号的完整性，这两个管脚并未连接至 JP1 I/O 连接器。用户可通过将 R11/R23 处的 0 欧电阻移至 R12/R24 处，以将 GP1O32 和 GPIO33 的连接从晶振移至 JP1。
.. _get-started-esp-wrover-kit-v3-spi-flash-header-cmake:
SPI Flash / JP13
^^^^^^^^^^^^^^^^
==== =============
. ESP32 管脚
==== =============
1. CLK / GPIO6
2. SD0 / GPIO7
3. SD1 / GPIO8
4. SD2 / GPIO9
5. SD3 / GPIO10
6. CMD / GPIO11
==== =============
.. important::
模组的 flash 总线已通过 0 欧电阻 R140 ~ R145 连接至排针 JP13。如果需要将 flash 的工作频率控制在 80 MHz，为了达到保证总线信号完整性等目的，建议移除 R140 ~ R145 电阻，将模组的 flash 总线与排针 JP2 断开。
.. _get-started-esp-wrover-kit-v3-jtag-header-cmake:
JTAG / JP8
^^^^^^^^^^
==== ============== =============
. ESP32 管脚 JTAG 信号
==== ============== =============
1. EN TRST_N
2. MTMS / GPIO14 TMS
3. MTDO / GPIO15 TDO
4. MTDI / GPIO12 TDI
5. MTCK / GPIO13 TCK
==== ============== =============
.. _get-started-esp-wrover-kit-v3-camera-header-cmake:
摄像头 / JP4
^^^^^^^^^^^^
==== ========== =============================
. ESP32 管脚 摄像头信号
==== ========== =============================
1. n/a 3.3V
2. n/a 地
3. GPIO27 SIO_C / SCCB 时钟
4. GPIO26 SIO_D / SCCB 数据
5. GPIO25 VSYNC / 垂直同步
6. GPIO23 HREF / 水平参考
7. GPIO22 PCLK / 像素时钟
8. GPIO21 XCLK / 系统时钟
9. GPIO35 D7 / 像素数据 Bit 7
10. GPIO34 D6 / 像素数据 Bit 6
11. GPIO39 D5 / 像素数据 Bit 5
12. GPIO36 D4 / 像素数据 Bit 4
13. GPIO19 D3 / 像素数据 Bit 3
14. GPIO18 D2 / 像素数据 Bit 2
15. GPIO5 D1 / 像素数据 Bit 1
16. GPIO4 D0 / 像素数据 Bit 0
17. GPIO0 RESET / 摄像头复位
18. n/a PWDN / 摄像头断电
==== ========== =============================
* D0 到 D7 为摄像头的数据总线
.. _get-started-esp-wrover-kit-v3-rgb-led-connections-cmake:
RGB LED
^^^^^^^
==== ========== =========
. ESP32 管脚 RGB LED
==== ========== =========
1. GPIO0 红色
2. GPIO2 绿色
3. GPIO4 蓝色
==== ========== =========
.. _get-started-esp-wrover-kit-v3-microsd-card-slot-cmake:
MicroSD 卡
^^^^^^^^^^^^
==== ============== ===============
. ESP32 管脚 MicroSD 信号
==== ============== ===============
1. MTDI / GPIO12 DATA2
2. MTCK / GPIO13 CD / DATA3
3. MTDO / GPIO15 CMD
4. MTMS / GPIO14 CLK
5. GPIO2 DATA0
6. GPIO4 DATA1
7. GPIO21 CD
==== ============== ===============
.. _get-started-esp-wrover-kit-v3-lcd-connector-cmake:
LCD / U5
^^^^^^^^
==== ============== ===============
. ESP32 管脚 LCD 信号
==== ============== ===============
1. GPIO18 复位
2. GPIO19 SCL
3. GPIO21 D/C
4. GPIO22 CS
5. GPIO23 SDA
6. GPIO25 SDO
7. GPIO5 背光
==== ============== ===============
.. _get-started-esp-wrover-kit-v3-start-development-cmake:
应用程序开发
-----------------------------
ESP-WROVER-KIT 上电前，请首先确认开发板完好无损。
初始设置
^^^^^^^^^^^^^
请严格按照下图所示连接跳线帽，注意不要额外连接其他跳线帽。
- 使用 JP7 连接器，选择 USB 为开发板供电。
- 使用 JP11 连接器，使能 UART 通信。
======================== ==========================
USB 供电 使能 UART 通信
======================== ==========================
|jp7-usb_5v| |jp11-tx-rx|
======================== ==========================
注意不要连接其他跳线帽。
打开 **电源开关**，**5V Power On LED** 应点亮。
正式开始开发
^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step-cmake` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
相关文档
-----------------
* `ESP-WROVER-KIT V3 原理图`_ (PDF)
* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (PDF)
* `《ESP32-WROVER 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_wrover_datasheet_cn.pdf>`_ (PDF)
* `《ESP32-WROOM-32 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_cn.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index`
.. |jp7-ext_5v| image:: ../../_static/esp-wrover-kit-v3-jp7-ext_5v.png
.. |jp7-usb_5v| image:: ../../_static/esp-wrover-kit-v3-jp7-usb_5v.png
.. |jp8| image:: ../../_static/esp-wrover-kit-v3-jp8.png
.. |jp11-tx-rx| image:: ../../_static/esp-wrover-kit-v3-jp11-tx-rx.png
.. |jp14| image:: ../../_static/esp-wrover-kit-v3-jp14.png
.. _ESP-WROVER-KIT V3 原理图: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-3.pdf
.. toctree::
:hidden:
get-started-wrover-kit-v2.rst

384
docs/zh_CN/get-started-cmake/get-started-wrover-kit.rst
View File

@ -1 +1,383 @@
.. include:: ../../en/get-started-cmake/get-started-wrover-kit.rst
ESP-WROVER-KIT V4.1 入门指南（CMake）
=========================================
:link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V4.1 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。
准备工作
-------------
* :ref:`ESP-WROVER-KIT V4.1 开发板 <get-started-esp-wrover-kit-v4.1-board-front-cmake>`
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
--------
ESP-WROVER-KIT 是 `乐鑫 <https://espressif.com>`_ 一款基于 ESP32 的开发板。
ESP-WROVER-KIT 开发板已集成了如下组件：
- ESP32-WROVER-B 模组
- LCD 屏
- MicroSD 卡槽
此外，ESP-WROVER-KIT 的独特之处在于集成了一款先进多协议 USB 桥接器 (FTDI FT2232HL)，允许开发人员直接通过 USB 接口，使用 JTAG 对 ESP32 进行调试，无需额外的 JTAG 调试器。ESP-WROVER-KIT 可为开发人员提供简单、便捷且极具成本效益的开发体验。
为了便于使用，板上模组的绝大部分管脚均已引出至开发板的引脚。
.. note::
ESP32 的 GPIO16 和 GPIO17 管脚用作 PSRAM 的片选和时钟信号。默认情况下，为了给用户提供可靠的性能，这两个 GPIO 管脚不引出至开发板引脚。
功能概述
----------------------
ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT 功能框图
:figclass: align-center
ESP-WROVER-KIT 功能框图
功能说明
----------------------
ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v4.1-board-front-cmake:
.. figure:: ../../_static/esp-wrover-kit-v4.1-layout-front.png
:align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 俯视图
:figclass: align-center
ESP-WROVER-KIT 开发板布局 -- 俯视图
.. _get-started-esp-wrover-kit-v4.1-board-back-cmake:
.. figure:: ../../_static/esp-wrover-kit-v4.1-layout-back.png
:align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 仰视图
:figclass: align-center
ESP-WROVER-KIT 开发板布局 -- 仰视图
下表将从图片右上角开始，以顺时针顺序介绍图 1 中的主要组件，然后按同样顺序介绍图 2 中的主要组件。
==================== ======================================================================================================================================================================================================================================================================================================================================
主要组件 基本介绍
==================== ======================================================================================================================================================================================================================================================================================================================================
FT2232 FT2232 多协议 USB 转串口桥接器。开发人员可通过 USB 接口对 FT2232 芯片进行控制和编程，与 ESP32 建立连接。FT2232 芯片可在通道 A 提供 USB-to-JTAG 接口功能，并在通道 B 提供 USB-to-Serial 接口功能，便利开发人员的应用开发与调试。详见 `ESP-WROVER-KIT V4.1 原理图`_。
32.768 kHz 外接 32.768 kHz 晶振，可提供 Deep-sleep 下使用的低功耗时钟。
0 欧电阻 ESP-WROVER-KIT 开发板设计了一个 0 欧电阻，可在测量 ESP32 系列模组在不同功耗模式下的电流时，直接移除或替换为分流器。
ESP32-WROVER-B 模组 ESP-WROVER 模组内置 64-Mbit PSRAM，可提供灵活的额外存储空间和数据处理能力。
诊断 LED 信号灯 本开发板 FT2232 芯片的 GPIO 管脚连接了 4 个红色 LED 信号灯，以备后用。
UART 串口。FT2232HL 和 ESP32 的串行 TX/RX 信号已引出至 JP11 的两端。默认情况下，这两路信号由跳线帽连接。如果要跳过 FT2232 使用 ESP32 模组串口，则可移除相关跳线帽，将模组连接至其他外部串口设备。
SPI 默认情况下，ESP32 使用 SPI 接口访问内置 flash 和 PSRAM。使用这些引脚连接 ESP32 和其他 SPI 设备。这种情况下，需增加额外的片选 (CS) 信号。注意，本接口的工作电压为 3.3 V。
CTS/RTS 串口流控信号。管脚默认不连接至电路。为了使能该功能，必须用跳线帽短路掉 JP14 的相应管脚。
JTAG JTAG 接口。FT2232HL 和 ESP32 的 JTAG 信号已引出至 JP2 的两端。默认情况下，这两路信号不连接。如需使能 JTAG，请按照 `设置选项`_ 的介绍，连接跳线帽。
USB 端口 USB 接口。可用作开发板的供电电源，或连接 PC 和开发板的通信接口。
EN 复位按键。
Boot 按键 下载按键。按下 **Boot** 键并保持，同时按一下 **EN** 键（此时不要松开 **Boot** 键）进入“固件下载”模式，通过串口下载固件。
电源开关 拨向 **Boot** 按键一侧，开发板上电；拨离 **Boot** 按键一侧，开发板掉电。
电源选择开关 ESP-WROVER-KIT 开发板可通过 USB 端口或 5V 输入接口供电。用户可使用跳线帽在两种供电模式中进行选择。更多详细信息，请见章节 `设置选项`_ 中有关 JP7 连接器的描述。
5V Input 5V 电源接口建议仅在开发板自动运行（未连接 PC）时使用。仅用于全负荷工作下的后备电源。
5V Power On LED 当开发板通电后（USB 或外部 5V 供电），该红色指示灯将亮起。
LDO 5V-to-3.3V 低压差线型稳压器 NCP1117(1A)。NCP1117 最大电流输出为 1 A。板上 LDO 为固定输出电压，但用户也可以选用具有可变输出电压的 LDO。更多信息，请见 `ESP-WROVER-KIT V4.1 原理图`_。
摄像头连接器 摄像头接口，支持标准 OV7670 摄像头模块。
RGB LED 红绿蓝发光二极管，可由 PWM（脉冲宽度调制）控制。
I/O 连接器 板上模组的所有管脚均已引出至开发板的排针。用户可以对 ESP32 进行编程，实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。
MicroSD 卡槽 适用于需要扩充数据存储空间或进行备份的应用开发场景。
LCD 显示屏 支持贴装一款 3.2” 的 SPI（标准四线串行外设接口）LCD 显示器，请见 :ref:`get-started-esp-wrover-kit-v4.1-board-back-cmake`。
==================== ======================================================================================================================================================================================================================================================================================================================================
.. _get-started-esp-wrover-kit-v4.1-setup-options-cmake:
设置选项
-------------
用户可通过 3 组排针，设置开发板功能，其中常见功能见下表：
======= ================ =========================================================
排针 跳线设置 功能描述
======= ================ =========================================================
JP7 |jp7-ext_5v| 使用外部电源为 ESP-WROVER-KIT 开发板供电
JP7 |jp7-usb_5v| 使用 USB 端口为 ESP-WROVER-KIT 开发板供电
JP2 |jp2-jtag| 使能 JTAG 功能
JP2 |jp2-tx-rx| 使能 UART 通信
JP14 |jp14| 使能 RTS/CTS 串口流控
======= ================ =========================================================
ESP32 管脚分配
------------------------
ESP32 模组的部分管脚/终端已被板上组件占用或用于外部硬件设备。如果某管脚对应的特定硬件未连接，则该管脚可用作他用。比如，摄像头/JP4 排针未连接相应硬件，则这些 GPIO 可用于其他用途。
部分管脚具备多个功能，可供板上组件或外部硬件设备同时使用，比如 GPIO0 和 GPIO2。由于管脚限制，一些外围设备不可同时使用，比如，由于 JTAG 和 SD 卡槽需共用部分管脚，因此一些使用 SD 卡功能的应用无法同时进行 JTAG 调试。
其他情况下，不同外设可同时使用。比如，LCD 屏幕和 SD 卡仅共用一个 GPIO21 管脚，可以同时使用。该管脚可为 LCD 屏幕提供 D/C（数据/控制）信号，并用于读取来自 SD 卡槽的 CD 信号（卡检测信号）。如无需使用卡检测功能，开发人员还可以通过移除 R167 来禁用该功能。此时，LCD 和 SD 卡槽可同时使用。
更多外设共享管脚的介绍，请见下一章节中的表格。
主要 I/O 连接器 / JP1
^^^^^^^^^^^^^^^^^^^^^^^^
JP1 连接器包括 14 x 2 个排针，具体功能可见下表中间 “I/O” 列的介绍。两侧的“共用”列则介绍了这些管脚在板上的其他用途。
===================== ===== ===== =====================
共用 I/O I/O 共用
===================== ===== ===== =====================
n/a 3.3V GND n/a
NC/XTAL IO32 IO33 NC/XTAL
JTAG，MicroSD IO12 IO13 JTAG，MicroSD
JTAG，MicroSD IO14 IO27 摄像头
摄像头 IO26 IO25 摄像头，LCD
摄像头 IO35 IO34 摄像头
摄像头 IO39 IO36 摄像头
JTAG EN IO23 摄像头，LCD
摄像头，LCD IO22 IO21 摄像头，LCD，MicroSD
摄像头，LCD IO19 IO18 摄像头，LCD
摄像头，LCD IO5 IO17 PSRAM
PSRAM IO16 IO4 LED，摄像头，MicroSD
摄像头，LED，Boot IO0 IO2 LED，MicroSD
JTAG，MicroSD IO15 5V
===================== ===== ===== =====================
说明：
* NC/XTAL - :ref:`32.768 kHz 晶振 <get-started-esp-wrover-kit-v4.1-xtal-cmake>`
* JTAG - :ref:`JTAG / JP8 <get-started-esp-wrover-kit-v4.1-jtag-header-cmake>`
* Boot - Boot 按键 / SW2
* 摄像头 - :ref:`摄像头 / JP4 <get-started-esp-wrover-kit-v4.1-camera-header-cmake>`
* LED - :ref:`RGB LED <get-started-esp-wrover-kit-v4.1-rgb-led-connections-cmake>`
* MicroSD - :ref:`MicroSD Card / J4 <get-started-esp-wrover-kit-v4.1-microsd-card-slot-cmake>`
* LCD - :ref:`LCD / U5 <get-started-esp-wrover-kit-v4.1-lcd-connector-cmake>`
* PSRAM - ESP32-WROVER-B 的 PSRAM
.. _get-started-esp-wrover-kit-v4.1-xtal-cmake:
32.768 kHz 晶振
^^^^^^^^^^^^^^^^^^^^^
==== ==========
. ESP32 管脚
==== ==========
1. GPIO32
2. GPIO33
==== ==========
.. note::
默认情况下，管脚 GPIO32 和 GPIO33 已连接至晶振。因此，为了保证信号的完整性，这两个管脚并未连接至 JP1 I/O 连接器。用户可通过将 R11/R23 处的 0 欧电阻移至 R12/R24 处，以将 GP1O32 和 GPIO33 的连接从晶振移至 JP1。
.. _get-started-esp-wrover-kit-v4.1-spi-flash-header-cmake:
SPI Flash / JP2
^^^^^^^^^^^^^^^
==== =============
. ESP32 管脚
==== =============
1. CLK / GPIO6
2. SD0 / GPIO7
3. SD1 / GPIO8
4. SD2 / GPIO9
5. SD3 / GPIO10
6. CMD / GPIO11
==== =============
.. important::
模组的 flash 总线已通过 0 欧电阻 R140 ~ R145 连接至排针 JP2。如果需要将 flash 的工作频率控制在 80 MHz，以达到保证总线信号完整性等目的，建议移除 R140 ~ R145 电阻，将模组的 flash 总线与排针 JP2 断开。
.. _get-started-esp-wrover-kit-v4.1-jtag-header-cmake:
JTAG / JP2
^^^^^^^^^^
==== ============== =============
. ESP32 管脚 JTAG 信号
==== ============== =============
1. EN TRST_N
2. MTMS / GPIO14 TMS
3. MTDO / GPIO15 TDO
4. MTDI / GPIO12 TDI
5. MTCK / GPIO13 TCK
==== ============== =============
.. _get-started-esp-wrover-kit-v4.1-camera-header-cmake:
摄像头 / JP4
^^^^^^^^^^^^
==== ========== =============================
. ESP32 管脚 摄像头信号
==== ========== =============================
1. n/a 3.3V
2. n/a 地
3. GPIO27 SIO_C / SCCB 时钟
4. GPIO26 SIO_D / SCCB 数据
5. GPIO25 VSYNC / 垂直同步
6. GPIO23 HREF / 水平参考
7. GPIO22 PCLK / 像素时钟
8. GPIO21 XCLK / 系统时钟
9. GPIO35 D7 / 像素数据 Bit 7
10. GPIO34 D6 / 像素数据 Bit 6
11. GPIO39 D5 / 像素数据 Bit 5
12. GPIO36 D4 / 像素数据 Bit 4
13. GPIO19 D3 / 像素数据 Bit 3
14. GPIO18 D2 / 像素数据 Bit 2
15. GPIO5 D1 / 像素数据 Bit 1
16. GPIO4 D0 / 像素数据 Bit 0
17. GPIO0 RESET / 摄像头复位
18. n/a PWDN / 摄像头断电
==== ========== =============================
* D0 到 D7 为摄像头的数据总线
.. _get-started-esp-wrover-kit-v4.1-rgb-led-connections-cmake:
RGB LED
^^^^^^^
==== ========== =========
. ESP32 管脚 RGB LED
==== ========== =========
1. GPIO0 红色
2. GPIO2 绿色
3. GPIO4 蓝色
==== ========== =========
.. _get-started-esp-wrover-kit-v4.1-microsd-card-slot-cmake:
MicroSD 卡
^^^^^^^^^^^^
==== ============== ===============
. ESP32 管脚 MicroSD 信号
==== ============== ===============
1. MTDI / GPIO12 DATA2
2. MTCK / GPIO13 CD / DATA3
3. MTDO / GPIO15 CMD
4. MTMS / GPIO14 CLK
5. GPIO2 DATA0
6. GPIO4 DATA1
7. GPIO21 CD
==== ============== ===============
.. _get-started-esp-wrover-kit-v4.1-lcd-connector-cmake:
LCD / U5
^^^^^^^^
==== ============== ===============
. ESP32 管脚 LCD 信号
==== ============== ===============
1. GPIO18 复位
2. GPIO19 SCL
3. GPIO21 D/C
4. GPIO22 CS
5. GPIO23 SDA
6. GPIO25 SDO
7. GPIO5 背光
==== ============== ===============
.. _get-started-esp-wrover-kit-start-development-cmake:
应用程序开发
-----------------------------
ESP-WROVER-KIT 上电前，请首先确认开发板完好无损。
初始设置
^^^^^^^^^^^^^
请严格按照下图所示连接跳线帽，注意不要额外连接其他跳线帽。
- 使用 JP7 连接器，选择 USB 为开发板供电。
- 使用 JP2 连接器，使能 UART 通信。
======================== ==========================
USB 供电 使能 UART 通信
======================== ==========================
|jp7-usb_5v| |jp2-tx-rx|
======================== ==========================
注意不要连接其他跳线帽。
打开 **电源开关**，**5V Power On LED** 应点亮。
正式开始开发
^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step-cmake` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
相关文档
-----------------
* `ESP-WROVER-KIT V4.1 原理图`_ (PDF)
* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (PDF)
* `《ESP32-WROVER-B 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_cn.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index`
.. |jp7-ext_5v| image:: ../../_static/esp-wrover-kit-v4.1-jp7-ext_5v.jpg
.. |jp7-usb_5v| image:: ../../_static/esp-wrover-kit-v4.1-jp7-usb_5v.jpg
.. |jp2-jtag| image:: ../../_static/esp-wrover-kit-v4.1-jp2-jtag.jpg
.. |jp2-tx-rx| image:: ../../_static/esp-wrover-kit-v4.1-jp2-tx-rx.jpg
.. |jp14| image:: ../../_static/esp-wrover-kit-v4.1-jp14.jpg
.. _ESP-WROVER-KIT V4.1 原理图: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_V4_1.pdf
.. toctree::
:hidden:
get-started-wrover-kit-v3.rst
get-started-wrover-kit-v2.rst

4
docs/zh_CN/get-started/get-started-devkitc-v2.rst
View File

@ -1,5 +1,5 @@
ESP32-DevKitC V2 入门指南 (CMake)
==============================================
ESP32-DevKitC V2 入门指南
=========================================
:link_to_translation:`en: [English]`

192
docs/zh_CN/get-started/get-started-wrover-kit-v2.rst
View File

@ -1 +1,191 @@
.. include:: ../../en/get-started/get-started-wrover-kit-v2.rst
ESP-WROVER-KIT V2 入门指南
===========================================
:link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V2 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。
准备工作
-------------
* ESP-WROVER-KIT V2 开发板
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
--------
ESP-WROVER-KIT 是 `乐鑫 <https://espressif.com>`_ 一款基于 ESP32 的开发板，集成了 LCD 屏幕和 MicroSD 卡槽。
ESP-WROVER-KIT 可选贴以下 ESP32 模组：
- :ref:`esp-modules-and-boards-esp32-wroom-32`
- :ref:`ESP32-WROVER <esp-modules-and-boards-esp32-wrover>`
此外，ESP-WROVER-KIT 的独特之处在于集成了一款先进多协议 USB 桥接器 (FTDI FT2232HL)，允许开发人员直接通过 USB 接口，使用 JTAG 对 ESP32 进行调试，无需额外的 JTAG 调试器。ESP-WROVER-KIT 可为开发人员提供简单、便捷且极具成本效益的开发体验。
为了便于使用，板上模组的绝大部分管脚均已引出至开发板的引脚。
.. note::
ESP-WROVER-KIT V2 板载 ESP32-WROVER 模组的 GPIO16 和 GPIO17 管脚用作 PSRAM 的片选和时钟信号。 默认情况下，为了给用户提供可靠的性能，这两个 GPIO 管脚不引出至开发板引脚。
功能概述
----------------------
ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT 功能框图
:figclass: align-center
ESP-WROVER-KIT 功能框图
功能说明
----------------------
ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v2-board-front:
.. figure:: ../../_static/esp-wrover-kit-v2-layout-front.png
:align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 俯视图
:figclass: align-center
ESP-WROVER-KIT 开发板布局 -- 俯视图
.. _get-started-esp-wrover-kit-v2-board-back:
.. figure:: ../../_static/esp-wrover-kit-v2-layout-back.png
:align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 仰视图
:figclass: align-center
ESP-WROVER-KIT 开发板布局 -- 仰视图
下表从图片右上角开始，以顺时针顺序介绍了图 1 中的主要组件，然后以同样的顺序介绍了图 2 中的主要组件。
==================== ======================================================================================================================================================================================================================================================================================================================================
主要组件 基本介绍
==================== ======================================================================================================================================================================================================================================================================================================================================
32.768 kHz 外接 32.768 kHz 晶振，可提供 Deep-sleep 下使用的低功耗时钟。
ESP32 模组 可选贴 ESP32-WROOM-32 或 ESP32-WROVER。ESP32-WROVER 模组完整集成了 ESP32-WROOM-32 的所有功能，且内置 32-Mbit PSRAM，可提供灵活的额外存储空间和数据处理能力。
CTS/RTS 串口流控信号。管脚默认不连接至电路。为了使能该功能，必须用跳线帽短路掉 JP14 的相应管脚。
UART 串口。FT2232HL 和 ESP32 的串行 TX/RX 信号已引出至 JP11 的两端。默认情况下，这两路信号由跳线帽连接。如果要跳过 FT2232 使用 ESP32 模组串口，则可移除相关跳线帽，将模组连接至其他外部串口设备。
SPI 默认情况下，ESP32 使用 SPI 接口访问内置 flash 和 PSRAM。使用这些引脚连接 ESP32 和其他 SPI 设备。这种情况下，需增加额外的片选 (CS) 信号。注意，选贴 ESP32-WROVER 模组时，该接口的工作电压为 1.8 V；选贴 ESP32-WROOM-32 时，该接口的工作电压为 3.3V。
JTAG JTAG 接口。FT2232HL 和 ESP32 的 JTAG 信号已引出至 JP8 的两端。默认情况下，这两路信号不连接。如需使能 JTAG，请按照 `设置选项`_ 的介绍，连接跳线帽。
FT2232 FT2232 多协议 USB 转串口桥接器。开发人员可通过 USB 接口对 FT2232 芯片进行控制和编程，与 ESP32 建立连接。FT2232 具有 USB-to-UART 和 USB-to-JTAG 功能。
EN 复位按键。
Boot 下载按键。按下 **Boot** 键并保持，同时按一下 **EN** 键（此时不要松开 **Boot** 键）进入“固件下载”模式，通过串口下载固件。
USB USB 接口。可用作开发板的供电电源，或连接 PC 和开发板的通信接口。
电源选择开关 ESP-WROVER-KIT 开发板可通过 USB 端口或 5V 输入接口供电。用户可使用跳线帽在两种供电模式中进行选择。更多详细信息，请见章节 `设置选项`_ 中有关 JP7 连接器的描述。
电源开关 拨向 **USB** 按键一侧，开发板上电；拨离 **USB** 按键一侧，开发板掉电。
5V Input 5V 电源接口建议仅在开发板自动运行（未连接 PC）时使用。仅用于全负荷工作下的后备电源。
LDO 5V-to-3.3V 低压差线型稳压器 NCP1117(1A)。NCP1117 最大电流输出为 1 A。板上 LDO 为固定输出电压，但用户也可以选用具有可变输出电压的 LDO。更多信息，请见 `ESP-WROVER-KIT V2 原理图`_。
摄像头 摄像头接口，支持标准 OV7670 摄像头模块。
RGB LED 红绿蓝发光二极管，可由 PWM（脉冲宽度调制）控制。
I/O 板上模组的所有管脚均已引出至开发板的排针。用户可以对 ESP32 进行编程，实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。
MicroSD 卡槽 MicroSD 卡槽，可扩充存储空间：当 ESP32 进入下载模式时，GPIO2 不可处于高电平。然而，为了使能 MicroSD 卡功能，需为 GPIO2 增加一个上拉电阻。默认情况下，GPIO2 和上拉电阻 R153 处于断开状态。为了使能 MicroSD 卡，请按照 `设置选项`_ 章节的要求，连接 JP1 连接器。
LCD 显示屏 支持贴装一款 3.2” 的 SPI（标准四线串行外设接口）LCD 显示器，请见 :ref:`get-started-esp-wrover-kit-v2-board-back`。
==================== ======================================================================================================================================================================================================================================================================================================================================
.. _get-started-esp-wrover-kit-v2-setup-options:
设置选项
-------------
用户可通过 5 组排针，设置开发板功能，其中常见功能见下表：
======= ================ =====================================================================================
排针 跳线设置 功能描述
======= ================ =====================================================================================
JP1 |jp1-sd_io2| 使能 MicroSD Card 功能的上拉电阻
JP1 |jp1-both| 确保开发板处于下载模式时，GPIO2 时钟处于低位（将 JP1 连接至 GPIO0）
JP7 |jp7-ext_5v| 使用外部电源为 ESP-WROVER-KIT 开发板供电
JP7 |jp7-usb_5v| 使用 USB 端口为 ESP-WROVER-KIT 开发板供电
JP8 |jp8| 使能 JTAG 功能
JP11 |jp11-tx-rx| 使能 UART 通信
JP14 |jp14| 使能 RTS/CTS 串口流控
======= ================ =====================================================================================
.. _get-started-esp-wrover-kit-v2-start-development:
应用程序开发
-----------------------------
ESP-WROVER-KIT 上电前，请首先确认开发板完好无损。
初始设置
^^^^^^^^^^^^^
请严格按照下图所示连接跳线帽，注意不要额外连接其他跳线帽。
- 使用 JP7 连接器，选择 USB 为开发板供电。
- 使用 JP11 连接器，使能 UART 通信。
======================== ==========================
USB 供电 使能 UART 通信
======================== ==========================
|jp7-usb_5v| |jp11-tx-rx|
======================== ==========================
注意不要连接其他跳线帽。
打开 **电源开关**，**5V Power On LED** 应点亮。
正式开始开发
^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
相关文档
-----------------
* `ESP-WROVER-KIT V2 原理图`_ (PDF)
* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (PDF)
* `《ESP32-WROVER 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32_wrover_datasheet_cn.pdf>`_ (PDF)
* `《ESP32-WROOM-32 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_cn.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index`
.. |jp1-sd_io2| image:: ../../_static/wrover-jp1-sd_io2.png
.. |jp1-both| image:: ../../_static/wrover-jp1-both.png
.. |jp7-ext_5v| image:: ../../_static/wrover-jp7-ext_5v.png
.. |jp7-usb_5v| image:: ../../_static/wrover-jp7-usb_5v.png
.. |jp8| image:: ../../_static/wrover-jp8.png
.. |jp11-tx-rx| image:: ../../_static/wrover-jp11-tx-rx.png
.. |jp14| image:: ../../_static/wrover-jp14.png
.. _ESP-WROVER-KIT V2 原理图: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-2.pdf

378
docs/zh_CN/get-started/get-started-wrover-kit-v3.rst
View File

@ -1 +1,377 @@
.. include:: ../../en/get-started/get-started-wrover-kit-v3.rst
ESP-WROVER-KIT V3 入门指南
=======================================
:link_to_translation:`en:[Engish]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V3 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。
准备工作
-------------
* :ref:`ESP-WROVER-KIT V3 开发板 <get-started-esp-wrover-kit-v3-board-front>`
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
--------
ESP-WROVER-KIT 是 `乐鑫 <https://espressif.com>`_ 一款基于 ESP32 的开发板，集成了 LCD 屏幕和 MicroSD 卡槽。
ESP-WROVER-KIT 可选贴以下 ESP32 模组：
- :ref:`esp-modules-and-boards-esp32-wroom-32`
- :ref:`ESP32-WROVER <esp-modules-and-boards-esp32-wrover>`
此外，ESP-WROVER-KIT 的独特之处在于集成了一款先进多协议 USB 桥接器 (FTDI FT2232HL)，允许开发人员直接通过 USB 接口，使用 JTAG 对 ESP32 进行调试，无需额外的 JTAG 调试器。ESP-WROVER-KIT 可为开发人员提供简单、便捷且极具成本效益的开发体验。
为了便于使用，板上模组的绝大部分管脚均已引出至开发板的引脚。
.. note::
该版本 ESP32-WROVER 模组 的 GPIO16 和 GPIO17 管脚用作 PSRAM 的片选和时钟信号。默认情况下，为了给用户提供可靠的性能，这两个 GPIO 管脚不引出至开发板引脚。
功能概述
----------------------
ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT 功能框图
:figclass: align-center
ESP-WROVER-KIT 功能框图
功能说明
----------------------
ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v3-board-front:
.. figure:: ../../_static/esp-wrover-kit-v3-layout-front.jpg
:align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 俯视图
:figclass: align-center
ESP-WROVER-KIT 开发板布局 -- 俯视图
.. _get-started-esp-wrover-kit-v3-board-back:
.. figure:: ../../_static/esp-wrover-kit-v3-layout-back.jpg
:align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 仰视图
:figclass: align-center
ESP-WROVER-KIT 开发板布局 -- 仰视图
下表从图片右上角开始，以顺时针顺序介绍了图 1 中的主要组件，然后以同样的顺序介绍图 2 中的主要组件。
==================== ======================================================================================================================================================================================================================================================================================================================================
主要组件 基本介绍
==================== ======================================================================================================================================================================================================================================================================================================================================
32.768 kHz 外接 32.768 kHz 晶振，可提供 Deep-sleep 下使用的低功耗时钟。
0 欧电阻 ESP-WROVER-KIT 开发板设计了一个 0 欧电阻，可在测量 ESP32 系列模组在不同功耗模式下的电流时，直接移除或替换为分流器。
ESP32 模组 可选贴 ESP32-WROOM-32 或 ESP32-WROVER。ESP32-WROVER 模组完整集成了 ESP32-WROOM-32 的所有功能，且内置 32-Mbit PSRAM，可提供灵活的额外存储空间和数据处理能力。
FT2232 FT2232 多协议 USB 转串口桥接器。开发人员可通过 USB 接口对 FT2232 芯片进行控制和编程，与 ESP32 建立连接。FT2232 芯片可在通道 A 提供 USB-to-JTAG 接口功能，并在通道 B 提供 USB-to-Serial 接口功能，便利开发人员的应用开发与调试。见 `ESP-WROVER-KIT V3 原理图`_。
UART 串口。FT2232HL 和 ESP32 的串行 TX/RX 信号已引出至 JP11 的两端。默认情况下，这两路信号由跳线帽连接。如果要跳过 FT2232 使用 ESP32 模组串口，则可移除相关跳线帽，将模组连接至其他外部串口设备。
SPI 默认情况下，ESP32 使用 SPI 接口访问内置 flash 和 PSRAM。使用这些引脚连接 ESP32 和其他 SPI 设备。这种情况下，需增加额外的片选 (CS) 信号。注意，选贴 ESP32-WROVER 模组时，该接口的工作电压为 1.8 V；选贴 ESP32-WROOM-32 时，该接口的工作电压为 3.3V。
CTS/RTS 串口流控信号。管脚默认不连接至电路。为了使能该功能，必须用跳线帽短路掉 JP14 的相应管脚。
JTAG JTAG 接口。FT2232HL 和 ESP32 的 JTAG 信号已引出至 JP8 的两端。默认情况下，这两路信号不连接。如需使能 JTAG，请按照 `设置选项`_ 的介绍，连接跳线帽。
EN 复位按键。
Boot 下载按键。按下 **Boot** 键并保持，同时按一下 **EN** 键（此时不要松开 **Boot** 键）进入“固件下载”模式，通过串口下载固件。
USB USB 接口。可用作开发板的供电电源，或连接 PC 和开发板的通信接口。
电源开关 拨向 **USB** 按键一侧，开发板上电；拨离 **USB** 按键一侧，开发板掉电。
电源选择开关 ESP-WROVER-KIT 开发板可通过 USB 端口或 5V 输入接口供电。用户可使用跳线帽在两种供电模式中进行选择。更多详细信息，请见章节 `设置选项`_ 中有关 JP7 连接器的描述。
5V Input 5V 电源接口建议仅在开发板自动运行（未连接 PC）时使用。仅用于全负荷工作下的后备电源。
LDO 5V-to-3.3V 低压差线型稳压器 NCP1117(1A)。NCP1117 最大电流输出为 1 A。板上 LDO 为固定输出电压，但用户也可以选用具有可变输出电压的 LDO。更多信息，请见 `ESP-WROVER-KIT V3 原理图`_。
摄像头 摄像头接口，支持标准 OV7670 摄像头模块。
RGB LED 红绿蓝发光二极管，可由 PWM（脉冲宽度调制）控制。
I/O 板上模组的所有管脚均已引出至开发板的排针。用户可以对 ESP32 进行编程，实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。
MicroSD 卡槽 适用于需要扩充数据存储空间或进行备份的应用开发场景。
LCD 显示屏 支持贴装一款 3.2” 的 SPI（标准四线串行外设接口）LCD 显示器，请见 :ref:`get-started-esp-wrover-kit-v3-board-back`。
==================== ======================================================================================================================================================================================================================================================================================================================================
.. _get-started-esp-wrover-kit-v3-setup-options:
设置选项
-------------
用户可通过 5 组排针，设置开发板功能，其中常见功能见下表：
======= ================ =========================================================================
排针 跳线设置 功能描述
======= ================ =========================================================================
JP7 |jp7-ext_5v| 使用外部电源为 ESP-WROVER-KIT 开发板供电
JP7 |jp7-usb_5v| 使用 USB 端口为 ESP-WROVER-KIT 开发板供电
JP8 |jp8| 使能 JTAG 功能
JP11 |jp11-tx-rx| 使能 UART 通信
JP14 |jp14| 使能 RTS/CTS 串口流控
======= ================ =========================================================================
ESP32 管脚分配
------------------------
ESP32 模组的部分管脚/终端已被板上组件占用或用于外部硬件设备。如果某管脚对应的特定硬件未连接，则该管脚可用作他用。比如，摄像头/JP4 排针未连接相应硬件，则这些 GPIO 可用于其他用途。
部分管脚具备多个功能，可供板上组件或外部硬件设备同时使用，比如 GPIO0 和 GPIO2。由于管脚限制，一些外围设备不可同时使用，比如，由于 JTAG 和 SD 卡槽需共用部分管脚，因此一些使用 SD 卡功能的应用无法同时进行 JTAG 调试。
其他情况下，不同外设可同时使用。比如，LCD 屏幕和 SD 卡仅共用一个 GPIO21 管脚，可以同时使用。该管脚可为 LCD 屏幕提供 D/C（数据/控制）信号，并用于读取来自 SD 卡槽的 CD 信号（卡检测信号）。如无需使用卡检测功能，开发人员还可以通过移除 R167 来禁用该功能。此时，LCD 和 SD 卡槽可同时使用。
更多外设共享管脚的介绍，请见下一章节中的表格。
主要 I/O 连接器 / JP1
^^^^^^^^^^^^^^^^^^^^^^^^
JP1 连接器包括 14 x 2 个排针，具体功能可见下表中间 “I/O” 列的介绍。两侧的“共用”列则介绍了这些管脚在板上的其他用途。
===================== ===== ===== =====================
共用 I/O I/O 共用
===================== ===== ===== =====================
n/a 3.3V GND n/a
NC/XTAL IO32 IO33 NC/XTAL
JTAG, MicroSD IO12 IO13 JTAG, MicroSD
JTAG, MicroSD IO14 IO27 摄像头
摄像头 IO26 IO25 摄像头，LCD
摄像头 IO35 IO34 摄像头
摄像头 IO39 IO36 摄像头
JTAG EN IO23 摄像头，LCD
摄像头，LCD IO22 IO21 摄像头，LCD，MicroSD
摄像头，LCD IO19 IO18 摄像头，LCD
摄像头，LCD IO5 IO17 PSRAM
PSRAM IO16 IO4 LED，摄像头，MicroSD
摄像头，LED，Boot IO0 IO2 LED，MicroSD
JTAG，MicroSD IO15 5V
===================== ===== ===== =====================
说明：
* NC/XTAL - :ref:`32.768 kHz Oscillator <get-started-esp-wrover-kit-v3-xtal>`
* JTAG - :ref:`JTAG / JP8 <get-started-esp-wrover-kit-v3-jtag-header>`
* Boot - Boot 按键 / SW2
* 摄像头 - :ref:`摄像头 / JP4 <get-started-esp-wrover-kit-v3-camera-header>`
* LED - :ref:`RGB LED <get-started-esp-wrover-kit-v3-rgb-led-connections>`
* MicroSD - :ref:`MicroSD Card / J4 <get-started-esp-wrover-kit-v3-microsd-card-slot>`
* LCD - :ref:`LCD / U5 <get-started-esp-wrover-kit-v3-lcd-connector>`
* PSRAM - 仅适用于选贴 ESP32-WROVER 的情况。
.. _get-started-esp-wrover-kit-v3-xtal:
32.768 kHz 晶振
^^^^^^^^^^^^^^^^^^^^^
==== ==========
. ESP32 管脚
==== ==========
1. GPIO32
2. GPIO33
==== ==========
.. note::
默认情况下，管脚 GPIO32 和 GPIO33 已连接至晶振。因此，为了保证信号的完整性，这两个管脚并未连接至 JP1 I/O 连接器。用户可通过将 R11/R23 处的 0 欧电阻移至 R12/R24 处，以将 GP1O32 和 GPIO33 的连接从晶振移至 JP1。
.. _get-started-esp-wrover-kit-v3-spi-flash-header:
SPI Flash / JP13
^^^^^^^^^^^^^^^^
==== =============
. ESP32 管脚
==== =============
1. CLK / GPIO6
2. SD0 / GPIO7
3. SD1 / GPIO8
4. SD2 / GPIO9
5. SD3 / GPIO10
6. CMD / GPIO11
==== =============
.. important::
模组的 flash 总线已通过 0 欧电阻 R140 ~ R145 连接至排针 JP13。如果需要将 flash 的工作频率控制在 80 MHz，为了达到保证总线信号完整性等目的，建议移除 R140 ~ R145 电阻，将模组的 flash 总线与排针 JP2 断开。
.. _get-started-esp-wrover-kit-v3-jtag-header:
JTAG / JP8
^^^^^^^^^^
==== ============== =============
. ESP32 管脚 JTAG 信号
==== ============== =============
1. EN TRST_N
2. MTMS / GPIO14 TMS
3. MTDO / GPIO15 TDO
4. MTDI / GPIO12 TDI
5. MTCK / GPIO13 TCK
==== ============== =============
.. _get-started-esp-wrover-kit-v3-camera-header:
摄像头 / JP4
^^^^^^^^^^^^
==== ========== =============================
. ESP32 管脚 摄像头信号
==== ========== =============================
1. n/a 3.3V
2. n/a 地
3. GPIO27 SIO_C / SCCB 时钟
4. GPIO26 SIO_D / SCCB 数据
5. GPIO25 VSYNC / 垂直同步
6. GPIO23 HREF / 水平参考
7. GPIO22 PCLK / 像素时钟
8. GPIO21 XCLK / 系统时钟
9. GPIO35 D7 / 像素数据 Bit 7
10. GPIO34 D6 / 像素数据 Bit 6
11. GPIO39 D5 / 像素数据 Bit 5
12. GPIO36 D4 / 像素数据 Bit 4
13. GPIO19 D3 / 像素数据 Bit 3
14. GPIO18 D2 / 像素数据 Bit 2
15. GPIO5 D1 / 像素数据 Bit 1
16. GPIO4 D0 / 像素数据 Bit 0
17. GPIO0 RESET / 摄像头复位
18. n/a PWDN / 摄像头断电
==== ========== =============================
* D0 到 D7 为摄像头的数据总线
.. _get-started-esp-wrover-kit-v3-rgb-led-connections:
RGB LED
^^^^^^^
==== ========== =========
. ESP32 管脚 RGB LED
==== ========== =========
1. GPIO0 红色
2. GPIO2 绿色
3. GPIO4 蓝色
==== ========== =========
.. _get-started-esp-wrover-kit-v3-microsd-card-slot:
MicroSD 卡
^^^^^^^^^^^^
==== ============== ===============
. ESP32 管脚 MicroSD 信号
==== ============== ===============
1. MTDI / GPIO12 DATA2
2. MTCK / GPIO13 CD / DATA3
3. MTDO / GPIO15 CMD
4. MTMS / GPIO14 CLK
5. GPIO2 DATA0
6. GPIO4 DATA1
7. GPIO21 CD
==== ============== ===============
.. _get-started-esp-wrover-kit-v3-lcd-connector:
LCD / U5
^^^^^^^^
==== ============== ===============
. ESP32 管脚 LCD 信号
==== ============== ===============
1. GPIO18 复位
2. GPIO19 SCL
3. GPIO21 D/C
4. GPIO22 CS
5. GPIO23 SDA
6. GPIO25 SDO
7. GPIO5 背光
==== ============== ===============
.. _get-started-esp-wrover-kit-v3-start-development:
应用程序开发
-----------------------------
ESP-WROVER-KIT 上电前，请首先确认开发板完好无损。
初始设置
^^^^^^^^^^^^^
请严格按照下图所示连接跳线帽，注意不要额外连接其他跳线帽。
- 使用 JP7 连接器，选择 USB 为开发板供电。
- 使用 JP11 连接器，使能 UART 通信。
======================== ==========================
USB 供电 使能 UART 通信
======================== ==========================
|jp7-usb_5v| |jp11-tx-rx|
======================== ==========================
注意不要连接其他跳线帽。
打开 **电源开关**，**5V Power On LED** 应点亮。
正式开始开发
^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
相关文档
-----------------
* `ESP-WROVER-KIT V3 原理图`_ (PDF)
* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (PDF)
* `《ESP32-WROVER 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32_wrover_datasheet_cn.pdf>`_ (PDF)
* `《ESP32-WROOM-32 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_cn.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index`
.. |jp7-ext_5v| image:: ../../_static/esp-wrover-kit-v3-jp7-ext_5v.png
.. |jp7-usb_5v| image:: ../../_static/esp-wrover-kit-v3-jp7-usb_5v.png
.. |jp8| image:: ../../_static/esp-wrover-kit-v3-jp8.png
.. |jp11-tx-rx| image:: ../../_static/esp-wrover-kit-v3-jp11-tx-rx.png
.. |jp14| image:: ../../_static/esp-wrover-kit-v3-jp14.png
.. _ESP-WROVER-KIT V3 原理图: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-3.pdf
.. toctree::
:hidden:
get-started-wrover-kit-v2.rst

454
docs/zh_CN/get-started/get-started-wrover-kit.rst
View File

@ -2,128 +2,126 @@ ESP-WROVER-KIT V4.1 入门指南
=========================================
:link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V4.1 开发板。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。
如果你希望开始 ESP-WROVER-KIT V4.1 的应用开发，请直接前往章节 :ref:`应用程序开发 <get-started-esp-wrover-kit-v4.1-start-development>`。
本指南介绍了如何开始使用 ESP-WROVER-KIT V4.1 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。
准备工作
-------------
* 1 × :ref:`ESP-WROVER-KIT V4.1 开发板 <get-started-esp-wrover-kit-v4.1-board-front>`
* 1 × USB A / micro USB B 电缆
* 1 × PC（Windows、Linux 或 Mac OS）
* :ref:`ESP-WROVER-KIT V4.1 开发板 <get-started-esp-wrover-kit-v4.1-board-front>`
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
简介
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
--------
ESP-WROVER-KIT 是一款来自 `乐鑫 <https://espressif.com>`_ 的开发板，板上模组的绝大部分管脚均已引出，可根据用户需求，轻松连接多种外围器件。本开发板搭配一块 LCD 显示器，支持 MicroSD 卡槽拓展，还搭载一款先进多协议 USB 桥接器 (FTDI FT2232HL)，允许开发者直接通过 USB 接口，使用 JTAG 对 ESP32 进行调试，便利用户的二次开发。
ESP-WROVER-KIT 是 `乐鑫 <https://espressif.com>`_ 一款基于 ESP32 的开发板。
ESP-WROVER-KIT V4.1 开发板可兼容 ESP32-WROOM-32、ESP32-WROVER 和 ESP32-WROVER-B 模组，默认贴 ESP32-WROVER-B 模组。
ESP-WROVER-KIT 开发板已集成了如下组件：
功能框图
-------------------
- ESP32-WROVER-B 模组
- LCD 屏
- MicroSD 卡槽
此外，ESP-WROVER-KIT 的独特之处在于集成了一款先进多协议 USB 桥接器 (FTDI FT2232HL)，允许开发人员直接通过 USB 接口，使用 JTAG 对 ESP32 进行调试，无需额外的 JTAG 调试器。ESP-WROVER-KIT 可为开发人员提供简单、便捷且极具成本效益的开发体验。
为了便于使用，板上模组的绝大部分管脚均已引出至开发板的引脚。
.. note::
ESP32 的 GPIO16 和 GPIO17 管脚用作 PSRAM 的片选和时钟信号。默认情况下，为了给用户提供可靠的性能，这两个 GPIO 管脚不引出至开发板引脚。
功能概述
----------------------
ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT block diagram
:alt: ESP-WROVER-KIT 功能框图
:figclass: align-center
ESP-WROVER-KIT 功能框图
功能描述
--------------------
功能说明
----------------------
ESP-WROVER-KIT 开发板的主要组件、接口及控制方式如下文所示。
32.768 kHz 晶振
32.768 kHz 晶振，可提供 Deep-sleep 下使用的低功耗时钟。
USB-UART 桥接器
单芯片 USB-UART 桥接器 (FT2232)，可提供高达 3 Mbps 的传输速率。开发者可通过 USB 接口对 FT2232 芯片进行控制和编程，与 ESP32 建立连接。FT2232 芯片可在通道 A 提供 USB-to-JTAG 接口功能，并在通道 B 提供 USB-to-serial 接口功能。ESP-WROVER-KIT 的内置 FT2232 芯片功能强大，是这款开发板的特色之一，可显著便利用户的应用开发与调试。此外，用户无需单独购买 JTAG 调试器，可降低应用开发成本。具体请见 `ESP-WROVER-KIT V4.1 原理图`_ 。
0 欧电阻
ESP-WROVER-KIT 开发板设计了一个 0 欧电阻，可在测量 ESP32 系列模组在不同功耗模式下的电流时，直接移除或替换为分流器。
ESP32-WROVER 模组
ESP-WROVER-KIT V4.1 默认贴 ESP-WROVER-B 模组，内置 8 MB PSRAM，可提供灵活的额外存储空间和数据处理能力。本开发板支持的其他模组的信息，请见 :ref:`esp-wroom-solo-wrover-modules`。
.. note::
GPIO16 和 GPIO17 用于为 PSRAM 提供 CS 和时钟信号，因此并未引出。
诊断 LED 信号灯
本开发板 FT2232 芯片的 GPIO 管脚连接了 4 个 LED 信号灯，以备后用。
UART
FT2232HL 和 ESP32 的串行 TX/RX 信号已引出至 JP2 的两端。默认情况下，这两路信号由跳线帽连接。如果仅需使用 ESP32 模组串口，则可移除相关跳线帽，将模组连接至其他外部串口设备。
SPI
该 SPI 接口可用于 ESP32 访问模组 flash 和 PSRAM 内存。注意，该接口的电压取决于开发板上贴的模组。
CTS/RTS
串口流控信号。管脚默认不连接至电路。为了使能该功能，必须用跳线帽断路掉 JP14 连接器的相应管脚。
JTAG
FT2232HL 和 ESP32 的串口 JTAG 信号已引出至 JP2 连接器的两端。默认情况下，这两路信号不连接。如需使能 JTAG，请按照 :ref:`设置选项 <get-started-esp-wrover-kit-v4.1-setup-options>` 中的介绍，连接跳线帽。
USB 端口
USB 端口，可用作电路板的供电电源或连接 PC 端的通信接口。
EN 按键
复位键，可重置系统。
Boot 按键
下载按键。按下 **Boot** 键并保持，同时按一下 **EN** 键（此时不要松开 **Boot** 键）进入固件下载模式，通过串口下载固件。
电源开关
拨置右侧，开发板上电；拨置左侧，开发板掉电。
电源选择开关
ESP-WROVER-KIT 开发板可通过 USB 端口或 5V 输入端口供电。用户可使用跳线帽在两种供电模式中进行选择。更多详细信息，请见章节 :ref:`设置选项 <get-started-esp-wrover-kit-v4.1-setup-options>` 中有关 JP7 连接器的描述。
5V 输入
5V 电源接口仅用于全负荷工作下的后备电源。
5V LED 电源指示灯
当开发板通电后（USB 或外部 5V 供电），该指示灯将亮起。
LDO
5V-to-3.3V LDO NCP1117(1 A)（也可选 Pin-to-Pin LDO LM317DCY，最高输出电流为 1.5 A）。NCP1117 最大电流输出为 1 A。LDO 解决方案同时支持固定输出电压和可变输出电压。更多信息，请见 `ESP-WROVER-KIT V4.1 原理图`_。
摄像头连接器
摄像头接口：支持标准 OV7670 摄像头模块。
RGB LED
红绿蓝发光二极管，由 PMW 控制。
I/O 连接器
ESP32 系列模组的所有管脚均引出至 ESP-WROVER-KIT 的排针。用户可对 ESP32 进行编程，实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。
Micro SD 卡槽
可用于一些使用 Micro SD 卡，扩充数据存储空间或进行备份的应用开发。
LCD 显示器
ESP-WROVER-KIT 支持贴装一款 3.2” 的 SPI（标准四线串行外设接口）LCD 显示器，请见 :ref:`get-started-esp-wrover-kit-v4.1-board-back`。
ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v4.1-board-front:
.. figure:: ../../_static/esp-wrover-kit-v4.1-layout-front.png
:align: center
:alt: ESP-WROVER-KIT board layout - front
:alt: ESP-WROVER-KIT 开发板布局 -- 俯视图
:figclass: align-center
ESP-WROVER-KIT 开发板 - 正面
ESP-WROVER-KIT 开发板布局 -- 俯视图
.. _get-started-esp-wrover-kit-v4.1-board-back:
.. figure:: ../../_static/esp-wrover-kit-v4.1-layout-back.png
:align: center
:alt: ESP-WROVER-KIT board layout - back
:alt: ESP-WROVER-KIT 开发板布局 -- 仰视图
:figclass: align-center
ESP-WROVER-KIT 开发板 - 背面
ESP-WROVER-KIT 开发板布局 -- 仰视图
下表将从图片右上角开始，以顺时针顺序介绍图 1 中的主要组件，然后按同样顺序介绍图 2 中的主要组件。
==================== ======================================================================================================================================================================================================================================================================================================================================
主要组件 基本介绍
==================== ======================================================================================================================================================================================================================================================================================================================================
FT2232 FT2232 多协议 USB 转串口桥接器。开发人员可通过 USB 接口对 FT2232 芯片进行控制和编程，与 ESP32 建立连接。FT2232 芯片可在通道 A 提供 USB-to-JTAG 接口功能，并在通道 B 提供 USB-to-Serial 接口功能，便利开发人员的应用开发与调试。详见 `ESP-WROVER-KIT V4.1 原理图`_。
32.768 kHz 外接 32.768 kHz 晶振，可提供 Deep-sleep 下使用的低功耗时钟。
0 欧电阻. ESP-WROVER-KIT 开发板设计了一个 0 欧电阻，可在测量 ESP32 系列模组在不同功耗模式下的电流时，直接移除或替换为分流器。
ESP32-WROVER-B 模组 ESP-WROVER 模组内置 64-Mbit PSRAM，可提供灵活的额外存储空间和数据处理能力。
诊断 LED 信号灯 本开发板 FT2232 芯片的 GPIO 管脚连接了 4 个红色 LED 信号灯，以备后用。
UART 串口。FT2232HL 和 ESP32 的串行 TX/RX 信号已引出至 JP11 的两端。默认情况下，这两路信号由跳线帽连接。如果要跳过 FT2232 使用 ESP32 模组串口，则可移除相关跳线帽，将模组连接至其他外部串口设备。
SPI 默认情况下，ESP32 使用 SPI 接口访问内置 flash 和 PSRAM。使用这些引脚连接 ESP32 和其他 SPI 设备。这种情况下，需增加额外的片选 (CS) 信号。注意，本接口的工作电压为 3.3 V。
CTS/RTS 串口流控信号。管脚默认不连接至电路。为了使能该功能，必须用跳线帽短路掉 JP14 的相应管脚。
JTAG JTAG 接口。FT2232HL 和 ESP32 的 JTAG 信号已引出至 JP2 的两端。默认情况下，这两路信号不连接。如需使能 JTAG，请按照 `设置选项`_ 的介绍，连接跳线帽。
USB 端口 USB 接口。可用作开发板的供电电源，或连接 PC 和开发板的通信接口。
EN 复位按键。
Boot 按键 下载按键。按下 **Boot** 键并保持，同时按一下 **EN** 键（此时不要松开 **Boot** 键）进入“固件下载”模式，通过串口下载固件。
电源开关 拨向 **Boot** 按键一侧，开发板上电；拨离 **Boot** 按键一侧，开发板掉电。
电源选择开关 ESP-WROVER-KIT 开发板可通过 USB 端口或 5V 输入接口供电。用户可使用跳线帽在两种供电模式中进行选择。更多详细信息，请见章节 `设置选项`_ 中有关 JP7 连接器的描述。
5V Input 5V 电源接口建议仅在开发板自动运行（未连接 PC）时使用。仅用于全负荷工作下的后备电源。
5V Power On LED 当开发板通电后（USB 或外部 5V 供电），该红色指示灯将亮起。
LDO 5V-to-3.3V 低压差线型稳压器 NCP1117(1A)。NCP1117 最大电流输出为 1 A。板上 LDO 为固定输出电压，但用户也可以选用具有可变输出电压的 LDO。更多信息，请见 `ESP-WROVER-KIT V4.1 原理图`_。
摄像头连接器 摄像头接口，支持标准 OV7670 摄像头模块。
RGB LED 红绿蓝发光二极管，可由 PWM（脉冲宽度调制）控制。
I/O 连接器 板上模组的所有管脚均已引出至开发板的排针。用户可以对 ESP32 进行编程，实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。
MicroSD 卡槽 适用于需要扩充数据存储空间或进行备份的应用开发场景。
LCD 显示屏 支持贴装一款 3.2” 的 SPI（标准四线串行外设接口）LCD 显示器，请见 :ref:`get-started-esp-wrover-kit-v4.1-board-back`。
==================== ======================================================================================================================================================================================================================================================================================================================================
.. _get-started-esp-wrover-kit-v4.1-setup-options:
@ -131,75 +129,82 @@ LCD 显示器
设置选项
-------------
用户可通过 3 组排针，设置开发板功能，详见下表：
==== ============== ===============
排针 跳线设置 功能描述
==== ============== ===============
JP7 |jp7-ext_5v| 使用外部电源为 ESP-WROVER-KIT 开发板供电
JP7 |jp7-usb_5v| 使用 USB 端口为 ESP-WROVER-KIT 开发板供电
JP2 |jp2-jtag| 使能 JTAG 功能
JP2 |jp2-tx-rx| 使能 UART 功能
JP14 |jp14| 使能 RTS/CTS 串口流控
==== ============== ===============
用户可通过 3 组排针，设置开发板功能，其中常见功能见下表：
======= ================ =========================================================================
排针 跳线设置 功能描述
======= ================ =========================================================================
JP7 |jp7-ext_5v| 使用外部电源为 ESP-WROVER-KIT 开发板供电
JP7 |jp7-usb_5v| 使用 USB 端口为 ESP-WROVER-KIT 开发板供电
JP2 |jp2-jtag| 使能 JTAG 功能
JP2 |jp2-tx-rx| 使能 UART 通信
JP14 |jp14| 使能 RTS/CTS 串口流控
======= ================ =========================================================================
ESP32 管脚分配
------------------------
ESP32 模组的多个管脚已分配给开发板的硬件使用，部分支持多个功能，比如 GPIO0 和 GPIO2。如果某管脚对应的特定硬件未连接，则该管脚可用作他用。比如，摄像头/JP4 排针未连接相应硬件，则这些 GPIO 可用于其他用途。
ESP32 模组的部分管脚/终端已被板上组件占用或用于外部硬件设备。如果某管脚对应的特定硬件未连接，则该管脚可用作他用。比如，摄像头/JP4 排针未连接相应硬件，则这些 GPIO 可用于其他用途。
部分管脚具备多个功能，可供板上组件或外部硬件设备同时使用，比如 GPIO0 和 GPIO2。由于管脚限制，一些外围设备不可同时使用，比如，由于 JTAG 和 SD 卡槽需共用部分管脚，因此一些使用 SD 卡功能的应用无法同时进行 JTAG 调试。
其他情况下，不同外设可同时使用。比如，LCD 屏幕和 SD 卡仅共用一个 GPIO21 管脚，可以同时使用。该管脚可为 LCD 屏幕提供 D/C（数据/控制）信号，并用于读取来自 SD 卡槽的 CD 信号（卡检测信号）。如无需使用卡检测功能，开发人员还可以通过移除 R167 来禁用该功能。此时，LCD 和 SD 卡槽可同时使用。
更多外设共享管脚的介绍，请见下一章节中的表格。
主要 I/O 连接器 / JP1
^^^^^^^^^^^^^^^^^^^^^^^^
JP1 连接器可见下表中部的 “I/O” 列，GPIO 共用描述可见下表两侧的 “共用” 列：
JP1 连接器包括 14 x 2 个排针，具体功能可见下表中间 “I/O” 列的介绍。两侧的“共用”列则介绍了这些管脚在板上的其他用途。
===================== ====== ====== =====================
共用 I/O I/O 共用
===================== ====== ====== =====================
-- 3.3 V GND --
NC/XTAL IO32 IO33 NC/XTAL
JTAG, MicroSD IO12 IO13 JTAG, MicroSD
JTAG, MicroSD IO14 IO27 Camera
Camera IO26 IO25 Camera, LCD
Camera IO35 IO34 Camera
Camera IO39 IO36 Camera
JTAG EN IO23 Camera, LCD
Camera, LCD IO22 IO21 Camera, LCD, MicroSD
Camera, LCD IO19 IO18 Camera, LCD
Camera, LCD IO5 IO17 PSRAM
PSRAM IO16 IO4 LED, Camera, MicroSD
Camera, LED, Boot IO0 IO2 LED, MicroSD
JTAG, MicroSD IO15 5 V --
===================== ====== ====== =====================
===================== ===== ===== =====================
共用 I/O I/O 共用
===================== ===== ===== =====================
n/a 3.3V GND n/a
NC/XTAL IO32 IO33 NC/XTAL
JTAG，MicroSD IO12 IO13 JTAG，MicroSD
JTAG，MicroSD IO14 IO27 摄像头
摄像头 IO26 IO25 摄像头，LCD
摄像头 IO35 IO34 摄像头
摄像头 IO39 IO36 摄像头
JTAG EN IO23 摄像头，LCD
摄像头，LCD IO22 IO21 摄像头，LCD，MicroSD
摄像头，LCD IO19 IO18 摄像头，LCD
摄像头，LCD IO5 IO17 PSRAM
PSRAM IO16 IO4 LED，摄像头，MicroSD
摄像头，LED，Boot IO0 IO2 LED，MicroSD
JTAG，MicroSD IO15 5V
===================== ===== ===== =====================
说明：
* NC/XTAL - :ref:`32.768 kHz Oscillator <get-started-esp-wrover-kit-v4.1-xtal>`
* NC/XTAL - :ref:`32.768 kHz 晶振 <get-started-esp-wrover-kit-v4.1-xtal>`
* JTAG - :ref:`JTAG / JP8 <get-started-esp-wrover-kit-v4.1-jtag-header>`
* Boot - Boot button / SW2
* Camera - :ref:`Camera / JP4 <get-started-esp-wrover-kit-v4.1-camera-header>`
* Boot - Boot 按键 / SW2
* 摄像头 - :ref:`摄像头 / JP4 <get-started-esp-wrover-kit-v4.1-camera-header>`
* LED - :ref:`RGB LED <get-started-esp-wrover-kit-v4.1-rgb-led-connections>`
* MicroSD - :ref:`MicroSD Card / J4 <get-started-esp-wrover-kit-v4.1-microsd-card-slot>`
* LCD - :ref:`LCD / U5 <get-started-esp-wrover-kit-v4.1-lcd-connector>`
* PSRAM - 适用于贴装 ESP32-WROVER 模组（带有 PSRAM）的情况
* PSRAM - ESP32-WROVER-B 的 PSRAM
.. _get-started-esp-wrover-kit-v4.1-xtal:
32.768 kHz 晶振
^^^^^^^^^^^^^^^^^^^^^
=== ============
No. ESP32 管脚
=== ============
1 GPIO32
2 GPIO33
=== ============
==== ==========
. ESP32 管脚
==== ==========
1. GPIO32
2. GPIO33
==== ==========
.. note::
管脚 GPIO32 和 GPIO33 已连接至晶振，为了保证信号的完整性，并未连接至 JP1 I/O 扩展连接器。用户可通过移除 R11/R23 位置处的 0 欧电阻，并将这些 0 欧电阻安装至 R12/R24 位置，从而从晶振换至 JP1 I/O 扩展连接器。
默认情况下，管脚 GPIO32 和 GPIO33 已连接至晶振。因此，为了保证信号的完整性，这两个管脚并未连接至 JP1 I/O 连接器。用户可通过将 R11/R23 处的 0 欧电阻移至 R12/R24 处，以将 GP1O32 和 GPIO33 的连接从晶振移至 JP1。
.. _get-started-esp-wrover-kit-v4.1-spi-flash-header:
@ -207,20 +212,20 @@ No. ESP32 管脚
SPI Flash / JP2
^^^^^^^^^^^^^^^
=== =============
No. ESP32 管脚
=== =============
1 CLK / GPIO6
2 SD0 / GPIO7
3 SD1 / GPIO
4 SD2 / GPIO9
5 SD3 / GPIO10
6 CMD / GPIO11
=== =============
==== =============
. ESP32 管脚
==== =============
1. CLK / GPIO6
2. SD0 / GPIO7
3. SD1 / GPIO8
4. SD2 / GPIO9
5. SD3 / GPIO10
6. CMD / GPIO11
==== =============
.. important::
模组的 flash 总线已通过 0 欧电阻 R140 ~ R145 连接至排针 JP2。如果需要将 flash 的工作频率控制在 80 MHz（比如为了保证总线信号完整性），建议将 R140 ~ R145 电阻焊掉。此时，模组的 flash 总线与排针 JP2 断开连接。
模组的 flash 总线已通过 0 欧电阻 R140 ~ R145 连接至排针 JP2。如果需要将 flash 的工作频率控制在 80 MHz，以达到保证总线信号完整性等目的，建议移除 R140 ~ R145 电阻，将模组的 flash 总线与排针 JP2 断开。
.. _get-started-esp-wrover-kit-v4.1-jtag-header:
@ -228,44 +233,46 @@ No. ESP32 管脚
JTAG / JP2
^^^^^^^^^^
=== ============== ==========
No. ESP32 管脚 JTAG 信号
=== ============== ==========
1 EN TRST_N
2 MTMS / GPIO14 TMS
3 MTDO / GPIO15 TDO
4 MTDI / GPIO12 TDI
5 MTCK / GPIO13 TCK
=== ============== ==========
==== ============== =============
. ESP32 管脚 JTAG 信号
==== ============== =============
1. EN TRST_N
2. MTMS / GPIO14 TMS
3. MTDO / GPIO15 TDO
4. MTDI / GPIO12 TDI
5. MTCK / GPIO13 TCK
==== ============== =============
.. _get-started-esp-wrover-kit-v4.1-camera-header:
摄像头 / JP4
^^^^^^^^^^^^
=== ============== ===============================
No. ESP32 管脚 摄像头信号
=== ============== ===============================
1 n/a 3.3V
2 n/a Ground
3 GPIO27 SIO_C / SCCB 时钟
4 GPIO26 SIO_D / SCCB 数据
5 GPIO25 VSYNC / 垂直同步
6 GPIO23 HREF / 水平参考
7 GPIO22 PCLK / 像素时钟
8 GPIO21 XCLK / 系统时钟
9 GPIO35 D7 / 像素数据第 7 位
10 GPIO34 D6 / 像素数据第 6 位
11 GPIO39 D5 / 像素数据第 5 位
12 GPIO36 D4 / 像素数据第 4 位
13 GPIO19 D3 / 像素数据第 3 位
14 GPIO18 D2 / 像素数据第 2 位
15 GPIO5 D1 / 像素数据第 1 位
16 GPIO4 D0 / 像素数据第 0 位
17 GPIO0 RESET / 摄像头复位
18 n/a PWDN / 摄像头掉电
=== ============== ===============================
* 信号 D0 .. D7 为摄像头数据总线
==== ========== =============================
. ESP32 管脚 摄像头信号
==== ========== =============================
1. n/a 3.3V
2. n/a 地
3. GPIO27 SIO_C / SCCB 时钟
4. GPIO26 SIO_D / SCCB 数据
5. GPIO25 VSYNC / 垂直同步
6. GPIO23 HREF / 水平参考
7. GPIO22 PCLK / 像素时钟
8. GPIO21 XCLK / 系统时钟
9. GPIO35 D7 / 像素数据 Bit 7
10. GPIO34 D6 / 像素数据 Bit 6
11. GPIO39 D5 / 像素数据 Bit 5
12. GPIO36 D4 / 像素数据 Bit 4
13. GPIO19 D3 / 像素数据 Bit 3
14. GPIO18 D2 / 像素数据 Bit 2
15. GPIO5 D1 / 像素数据 Bit 1
16. GPIO4 D0 / 像素数据 Bit 0
17. GPIO0 RESET / 摄像头复位
18. n/a PWDN / 摄像头断电
==== ========== =============================
* D0 到 D7 为摄像头的数据总线
.. _get-started-esp-wrover-kit-v4.1-rgb-led-connections:
@ -273,91 +280,90 @@ No. ESP32 管脚 摄像头信号
RGB LED
^^^^^^^
==== ========== =========
. ESP32 管脚 RGB LED
==== ========== =========
1. GPIO0 红色
2. GPIO2 绿色
3. GPIO4 蓝色
==== ========== =========
=== ============== ==========
No. ESP32 管脚 RGB LED
=== ============== ==========
1 GPIO0 红
2 GPIO2 绿
3 GPIO4 蓝
=== ============== ==========
.. _get-started-esp-wrover-kit-v4.1-microsd-card-slot:
MicroSD 卡 / J4
^^^^^^^^^^^^^^^^^
=== ============== =============
No. ESP32 管脚 MicroSD 信号
=== ============== =============
1 MTDI / GPIO12 DATA2
2 MTCK / GPIO13 CD / DATA3
3 MTDO / GPIO15 CMD
4 MTMS / GPIO14 CLK
5 GPIO2 DATA0
6 GPIO4 DATA1
7 GPIO21 CD
=== ============== =============
MicroSD 卡
^^^^^^^^^^^^
==== ============== ===============
. ESP32 管脚 MicroSD 信号
==== ============== ===============
1. MTDI / GPIO12 DATA2
2. MTCK / GPIO13 CD / DATA3
3. MTDO / GPIO15 CMD
4. MTMS / GPIO14 CLK
5. GPIO2 DATA0
6. GPIO4 DATA1
7. GPIO21 CD
==== ============== ===============
.. _get-started-esp-wrover-kit-v4.1-lcd-connector:
LCD / U5
^^^^^^^^
=== ============== =============
No. ESP32 管脚 LCD 信号
=== ============== =============
1 GPIO18 RESET
2 GPIO19 SCL
3 GPIO21 D/C
4 GPIO22 CS
5 GPIO23 SDA
6 GPIO25 SDO
7 GPIO5 背光
=== ============== =============
==== ============== ===============
. ESP32 管脚 LCD 信号
==== ============== ===============
1. GPIO18 复位
2. GPIO19 SCL
3. GPIO21 D/C
4. GPIO22 CS
5. GPIO23 SDA
6. GPIO25 SDO
7. GPIO5 背光
==== ============== ===============
.. _get-started-esp-wrover-kit-v4.1-start-development:
.. _get-started-esp-wrover-kit-start-development:
应用程序开发
-----------------------------
ESP-WROVER-KIT 上电前，请首先确认电路板完好无损。
ESP-WROVER-KIT 上电前，请首先确认开发板完好无损。
初始设置
^^^^^^^^^^^^^
通过排针 JP7 选择开发板的供电模式：**USB** 端口供电或外部 **5V Input** 供电，请见下表：
请严格按照下图所示连接跳线帽，注意不要额外连接其他跳线帽。
=============== ===============
USB 供电 使能 UART 通信
=============== ===============
|jp7-usb_5v| |jp2-tx-rx|
=============== ===============
- 使用 JP7 连接器，选择 USB 为开发板供电。
在本应用中，USB 供电已经足够。用户可通过 JP2 处的跳线设置，使能 UART 通信。
- 使用 JP2 连接器，使能 UART 通信。
.. 注意::
======================== ==========================
USB 供电 使能 UART 通信
======================== ==========================
|jp7-usb_5v| |jp2-tx-rx|
======================== ==========================
1. 不要安装任何其他跳线。
2. 打开 **电源开关**，**5V LED 指示灯** 也应亮起。
注意不要连接其他跳线帽。
开始开发
打开 **电源开关**，**5V Power On LED** 应点亮。
正式开始开发
^^^^^^^^^^^^^^^^^^
有关 ESP-WROVER-KIT 应用程序开发的具体步骤，请见章节 :doc:`index`：
* :ref:`设置 Toolchain <get-started-setup-toolchain>`，以便用 C 语言开发应用
* :ref:`连接 <get-started-connect>` 模组至 PC，并确认访问状态
* :ref:`构建并向 ESP32 烧录示例 <get-started-build-and-flash>`
* :ref:`即刻监测 <get-started-monitor>` 应用程序的动作
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
相关文档
-----------------
* `ESP-WROVER-KIT V4.1 原理图`_ (PDF)
* `ESP32 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (PDF)
* `ESP32-WROVER-B 技术规格书 <https://espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_cn.pdf>`_ (PDF)
* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (PDF)
* `《ESP32-WROVER-B 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_cn.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index`