Added CN version of 'Getting Started' guides for 'ESP32-DevKitC' and 'ESP-WROVER-KIT'

This commit is contained in:
Krzysztof Budzynski 2018-10-22 09:10:58 +08:00 committed by Angus Gratton
parent 129d32772e
commit 46c2112400
12 changed files with 639 additions and 187 deletions

View file

Before

Width:  |  Height:  |  Size: 40 KiB

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 62 KiB

After

Width:  |  Height:  |  Size: 155 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 81 KiB

After

Width:  |  Height:  |  Size: 213 KiB

View file

@ -29,7 +29,7 @@ Functionality Overview
Block diagram below presents main components of ESP-WROVER-KIT and interconnections between components.
.. figure:: ../../_static/esp32-wrover-kit-block-diagram.png
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT block diagram
:figclass: align-center

View file

@ -29,7 +29,7 @@ Functionality Overview
Block diagram below presents main components of ESP-WROVER-KIT and interconnections between components.
.. figure:: ../../_static/esp32-wrover-kit-block-diagram.png
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT block diagram
:figclass: align-center

View file

@ -1,5 +1,6 @@
ESP32-DevKitC V4 Getting Started Guide
======================================
:link_to_translation:`zh_CN:[中文]`
This user guide shows how to get started with ESP32-DevKitC V4 development board. For description of other versions of the ESP32-DevKitC check :doc:`../hw-reference/index`.
@ -17,7 +18,7 @@ Overview
ESP32-DevKitC V4 is a small-sized ESP32-based development board produced by `Espressif <https://espressif.com>`_. Most of the I/O pins are broken out to the pin headers on both sides for easy interfacing. Developers can connect these pins to peripherals as needed. Standard headers also make development easy and convenient when using a breadboard.
The board supports various ESP32 modules, including :ref:`esp-modules-and-boards-esp32-wroom-32`, :ref:`ESP32-WROOM-32U <esp-modules-and-boards-esp32-wroom-32d-and-u>`, :ref:`ESP32-WROOM-32D <esp-modules-and-boards-esp32-wroom-32d-and-u>` and :ref:`esp-modules-and-boards-esp32-solo-1`.
The board supports various ESP32 modules, including :ref:`esp-modules-and-boards-esp32-wroom-32`, :ref:`ESP32-WROOM-32U <esp-modules-and-boards-esp32-wroom-32d-and-u>`, :ref:`ESP32-WROOM-32D <esp-modules-and-boards-esp32-wroom-32d-and-u>`, :ref:`esp-modules-and-boards-esp32-solo-1`, and :ref:`esp-modules-and-boards-esp32-wrover` series.
Functional Description
@ -26,18 +27,20 @@ Functional Description
The following list and figure below describe key components, interfaces and controls of ESP32-DevKitC V4 board.
ESP32-WROOM-32
:ref:`esp-modules-and-boards-esp32-wroom-32` module soldered to the ESP32-DevKitC V4 board. Optionally ESP32-WROOM-32D, ESP32-WROOM-32U or ESP32-SOLO-1 module may be soldered instead of the ESP32-WROOM-32.
USB-UART Bridge
A single chip USB-UART bridge provides up to 3 Mbps transfers rates.
Boot
:ref:`esp-modules-and-boards-esp32-wroom-32` module soldered to the ESP32-DevKitC V4 board.
Optional Space for ESP32-WROVER
Longer :ref:`esp-modules-and-boards-esp32-wrover` modules may be soldered instead of the ESP32-WROOM-32.
USB-to-UART Bridge
A single chip USB-to-UART bridge provides up to 3 Mbps transfers rates.
Boot Button
Download button: holding down the **Boot** button and pressing the **EN** button initiates the firmware download mode. Then user can download firmware through the serial port.
EN Button
Reset button: pressing this button resets the system.
Micro USB Port
USB interface. It functions as the power supply for the board and the communication interface between PC and the ESP module.
5V Power On LED
This LED lights when the USB or an external 5V power supply is applied to the board. For details see schematic in `Related Documents`_.
EN
Reset button: pressing this button resets the system.
I/O
I/O Connector
Most of the pins on the ESP module are broken out to the pin headers on the board. Users can program ESP32 to enable multiple functions such as PWM, ADC, DAC, I2C, I2S, SPI, etc.
.. note::
@ -105,10 +108,10 @@ Board Dimensions
.. figure:: ../../_static/esp32-devkitc-dimensions-back.jpg
:align: center
:alt: ESP32 DevKitC board dimensions - back
:alt: ESP32-DevKitC board dimensions - back
:figclass: align-center
ESP32 DevKitC board dimensions - back
ESP32-DevKitC board dimensions - back
Related Documents

View file

@ -29,7 +29,7 @@ Functionality Overview
Block diagram below presents main components of ESP-WROVER-KIT and interconnections between components.
.. figure:: ../../_static/esp32-wrover-kit-block-diagram.png
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT block diagram
:figclass: align-center

View file

@ -29,7 +29,7 @@ Functionality Overview
The block diagram below illustrates the ESP-WROVER-KIT's main components and their interconnections.
.. figure:: ../../_static/esp32-wrover-kit-block-diagram.png
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT block diagram
:figclass: align-center

View file

@ -1,5 +1,6 @@
ESP-WROVER-KIT V4.1 Getting Started Guide
=========================================
:link_to_translation:`zh_CN:[中文]`
This user guide shows how to get started with the ESP-WROVER-KIT V4.1 development board including description of its functionality and configuration options. For descriptions of other versions of the ESP-WROVER-KIT check :doc:`../hw-reference/index`.
@ -25,7 +26,7 @@ Functionality Overview
The block diagram below illustrates the ESP-WROVER-KIT's main components and their interconnections.
.. figure:: ../../_static/esp32-wrover-kit-block-diagram.png
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT block diagram
:figclass: align-center
@ -114,21 +115,15 @@ Setup Options
There are three jumper headers available to set up the board functionality. Typical options to select from are listed in table below.
+--------+------------------+--------------------------------------------------+
| Header | Jumper Setting | Description of Functionality |
+--------+------------------+--------------------------------------------------+
| JP7 | |jp7-ext_5v| | Power ESP-WROVER-KIT board from an external |
| | | power supply |
+--------+------------------+--------------------------------------------------+
| JP7 | |jp7-usb_5v| | Power ESP-WROVER-KIT board from an USB port |
+--------+------------------+--------------------------------------------------+
| JP2 | |jp2-jtag| | Enable JTAG functionality |
+--------+------------------+--------------------------------------------------+
| JP2 | |jp2-tx-rx| | Enable UART communication |
+--------+------------------+--------------------------------------------------+
| JP14 | |jp14| | Enable RTS/CTS flow control for serial |
| | | communication |
+--------+------------------+--------------------------------------------------+
======= ================ =========================================================
Header Jumper Setting Description of Functionality
======= ================ =========================================================
JP7 |jp7-ext_5v| Power ESP-WROVER-KIT board from an external power supply
JP7 |jp7-usb_5v| Power ESP-WROVER-KIT board from an USB port
JP2 |jp2-jtag| Enable JTAG functionality
JP2 |jp2-tx-rx| Enable UART communication
JP14 |jp14| Enable RTS/CTS flow control for serial communication
======= ================ =========================================================
Allocation of ESP32 Pins
@ -142,37 +137,24 @@ Main I/O Connector / JP1
The JP1 connector is shown in two columns in the middle under "I/O" headers. The two columns "Shared With" outside, describe where else on the board certain GPIO is used.
+----------------------+------+------+----------------------+
| Shared With | I/O | I/O | Shared With |
+======================+======+======+======================+
| | 3.3V | 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 | 5V | |
+----------------------+------+------+----------------------+
===================== ===== ===== =====================
Shared With I/O I/O Shared With
===================== ===== ===== =====================
3.3V 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 5V
===================== ===== ===== =====================
Legend:
@ -191,13 +173,12 @@ Legend:
32.768 kHz Oscillator
^^^^^^^^^^^^^^^^^^^^^
+---+-----------+
| | ESP32 Pin |
+===+===========+
| 1 | GPIO32 |
+---+-----------+
| 2 | GPIO33 |
+---+-----------+
==== ==========
. ESP32 Pin
==== ==========
1 GPIO32
2 GPIO33
==== ==========
.. note::
@ -209,21 +190,16 @@ Legend:
SPI Flash / JP2
^^^^^^^^^^^^^^^
+---+--------------+
| | ESP32 Pin |
+===+==============+
| 1 | CLK / GPIO6 |
+---+--------------+
| 2 | SD0 / GPIO7 |
+---+--------------+
| 3 | SD1 / GPIO8 |
+---+--------------+
| 4 | SD2 / GPIO9 |
+---+--------------+
| 5 | SD3 / GPIO10 |
+---+--------------+
| 6 | CMD / GPIO11 |
+---+--------------+
==== =============
. ESP32 Pin
==== =============
1 CLK / GPIO6
2 SD0 / GPIO7
3 SD1 / GPIO8
4 SD2 / GPIO9
5 SD3 / GPIO10
6 CMD / GPIO11
==== =============
.. important::
@ -235,19 +211,15 @@ SPI Flash / JP2
JTAG / JP2
^^^^^^^^^^
+---+---------------+-------------+
| | ESP32 Pin | JTAG Signal |
+===+===============+=============+
| 1 | EN | TRST_N |
+---+---------------+-------------+
| 2 | MTMS / GPIO14 | TMS |
+---+---------------+-------------+
| 3 | MTDO / GPIO15 | TDO |
+---+---------------+-------------+
| 4 | MTDI / GPIO12 | TDI |
+---+---------------+-------------+
| 5 | MTCK / GPIO13 | TCK |
+---+---------------+-------------+
==== ============== =============
. ESP32 Pin JTAG Signal
==== ============== =============
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:
@ -255,45 +227,28 @@ JTAG / JP2
Camera / JP4
^^^^^^^^^^^^
+----+--------------+------------------------------+
| | ESP32 Pin | Camera Signal |
+====+==============+==============================+
| 1 | n/a | 3.3V |
+----+--------------+------------------------------+
| 2 | n/a | Ground |
+----+--------------+------------------------------+
| 3 | GPIO27 | SIO_C / SCCB Clock |
+----+--------------+------------------------------+
| 4 | GPIO26 | SIO_D / SCCB Data |
+----+--------------+------------------------------+
| 5 | GPIO25 | VSYNC / Vertical Sync |
+----+--------------+------------------------------+
| 6 | GPIO23 | HREF / Horizontal Reference |
+----+--------------+------------------------------+
| 7 | GPIO22 | PCLK / Pixel Clock |
+----+--------------+------------------------------+
| 8 | GPIO21 | XCLK / System Clock |
+----+--------------+------------------------------+
| 9 | GPIO35 | D7 / Pixel Data Bit 7 |
+----+--------------+------------------------------+
| 10 | GPIO34 | D6 / Pixel Data Bit 6 |
+----+--------------+------------------------------+
| 11 | GPIO39 | D5 / Pixel Data Bit 5 |
+----+--------------+------------------------------+
| 12 | GPIO36 | D4 / Pixel Data Bit 4 |
+----+--------------+------------------------------+
| 13 | GPIO19 | D3 / Pixel Data Bit 3 |
+----+--------------+------------------------------+
| 14 | GPIO18 | D2 / Pixel Data Bit 2 |
+----+--------------+------------------------------+
| 15 | GPIO5 | D1 / Pixel Data Bit 1 |
+----+--------------+------------------------------+
| 16 | GPIO4 | D0 / Pixel Data Bit 0 |
+----+--------------+------------------------------+
| 17 | GPIO0 | RESET / Camera Reset |
+----+--------------+------------------------------+
| 18 | n/a | PWDN / Camera Power Down |
+----+--------------+------------------------------+
==== ========== =============================
. ESP32 Pin Camera Signal
==== ========== =============================
1 n/a 3.3V
2 n/a Ground
3 GPIO27 SIO_C / SCCB Clock
4 GPIO26 SIO_D / SCCB Data
5 GPIO25 VSYNC / Vertical Sync
6 GPIO23 HREF / Horizontal Reference
7 GPIO22 PCLK / Pixel Clock
8 GPIO21 XCLK / System Clock
9 GPIO35 D7 / Pixel Data Bit 7
10 GPIO34 D6 / Pixel Data Bit 6
11 GPIO39 D5 / Pixel Data Bit 5
12 GPIO36 D4 / Pixel Data Bit 4
13 GPIO19 D3 / Pixel Data Bit 3
14 GPIO18 D2 / Pixel Data Bit 2
15 GPIO5 D1 / Pixel Data Bit 1
16 GPIO4 D0 / Pixel Data Bit 0
17 GPIO0 RESET / Camera Reset
18 n/a PWDN / Camera Power Down
==== ========== =============================
* Signals D0 .. D7 denote camera data bus
@ -303,15 +258,13 @@ Camera / JP4
RGB LED
^^^^^^^
+---+-----------+---------+
| | ESP32 Pin | RGB LED |
+===+===========+=========+
| 1 | GPIO0 | Red |
+---+-----------+---------+
| 2 | GPIO2 | Green |
+---+-----------+---------+
| 3 | GPIO4 | Blue |
+---+-----------+---------+
==== ========== =========
. ESP32 Pin RGB LED
==== ========== =========
1 GPIO0 Red
2 GPIO2 Green
3 GPIO4 Blue
==== ========== =========
.. _get-started-esp-wrover-kit-v4.1-microsd-card-slot:
@ -319,23 +272,17 @@ RGB LED
MicroSD Card / J4
^^^^^^^^^^^^^^^^^
+---+---------------+----------------+
| | ESP32 Pin | MicroSD Signal |
+===+===============+================+
| 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 |
+---+---------------+----------------+
==== ============== ===============
. ESP32 Pin MicroSD Signal
==== ============== ===============
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:
@ -343,23 +290,17 @@ MicroSD Card / J4
LCD / U5
^^^^^^^^
+---+-----------+------------+
| | ESP32 Pin | LCD Signal |
+===+===========+============+
| 1 | GPIO18 | RESET |
+---+-----------+------------+
| 2 | GPIO19 | SCL |
+---+-----------+------------+
| 3 | GPIO21 | D/C |
+---+-----------+------------+
| 4 | GPIO22 | CS |
+---+-----------+------------+
| 5 | GPIO23 | SDA |
+---+-----------+------------+
| 6 | GPIO25 | SDO |
+---+-----------+------------+
| 7 | GPIO5 | Backlight |
+---+-----------+------------+
==== ============== ===============
. ESP32 Pin LCD Signal
==== ============== ===============
1 GPIO18 RESET
2 GPIO19 SCL
3 GPIO21 D/C
4 GPIO22 CS
5 GPIO23 SDA
6 GPIO25 SDO
7 GPIO5 Backlight
==== ============== ===============
.. _get-started-esp-wrover-kit-start-development:
@ -375,12 +316,11 @@ Initial Setup
Select the source of power supply for the board by setting jumper JP7. The options are either **USB** port or an external **5V Input**. For this application, the selection of the USB port is sufficient. Enable UART communication by installing jumpers on JP2. Both selections are shown in table below.
+----------------------+----------------------+
| Power up | Enable UART |
| from USB port | communication |
+----------------------+----------------------+
| |jp7-usb_5v| | |jp2-tx-rx| |
+----------------------+----------------------+
======================== ==========================
Power up from USB port Enable UART communication
======================== ==========================
|jp7-usb_5v| |jp2-tx-rx|
======================== ==========================
Do not install any other jumpers.

View file

@ -119,7 +119,10 @@ ESP32-WROVER
A step upgrade of ESP32-WROOM-32x modules with an additional 8MB SPI PSRAM (Pseudo static RAM).
The module comes in couple of versions listed in section :ref:`esp-wroom-solo-wrover-modules`. ESP32-WROVER and ESP32-WROVER-I have PSRAM that operates at 1.8V and can support up to 144 MHz clock rate. ESP32-WROVER-B and ESP32-WROVER-IB have PSRAM that operates at 3.3V and can support up to 133 MHz clock rate.
The module comes in couple of versions listed in section :ref:`esp-wroom-solo-wrover-modules`:
* **ESP32-WROVER** and **ESP32-WROVER-I** have PSRAM that operates at 1.8V and can support up to 144 MHz clock rate.
* **ESP32-WROVER-B** and **ESP32-WROVER-IB** have PSRAM that operates at 3.3V and can support up to 133 MHz clock rate.
By default the module has 4MB flash and may be also ordered with custom flash size of 8 or 16MB, see `Espressif Products Ordering Information`_.

View file

@ -1 +1,132 @@
.. include:: ../../en/get-started/get-started-devkitc.rst
ESP32-DevKitC V4 入门指南
======================================
:link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP32-DevKitC V4 开发板。有关 ESP32-DevKitC 其他版本的介绍,请见:`../hw-reference/index`
准备工作
-------------
* 1 × :ref:`ESP32-DevKitC V4 开发板 <get-started-esp32-devkitc-board-front>`
* 1 × USB A / micro USB B 电缆
* 1 × PCWindows、Linux 或 Mac OS
简介
--------
ESP32-DevKitC V4 是一款来自 `乐鑫 <https://espressif.com>`_ 的迷你开发板,板上模组的绝大部分管脚均已引出,可根据用户需求,轻松连接多种外围器件。此外,本开发板还采用了标准排针,可便利面包板的使用。
本开发板可支持多款 ESP32 模组,包括 :ref:`esp-modules-and-boards-esp32-wroom-32`:ref:`ESP32-WROOM-32U <esp-modules-and-boards-esp32-wroom-32d-and-u>`:ref:`ESP32-WROOM-32D <esp-modules-and-boards-esp32-wroom-32d-and-u>`:ref:`esp-modules-and-boards-esp32-solo-1`:ref:`esp-modules-and-boards-esp32-wrover` 系列。
功能说明
----------------------
ESP32-DevKitC V4 开发板的主要组件、接口及控制方式如下文所示。
ESP32-WROOM-32
ESP32-DevKitC V4 开发板上焊接的标准 :ref:`esp-modules-and-boards-esp32-wroom-32` 模组。
额外空间
本开发板的还预留了部分额外空间,用于焊接其他 ESP32-WROOM-32 之外的较长模组,比如 :ref:`esp-modules-and-boards-esp32-wrover` 模组。
USB-UART 桥接器
单芯片 USB-UART 桥接器,可提供高达 3 Mbps 的传输速率。
Boot 按键
按下 **Boot** 键并保持,同时按一下 **EN** 键(此时不要松开 **Boot** 键)进入固件下载模式,通过串口下载固件。
EN 按键
复位键,可重置系统。
Micro USB 端口
USB 接口,可用作电路板的供电电源,或连接 PC 端的通信接口。
5V LED 电源指示灯
更多信息,请见 `相关文档`_ 中的原理图。
I/O 连接器
ESP32-DevKitC V4 迷你开发板,板上模组的绝大部分管脚均已引出。用户可以对 ESP32 进行编程,实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。
.. note::
引脚 CLK、D0、D1、D2、D3 和 CMD (GPIO6 - GPIO11) 用于 ESP32-WROOM-32、ESP32-WROOM-32D/U 和 ESP32-SOLO-1 模组的内部 SPI 通信,集中分布在 USB 接口一侧。通常而言,这些引脚最好不连,否则可能影响 SPI flash 内存 / SPI RAM 的工作。
.. _get-started-esp32-devkitc-board-front:
.. figure:: ../../_static/esp32-devkitc-functional-overview.jpg
:align: center
:alt: ESP32-DevKitC V4 with ESP32-WROOM-32 module soldered
:figclass: align-center
图为 ESP32-DevKitC V4贴 ESP32-WROOM-32
电源选项
--------------------
ESP32-DevKitC V4 支持以下几种供电模式:
1. Micro USB 接口供电(默认)
2. 5V / GND 管脚供电
3. 3V3 / GND 管脚供电
.. warning::
上述供电模式不可同时连接,否则可能会损坏电路板和/或电源。
C15 相关说明
--------------
较早版本 ESP32-DevKitC 上的 C15 可能带来两个问题:
1. 开发板上电后可能进入下载模式;
2. 如果用户通过 GPIO0 输出时钟C15 可能会影响时钟输出。
用户如果认为 C15 可能影响开发板的使用,则可以将 C15 完全移除C15 在开发板上的具体位置见下图黄色部分)。否则,则无需处理 C15。
.. figure:: ../../_static/esp32-devkitc-c15-location.png
:align: center
:alt: Location of C15 (colored yellow) on ESP32-DevKitC V4 board
:figclass: align-center
:width: 30%
C15黄色部分在 ESP32-DevKitC V4 开发板上的具体位置
应用程序开发
------------------------------
ESP32-DevKitC 上电前,请首先确认电路板完好无损。
有关应用程序开发的具体步骤,请见章节 :doc:`index`
* :ref:`设置 Toolchain <get-started-setup-toolchain>`,以便用 C 语言开发应用
* :ref:`连接 <get-started-connect>` 模组至 PC并确认访问状态
* :ref:`构建并向 ESP32 烧录示例 <get-started-build-flash>`
* :ref:`即刻监测 <get-started-build-monitor>` 应用程序的动作
开发板尺寸
----------------
.. figure:: ../../_static/esp32-devkitc-dimensions-back.jpg
:align: center
:alt: ESP32-DevKitC board dimensions - back
:figclass: align-center
ESP32-DevKitC 开发板尺寸 - 背面
相关文档
-----------------
* `ESP32-DevKitC V4 原理图 <https://dl.espressif.com/dl/schematics/esp32_devkitc_v4-sch-20180607a.pdf>`_ (PDF)
* `ESP32 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (PDF)
* `ESP32-WROOM-32 技术规格书 <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_cn.pdf>`_ (PDF)
* `ESP32-WROOM-32D/U 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32d_esp32-wroom-32u_datasheet_cn.pdf>`_ (PDF)
.. toctree::
:hidden:
get-started-devkitc-v2

View file

@ -1 +1,376 @@
.. include:: ../../en/get-started/get-started-wrover-kit.rst
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-start-development>`
准备工作
-------------
* 1 × :ref:`ESP-WROVER-KIT V4.1 开发板 <get-started-esp-wrover-kit-v4.1-board-front>`
* 1 × USB A / micro USB B 电缆
* 1 × PCWindows、Linux 或 Mac OS
简介
--------
ESP-WROVER-KIT 是一款来自 `乐鑫 <https://espressif.com>`_ 的开发板,板上模组的绝大部分管脚均已引出,可根据用户需求,轻松连接多种外围器件。本开发板搭配一块 LCD 显示器,支持 MicroSD 卡槽拓展,还搭载一款先进多协议 USB 桥接器 (FTDI FT2232HL),允许开发者直接通过 USB 接口,使用 JTAG 对 ESP32 进行调试,便利用户的二次开发。
ESP-WROVER-KIT V4.1 开发板可兼容 ESP32-WROOM-32、ESP32-WROVER 和 ESP32-WROVER-B 模组,默认贴 ESP32-WROVER-B 模组。
功能框图
-------------------
ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png
:align: center
:alt: ESP-WROVER-KIT block diagram
: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-setup-options>` 中的介绍,连接跳线帽。
USB 端口
USB 端口,可用作电路板的供电电源或连接 PC 端的通信接口。
EN 按键
复位键,可重置系统。
Boot 按键
下载按键。按下 **Boot** 键并保持,同时按一下 **EN** 键(此时不要松开 **Boot** 键)进入固件下载模式,通过串口下载固件。
电源开关
拨置右侧,开发板上电;拨置左侧,开发板掉电。
电源选择开关
ESP-WROVER-KIT 开发板可通过 USB 端口或 5V 输入端口供电。用户可使用跳线帽在两种供电模式中进行选择。更多详细信息,请见章节 :ref:`设置选项 <get-started-esp-wrover-kit-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`
.. _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
:figclass: align-center
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
:figclass: align-center
ESP-WROVER-KIT 开发板 - 背面
.. _get-started-esp-wrover-kit-setup-options:
设置选项
-------------
用户可通过 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 可用于其他用途。
主要 I/O 连接器 / JP1
^^^^^^^^^^^^^^^^^^^^^^^^
JP1 连接器可见下表中部的 “I/O” 列GPIO 共用描述可见下表两侧的 “共用” 列:
===================== ====== ====== =====================
共用 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 --
===================== ====== ====== =====================
说明:
* NC/XTAL - :ref:`32.768 kHz Oscillator <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>`
* 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的情况
.. _get-started-esp-wrover-kit-v4.1-xtal:
32.768 kHz 晶振
^^^^^^^^^^^^^^^^^^^^^
=== ============
No. ESP32 管脚
=== ============
1 GPIO32
2 GPIO33
=== ============
.. note::
管脚 GPIO32 和 GPIO33 已连接至晶振,为了保证信号的完整性,并未连接至 JP1 I/O 扩展连接器。用户可通过移除 R11/R23 位置处的 0 欧电阻,并将这些 0 欧电阻安装至 R12/R24 位置,从而从晶振换至 JP1 I/O 扩展连接器。
.. _get-started-esp-wrover-kit-v4.1-spi-flash-header:
SPI Flash / JP2
^^^^^^^^^^^^^^^
=== =============
No. ESP32 管脚
=== =============
1 CLK / GPIO6
2 SD0 / GPIO7
3 SD1 / GPIO
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:
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
=== ============== ==========
.. _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 为摄像头数据总线
.. _get-started-esp-wrover-kit-v4.1-rgb-led-connections:
RGB LED
^^^^^^^
=== ============== ==========
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
=== ============== =============
.. _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 背光
=== ============== =============
.. _get-started-esp-wrover-kit-start-development:
应用程序开发
-----------------------------
ESP-WROVER-KIT 上电前,请首先确认电路板完好无损。
初始设置
^^^^^^^^^^^^^
通过排针 JP7 选择开发板的供电模式:**USB** 端口供电或外部 **5V Input** 供电,请见下表:
=============== ===============
USB 供电 使能 UART 通信
=============== ===============
|jp7-usb_5v| |jp2-tx-rx|
=============== ===============
在本应用中USB 供电已经足够。用户可通过 JP2 处的跳线设置,使能 UART 通信。
.. 注意::
1. 不要安装任何其他跳线。
2. 打开 **电源开关****5V LED 指示灯** 也应亮起。
开始开发
^^^^^^^^^^^^^^^^^^
有关 ESP-WROVER-KIT 应用程序开发的具体步骤,请见章节 :doc:`index`
* :ref:`设置 Toolchain <get-started-setup-toolchain>`,以便用 C 语言开发应用
* :ref:`连接 <get-started-connect>` 模组至 PC并确认访问状态
* :ref:`构建并向 ESP32 烧录示例 <get-started-build-flash>`
* :ref:`即刻监测 <get-started-build-monitor>` 应用程序的动作
相关文档
-----------------
* `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