1ESP-WROVER-KIT V3 入门指南
2=======================================
3:link_to_translation:`en:[English]`
4
5本指南介绍了如何开始使用 ESP-WROVER-KIT V3 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../../hw-reference/index`。
6
7
8准备工作
9-------------
10
11* :ref:`ESP-WROVER-KIT V3 开发板 <get-started-esp-wrover-kit-v3-board-front>`
12* USB 数据线（A 转 Micro-B）
13* PC（Windows、Linux 或 macOS）
14
15您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
16
17
18概述
19--------
20
21ESP-WROVER-KIT 是 `乐鑫 <https://espressif.com>`_ 一款基于 ESP32 的开发板，集成了 LCD 屏幕和 MicroSD 卡槽。
22
23ESP-WROVER-KIT 可选贴以下 ESP32 模组：
24
25- ESP32-WROOM-32
26- ESP32-WROVER 系列模组
27
28此外，ESP-WROVER-KIT 的独特之处在于集成了一款先进多协议 USB 桥接器 (FTDI FT2232HL)，允许开发人员直接通过 USB 接口，使用 JTAG 对 ESP32 进行调试，无需额外的 JTAG 调试器。ESP-WROVER-KIT 可为开发人员提供简单、便捷且极具成本效益的开发体验。
29
30为了便于使用，板上模组的绝大部分管脚均已引出至开发板的引脚。
31
32.. note::
33
34    该版本 ESP32-WROVER 模组 的 GPIO16 和 GPIO17 管脚用作 PSRAM 的片选和时钟信号。默认情况下，为了给用户提供可靠的性能，这两个 GPIO 管脚不引出至开发板引脚。
35
36
37功能概述
38----------------------
39
40ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。
41
42.. figure:: ../../../_static/esp-wrover-kit-block-diagram.png
43    :align: center
44    :alt: ESP-WROVER-KIT 功能框图
45    :figclass: align-center
46
47    ESP-WROVER-KIT 功能框图
48
49
50功能说明
51----------------------
52
53ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
54
55.. _get-started-esp-wrover-kit-v3-board-front:
56
57.. figure:: ../../../_static/esp-wrover-kit-v3-layout-front.jpg
58    :align: center
59    :alt: ESP-WROVER-KIT 开发板布局 -- 俯视图
60    :figclass: align-center
61
62    ESP-WROVER-KIT 开发板布局 -- 俯视图
63
64.. _get-started-esp-wrover-kit-v3-board-back:
65
66.. figure:: ../../../_static/esp-wrover-kit-v3-layout-back.jpg
67    :align: center
68    :alt: ESP-WROVER-KIT 开发板布局 -- 仰视图
69    :figclass: align-center
70
71    ESP-WROVER-KIT 开发板布局 -- 仰视图
72
73
74下表从图片右上角开始，以顺时针顺序介绍了图 1 中的主要组件，然后以同样的顺序介绍图 2 中的主要组件。
75
76.. list-table::
77    :widths: 25 75
78    :header-rows: 1
79
80    * - 主要组件
81      - 基本介绍
82    * - 32.768 kHz
83      - 外接 32.768 kHz 晶振，可提供 Deep-sleep 下使用的低功耗时钟。
84    * - 0 欧电阻
85      - ESP-WROVER-KIT 开发板设计了一个 0 欧电阻，可在测量 ESP32 系列模组在不同功耗模式下的电流时，直接移除或替换为分流器。
86    * - ESP32 模组
87      - 可选贴 ESP32-WROOM-32 或 ESP32-WROVER。ESP32-WROVER 模组完整集成了 ESP32-WROOM-32 的所有功能，且内置 32-Mbit PSRAM，可提供灵活的额外存储空间和数据处理能力。
88    * - FT2232
89      - FT2232 多协议 USB 转串口桥接器。开发人员可通过 USB 接口对 FT2232 芯片进行控制和编程，与 ESP32 建立连接。FT2232 芯片可在通道 A 提供 USB-to-JTAG 接口功能，并在通道 B 提供 USB-to-Serial 接口功能，便利开发人员的应用开发与调试。见 `ESP-WROVER-KIT V3 原理图`_。
90    * - UART
91      - 串口。FT2232HL 和 ESP32 的串行 TX/RX 信号已引出至 JP11 的两端。默认情况下，这两路信号由跳线帽连接。如果要跳过 FT2232 使用 ESP32 模组串口，则可移除相关跳线帽，将模组连接至其他外部串口设备。
92    * - SPI
93      - 默认情况下，ESP32 使用 SPI 接口访问内置 flash 和 PSRAM。使用这些引脚连接 ESP32 和其他 SPI 设备。这种情况下，需增加额外的片选 (CS) 信号。注意，选贴 ESP32-WROVER 模组时，该接口的工作电压为 1.8 V；选贴 ESP32-WROOM-32 时，该接口的工作电压为 3.3V。
94    * - CTS/RTS
95      - 串口流控信号。管脚默认不连接至电路。为了使能该功能，必须用跳线帽短路掉 JP14 的相应管脚。
96    * - JTAG
97      - JTAG 接口。FT2232HL 和 ESP32 的 JTAG 信号已引出至 JP8 的两端。默认情况下，这两路信号不连接。如需使能 JTAG，请按照 `设置选项`_ 的介绍，连接跳线帽。
98    * - EN
99      - 复位按键。
100    * - Boot
101      - 下载按键。按下 **Boot** 键并保持，同时按一下 **EN** 键（此时不要松开 **Boot** 键）进入“固件下载”模式，通过串口下载固件。
102    * - USB
103      - USB 接口。可用作开发板的供电电源，或连接 PC 和开发板的通信接口。
104    * - 电源开关
105      - 拨向 **USB** 按键一侧，开发板上电；拨离 **USB** 按键一侧，开发板掉电。
106    * - 电源选择开关
107      - ESP-WROVER-KIT 开发板可通过 USB 端口或 5V 输入接口供电。用户可使用跳线帽在两种供电模式中进行选择。更多详细信息，请见章节 `设置选项`_ 中有关 JP7 连接器的描述。
108    * - 5V Input
109      - 5V 电源接口建议仅在开发板自动运行（未连接 PC）时使用。仅用于全负荷工作下的后备电源。
110    * - LDO
111      - 5V-to-3.3V 低压差线型稳压器 NCP1117(1A)。NCP1117 最大电流输出为 1 A。板上 LDO 为固定输出电压，但用户也可以选用具有可变输出电压的 LDO。更多信息，请见 `ESP-WROVER-KIT V3 原理图`_。
112    * - 摄像头
113      - 摄像头接口，支持标准 OV7670 摄像头模块。
114    * - RGB LED
115      - 红绿蓝发光二极管，可由 PWM（脉冲宽度调制）控制。
116    * - I/O
117      - 板上模组的所有管脚均已引出至开发板的排针。用户可以对 ESP32 进行编程，实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。
118    * - MicroSD 卡槽
119      - 适用于需要扩充数据存储空间或进行备份的应用开发场景。
120    * - LCD 显示屏
121      - 支持贴装一款 3.2” 的 SPI（标准四线串行外设接口）LCD 显示器，请见 :ref:`get-started-esp-wrover-kit-v3-board-back`。
122
123.. _get-started-esp-wrover-kit-v3-setup-options:
124
125设置选项
126-------------
127
128用户可通过 5 组排针，设置开发板功能，其中常见功能见下表：
129
130=======  ================  =========================================================================
131排针      跳线设置           功能描述
132=======  ================  =========================================================================
133JP7      |jp7-ext_5v|      使用外部电源为 ESP-WROVER-KIT 开发板供电
134JP7      |jp7-usb_5v|      使用 USB 端口为 ESP-WROVER-KIT 开发板供电
135JP8      |jp8|             使能 JTAG 功能
136JP11     |jp11-tx-rx|      使能 UART 通信
137JP14     |jp14|            使能 RTS/CTS 串口流控
138=======  ================  =========================================================================
139
140
141ESP32 管脚分配
142------------------------
143
144ESP32 模组的部分管脚/终端已被板上组件占用或用于外部硬件设备。如果某管脚对应的特定硬件未连接，则该管脚可用作他用。比如，摄像头/JP4 排针未连接相应硬件，则这些 GPIO 可用于其他用途。
145
146部分管脚具备多个功能，可供板上组件或外部硬件设备同时使用，比如 GPIO0 和 GPIO2。由于管脚限制，一些外围设备不可同时使用，比如，由于 JTAG 和 SD 卡槽需共用部分管脚，因此一些使用 SD 卡功能的应用无法同时进行 JTAG 调试。
147
148其他情况下，不同外设可同时使用。比如，LCD 屏幕和 SD 卡仅共用一个 GPIO21 管脚，可以同时使用。该管脚可为 LCD 屏幕提供 D/C（数据/控制）信号，并用于读取来自 SD 卡槽的 CD 信号（卡检测信号）。如无需使用卡检测功能，开发人员还可以通过移除 R167 来禁用该功能。此时，LCD 和 SD 卡槽可同时使用。
149
150更多外设共享管脚的介绍，请见下一章节中的表格。
151
152
153主要 I/O 连接器 / JP1
154^^^^^^^^^^^^^^^^^^^^^^^^
155
156JP1 连接器包括 14 x 2 个排针，具体功能可见下表中间 “I/O” 列的介绍。两侧的“共用”列则介绍了这些管脚在板上的其他用途。
157
158=====================  =====  =====  =====================
159共用                    I/O    I/O    共用
160=====================  =====  =====  =====================
161n/a                    3.3V   GND    n/a
162NC/XTAL                IO32   IO33   NC/XTAL
163JTAG, MicroSD          IO12   IO13   JTAG, MicroSD
164JTAG, MicroSD          IO14   IO27   摄像头
165摄像头                  IO26   IO25   摄像头，LCD
166摄像头                  IO35   IO34   摄像头
167摄像头                  IO39   IO36   摄像头
168JTAG                   EN     IO23   摄像头，LCD
169摄像头，LCD             IO22   IO21   摄像头，LCD，MicroSD
170摄像头，LCD             IO19   IO18   摄像头，LCD
171摄像头，LCD             IO5    IO17   PSRAM
172PSRAM                  IO16   IO4    LED，摄像头，MicroSD
173摄像头，LED，Boot       IO0    IO2    LED，MicroSD
174JTAG，MicroSD          IO15   5V
175=====================  =====  =====  =====================
176
177说明：
178
179* NC/XTAL - :ref:`32.768 kHz Oscillator <get-started-esp-wrover-kit-v3-xtal>`
180* JTAG - :ref:`JTAG / JP8 <get-started-esp-wrover-kit-v3-jtag-header>`
181* Boot - Boot 按键 / SW2
182* 摄像头 - :ref:`摄像头 / JP4 <get-started-esp-wrover-kit-v3-camera-header>`
183* LED - :ref:`RGB LED <get-started-esp-wrover-kit-v3-rgb-led-connections>`
184* MicroSD - :ref:`MicroSD Card / J4 <get-started-esp-wrover-kit-v3-microsd-card-slot>`
185* LCD - :ref:`LCD / U5 <get-started-esp-wrover-kit-v3-lcd-connector>`
186* PSRAM - 仅适用于选贴 ESP32-WROVER 的情况。
187
188
189.. _get-started-esp-wrover-kit-v3-xtal:
190
19132.768 kHz 晶振
192^^^^^^^^^^^^^^^^^^^^^
193
194====  ==========
195.     ESP32 管脚
196====  ==========
1971.    GPIO32
1982.    GPIO33
199====  ==========
200
201.. note::
202
203    默认情况下，管脚 GPIO32 和 GPIO33 已连接至晶振。因此，为了保证信号的完整性，这两个管脚并未连接至 JP1 I/O 连接器。用户可通过将 R11/R23 处的 0 欧电阻移至 R12/R24 处，以将 GP1O32 和 GPIO33 的连接从晶振移至 JP1。
204
205
206.. _get-started-esp-wrover-kit-v3-spi-flash-header:
207
208SPI Flash / JP13
209^^^^^^^^^^^^^^^^
210
211====  =============
212.     ESP32 管脚
213====  =============
2141.    CLK / GPIO6
2152.    SD0 / GPIO7
2163.    SD1 / GPIO8
2174.    SD2 / GPIO9
2185.    SD3 / GPIO10
2196.    CMD / GPIO11
220====  =============
221
222.. important::
223
224    模组的 flash 总线已通过 0 欧电阻 R140 ~ R145 连接至排针 JP13。如果需要将 flash 的工作频率控制在 80 MHz，为了达到保证总线信号完整性等目的，建议移除 R140 ~ R145 电阻，将模组的 flash 总线与排针 JP2 断开。
225
226
227
228.. _get-started-esp-wrover-kit-v3-jtag-header:
229
230JTAG / JP8
231^^^^^^^^^^
232
233====  ==============  =============
234.     ESP32 管脚       JTAG 信号
235====  ==============  =============
2361.    EN              TRST_N
2372.    MTMS / GPIO14   TMS
2383.    MTDO / GPIO15   TDO
2394.    MTDI / GPIO12   TDI
2405.    MTCK / GPIO13   TCK
241====  ==============  =============
242
243
244.. _get-started-esp-wrover-kit-v3-camera-header:
245
246摄像头 / JP4
247^^^^^^^^^^^^
248
249====  ==========  =============================
250.     ESP32 管脚   摄像头信号
251====  ==========  =============================
2521.    n/a         3.3V
2532.    n/a         地
2543.    GPIO27      SIO_C / SCCB 时钟
2554.    GPIO26      SIO_D / SCCB 数据
2565.    GPIO25      VSYNC / 垂直同步
2576.    GPIO23      HREF / 水平参考
2587.    GPIO22      PCLK / 像素时钟
2598.    GPIO21      XCLK / 系统时钟
2609.    GPIO35      D7 / 像素数据 Bit 7
26110.   GPIO34      D6 / 像素数据 Bit 6
26211.   GPIO39      D5 / 像素数据 Bit 5
26312.   GPIO36      D4 / 像素数据 Bit 4
26413.   GPIO19      D3 / 像素数据 Bit 3
26514.   GPIO18      D2 / 像素数据 Bit 2
26615.   GPIO5       D1 / 像素数据 Bit 1
26716.   GPIO4       D0 / 像素数据 Bit 0
26817.   GPIO0       RESET / 摄像头复位
26918.   n/a         PWDN / 摄像头断电
270====  ==========  =============================
271
272* D0 到 D7 为摄像头的数据总线
273
274
275.. _get-started-esp-wrover-kit-v3-rgb-led-connections:
276
277RGB LED
278^^^^^^^
279
280====  ==========  =========
281.     ESP32 管脚   RGB LED
282====  ==========  =========
2831.    GPIO0       红色
2842.    GPIO2       绿色
2853.    GPIO4       蓝色
286====  ==========  =========
287
288
289.. _get-started-esp-wrover-kit-v3-microsd-card-slot:
290
291MicroSD 卡
292^^^^^^^^^^^^
293
294====  ==============  ===============
295.     ESP32 管脚       MicroSD 信号
296====  ==============  ===============
2971.    MTDI / GPIO12   DATA2
2982.    MTCK / GPIO13   CD / DATA3
2993.    MTDO / GPIO15   CMD
3004.    MTMS / GPIO14   CLK
3015.    GPIO2           DATA0
3026.    GPIO4           DATA1
3037.    GPIO21          CD
304====  ==============  ===============
305
306
307.. _get-started-esp-wrover-kit-v3-lcd-connector:
308
309LCD / U5
310^^^^^^^^
311
312====  ==============  ===============
313.     ESP32 管脚       LCD 信号
314====  ==============  ===============
3151.    GPIO18          复位
3162.    GPIO19          SCL
3173.    GPIO21          D/C
3184.    GPIO22          CS
3195.    GPIO23          SDA
3206.    GPIO25          SDO
3217.    GPIO5           背光
322====  ==============  ===============
323
324
325.. _get-started-esp-wrover-kit-v3-start-development:
326
327应用程序开发
328-----------------------------
329
330ESP-WROVER-KIT 上电前，请首先确认开发板完好无损。
331
332
333初始设置
334^^^^^^^^^^^^^
335
336请严格按照下图所示连接跳线帽，注意不要额外连接其他跳线帽。
337
338- 使用 JP7 连接器，选择 USB 为开发板供电。
339
340- 使用 JP11 连接器，使能 UART 通信。
341
342========================  ==========================
343USB 供电                   使能 UART 通信
344========================  ==========================
345|jp7-usb_5v|              |jp11-tx-rx|
346========================  ==========================
347
348注意不要连接其他跳线帽。
349
350打开 **电源开关**，**5V Power On LED** 应点亮。
351
352正式开始开发
353^^^^^^^^^^^^^^^^^^
354
355现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
356
357相关文档
358-----------------
359
360* `ESP-WROVER-KIT V3 原理图`_ (PDF)
361* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (PDF)
362* `《ESP32-WROVER 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_wrover_datasheet_cn.pdf>`_ (PDF)
363* `《ESP32-WROOM-32 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_cn.pdf>`_ (PDF)
364* :doc:`../../api-guides/jtag-debugging/index`
365* :doc:`../../hw-reference/index`
366
367.. |jp7-ext_5v| image:: ../../../_static/esp-wrover-kit-v3-jp7-ext_5v.png
368.. |jp7-usb_5v| image:: ../../../_static/esp-wrover-kit-v3-jp7-usb_5v.png
369.. |jp8| image:: ../../../_static/esp-wrover-kit-v3-jp8.png
370.. |jp11-tx-rx| image:: ../../../_static/esp-wrover-kit-v3-jp11-tx-rx.png
371.. |jp14| image:: ../../../_static/esp-wrover-kit-v3-jp14.png
372
373.. _ESP-WROVER-KIT V3 原理图: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-3.pdf
374
375.. toctree::
376    :hidden:
377
378    get-started-wrover-kit-v2.rst
379