]> granicus.if.org Git - esp-idf/commitdiff
Added CN version of 'Getting Started' guides for 'ESP32-DevKitC' and 'ESP-WROVER...
authorKrzysztof Budzynski <krzysztof@espressif.com>
Mon, 22 Oct 2018 01:10:58 +0000 (09:10 +0800)
committerAngus Gratton <angus@espressif.com>
Mon, 22 Oct 2018 01:10:58 +0000 (09:10 +0800)
12 files changed:
docs/_static/esp-wrover-kit-block-diagram.png [moved from docs/_static/esp32-wrover-kit-block-diagram.png with 100% similarity]
docs/_static/esp32-devkitc-dimensions-back.jpg
docs/_static/esp32-devkitc-functional-overview.jpg
docs/en/get-started-cmake/get-started-wrover-kit-v2.rst
docs/en/get-started-cmake/get-started-wrover-kit.rst
docs/en/get-started/get-started-devkitc.rst
docs/en/get-started/get-started-wrover-kit-v2.rst
docs/en/get-started/get-started-wrover-kit-v3.rst
docs/en/get-started/get-started-wrover-kit.rst
docs/en/hw-reference/modules-and-boards.rst
docs/zh_CN/get-started/get-started-devkitc.rst
docs/zh_CN/get-started/get-started-wrover-kit.rst

index a19fdce2a0ea93ebd3ba96bc16767ffd5a2d186c..47cdfce82ebdadc2b94483acc1919cd6875313b9 100644 (file)
Binary files a/docs/_static/esp32-devkitc-dimensions-back.jpg and b/docs/_static/esp32-devkitc-dimensions-back.jpg differ
index 0aec63513de2c0dd8bfe82df3c58e6ac426e84b8..bdd89bc4006aa622996d09daee75a18cf1569799 100644 (file)
Binary files a/docs/_static/esp32-devkitc-functional-overview.jpg and b/docs/_static/esp32-devkitc-functional-overview.jpg differ
index c10325fb3801fa3dcf3feb2102cb8819fd591d18..db31f205421f673de2baa7ffe4727428300ce4a6 100644 (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
index c99c62d3602b00612024fd7c7945c523f7002cea..df027a43aeae19201072b37ec498ea5779a4302b 100644 (file)
@@ -29,7 +29,7 @@ Functionality Overview
 \r
 Block diagram below presents main components of ESP-WROVER-KIT and interconnections between components.\r
 \r
-.. figure:: ../../_static/esp32-wrover-kit-block-diagram.png\r
+.. figure:: ../../_static/esp-wrover-kit-block-diagram.png\r
     :align: center\r
     :alt: ESP-WROVER-KIT block diagram\r
     :figclass: align-center\r
index 6c9d43d61c49bbcc08a296a709ae4aeb4ca075dc..123f37143f7593357f58a8e230f075cd73ddee1d 100644 (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
index c2cc7cb2a206e8d5618c94912be5de846c54b566..9783be7fb3be327c26e96d8d89c6603401ec6111 100644 (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
index 6f3ae3ac99f7cd18cbd8871f539eb23f4c7c016d..884404c4d3ec10015131759b5252aaa1a45b54ce 100644 (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
index 6fe89f2e0246894147abf28ee292b1583647ff2a..18e33fb7aa87f9bce4d3c9f81b3eed98b7767ad4 100644 (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.
 
index d28bc8dd977a63f557556cc38e8052358eb77973..ecc9666c145ccc839287db10b0150bb62b64cfb2 100644 (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`_. 
 
index 522695d65f5e45b5950534e79d57b0f20ab0859f..cd3313db88fc375beb4ba27242a33aaef3e34edb 100644 (file)
@@ -1 +1,132 @@
-.. include:: ../../en/get-started/get-started-devkitc.rst
\ No newline at end of file
+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 × PC(Windows、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
\ No newline at end of file
index 50944db789a6f6a302dee0da0b900dbad5ae5af7..f7d7852dd767a152abc739da75c5b474ec6fce7f 100644 (file)
@@ -1 +1,376 @@
-.. include:: ../../en/get-started/get-started-wrover-kit.rst
\ No newline at end of file
+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 × PC(Windows、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
\ No newline at end of file