Crash_Override/OVMS3-idf
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

doc: Split HW-Reference into seperate files/folders for different chips

Browse source
This commit is contained in:
Marius Vikhammer 2019-12-11 15:45:30 +08:00 committed by Angus Gratton
parent cfeb9e68cb
commit 1a90470f02
48 changed files with 1077 additions and 1414 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
docs/conf_common.py
View file

@ -136,19 +136,18 @@ def update_exclude_patterns(tags):
'api-reference/system/himem.rst', 'api-reference/system/himem.rst',
'api-reference/bluetooth/**', 'api-reference/bluetooth/**',
'api-reference/system/ipc.rst', 'api-reference/system/ipc.rst',
'hw-reference/get-started-devkitc-v2.rst',
'hw-reference/get-started-devkitc.rst',
'hw-reference/get-started-ethernet-kit-v1.0.rst',
'hw-reference/get-started-ethernet-kit.rst',
'hw-reference/get-started-pico-kit-v3.rst',
'hw-reference/get-started-pico-kit.rst',
'hw-reference/get-started-wrover-kit-v2.rst',
'hw-reference/get-started-wrover-kit-v3.rst',
'hw-reference/get-started-wrover-kit.rst',
'get-started-legacy/**', 'get-started-legacy/**',
'gnu-make-legacy.rst']: 'gnu-make-legacy.rst',
'hw-reference/esp32/**']:
exclude_patterns.append(e) exclude_patterns.append(e)
if "esp32s2" not in tags:
# Exclude ESP32-only document pages so they aren't found in the initial search for .rst files
# note: in toctrees, these also need to be marked with a :esp32: filter
for e in ['hw-reference/esp32s2/**']:
exclude_patterns.append(e)
# The reST default role (used for this markup: `text`) to use for all # The reST default role (used for this markup: `text`) to use for all
# documents. # documents.
# default_role = None # default_role = None
@ -349,7 +348,6 @@ texinfo_documents = [
# texinfo_no_detailmenu = False # texinfo_no_detailmenu = False
# Override RTD CSS theme to introduce the theme corrections # Override RTD CSS theme to introduce the theme corrections
# https://github.com/rtfd/sphinx_rtd_theme/pull/432 # https://github.com/rtfd/sphinx_rtd_theme/pull/432
def setup(app): def setup(app):

2
docs/en/api-guides/esp-ble-mesh/ble-mesh-faq.rst
View file

@ -527,7 +527,7 @@ Generally, a Provisioner is used to provision unprovisioned devices and form a m
3.2 Why is the Wi-Fi throughput so low when Wi-Fi and ESP-BLE-MESH coexist? 3.2 Why is the Wi-Fi throughput so low when Wi-Fi and ESP-BLE-MESH coexist?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The `ESP32-DevKitC <../../hw-reference/get-started-devkitc>`_ board without PSRAM can run properly but the throughput of it is low since it has no PSRAM. When Bluetooth and Wi-Fi coexist, the throughput of ESP32-DevKitC with PSRAM can be stabilized to more than 1Mbps. The `ESP32-DevKitC <../../hw-reference/esp32/get-started-devkitc>`_ board without PSRAM can run properly but the throughput of it is low since it has no PSRAM. When Bluetooth and Wi-Fi coexist, the throughput of ESP32-DevKitC with PSRAM can be stabilized to more than 1Mbps.
And some configurations in menuconfig shall be enabled to support PSRAM. And some configurations in menuconfig shall be enabled to support PSRAM.

3
docs/en/api-guides/external-ram.rst
View file

@ -33,7 +33,8 @@ The ESP-PSRAM32 chip is a 1.8 V device which can only be used in parallel with a
Connections for ESP32D2W* chips are TBD. Connections for ESP32D2W* chips are TBD.
.. NOTE:: .. note::
Espressif produces the line of ESP32-WROVER modules which contain ESP32, 1.8 V flash, and ESP-PSRAM32. These modules are ready to be mounted on an end product PCB. Espressif produces the line of ESP32-WROVER modules which contain ESP32, 1.8 V flash, and ESP-PSRAM32. These modules are ready to be mounted on an end product PCB.
.. _external_ram_config: .. _external_ram_config:

2
docs/en/api-guides/jtag-debugging/configure-wrover.rst
View file

@ -8,7 +8,7 @@ All versions of ESP-WROVER-KIT boards have built-in JTAG functionality. Putting
Configure Hardware Configure Hardware
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
1. Enable on-board JTAG functionality by setting JP8 according to :doc:`../../hw-reference/get-started-wrover-kit`, Section :ref:`get-started-esp-wrover-kit-v4.1-setup-options`. 1. Enable on-board JTAG functionality by setting JP8 according to :doc:`../../hw-reference/esp32/get-started-wrover-kit`, Section :ref:`get-started-esp-wrover-kit-v4.1-setup-options`.
2. Verify if ESP32 pins used for JTAG communication are not connected to some other h/w that may disturb JTAG operation: 2. Verify if ESP32 pins used for JTAG communication are not connected to some other h/w that may disturb JTAG operation:

18
docs/en/api-guides/jtag-debugging/index.rst
View file

@ -279,20 +279,10 @@ Tips and Quirks
This section provides collection of links to all tips and quirks referred to from various parts of this guide. This section provides collection of links to all tips and quirks referred to from various parts of this guide.
* :ref:`jtag-debugging-tip-breakpoints` .. toctree::
* :ref:`jtag-debugging-tip-where-breakpoints` :maxdepth: 2
* :ref:`jtag-debugging-tip-flash-mappings`
* :ref:`jtag-debugging-tip-why-next-works-as-step` tips-and-quirks
* :ref:`jtag-debugging-tip-code-options`
* :ref:`jtag-debugging-tip-freertos-support`
* :ref:`jtag-debugging-tip-code-flash-voltage`
* :ref:`jtag-debugging-tip-optimize-jtag-speed`
* :ref:`jtag-debugging-tip-debugger-startup-commands`
* :ref:`jtag-debugging-tip-openocd-configure-target`
* :ref:`jtag-debugging-tip-reset-by-debugger`
* :ref:`jtag-debugging-tip-jtag-pins-reconfigured`
* :ref:`jtag-debugging-tip-at-firmware-issue`
* :ref:`jtag-debugging-tip-reporting-issues`
Related Documents Related Documents

8
docs/en/get-started-legacy/index.rst
View file

@ -59,10 +59,10 @@ If you have one of ESP32 development boards listed below, you can click on the l
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
ESP32-DevKitC <../hw-reference/get-started-devkitc> ESP32-DevKitC <../hw-reference/esp32/get-started-devkitc>
ESP-WROVER-KIT <../hw-reference/get-started-wrover-kit> ESP-WROVER-KIT <../hw-reference/esp32/get-started-wrover-kit>
ESP32-PICO-KIT <../hw-reference/get-started-pico-kit> ESP32-PICO-KIT <../hw-reference/esp32/get-started-pico-kit>
ESP32-Ethernet-Kit <../hw-reference/get-started-ethernet-kit> ESP32-Ethernet-Kit <../hw-reference/esp32/get-started-ethernet-kit>
.. _get-started-step-by-step-legacy: .. _get-started-step-by-step-legacy:

8
docs/en/get-started/index.rst
View file

@ -70,10 +70,10 @@ If you have one of {IDF_TARGET_NAME} development boards listed below, you can cl
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
ESP32-DevKitC <../hw-reference/get-started-devkitc> ESP32-DevKitC <../hw-reference/esp32/get-started-devkitc>
ESP-WROVER-KIT <../hw-reference/get-started-wrover-kit> ESP-WROVER-KIT <../hw-reference/esp32/get-started-wrover-kit>
ESP32-PICO-KIT <../hw-reference/get-started-pico-kit> ESP32-PICO-KIT <../hw-reference/esp32/get-started-pico-kit>
ESP32-Ethernet-Kit <../hw-reference/get-started-ethernet-kit> ESP32-Ethernet-Kit <../hw-reference/esp32/get-started-ethernet-kit>
.. _get-started-step-by-step: .. _get-started-step-by-step:

4
docs/en/hw-reference/get-started-devkitc-v2.rst → docs/en/hw-reference/esp32/get-started-devkitc-v2.rst
View file

@ -29,7 +29,7 @@ The following figure and the table below describe the key components, interfaces
.. _get-started-esp32-devkitc-v2-board-front-make: .. _get-started-esp32-devkitc-v2-board-front-make:
.. figure:: ../../_static/esp32-devkitc-v2-functional-overview.png .. figure:: ../../../_static/esp32-devkitc-v2-functional-overview.png
:align: center :align: center
:alt: ESP32-DevKitC V2 board layout :alt: ESP32-DevKitC V2 board layout
:figclass: align-center :figclass: align-center
@ -71,7 +71,7 @@ Start Application Development
Before powering up your ESP32-DevKitC V2, please make sure that the board is in good condition with no obvious signs of damage. Before powering up your ESP32-DevKitC V2, please make sure that the board is in good condition with no obvious signs of damage.
After that, 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. After that, proceed to :doc:`../../get-started/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.
Related Documents Related Documents

10
docs/en/hw-reference/get-started-devkitc.rst → docs/en/hw-reference/esp32/get-started-devkitc.rst
View file

@ -3,7 +3,7 @@ ESP32-DevKitC V4 Getting Started Guide
:link_to_translation:`zh_CN:[中文]` :link_to_translation:`zh_CN:[中文]`
This guide shows how to start using the ESP32-DevKitC V4 development board. For description of other versions of ESP32-DevKitC check :doc:`../hw-reference/index`. This guide shows how to start using the ESP32-DevKitC V4 development board. For description of other versions of ESP32-DevKitC check :doc:`../../hw-reference/index`.
What You Need What You Need
@ -48,7 +48,7 @@ The following figure and the table below describe the key components, interfaces
.. _get-started-esp32-devkitc-board-front: .. _get-started-esp32-devkitc-board-front:
.. figure:: ../../_static/esp32-devkitc-functional-overview.jpg .. figure:: ../../../_static/esp32-devkitc-functional-overview.jpg
:align: center :align: center
:alt: ESP32-DevKitC V4 with ESP-WROOM-32 module soldered :alt: ESP32-DevKitC V4 with ESP-WROOM-32 module soldered
:figclass: align-center :figclass: align-center
@ -108,7 +108,7 @@ The component C15 may cause the following issues on earlier ESP32-DevKitC V4 boa
In case these issues occur, please remove the component. The figure below shows C15 highlighted in yellow. In case these issues occur, please remove the component. The figure below shows C15 highlighted in yellow.
.. figure:: ../../_static/esp32-devkitc-c15-location.png .. figure:: ../../../_static/esp32-devkitc-c15-location.png
:align: center :align: center
:alt: Location of C15 (colored yellow) on ESP32-DevKitC V4 board :alt: Location of C15 (colored yellow) on ESP32-DevKitC V4 board
:figclass: align-center :figclass: align-center
@ -122,13 +122,13 @@ Start Application Development
Before powering up your ESP32-DevKitC V4, please make sure that the board is in good condition with no obvious signs of damage. Before powering up your ESP32-DevKitC V4, please make sure that the board is in good condition with no obvious signs of damage.
After that, 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. After that, proceed to :doc:`../../get-started/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.
Board Dimensions Board Dimensions
---------------- ----------------
.. figure:: ../../_static/esp32-devkitc-dimensions-back.jpg .. figure:: ../../../_static/esp32-devkitc-dimensions-back.jpg
:align: center :align: center
:alt: ESP32 DevKitC board dimensions - back :alt: ESP32 DevKitC board dimensions - back
:figclass: align-center :figclass: align-center

14
docs/en/hw-reference/get-started-ethernet-kit-v1.0.rst → docs/en/hw-reference/esp32/get-started-ethernet-kit-v1.0.rst
View file

@ -25,7 +25,7 @@ It consists of two development boards, the Ethernet board A and the PoE board B,
.. _get-started-esp32-ethernet-kit-b-v1.0: .. _get-started-esp32-ethernet-kit-b-v1.0:
.. figure:: ../../_static/esp32-ethernet-kit-v1.0.png .. figure:: ../../../_static/esp32-ethernet-kit-v1.0.png
:align: center :align: center
:alt: ESP32-Ethernet-Kit V1.0 :alt: ESP32-Ethernet-Kit V1.0
:figclass: align-center :figclass: align-center
@ -40,7 +40,7 @@ Functionality Overview
The block diagram below shows the main components of ESP32-Ethernet-Kit and their interconnections. The block diagram below shows the main components of ESP32-Ethernet-Kit and their interconnections.
.. figure:: ../../_static/esp32-ethernet-kit-block-diagram.png .. figure:: ../../../_static/esp32-ethernet-kit-block-diagram.png
:align: center :align: center
:scale: 50% :scale: 50%
:alt: ESP32-Ethernet-Kit block diagram (click to enlarge) :alt: ESP32-Ethernet-Kit block diagram (click to enlarge)
@ -60,7 +60,7 @@ The following two figures and tables describe the key components, interfaces, an
Ethernet Board (A) Ethernet Board (A)
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
.. figure:: ../../_static/esp32-ethernet-kit-a-v1.0-layout.png .. figure:: ../../../_static/esp32-ethernet-kit-a-v1.0-layout.png
:align: center :align: center
:scale: 80% :scale: 80%
:alt: ESP32-Ethernet-Kit - Ethernet board (A) layout :alt: ESP32-Ethernet-Kit - Ethernet board (A) layout
@ -130,7 +130,7 @@ The PoE board (B) has the following features:
To take advantage of the PoE functionality the **RJ45 Port** of the Ethernet board (A) should be connected with an Ethernet cable to a switch that supports PoE. When the Ethernet board (A) detects 5 V power output from the PoE board (B), the USB power will be automatically cut off. To take advantage of the PoE functionality the **RJ45 Port** of the Ethernet board (A) should be connected with an Ethernet cable to a switch that supports PoE. When the Ethernet board (A) detects 5 V power output from the PoE board (B), the USB power will be automatically cut off.
.. figure:: ../../_static/esp32-ethernet-kit-b-v1.0-layout.png .. figure:: ../../../_static/esp32-ethernet-kit-b-v1.0-layout.png
:align: center :align: center
:scale: 80% :scale: 80%
:alt: ESP32-Ethernet-Kit - PoE board (B) :alt: ESP32-Ethernet-Kit - PoE board (B)
@ -346,7 +346,7 @@ Initial Setup
Now to Development Now to Development
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
Proceed to :doc:`../get-started/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. Proceed to :doc:`../../get-started/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.
Move on to the next section only if you have successfully completed all the above steps. Move on to the next section only if you have successfully completed all the above steps.
@ -364,8 +364,8 @@ Related Documents
* `ESP32-Ethernet-Kit V1.0 PoE board (B) schematic`_ (PDF) * `ESP32-Ethernet-Kit V1.0 PoE board (B) schematic`_ (PDF)
* `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF) * `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF)
* `ESP32-WROVER-B Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_en.pdf>`_ (PDF) * `ESP32-WROVER-B Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_en.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index` * :doc:`../../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`
.. _ESP32-Ethernet-Kit V1.0 Ethernet board (A) schematic: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_A_V1.0_20190517.pdf .. _ESP32-Ethernet-Kit V1.0 Ethernet board (A) schematic: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_A_V1.0_20190517.pdf
.. _ESP32-Ethernet-Kit V1.0 PoE board (B) schematic: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_B_V1.0_20190517.pdf .. _ESP32-Ethernet-Kit V1.0 PoE board (B) schematic: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_B_V1.0_20190517.pdf

18
docs/en/hw-reference/get-started-ethernet-kit.rst → docs/en/hw-reference/esp32/get-started-ethernet-kit.rst
View file

@ -25,7 +25,7 @@ It consists of two development boards, the Ethernet board A and the PoE board B.
.. _get-started-esp32-ethernet-kit-v1.1: .. _get-started-esp32-ethernet-kit-v1.1:
.. figure:: ../../_static/esp32-ethernet-kit-v1.1.png .. figure:: ../../../_static/esp32-ethernet-kit-v1.1.png
:align: center :align: center
:alt: ESP32-Ethernet-Kit V1.1 :alt: ESP32-Ethernet-Kit V1.1
:figclass: align-center :figclass: align-center
@ -40,7 +40,7 @@ Functionality Overview
The block diagram below shows the main components of ESP32-Ethernet-Kit and their interconnections. The block diagram below shows the main components of ESP32-Ethernet-Kit and their interconnections.
.. figure:: ../../_static/esp32-ethernet-kit-v1.1-block-diagram.png .. figure:: ../../../_static/esp32-ethernet-kit-v1.1-block-diagram.png
:align: center :align: center
:scale: 60% :scale: 60%
:alt: ESP32-Ethernet-Kit block diagram (click to enlarge) :alt: ESP32-Ethernet-Kit block diagram (click to enlarge)
@ -60,7 +60,7 @@ The following figures and tables describe the key components, interfaces, and co
Ethernet Board (A) Ethernet Board (A)
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
.. figure:: ../../_static/esp32-ethernet-kit-a-v1.1-layout.png .. figure:: ../../../_static/esp32-ethernet-kit-a-v1.1-layout.png
:align: center :align: center
:scale: 80% :scale: 80%
:alt: ESP32-Ethernet-Kit - Ethernet board (A) layout :alt: ESP32-Ethernet-Kit - Ethernet board (A) layout
@ -123,7 +123,7 @@ The PoE board (B) has the following features:
To take advantage of the PoE functionality the **RJ45 Port** of the Ethernet board (A) should be connected with an Ethernet cable to a switch that supports PoE. When the Ethernet board (A) detects 5 V power output from the PoE board (B), the USB power will be automatically cut off. To take advantage of the PoE functionality the **RJ45 Port** of the Ethernet board (A) should be connected with an Ethernet cable to a switch that supports PoE. When the Ethernet board (A) detects 5 V power output from the PoE board (B), the USB power will be automatically cut off.
.. figure:: ../../_static/esp32-ethernet-kit-b-v1.0-layout.png .. figure:: ../../../_static/esp32-ethernet-kit-b-v1.0-layout.png
:align: center :align: center
:scale: 80% :scale: 80%
:alt: ESP32-Ethernet-Kit - PoE board (B) :alt: ESP32-Ethernet-Kit - PoE board (B)
@ -183,7 +183,7 @@ RMII Clock Sourced Externally by PHY
By default, the ESP32-Ethernet-Kit is configured to provide RMII clock for the IP101GRI PHY's 50M_CLKO output. The clock signal is generated by the frequency multiplication of 25 MHz crystal connected to the PHY. For details, please see the figure below. By default, the ESP32-Ethernet-Kit is configured to provide RMII clock for the IP101GRI PHY's 50M_CLKO output. The clock signal is generated by the frequency multiplication of 25 MHz crystal connected to the PHY. For details, please see the figure below.
.. figure:: ../../_static/esp32-ethernet-kit-rmii-clk-from-phy.png .. figure:: ../../../_static/esp32-ethernet-kit-rmii-clk-from-phy.png
:align: center :align: center
:scale: 80% :scale: 80%
:alt: RMII Clock from IP101GRI PHY :alt: RMII Clock from IP101GRI PHY
@ -199,7 +199,7 @@ RMII Clock Sourced Internally from ESP32's APLL
Another option is to source the RMII Clock from internal ESP32 APLL, see figure below. The clock signal coming from GPIO0 is first inverted, to account for transmission line delay, and then supplied to the PHY. Another option is to source the RMII Clock from internal ESP32 APLL, see figure below. The clock signal coming from GPIO0 is first inverted, to account for transmission line delay, and then supplied to the PHY.
.. figure:: ../../_static/esp32-ethernet-kit-rmii-clk-to-phy.png .. figure:: ../../../_static/esp32-ethernet-kit-rmii-clk-to-phy.png
:align: center :align: center
:scale: 80% :scale: 80%
:alt: RMII Clock from ESP Internal APLL :alt: RMII Clock from ESP Internal APLL
@ -351,7 +351,7 @@ Initial Setup
Now to Development Now to Development
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
Proceed to :doc:`../get-started/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. Proceed to :doc:`../../get-started/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.
Move on to the next section only if you have successfully completed all the above steps. Move on to the next section only if you have successfully completed all the above steps.
@ -387,8 +387,8 @@ Related Documents
* `ESP32-Ethernet-Kit V1.0 PoE board (B) schematic`_ (PDF) * `ESP32-Ethernet-Kit V1.0 PoE board (B) schematic`_ (PDF)
* `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF) * `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF)
* `ESP32-WROVER-B Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_en.pdf>`_ (PDF) * `ESP32-WROVER-B Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_en.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index` * :doc:`../../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`
.. _ESP32-Ethernet-Kit V1.1 Ethernet board (A) schematic: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_A_V1.1_20190711.pdf .. _ESP32-Ethernet-Kit V1.1 Ethernet board (A) schematic: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_A_V1.1_20190711.pdf
.. _ESP32-Ethernet-Kit V1.0 PoE board (B) schematic: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_B_V1.0_20190517.pdf .. _ESP32-Ethernet-Kit V1.0 PoE board (B) schematic: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_B_V1.0_20190517.pdf

8
docs/en/hw-reference/get-started-pico-kit-v3.rst → docs/en/hw-reference/esp32/get-started-pico-kit-v3.rst
View file

@ -2,7 +2,7 @@ ESP32-PICO-KIT V3 Getting Started Guide
======================================= =======================================
:link_to_translation:`zh_CN:[中文]` :link_to_translation:`zh_CN:[中文]`
This guide shows how to get started with the ESP32-PICO-KIT V3 mini development board. For the description of other ESP32-PICO-KIT versions, please check :doc:`../hw-reference/index`. This guide shows how to get started with the ESP32-PICO-KIT V3 mini development board. For the description of other ESP32-PICO-KIT versions, please check :doc:`../../hw-reference/index`.
What You Need What You Need
@ -30,7 +30,7 @@ Functional Description
The following figure and the table below describe the key components, interfaces, and controls of the ESP32-PICO-KIT V3 board. The following figure and the table below describe the key components, interfaces, and controls of the ESP32-PICO-KIT V3 board.
.. figure:: ../../_static/esp32-pico-kit-v3-layout.jpg .. figure:: ../../../_static/esp32-pico-kit-v3-layout.jpg
:align: center :align: center
:alt: ESP32-PICO-KIT V3 board layout :alt: ESP32-PICO-KIT V3 board layout
:figclass: align-center :figclass: align-center
@ -65,7 +65,7 @@ Start Application Development
Before powering up your ESP32-PICO-KIT V3, please make sure that the board is in good condition with no obvious signs of damage. Before powering up your ESP32-PICO-KIT V3, please make sure that the board is in good condition with no obvious signs of damage.
After that, 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. After that, proceed to :doc:`../../get-started/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.
Related Documents Related Documents
@ -73,5 +73,5 @@ Related Documents
* `ESP32-PICO-KIT V3 schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v3_schematic.pdf>`_ (PDF) * `ESP32-PICO-KIT V3 schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v3_schematic.pdf>`_ (PDF)
* `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF) * `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`

14
docs/en/hw-reference/get-started-pico-kit.rst → docs/en/hw-reference/esp32/get-started-pico-kit.rst
View file

@ -2,7 +2,7 @@ ESP32-PICO-KIT V4 / V4.1 Getting Started Guide
============================================== ==============================================
:link_to_translation:`zh_CN:[中文]` :link_to_translation:`zh_CN:[中文]`
This guide shows how to get started with the ESP32-PICO-KIT V4 / V4.1 mini development board. For the description of other ESP32-PICO-KIT versions, please check :doc:`../hw-reference/index`. This guide shows how to get started with the ESP32-PICO-KIT V4 / V4.1 mini development board. For the description of other ESP32-PICO-KIT versions, please check :doc:`../../hw-reference/index`.
This particular description covers ESP32-PICO-KIT V4 and V4.1. The difference is the upgraded USB-UART bridge from CP2102 in V4 with up to 1 Mbps transfer rates to CP2102N in V4.1 with up to 3 Mbps transfer rates. This particular description covers ESP32-PICO-KIT V4 and V4.1. The difference is the upgraded USB-UART bridge from CP2102 in V4 with up to 1 Mbps transfer rates to CP2102N in V4.1 with up to 3 Mbps transfer rates.
@ -45,7 +45,7 @@ Functionality Overview
The block diagram below shows the main components of ESP32-PICO-KIT and their interconnections. The block diagram below shows the main components of ESP32-PICO-KIT and their interconnections.
.. figure:: ../../_static/esp32-pico-kit-v4-functional-block-diagram.png .. figure:: ../../../_static/esp32-pico-kit-v4-functional-block-diagram.png
:align: center :align: center
:alt: ESP32-PICO-KIT functional block diagram :alt: ESP32-PICO-KIT functional block diagram
:figclass: align-center :figclass: align-center
@ -60,7 +60,7 @@ The following figure and the table below describe the key components, interfaces
.. _get-started-pico-kit-v4-board-front: .. _get-started-pico-kit-v4-board-front:
.. figure:: ../../_static/esp32-pico-kit-v4.1-f-layout.jpeg .. figure:: ../../../_static/esp32-pico-kit-v4.1-f-layout.jpeg
:align: center :align: center
:alt: ESP32-PICO-KIT board layout :alt: ESP32-PICO-KIT board layout
:figclass: align-center :figclass: align-center
@ -193,7 +193,7 @@ Start Application Development
Before powering up your ESP32-PICO-KIT, please make sure that the board is in good condition with no obvious signs of damage. Before powering up your ESP32-PICO-KIT, please make sure that the board is in good condition with no obvious signs of damage.
After that, 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. After that, proceed to :doc:`../../get-started/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.
Board Dimensions Board Dimensions
@ -201,14 +201,14 @@ Board Dimensions
The dimensions are 52 x 20.3 x 10 mm (2.1" x 0.8" x 0.4"). The dimensions are 52 x 20.3 x 10 mm (2.1" x 0.8" x 0.4").
.. figure:: ../../_static/esp32-pico-kit-v4.1-dimensions-back.jpg .. figure:: ../../../_static/esp32-pico-kit-v4.1-dimensions-back.jpg
:align: center :align: center
:alt: ESP32-PICO-KIT dimensions - back :alt: ESP32-PICO-KIT dimensions - back
:figclass: align-center :figclass: align-center
ESP32-PICO-KIT dimensions - back ESP32-PICO-KIT dimensions - back
.. figure:: ../../_static/esp32-pico-kit-v4-dimensions-side.jpg .. figure:: ../../../_static/esp32-pico-kit-v4-dimensions-side.jpg
:align: center :align: center
:alt: ESP32-PICO-KIT V4 dimensions - side :alt: ESP32-PICO-KIT V4 dimensions - side
:figclass: align-center :figclass: align-center
@ -225,7 +225,7 @@ Related Documents
* `ESP32-PICO-KIT V4.1 schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4.1_schematic.pdf>`_ (PDF) * `ESP32-PICO-KIT V4.1 schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4.1_schematic.pdf>`_ (PDF)
* `ESP32-PICO-KIT Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-PICO-KIT+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerbers and BOM * `ESP32-PICO-KIT Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-PICO-KIT+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerbers and BOM
* `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF) * `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`
.. toctree:: .. toctree::

28
docs/en/hw-reference/get-started-wrover-kit-v2.rst → docs/en/hw-reference/esp32/get-started-wrover-kit-v2.rst
View file

@ -2,7 +2,7 @@ ESP-WROVER-KIT V2 Getting Started Guide
======================================= =======================================
:link_to_translation:`zh_CN:[中文]` :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`. 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`.
What You Need What You Need
@ -39,7 +39,7 @@ Functionality Overview
The block diagram below shows the main components of ESP-WROVER-KIT and their interconnections. The block diagram below shows the main components of ESP-WROVER-KIT and their interconnections.
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png .. figure:: ../../../_static/esp-wrover-kit-block-diagram.png
:align: center :align: center
:alt: ESP-WROVER-KIT block diagram :alt: ESP-WROVER-KIT block diagram
:figclass: align-center :figclass: align-center
@ -54,7 +54,7 @@ The following two figures and the table below describe the key components, inter
.. _get-started-esp-wrover-kit-v2-board-front: .. _get-started-esp-wrover-kit-v2-board-front:
.. figure:: ../../_static/esp-wrover-kit-v2-layout-front.png .. figure:: ../../../_static/esp-wrover-kit-v2-layout-front.png
:align: center :align: center
:alt: ESP-WROVER-KIT board layout - front :alt: ESP-WROVER-KIT board layout - front
:figclass: align-center :figclass: align-center
@ -63,7 +63,7 @@ The following two figures and the table below describe the key components, inter
.. _get-started-esp-wrover-kit-v2-board-back: .. _get-started-esp-wrover-kit-v2-board-back:
.. figure:: ../../_static/esp-wrover-kit-v2-layout-back.png .. figure:: ../../../_static/esp-wrover-kit-v2-layout-back.png
:align: center :align: center
:alt: ESP-WROVER-KIT board layout - back :alt: ESP-WROVER-KIT board layout - back
:figclass: align-center :figclass: align-center
@ -170,7 +170,7 @@ Turn the **Power Switch** to ON, the **5V Power On LED** should light up.
Now to Development 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:`../../get-started/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.
Related Documents Related Documents
@ -180,16 +180,16 @@ Related Documents
* `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF) * `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF)
* `ESP32-WROVER Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover_datasheet_en.pdf>`_ (PDF) * `ESP32-WROVER Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover_datasheet_en.pdf>`_ (PDF)
* `ESP32-WROOM-32 Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_en.pdf>`_ (PDF) * `ESP32-WROOM-32 Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_en.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index` * :doc:`../../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`
.. |jp1-sd_io2| image:: ../../_static/wrover-jp1-sd_io2.png .. |jp1-sd_io2| image:: ../../../_static/wrover-jp1-sd_io2.png
.. |jp1-both| image:: ../../_static/wrover-jp1-both.png .. |jp1-both| image:: ../../../_static/wrover-jp1-both.png
.. |jp7-ext_5v| image:: ../../_static/wrover-jp7-ext_5v.png .. |jp7-ext_5v| image:: ../../../_static/wrover-jp7-ext_5v.png
.. |jp7-usb_5v| image:: ../../_static/wrover-jp7-usb_5v.png .. |jp7-usb_5v| image:: ../../../_static/wrover-jp7-usb_5v.png
.. |jp8| image:: ../../_static/wrover-jp8.png .. |jp8| image:: ../../../_static/wrover-jp8.png
.. |jp11-tx-rx| image:: ../../_static/wrover-jp11-tx-rx.png .. |jp11-tx-rx| image:: ../../../_static/wrover-jp11-tx-rx.png
.. |jp14| image:: ../../_static/wrover-jp14.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

24
docs/en/hw-reference/get-started-wrover-kit-v3.rst → docs/en/hw-reference/esp32/get-started-wrover-kit-v3.rst
View file

@ -3,7 +3,7 @@ ESP-WROVER-KIT V3 Getting Started Guide
======================================= =======================================
:link_to_translation:`zh_CN:[中文]` :link_to_translation:`zh_CN:[中文]`
This guide shows how to get started with the ESP-WROVER-KIT V3 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`. This guide shows how to get started with the ESP-WROVER-KIT V3 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`.
What You Need What You Need
@ -40,7 +40,7 @@ Functionality Overview
The block diagram below shows the main components of ESP-WROVER-KIT and their interconnections. The block diagram below shows the main components of ESP-WROVER-KIT and their interconnections.
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png .. figure:: ../../../_static/esp-wrover-kit-block-diagram.png
:align: center :align: center
:alt: ESP-WROVER-KIT block diagram :alt: ESP-WROVER-KIT block diagram
:figclass: align-center :figclass: align-center
@ -55,7 +55,7 @@ The following two figures and the table below describe the key components, inter
.. _get-started-esp-wrover-kit-v3-board-front: .. _get-started-esp-wrover-kit-v3-board-front:
.. figure:: ../../_static/esp-wrover-kit-v3-layout-front.jpg .. figure:: ../../../_static/esp-wrover-kit-v3-layout-front.jpg
:align: center :align: center
:alt: ESP-WROVER-KIT board layout - front :alt: ESP-WROVER-KIT board layout - front
:figclass: align-center :figclass: align-center
@ -64,7 +64,7 @@ The following two figures and the table below describe the key components, inter
.. _get-started-esp-wrover-kit-v3-board-back: .. _get-started-esp-wrover-kit-v3-board-back:
.. figure:: ../../_static/esp-wrover-kit-v3-layout-back.jpg .. figure:: ../../../_static/esp-wrover-kit-v3-layout-back.jpg
:align: center :align: center
:alt: ESP-WROVER-KIT board layout - back :alt: ESP-WROVER-KIT board layout - back
:figclass: align-center :figclass: align-center
@ -354,7 +354,7 @@ Turn the **Power Switch** to ON, the **5V Power On LED** should light up.
Now to Development 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:`../../get-started/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.
Related Documents Related Documents
@ -364,14 +364,14 @@ Related Documents
* `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF) * `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF)
* `ESP32-WROVER Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover_datasheet_en.pdf>`_ (PDF) * `ESP32-WROVER Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover_datasheet_en.pdf>`_ (PDF)
* `ESP32-WROOM-32 Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_en.pdf>`_ (PDF) * `ESP32-WROOM-32 Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_en.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index` * :doc:`../../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`
.. |jp7-ext_5v| image:: ../../_static/esp-wrover-kit-v3-jp7-ext_5v.png .. |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 .. |jp7-usb_5v| image:: ../../../_static/esp-wrover-kit-v3-jp7-usb_5v.png
.. |jp8| image:: ../../_static/esp-wrover-kit-v3-jp8.png .. |jp8| image:: ../../../_static/esp-wrover-kit-v3-jp8.png
.. |jp11-tx-rx| image:: ../../_static/esp-wrover-kit-v3-jp11-tx-rx.png .. |jp11-tx-rx| image:: ../../../_static/esp-wrover-kit-v3-jp11-tx-rx.png
.. |jp14| image:: ../../_static/esp-wrover-kit-v3-jp14.png .. |jp14| image:: ../../../_static/esp-wrover-kit-v3-jp14.png
.. _ESP-WROVER-KIT V3 schematic: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-3.pdf .. _ESP-WROVER-KIT V3 schematic: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-3.pdf

24
docs/en/hw-reference/get-started-wrover-kit.rst → docs/en/hw-reference/esp32/get-started-wrover-kit.rst
View file

@ -2,7 +2,7 @@ ESP-WROVER-KIT V4.1 Getting Started Guide
========================================= =========================================
:link_to_translation:`zh_CN:[中文]` :link_to_translation:`zh_CN:[中文]`
This guide shows how to get started with the ESP-WROVER-KIT V4.1 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`. This guide shows how to get started with the ESP-WROVER-KIT V4.1 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`.
What You Need What You Need
@ -40,7 +40,7 @@ Functionality Overview
The block diagram below shows the main components of ESP-WROVER-KIT and their interconnections. The block diagram below shows the main components of ESP-WROVER-KIT and their interconnections.
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png .. figure:: ../../../_static/esp-wrover-kit-block-diagram.png
:align: center :align: center
:alt: ESP-WROVER-KIT block diagram :alt: ESP-WROVER-KIT block diagram
:figclass: align-center :figclass: align-center
@ -55,7 +55,7 @@ The following two figures and the table below describe the key components, inter
.. _get-started-esp-wrover-kit-v4.1-board-front: .. _get-started-esp-wrover-kit-v4.1-board-front:
.. figure:: ../../_static/esp-wrover-kit-v4.1-layout-front.png .. figure:: ../../../_static/esp-wrover-kit-v4.1-layout-front.png
:align: center :align: center
:alt: ESP-WROVER-KIT board layout - front :alt: ESP-WROVER-KIT board layout - front
:figclass: align-center :figclass: align-center
@ -64,7 +64,7 @@ The following two figures and the table below describe the key components, inter
.. _get-started-esp-wrover-kit-v4.1-board-back: .. _get-started-esp-wrover-kit-v4.1-board-back:
.. figure:: ../../_static/esp-wrover-kit-v4.1-layout-back.png .. figure:: ../../../_static/esp-wrover-kit-v4.1-layout-back.png
:align: center :align: center
:alt: ESP-WROVER-KIT board layout - back :alt: ESP-WROVER-KIT board layout - back
:figclass: align-center :figclass: align-center
@ -358,7 +358,7 @@ Turn the **Power Switch** to ON, the **5V Power On LED** should light up.
Now to Development 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:`../../get-started/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.
Related Documents Related Documents
@ -367,14 +367,14 @@ Related Documents
* `ESP-WROVER-KIT V4.1 schematic`_ (PDF) * `ESP-WROVER-KIT V4.1 schematic`_ (PDF)
* `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF) * `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF)
* `ESP32-WROVER-B Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_en.pdf>`_ (PDF) * `ESP32-WROVER-B Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_en.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index` * :doc:`../../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`
.. |jp7-ext_5v| image:: ../../_static/esp-wrover-kit-v4.1-jp7-ext_5v.jpg .. |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 .. |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-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 .. |jp2-tx-rx| image:: ../../../_static/esp-wrover-kit-v4.1-jp2-tx-rx.jpg
.. |jp14| image:: ../../_static/esp-wrover-kit-v4.1-jp14.jpg .. |jp14| image:: ../../../_static/esp-wrover-kit-v4.1-jp14.jpg
.. _ESP-WROVER-KIT V4.1 schematic: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_V4_1.pdf .. _ESP-WROVER-KIT V4.1 schematic: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_V4_1.pdf

289
docs/en/hw-reference/esp32/inc/modules-and-boards-esp32.rst Normal file
View file

@ -0,0 +1,289 @@
.. _esp-wroom-solo-wrover-modules:
Modules
=======
This is a family of ESP32-based modules with some integrated key components, including a crystal oscillator and an antenna matching circuit. The modules constitute ready-made solutions for integration into final products. If combined with a few extra components, such as a programming interface, bootstrapping resistors, and pin headers, these modules can also be used for evaluation of ESP32's functionality.
The key characteristics of these modules are summarized in the table below. Some additional details are covered in the following sections.
=================== ============ =========== ========= ==== ===============
Module Chip Flash, MB PSRAM, MB Ant. Dimensions, mm
=================== ============ =========== ========= ==== ===============
ESP32-WROOM-32 ESP32-D0WDQ6 4 -- MIFA 18 × 25.5 × 3.1
ESP32-WROOM-32D ESP32-D0WD 4, 8, or 16 -- MIFA 18 × 25.5 × 3.1
ESP32-WROOM-32U ESP32-D0WD 4, 8, or 16 -- U.FL 18 × 19.2 × 3.1
ESP32-SOLO-1 ESP32-S0WD 4 -- MIFA 18 × 25.5 × 3.1
ESP32-WROVER (PCB) ESP32-D0WDQ6 4 8 MIFA 18 × 31.4 × 3.3
ESP32-WROVER (IPEX) ESP32-D0WDQ6 4 8 U.FL 18 × 31.4 × 3.3
ESP32-WROVER-B ESP32-D0WD 4, 8, or 16 8 MIFA 18 × 31.4 × 3.3
ESP32-WROVER-IB ESP32-D0WD 4, 8, or 16 8 U.FL 18 × 31.4 × 3.3
=================== ============ =========== ========= ==== ===============
* ESP32-**D**.. identifies a dual-core chip, ESP32-**S**.. identifies a single-core chip
* MIFA - Meandered Inverted-F Antenna
* U.FL - U.FL / IPEX antenna connector
* ESP32-WROOM-32x, ESP32-WROVER-B and ESP32-WROVER-IB modules come with 4 MB flash by default but also available with custom flash sizes of 8 MB and 16 MB, see `Espressif Products Ordering Information`_ (PDF)
* `ESP32 Chip Datasheet <https://espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`__ (PDF)
* Initial release of the ESP32-WROVER module had 4 MB of PSRAM
* *ESP32-WROOM-32* was previously called *ESP-WROOM-32*
.. _esp-modules-and-boards-esp32-wroom-32:
ESP32-WROOM-32
--------------
This is a basic and commonly adopted ESP32 module with the ESP32-D0WDQ6 chip on board. It was the first module of the WROOM / WROVER family released to the market.
For key characteristics, see the table in Section :ref:`esp-wroom-solo-wrover-modules`, `Espressif Products Ordering Information`_.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32-front-back.jpg
:align: center
:alt: ESP32-WROOM-32 module (front and back)
:width: 45%
ESP32-WROOM-32 module (front and back)
Documentation
^^^^^^^^^^^^^
* `ESP32-WROOM-32 Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_en.pdf>`__ (PDF)
* `ESP32-WROOM-32 Reference Design <https://www.espressif.com/en/support/download/documents?keys=+ESP32-WROOM-32+Reference>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
.. _esp-modules-and-boards-esp32-wroom-32d-and-u:
ESP32-WROOM-32D / ESP32-WROOM-32U
---------------------------------
Both modules integrate the ESP32-D0WD chip which has a smaller footprint than the chip ESP32-D0WDQ6 installed in :ref:`esp-modules-and-boards-esp32-wroom-32`.
For key characteristics, see the table in Section :ref:`esp-wroom-solo-wrover-modules` and `Espressif Products Ordering Information`_.
ESP32-WROOM-32U is the smallest representative of the whole WROOM / WROVER family of modules.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32d-front-back.jpg
:align: center
:alt: ESP32-WROOM-32D module (front and back)
:width: 45%
ESP32-WROOM-32D module (front and back)
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32u-front-back.jpg
:align: center
:alt: ESP32-WROOM-32U module (front and back)
:width: 45%
ESP32-WROOM-32U module (front and back)
Documentation
^^^^^^^^^^^^^
* `ESP32-WROOM-32D / ESP32-WROOM-32U Datasheet <http://espressif.com/sites/default/files/documentation/esp32-wroom-32d_esp32-wroom-32u_datasheet_en.pdf>`__ (PDF)
.. _esp-modules-and-boards-esp32-solo-1:
ESP32-SOLO-1
------------
This is a simplified version of the ESP32-WROOM-32D module. It contains a single-core ESP32 chip that supports a clock frequency of up to 160 MHz.
For key characteristics, see the table in Section :ref:`esp-wroom-solo-wrover-modules` and `Espressif Products Ordering Information`_.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-solo-1-front-back.jpg
:align: center
:alt: ESP32-SOLO-1 module (front and back)
:width: 45%
ESP32-SOLO-1 module (front and back)
Documentation
^^^^^^^^^^^^^
* `ESP32-SOLO-1 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-solo-1_datasheet_en.pdf>`__ (PDF)
.. _esp-modules-and-boards-esp32-wrover:
ESP32-WROVER series
-------------------
This series consists of a few modifications of ESP32-WROOM-32x modules, which among other upgrades include additional 8 MB SPI PSRAM (pseudo static RAM).
For details, see the table in Section :ref:`esp-wroom-solo-wrover-modules` and `Espressif Products Ordering Information`_.
* **ESP32-WROVER (PCB)** and **ESP32-WROVER (IPEX)** have PSRAM that operates at 1.8 V and supports up to 144 MHz clock rate.
* **ESP32-WROVER-B** and **ESP32-WROVER-IB** have PSRAM that operates at 3.3 V and supports up to 133 MHz clock rate.
The picture below shows an ESP32-WROVER module with a PCB antenna.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wrover.jpg
:align: center
:alt: ESP32-WROVER module (front and back)
:width: 40%
ESP32-WROVER module (front and back)
Documentation
^^^^^^^^^^^^^
* `ESP32-WROVER Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover_datasheet_en.pdf>`__ (PDF)
* `ESP32-WROVER-B Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_en.pdf>`__ (PDF)
* `ESP-PSRAM64 & ESP-PSRAM64H Datasheet <https://www.espressif.com/sites/default/files/documentation/esp-psram64_esp-psram64h_datasheet_en.pdf>`__ (PDF)
* `ESP32-WROVER Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-WROVER+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
ESP32-PICO-D4
-------------
ESP32-PICO-D4 is a System-in-Package (SiP) module, integrating all peripheral components seamlessly, including the following:
- 4 MB flash memory
- crystal oscillator
- filter capacitors
- RF matching circuit
For key characteristics, see `Espressif Products Ordering Information`_.
Documentation
^^^^^^^^^^^^^
* `ESP32-PICO-D4 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`__ (PDF)
Development Boards
==================
Depending on the intended functionality, different development boards feature:
- Access to different ESP32 GPIO pins.
- Different interfaces: USB, JTAG.
- Different peripherals: touchpads, LCD screens, SD card slots, female headers for camera modules, etc.
.. _esp-modules-and-boards-esp32-pico-kit:
ESP32-PICO-KIT V4.1
-------------------
This is the smallest available ESP32-based development board. It features all the components for direct connection to a computer's USB port as well as pin headers for plugging into a mini breadboard.
The board is equipped with the `ESP32-PICO-D4`_ module. With such a module, the creation of a fully functional development board required only a few external components that fit on a PCB as small as 20 x 52 mm. The external components include antenna, LDO, USB-UART bridge, and two buttons for reset and activation of Firmware Download mode.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-pico-kit-v4.1.jpg
:align: center
:alt: ESP32-PICO-KIT V4.1 board
:width: 50%
ESP32-PICO-KIT V4.1 board
Comparing to ESP32-PICO-KIT V4, this version features the CP2102N USB-UART bridge that provides faster transfer rates of up to 3 Mbps.
Documentation
^^^^^^^^^^^^^
* :doc:`esp32/get-started-pico-kit`
* `ESP32-PICO-KIT V4.1 Schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4.1_schematic.pdf>`_ (PDF)
* `ESP32-PICO-KIT Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-PICO-KIT+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
* `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
Previous Versions
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp32-pico-kit-v4`
* :ref:`esp-modules-and-boards-esp32-pico-kit-v3`
.. _esp-modules-and-boards-esp32-devkitc:
ESP32 DevKitC V4
----------------
This is a small and convenient development board that features:
- :ref:`esp-modules-and-boards-esp32-wroom-32` module
- USB-to-serial programming interface that also provides power supply for the board
- pin headers
- pushbuttons for reset and activation of Firmware Download mode
- a few other components
Comparing to the previous :ref:`esp-modules-and-boards-esp32-devkitc-v2`, this version can integrate :ref:`esp-modules-and-boards-esp32-wrover` module instead of ESP32-WROOM-32 and has the CP2102N chip that supports faster baud rates.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-devkitc-v4-front.jpg
:align: center
:alt: ESP32 DevKitC V4 board
:width: 50%
ESP32 DevKitC V4 board
Documentation
^^^^^^^^^^^^^
* :doc:`esp32/get-started-devkitc`
* `ESP32-DevKitC schematic <https://dl.espressif.com/dl/schematics/esp32_devkitc_v4-sch-20180607a.pdf>`_ (PDF)
* `ESP32-DevKitC Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-DevKitC-V4+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
* `CP210x USB to UART Bridge VCP Drivers <https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers>`_
Previous Versions
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp32-devkitc-v2`
.. _esp-modules-and-boards-esp-wrover-kit:
ESP-WROVER-KIT V4.1
-------------------
This board features:
- Dual port USB-to-serial converter for programming
- JTAG interface for debugging
- MicroSD card slot
- 3.2” SPI LCD screen
- Female headers for a camera module
- RGB LED for diagnostics
- 32.768 kHz XTAL for internal RTC to operate it in low power modes
Power can be supplied either via USB or via a standard 5 mm power supply jack. A power source can be selected with a jumper and can be turned on/off with a separate switch.
This version of the ESP-WROVER-KIT board integrates the ESP-WROVER-B module that has 8 MB PSRAM for flexible extended storage and data processing capabilities. The board can accommodate other versions of ESP modules described in :ref:`esp-wroom-solo-wrover-modules`.
Comparing to :ref:`esp-modules-and-boards-esp-wrover-kit-v3`, this board has the following design changes:
- JP8, JP11, and JP13 have been combined into a single JP2.
- USB connector has been changed to DIP type and moved to the lower right corner of the board.
- R61 has been changed to a Zero-ohm resistor.
- Some components have been replaced with functional equivalents based on test results and sourcing options, e.g., the EN and Boot buttons.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v4.1-front.jpg
:align: center
:alt: ESP-WROVER-KIT V4.1 board
:width: 90%
ESP-WROVER-KIT V4.1 board
The board in the picture above integrates the ESP32-WROVER-B module.
Documentation
^^^^^^^^^^^^^
* :doc:`esp32/get-started-wrover-kit`
* `ESP-WROVER-KIT V4.1 Schematic <https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_V4_1.pdf>`__ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* `FTDI Virtual COM Port Drivers`_
Previous Versions
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp-wrover-kit-v3`
* :ref:`esp-modules-and-boards-esp-wrover-kit-v2`
* :ref:`esp-modules-and-boards-esp-wrover-kit-v1`
.. _FTDI Virtual COM Port Drivers: http://www.ftdichip.com/Drivers/VCP.htm
.. _Espressif Products Ordering Information: https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_en.pdf

179
docs/en/hw-reference/esp32/inc/modules-and-boards-previous-esp32.rst Normal file
View file

@ -0,0 +1,179 @@
.. _esp-modules-and-boards-previous_esp32:
Modules (No updated or discontinued modules)
============================================
So far, no modules have been updated or discontinued.
Development Boards
==================
To see the latest development boards, please refer to section :ref:`esp-modules-and-boards`.
.. _esp-modules-and-boards-esp32-pico-kit-v4:
ESP32-PICO-KIT V4
-----------------
The smallest ESP32 development board with all the components required to connect it directly to a PC USB port, and pin headers to plug into a mini breadboard. It is equipped with ESP32-PICO-D4 module that integrates 4 MB flash memory, a crystal oscillator, filter capacitors and RF matching circuit in one single package. As result, the fully functional development board requires only a few external components that can easy fit on a 20 x 52 mm PCB including antenna, LDO, USB-UART bridge and two buttons to reset it and put into download mode.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-pico-kit-v4.jpeg
:align: center
:alt: ESP32-PICO-KIT V4 board
:width: 50%
ESP32-PICO-KIT V4 board
Comparing to ESP32-PICO-KIT V3, this version has revised printout and reduced number of exposed pins. Instead of 20, only 17 header pins are populated, so V4 can fit into a mini breadboard.
Documentation
^^^^^^^^^^^^^
* :doc:`esp32/get-started-pico-kit`
* `ESP32-PICO-KIT V4 Schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4_schematic.pdf>`_ (PDF)
* `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
.. _esp-modules-and-boards-esp32-pico-kit-v3:
ESP32-PICO-KIT V3
-----------------
The first public release of Espressif's ESP32-PICO-D4 module on a mini development board. The board has a USB port for programming and debugging and two rows of 20 pin headers to plug into a breadboard. The ESP32-PICO-D4 module itself is small and requires only a few external components. Besides two core CPUs it integrates 4MB flash memory, a crystal oscillator and antenna matching components in one single 7 x 7 mm package. As a result the module and all the components making the complete development board fit into 20 x 52 mm PCB.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-pico-kit-v3.jpeg
:align: center
:alt: ESP32-PICO-KIT V3 board
:width: 50%
ESP32-PICO-KIT V3 board
Documentation
^^^^^^^^^^^^^
* :doc:`esp32/get-started-pico-kit-v3`
* `ESP32-PICO-KIT V3 Schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v3_schematic.pdf>`_ (PDF)
* `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
.. _esp-modules-and-boards-esp32-devkitc-v2:
ESP32 Core Board V2 / ESP32 DevKitC
-----------------------------------
Small and convenient development board with ESP-WROOM-32 module installed, break out pin headers and minimum additional components. Includes USB to serial programming interface, that also provides power supply for the board. Has pushbuttons to reset the board and put it in upload mode.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-core-board-v2.png
:align: center
:alt: ESP32 Core Board V2 / ESP32 DevKitC board
:width: 50%
ESP32 Core Board V2 / ESP32 DevKitC board
Documentation
^^^^^^^^^^^^^
* :doc:`esp32/get-started-devkitc-v2`
* `ESP32 DevKitC V2 Schematic <https://dl.espressif.com/dl/schematics/ESP32-Core-Board-V2_sch.pdf>`__ (PDF)
* `CP210x USB to UART Bridge VCP Drivers <https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers>`_
.. _esp-modules-and-boards-esp-wrover-kit-v3:
ESP-WROVER-KIT V3
-----------------
The ESP-WROVER-KIT V3 development board has dual port USB to serial converter for programming and JTAG interface for debugging. Power supply is provided by USB interface or from standard 5 mm power supply jack. Power supply selection is done with a jumper and may be put on/off with a separate switch. This board has MicroSD card slot, 3.2” SPI LCD screen and dedicated header to connect a camera. It provides RGB diode for diagnostics. Includes 32.768 kHz XTAL for internal RTC to operate it in low power modes.
As all previous versions of ESP-WROVER-KIT boards, it is ready to accommodate an :ref:`esp-modules-and-boards-esp32-wroom-32` or :ref:`esp-modules-and-boards-esp32-wrover` module.
This is the first release of ESP-WROVER-KIT shipped with :ref:`esp-modules-and-boards-esp32-wrover` module installed by default. This release also introduced several design changes to conditioning and interlocking of signals to the bootstrapping pins. Also, a zero Ohm resistor (R166) has been added between WROVER/WROOM module and VDD33 net, which can be desoldered, or replaced with a shunt resistor, for current measurement. This is intended to facilitate power consumption analysis in various operation modes of ESP32. Refer to schematic - the changes are enclosed in green border.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v3.jpg
:align: center
:alt: ESP-WROVER-KIT V3 board
:width: 90%
ESP-WROVER-KIT V3 board
The camera header has been changed from male back to female. The board soldermask is matte black. The board on picture above has :ref:`esp-modules-and-boards-esp32-wrover` is installed.
Documentation
^^^^^^^^^^^^^
* :doc:`esp32/get-started-wrover-kit-v3`
* `ESP-WROVER-KIT V3 Schematic <https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-3.pdf>`__ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* `FTDI Virtual COM Port Drivers`_
.. _esp-modules-and-boards-esp-wrover-kit-v2:
ESP-WROVER-KIT V2
-----------------
This is updated version of ESP32 DevKitJ V1 described above with design improvements identified when DevKitJ was in use, e.g. improved support for SD card. By default board has ESP-WROOM-32 module installed.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v2.jpg
:align: center
:alt: ESP-WROVER-KIT V2 board
:width: 90%
ESP-WROVER-KIT V2 board
Comparing to previous version, this board has a shiny black finish and a male camera header.
Documentation
^^^^^^^^^^^^^
* :doc:`esp32/get-started-wrover-kit-v2`
* `ESP-WROVER-KIT V2 Schematic <https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-2.pdf>`__ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* `FTDI Virtual COM Port Drivers`_
.. _esp-modules-and-boards-esp-wrover-kit-v1:
ESP-WROVER-KIT V1 / ESP32 DevKitJ V1
------------------------------------
The first version of ESP-WROVER-KIT development board. Shipped with ESP-WROOM-32 on board.
ESP-WROVER-KIT has dual port USB to serial converter for programming and JTAG interface for debugging. Power supply is provided by USB interface or from standard 5 mm power supply jack. Power supply selection is done with a jumper and may be put on/off with a separate switch. The board has MicroSD card slot, 3.2” SPI LCD screen and dedicated header to connect a camera. It provides RGB diode for diagnostics. Includes 32.768 kHz XTAL for internal RTC to operate it in low power modes.
All versions of ESP-WROVER-KIT are ready to accommodate an ESP-WROOM-32 or ESP32-WROVER module.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-devkitj-v1.jpg
:align: center
:alt: ESP-WROVER-KIT V1 / ESP32 DevKitJ V1 board
:width: 90%
ESP-WROVER-KIT V1 / ESP32 DevKitJ V1 board
The board has red soldermask.
Documentation
^^^^^^^^^^^^^
* `ESP-WROVER-KIT V1 Schematic <https://dl.espressif.com/dl/schematics/ESP32-DevKitJ-v1_sch.pdf>`__ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* `FTDI Virtual COM Port Drivers`_
.. _esp-modules-and-boards-esp32-demo-board:
ESP32 Demo Board V2
-------------------
One of first feature rich evaluation boards that contains several pin headers, dip switches, USB to serial programming interface, reset and boot mode press buttons, power switch, 10 touch pads and separate header to connect LCD screen.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-demo-board-v2.jpg
:align: center
:alt: ESP32 Demo Board V2
ESP32 Demo Board V2
Production of this board is discontinued.
Documentation
^^^^^^^^^^^^^
* `ESP32 Demo Board V2 Schematic <https://dl.espressif.com/dl/schematics/ESP32-Demo-Board-V2_sch.pdf>`__ (PDF)
* `FTDI Virtual COM Port Drivers`_

21
docs/en/hw-reference/esp32s2/inc/modules-and-boards-esp32s2.rst Normal file
View file

@ -0,0 +1,21 @@
.. _esp-s2-modules:
Modules
=======
This is a family of ESP32-S2-based modules with some integrated key components, including a crystal oscillator and an antenna matching circuit. The modules constitute ready-made solutions for integration into final products. If combined with a few extra components, such as a programming interface, bootstrapping resistors, and pin headers, these modules can also be used for evaluation of ESP32-S2's functionality.
The key characteristics of these modules are summarized in the table below. Some additional details are covered in the following sections.
=================== ============ =========== ========= ==== ===============
Module Chip Flash, MB PSRAM, MB Ant. Dimensions, mm
=================== ============ =========== ========= ==== ===============
ESP32-S2-WROOM-32 ESP32-S2 2 N/A MIFA 16 x 23 x 3
=================== ============ =========== ========= ==== ===============
* MIFA - Meandered Inverted-F Antenna
* U.FL - U.FL / IPEX antenna connector
.. _FTDI Virtual COM Port Drivers: http://www.ftdichip.com/Drivers/VCP.htm
.. _Espressif Products Ordering Information: https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_en.pdf

12
docs/en/hw-reference/esp32s2/inc/modules-and-boards-previous-esp32s2.rst Normal file
View file

@ -0,0 +1,12 @@
.. _esp-modules-and-boards-previous_esp32s2:
Modules (No updated or discontinued modules)
============================================
So far, no modules have been updated or discontinued.
Development Boards
==================
So far, no development boards have been updated or discontinued.

2
docs/en/hw-reference/index.rst
View file

@ -9,7 +9,7 @@
:esp32: Technical Reference Manual (PDF) <https://espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf> :esp32: Technical Reference Manual (PDF) <https://espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf>
:esp32s2beta: Technical Reference Manual (PDF) <https://espressif.com/sites/default/files/documentation/esp32s2_technical_reference_manual_en.pdf> :esp32s2beta: Technical Reference Manual (PDF) <https://espressif.com/sites/default/files/documentation/esp32s2_technical_reference_manual_en.pdf>
:esp32: Datasheet (PDF) <https://espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf> :esp32: Datasheet (PDF) <https://espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>
:esp32s2beta: Datasheet (PDF) <https://espressif.com/sites/default/files/documentation/esp32s2_datasheet_en.pdf> :esp32s2: Datasheet (PDF) <https://espressif.com/sites/default/files/documentation/esp32s2_datasheet_en.pdf>
:esp32: Hardware Design Guidelines (PDF) <https://espressif.com/sites/default/files/documentation/esp32_hardware_design_guidelines_en.pdf> :esp32: Hardware Design Guidelines (PDF) <https://espressif.com/sites/default/files/documentation/esp32_hardware_design_guidelines_en.pdf>
:esp32: Silicon Errata (PDF) <https://espressif.com/sites/default/files/documentation/eco_and_workarounds_for_bugs_in_esp32_en.pdf> :esp32: Silicon Errata (PDF) <https://espressif.com/sites/default/files/documentation/eco_and_workarounds_for_bugs_in_esp32_en.pdf>
Modules and Boards <modules-and-boards> Modules and Boards <modules-and-boards>

179
docs/en/hw-reference/modules-and-boards-previous.rst
View file

@ -7,186 +7,13 @@ Previous Versions of {IDF_TARGET_NAME} Modules and Boards
This sections contains overview and links to documentation of previous version {IDF_TARGET_NAME} Modules and Boards that have been replaced with newer versions or discontinued. It is maintained for convenience of users as previous versions of some modules and boards are still in use and some may still be available for purchase. This sections contains overview and links to documentation of previous version {IDF_TARGET_NAME} Modules and Boards that have been replaced with newer versions or discontinued. It is maintained for convenience of users as previous versions of some modules and boards are still in use and some may still be available for purchase.
Modules (No updated or discontinued modules)
============================================
So far, no modules have been updated or discontinued.
Development Boards
==================
To see the latest development boards, please refer to section :ref:`esp-modules-and-boards`.
.. only:: esp32 .. only:: esp32
.. _esp-modules-and-boards-esp32-pico-kit-v4: .. include:: esp32/inc/modules-and-boards-previous-esp32.rst
ESP32-PICO-KIT V4 .. only:: esp32s2
-----------------
The smallest ESP32 development board with all the components required to connect it directly to a PC USB port, and pin headers to plug into a mini breadboard. It is equipped with ESP32-PICO-D4 module that integrates 4 MB flash memory, a crystal oscillator, filter capacitors and RF matching circuit in one single package. As result, the fully functional development board requires only a few external components that can easy fit on a 20 x 52 mm PCB including antenna, LDO, USB-UART bridge and two buttons to reset it and put into download mode.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-pico-kit-v4.jpeg
:align: center
:alt: ESP32-PICO-KIT V4 board
:width: 50%
ESP32-PICO-KIT V4 board
Comparing to ESP32-PICO-KIT V3, this version has revised printout and reduced number of exposed pins. Instead of 20, only 17 header pins are populated, so V4 can fit into a mini breadboard.
Documentation
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-pico-kit`
* `ESP32-PICO-KIT V4 Schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4_schematic.pdf>`_ (PDF)
* `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
.. _esp-modules-and-boards-esp32-pico-kit-v3:
ESP32-PICO-KIT V3
-----------------
The first public release of Espressif's ESP32-PICO-D4 module on a mini development board. The board has a USB port for programming and debugging and two rows of 20 pin headers to plug into a breadboard. The ESP32-PICO-D4 module itself is small and requires only a few external components. Besides two core CPUs it integrates 4MB flash memory, a crystal oscillator and antenna matching components in one single 7 x 7 mm package. As a result the module and all the components making the complete development board fit into 20 x 52 mm PCB.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-pico-kit-v3.jpeg
:align: center
:alt: ESP32-PICO-KIT V3 board
:width: 50%
ESP32-PICO-KIT V3 board
Documentation
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-pico-kit-v3`
* `ESP32-PICO-KIT V3 Schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v3_schematic.pdf>`_ (PDF)
* `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
.. _esp-modules-and-boards-esp32-devkitc-v2:
ESP32 Core Board V2 / ESP32 DevKitC
-----------------------------------
Small and convenient development board with ESP-WROOM-32 module installed, break out pin headers and minimum additional components. Includes USB to serial programming interface, that also provides power supply for the board. Has pushbuttons to reset the board and put it in upload mode.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-core-board-v2.png
:align: center
:alt: ESP32 Core Board V2 / ESP32 DevKitC board
:width: 50%
ESP32 Core Board V2 / ESP32 DevKitC board
Documentation
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-devkitc-v2`
* `ESP32 DevKitC V2 Schematic <https://dl.espressif.com/dl/schematics/ESP32-Core-Board-V2_sch.pdf>`__ (PDF)
* `CP210x USB to UART Bridge VCP Drivers <https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers>`_
.. _esp-modules-and-boards-esp-wrover-kit-v3:
ESP-WROVER-KIT V3
-----------------
The ESP-WROVER-KIT V3 development board has dual port USB to serial converter for programming and JTAG interface for debugging. Power supply is provided by USB interface or from standard 5 mm power supply jack. Power supply selection is done with a jumper and may be put on/off with a separate switch. This board has MicroSD card slot, 3.2” SPI LCD screen and dedicated header to connect a camera. It provides RGB diode for diagnostics. Includes 32.768 kHz XTAL for internal RTC to operate it in low power modes.
As all previous versions of ESP-WROVER-KIT boards, it is ready to accommodate an :ref:`esp-modules-and-boards-esp32-wroom-32` or :ref:`esp-modules-and-boards-esp32-wrover` module.
This is the first release of ESP-WROVER-KIT shipped with :ref:`esp-modules-and-boards-esp32-wrover` module installed by default. This release also introduced several design changes to conditioning and interlocking of signals to the bootstrapping pins. Also, a zero Ohm resistor (R166) has been added between WROVER/WROOM module and VDD33 net, which can be desoldered, or replaced with a shunt resistor, for current measurement. This is intended to facilitate power consumption analysis in various operation modes of ESP32. Refer to schematic - the changes are enclosed in green border.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v3.jpg
:align: center
:alt: ESP-WROVER-KIT V3 board
:width: 90%
ESP-WROVER-KIT V3 board
The camera header has been changed from male back to female. The board soldermask is matte black. The board on picture above has :ref:`esp-modules-and-boards-esp32-wrover` is installed.
Documentation
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-wrover-kit-v3`
* `ESP-WROVER-KIT V3 Schematic <https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-3.pdf>`__ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* `FTDI Virtual COM Port Drivers`_
.. _esp-modules-and-boards-esp-wrover-kit-v2:
ESP-WROVER-KIT V2
-----------------
This is updated version of ESP32 DevKitJ V1 described above with design improvements identified when DevKitJ was in use, e.g. improved support for SD card. By default board has ESP-WROOM-32 module installed.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v2.jpg
:align: center
:alt: ESP-WROVER-KIT V2 board
:width: 90%
ESP-WROVER-KIT V2 board
Comparing to previous version, this board has a shiny black finish and a male camera header.
Documentation
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-wrover-kit-v2`
* `ESP-WROVER-KIT V2 Schematic <https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-2.pdf>`__ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* `FTDI Virtual COM Port Drivers`_
.. _esp-modules-and-boards-esp-wrover-kit-v1:
ESP-WROVER-KIT V1 / ESP32 DevKitJ V1
------------------------------------
The first version of ESP-WROVER-KIT development board. Shipped with ESP-WROOM-32 on board.
ESP-WROVER-KIT has dual port USB to serial converter for programming and JTAG interface for debugging. Power supply is provided by USB interface or from standard 5 mm power supply jack. Power supply selection is done with a jumper and may be put on/off with a separate switch. The board has MicroSD card slot, 3.2” SPI LCD screen and dedicated header to connect a camera. It provides RGB diode for diagnostics. Includes 32.768 kHz XTAL for internal RTC to operate it in low power modes.
All versions of ESP-WROVER-KIT are ready to accommodate an ESP-WROOM-32 or ESP32-WROVER module.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-devkitj-v1.jpg
:align: center
:alt: ESP-WROVER-KIT V1 / ESP32 DevKitJ V1 board
:width: 90%
ESP-WROVER-KIT V1 / ESP32 DevKitJ V1 board
The board has red soldermask.
Documentation
^^^^^^^^^^^^^
* `ESP-WROVER-KIT V1 Schematic <https://dl.espressif.com/dl/schematics/ESP32-DevKitJ-v1_sch.pdf>`__ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* `FTDI Virtual COM Port Drivers`_
.. _esp-modules-and-boards-esp32-demo-board:
ESP32 Demo Board V2
-------------------
One of first feature rich evaluation boards that contains several pin headers, dip switches, USB to serial programming interface, reset and boot mode press buttons, power switch, 10 touch pads and separate header to connect LCD screen.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-demo-board-v2.jpg
:align: center
:alt: ESP32 Demo Board V2
ESP32 Demo Board V2
Production of this board is discontinued.
Documentation
^^^^^^^^^^^^^
* `ESP32 Demo Board V2 Schematic <https://dl.espressif.com/dl/schematics/ESP32-Demo-Board-V2_sch.pdf>`__ (PDF)
* `FTDI Virtual COM Port Drivers`_
.. include:: esp32s2/inc/modules-and-boards-previous-esp32s2.rst
Related Documents Related Documents
================= =================

291
docs/en/hw-reference/modules-and-boards.rst
View file

@ -14,300 +14,15 @@ This document provides description of modules and development boards currently a
For description of previous versions of modules and development boards as well as for description of discontinued ones, please go to Section :ref:`esp-modules-and-boards-previous`. For description of previous versions of modules and development boards as well as for description of discontinued ones, please go to Section :ref:`esp-modules-and-boards-previous`.
.. _esp-wroom-solo-wrover-modules:
Modules
=======
This is a family of {IDF_TARGET_NAME}-based modules with some integrated key components, including a crystal oscillator and an antenna matching circuit. The modules constitute ready-made solutions for integration into final products. If combined with a few extra components, such as a programming interface, bootstrapping resistors, and pin headers, these modules can also be used for evaluation of {IDF_TARGET_NAME}'s functionality.
The key characteristics of these modules are summarized in the table below. Some additional details are covered in the following sections.
.. only:: esp32 .. only:: esp32
=================== ============ =========== ========= ==== =============== .. include:: esp32/inc/modules-and-boards-esp32.rst
Module Chip Flash, MB PSRAM, MB Ant. Dimensions, mm
=================== ============ =========== ========= ==== ===============
ESP32-WROOM-32 ESP32-D0WDQ6 4 -- MIFA 18 × 25.5 × 3.1
ESP32-WROOM-32D ESP32-D0WD 4, 8, or 16 -- MIFA 18 × 25.5 × 3.1
ESP32-WROOM-32U ESP32-D0WD 4, 8, or 16 -- U.FL 18 × 19.2 × 3.1
ESP32-SOLO-1 ESP32-S0WD 4 -- MIFA 18 × 25.5 × 3.1
ESP32-WROVER (PCB) ESP32-D0WDQ6 4 8 MIFA 18 × 31.4 × 3.3
ESP32-WROVER (IPEX) ESP32-D0WDQ6 4 8 U.FL 18 × 31.4 × 3.3
ESP32-WROVER-B ESP32-D0WD 4, 8, or 16 8 MIFA 18 × 31.4 × 3.3
ESP32-WROVER-IB ESP32-D0WD 4, 8, or 16 8 U.FL 18 × 31.4 × 3.3
=================== ============ =========== ========= ==== ===============
* ESP32-**D**.. identifies a dual-core chip, ESP32-**S**.. identifies a single-core chip .. only:: esp32s2
* MIFA - Meandered Inverted-F Antenna
* U.FL - U.FL / IPEX antenna connector
* ESP32-WROOM-32x, ESP32-WROVER-B and ESP32-WROVER-IB modules come with 4 MB flash by default but also available with custom flash sizes of 8 MB and 16 MB, see `Espressif Products Ordering Information`_ (PDF)
* `ESP32 Chip Datasheet <https://espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`__ (PDF)
* Initial release of the ESP32-WROVER module had 4 MB of PSRAM
* *ESP32-WROOM-32* was previously called *ESP-WROOM-32*
.. _esp-modules-and-boards-esp32-wroom-32:
ESP32-WROOM-32
--------------
This is a basic and commonly adopted ESP32 module with the ESP32-D0WDQ6 chip on board. It was the first module of the WROOM / WROVER family released to the market.
For key characteristics, see the table in Section :ref:`esp-wroom-solo-wrover-modules`, `Espressif Products Ordering Information`_.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32-front-back.jpg
:align: center
:alt: ESP32-WROOM-32 module (front and back)
:width: 45%
ESP32-WROOM-32 module (front and back)
Documentation
^^^^^^^^^^^^^
* `ESP32-WROOM-32 Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_en.pdf>`__ (PDF)
* `ESP32-WROOM-32 Reference Design <https://www.espressif.com/en/support/download/documents?keys=+ESP32-WROOM-32+Reference>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
.. _esp-modules-and-boards-esp32-wroom-32d-and-u:
ESP32-WROOM-32D / ESP32-WROOM-32U
---------------------------------
Both modules integrate the ESP32-D0WD chip which has a smaller footprint than the chip ESP32-D0WDQ6 installed in :ref:`esp-modules-and-boards-esp32-wroom-32`.
For key characteristics, see the table in Section :ref:`esp-wroom-solo-wrover-modules` and `Espressif Products Ordering Information`_.
ESP32-WROOM-32U is the smallest representative of the whole WROOM / WROVER family of modules.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32d-front-back.jpg
:align: center
:alt: ESP32-WROOM-32D module (front and back)
:width: 45%
ESP32-WROOM-32D module (front and back)
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32u-front-back.jpg
:align: center
:alt: ESP32-WROOM-32U module (front and back)
:width: 45%
ESP32-WROOM-32U module (front and back)
Documentation
^^^^^^^^^^^^^
* `ESP32-WROOM-32D / ESP32-WROOM-32U Datasheet <http://espressif.com/sites/default/files/documentation/esp32-wroom-32d_esp32-wroom-32u_datasheet_en.pdf>`__ (PDF)
.. _esp-modules-and-boards-esp32-solo-1:
ESP32-SOLO-1
------------
This is a simplified version of the ESP32-WROOM-32D module. It contains a single-core ESP32 chip that supports a clock frequency of up to 160 MHz.
For key characteristics, see the table in Section :ref:`esp-wroom-solo-wrover-modules` and `Espressif Products Ordering Information`_.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-solo-1-front-back.jpg
:align: center
:alt: ESP32-SOLO-1 module (front and back)
:width: 45%
ESP32-SOLO-1 module (front and back)
Documentation
^^^^^^^^^^^^^
* `ESP32-SOLO-1 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-solo-1_datasheet_en.pdf>`__ (PDF)
.. _esp-modules-and-boards-esp32-wrover:
ESP32-WROVER series
-------------------
This series consists of a few modifications of ESP32-WROOM-32x modules, which among other upgrades include additional 8 MB SPI PSRAM (pseudo static RAM).
For details, see the table in Section :ref:`esp-wroom-solo-wrover-modules` and `Espressif Products Ordering Information`_.
* **ESP32-WROVER (PCB)** and **ESP32-WROVER (IPEX)** have PSRAM that operates at 1.8 V and supports up to 144 MHz clock rate.
* **ESP32-WROVER-B** and **ESP32-WROVER-IB** have PSRAM that operates at 3.3 V and supports up to 133 MHz clock rate.
The picture below shows an ESP32-WROVER module with a PCB antenna.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wrover.jpg
:align: center
:alt: ESP32-WROVER module (front and back)
:width: 40%
ESP32-WROVER module (front and back)
Documentation
^^^^^^^^^^^^^
* `ESP32-WROVER Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover_datasheet_en.pdf>`__ (PDF)
* `ESP32-WROVER-B Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_en.pdf>`__ (PDF)
* `ESP-PSRAM64 & ESP-PSRAM64H Datasheet <https://www.espressif.com/sites/default/files/documentation/esp-psram64_esp-psram64h_datasheet_en.pdf>`__ (PDF)
* `ESP32-WROVER Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-WROVER+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
ESP32-PICO-D4
-------------
ESP32-PICO-D4 is a System-in-Package (SiP) module, integrating all peripheral components seamlessly, including the following:
- 4 MB flash memory
- crystal oscillator
- filter capacitors
- RF matching circuit
For key characteristics, see `Espressif Products Ordering Information`_.
Documentation
^^^^^^^^^^^^^
* `ESP32-PICO-D4 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`__ (PDF)
Development Boards
==================
Depending on the intended functionality, different development boards feature:
- Access to different ESP32 GPIO pins.
- Different interfaces: USB, JTAG.
- Different peripherals: touchpads, LCD screens, SD card slots, female headers for camera modules, etc.
.. _esp-modules-and-boards-esp32-pico-kit:
ESP32-PICO-KIT V4.1
-------------------
This is the smallest available ESP32-based development board. It features all the components for direct connection to a computer's USB port as well as pin headers for plugging into a mini breadboard.
The board is equipped with the `ESP32-PICO-D4`_ module. With such a module, the creation of a fully functional development board required only a few external components that fit on a PCB as small as 20 x 52 mm. The external components include antenna, LDO, USB-UART bridge, and two buttons for reset and activation of Firmware Download mode.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-pico-kit-v4.1.jpg
:align: center
:alt: ESP32-PICO-KIT V4.1 board
:width: 50%
ESP32-PICO-KIT V4.1 board
Comparing to ESP32-PICO-KIT V4, this version features the CP2102N USB-UART bridge that provides faster transfer rates of up to 3 Mbps.
Documentation
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-pico-kit`
* `ESP32-PICO-KIT V4.1 Schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4.1_schematic.pdf>`_ (PDF)
* `ESP32-PICO-KIT Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-PICO-KIT+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
* `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
Previous Versions
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp32-pico-kit-v4`
* :ref:`esp-modules-and-boards-esp32-pico-kit-v3`
.. _esp-modules-and-boards-esp32-devkitc:
ESP32 DevKitC V4
----------------
This is a small and convenient development board that features:
- :ref:`esp-modules-and-boards-esp32-wroom-32` module
- USB-to-serial programming interface that also provides power supply for the board
- pin headers
- pushbuttons for reset and activation of Firmware Download mode
- a few other components
Comparing to the previous :ref:`esp-modules-and-boards-esp32-devkitc-v2`, this version can integrate :ref:`esp-modules-and-boards-esp32-wrover` module instead of ESP32-WROOM-32 and has the CP2102N chip that supports faster baud rates.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-devkitc-v4-front.jpg
:align: center
:alt: ESP32 DevKitC V4 board
:width: 50%
ESP32 DevKitC V4 board
Documentation
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-devkitc`
* `ESP32-DevKitC schematic <https://dl.espressif.com/dl/schematics/esp32_devkitc_v4-sch-20180607a.pdf>`_ (PDF)
* `ESP32-DevKitC Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-DevKitC-V4+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
* `CP210x USB to UART Bridge VCP Drivers <https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers>`_
Previous Versions
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp32-devkitc-v2`
.. _esp-modules-and-boards-esp-wrover-kit:
ESP-WROVER-KIT V4.1
-------------------
This board features:
- Dual port USB-to-serial converter for programming
- JTAG interface for debugging
- MicroSD card slot
- 3.2” SPI LCD screen
- Female headers for a camera module
- RGB LED for diagnostics
- 32.768 kHz XTAL for internal RTC to operate it in low power modes
Power can be supplied either via USB or via a standard 5 mm power supply jack. A power source can be selected with a jumper and can be turned on/off with a separate switch.
This version of the ESP-WROVER-KIT board integrates the ESP-WROVER-B module that has 8 MB PSRAM for flexible extended storage and data processing capabilities. The board can accommodate other versions of ESP modules described in :ref:`esp-wroom-solo-wrover-modules`.
Comparing to :ref:`esp-modules-and-boards-esp-wrover-kit-v3`, this board has the following design changes:
- JP8, JP11, and JP13 have been combined into a single JP2.
- USB connector has been changed to DIP type and moved to the lower right corner of the board.
- R61 has been changed to a Zero-ohm resistor.
- Some components have been replaced with functional equivalents based on test results and sourcing options, e.g., the EN and Boot buttons.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v4.1-front.jpg
:align: center
:alt: ESP-WROVER-KIT V4.1 board
:width: 90%
ESP-WROVER-KIT V4.1 board
The board in the picture above integrates the ESP32-WROVER-B module.
Documentation
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-wrover-kit`
* `ESP-WROVER-KIT V4.1 Schematic <https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_V4_1.pdf>`__ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* `FTDI Virtual COM Port Drivers`_
Previous Versions
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp-wrover-kit-v3`
* :ref:`esp-modules-and-boards-esp-wrover-kit-v2`
* :ref:`esp-modules-and-boards-esp-wrover-kit-v1`
.. include:: esp32s2/inc/modules-and-boards-esp32s2.rst
Related Documents Related Documents
================= =================
* :doc:`modules-and-boards-previous` * :doc:`modules-and-boards-previous`
.. _FTDI Virtual COM Port Drivers: http://www.ftdichip.com/Drivers/VCP.htm
.. _Espressif Products Ordering Information: https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_en.pdf

2
docs/zh_CN/api-guides/external-ram.rst
View file

@ -114,7 +114,7 @@ ESP-IDF 启动过程中，片外 RAM 被映射到以 0x3F800000 起始的数据
* 片外 RAM 与片外 flash 使用相同的 cache 区域，即频繁在片外 RAM 访问的变量可以像在片上 RAM 中一样快速读取和修改。但访问大块数据时（大于 32 KB），cache 空间可能会不足，访问速度将回落到片外 RAM 访问速度。此外，访问大块数据可以“挤出” flash cache，可能会降低代码执行速度。 * 片外 RAM 与片外 flash 使用相同的 cache 区域，即频繁在片外 RAM 访问的变量可以像在片上 RAM 中一样快速读取和修改。但访问大块数据时（大于 32 KB），cache 空间可能会不足，访问速度将回落到片外 RAM 访问速度。此外，访问大块数据可以“挤出” flash cache，可能会降低代码执行速度。
* 片外 RAM 不可用作任务堆栈存储器。因此 :cpp:func:`xTaskCreate` 及类似函数将始终为堆栈和任务 TCB 分配片上储存器，而 :cpp:func:`xTaskCreateStatic` 类型的函数将检查传递的 Buffer 是否属于片上存储器。但对于不以任何方式直接或间接调用 ROM 中代码的任务，menuconfig 选项 :ref:`CONFIG_SPIRAM_ALLOW_STACK_EXTERNAL_MEMORY` 将消除 `xTaskCreateStatic` 中的检查，从而允许任务堆栈存储在外部 RAM 中。但是，不建议使用此方法。 * 片外 RAM 不可用作任务堆栈存储器。因此 :cpp:func:`xTaskCreate` 及类似函数将始终为堆栈和任务 TCB 分配片上储存器，而 :cpp:func:`xTaskCreateStatic` 类型的函数将检查传递的 Buffer 是否属于片上存储器。
* 默认情况下，片外 RAM 初始化失败将终止 ESP-IDF 启动。如果想禁用此功能，可启用 :ref:`CONFIG_SPIRAM_IGNORE_NOTFOUND` 配置选项。如果启用 :ref:`CONFIG_SPIRAM_ALLOW_BSS_SEG_EXTERNAL_MEMORY`，:ref:`CONFIG_SPIRAM_IGNORE_NOTFOUND` 选项将不能使用，这是因为在链接时，链接器已经向片外 RAM 分配符号。 * 默认情况下，片外 RAM 初始化失败将终止 ESP-IDF 启动。如果想禁用此功能，可启用 :ref:`CONFIG_SPIRAM_IGNORE_NOTFOUND` 配置选项。如果启用 :ref:`CONFIG_SPIRAM_ALLOW_BSS_SEG_EXTERNAL_MEMORY`，:ref:`CONFIG_SPIRAM_IGNORE_NOTFOUND` 选项将不能使用，这是因为在链接时，链接器已经向片外 RAM 分配符号。

2
docs/zh_CN/api-guides/jtag-debugging/configure-wrover.rst
View file

@ -8,7 +8,7 @@
配置硬件 配置硬件
^^^^^^^^ ^^^^^^^^
1. 根据 :doc:`../../hw-reference/get-started-wrover-kit` 文档中 :ref:`get-started-esp-wrover-kit-v4.1-setup-options` 章节所描述的信息，设置 JP8 便可以启用 JTAG 功能。 1. 根据 :doc:`../../hw-reference/esp32/get-started-wrover-kit` 文档中 :ref:`get-started-esp-wrover-kit-v4.1-setup-options` 章节所描述的信息，设置 JP8 便可以启用 JTAG 功能。
2. 检查 ESP32 上用于 JTAG 通信的引脚是否被接到了其它硬件上，这可能会影响 JTAG 的工作。 2. 检查 ESP32 上用于 JTAG 通信的引脚是否被接到了其它硬件上，这可能会影响 JTAG 的工作。

4
docs/zh_CN/api-guides/jtag-debugging/index.rst
View file

@ -127,7 +127,7 @@ JTAG 正常工作至少需要连接的信号线有：TDI，TDO，TCK，TMS 和 G
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
configure-wrover :esp32: configure-wrover
configure-other-jtag configure-other-jtag
@ -146,7 +146,7 @@ JTAG 正常工作至少需要连接的信号线有：TDI，TDO，TCK，TMS 和 G
.. note:: .. note::
上述命令中 ``-f`` 选项后跟的配置文件专用于板载 :ref:`ESP-WROOM-32 <esp-modules-and-boards-esp32-wroom-32>` 模组的 ESP-WROVER-KIT 开发板。您可能需要根据具体使用的硬件而选择或修改不同的配置文件，相关指导请参阅 :ref:`jtag-debugging-tip-openocd-configure-target`。 上述命令中 ``-f`` 选项后跟的配置文件专用于板载 esp32-wroom-32 模组的 ESP-WROVER-KIT 开发板。您可能需要根据具体使用的硬件而选择或修改不同的配置文件，相关指导请参阅 :ref:`jtag-debugging-tip-openocd-configure-target`。
.. highlight:: none .. highlight:: none

2
docs/zh_CN/api-guides/jtag-debugging/tips-and-quirks.rst
View file

@ -116,7 +116,7 @@ OpenOCD 完全支持 ESP-IDF 自带的 FreeRTOS 操作系统，GDB 会将 FreeRT
OpenOCD 需要知道当前使用的 JTAG 适配器的类型，以及其连接的目标板和处理器的类型。为此，请使用位于 OpenOCD 安装目录下 ``share/openocd/scripts/interface`` 和 ``share/openocd/scripts/board`` 文件夹中现有的配置文件。 OpenOCD 需要知道当前使用的 JTAG 适配器的类型，以及其连接的目标板和处理器的类型。为此，请使用位于 OpenOCD 安装目录下 ``share/openocd/scripts/interface`` 和 ``share/openocd/scripts/board`` 文件夹中现有的配置文件。
例如，如果使用板载 ESP-WROOM-32 模组的 ESP-WROVER-KIT 开发板（详见 :ref:`esp-modules-and-boards-esp-wrover-kit-v1`），请使用以下配置文件： 例如，如果使用板载 ESP-WROOM-32 模组的 ESP-WROVER-KIT 开发板，请使用以下配置文件：
* ``board/esp32-wrover-kit-3.3v.cfg`` * ``board/esp32-wrover-kit-3.3v.cfg``

2
docs/zh_CN/api-reference/system/power_management.rst
View file

@ -67,7 +67,7 @@ ESP32 支持下表中所述的三种电源管理锁。
.. only:: esp32 .. only:: esp32
.. include:: ../../en/inc/power_management_esp32.rst .. include:: ../../../en/api-reference/system/inc/power_management_esp32.rst
动态调频和外设驱动 动态调频和外设驱动
------------------------------------------------ ------------------------------------------------

8
docs/zh_CN/get-started-legacy/index.rst
View file

@ -57,10 +57,10 @@ ESP32 采用 40 nm 工艺制成，具有最佳的功耗性能、射频性能、
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
ESP32-DevKitC <../hw-reference/get-started-devkitc> ESP32-DevKitC <../hw-reference/esp32/get-started-devkitc>
ESP-WROVER-KIT <../hw-reference/get-started-wrover-kit> ESP-WROVER-KIT <../hw-reference/esp32/get-started-wrover-kit>
ESP32-PICO-KIT <../hw-reference/get-started-pico-kit> ESP32-PICO-KIT <../hw-reference/esp32/get-started-pico-kit>
ESP32-Ethernet-Kit <../hw-reference/get-started-ethernet-kit> ESP32-Ethernet-Kit <../hw-reference/esp32/get-started-ethernet-kit>
.. _get-started-step-by-step-legacy: .. _get-started-step-by-step-legacy:

8
docs/zh_CN/get-started/index.rst
View file

@ -68,10 +68,10 @@
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
ESP32-DevKitC <../hw-reference/get-started-devkitc> ESP32-DevKitC <../hw-reference/esp32/get-started-devkitc>
ESP-WROVER-KIT <../hw-reference/get-started-wrover-kit> ESP-WROVER-KIT <../hw-reference/esp32/get-started-wrover-kit>
ESP32-PICO-KIT <../hw-reference/get-started-pico-kit> ESP32-PICO-KIT <../hw-reference/esp32/get-started-pico-kit>
ESP32-Ethernet-Kit <../hw-reference/get-started-ethernet-kit> ESP32-Ethernet-Kit <../hw-reference/esp32/get-started-ethernet-kit>
.. _get-started-step-by-step: .. _get-started-step-by-step:

4
docs/zh_CN/hw-reference/get-started-devkitc-v2.rst → docs/zh_CN/hw-reference/esp32/get-started-devkitc-v2.rst
View file

@ -29,7 +29,7 @@ ESP32-DevKitC V2 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp32-devkitc-v2-board-front: .. _get-started-esp32-devkitc-v2-board-front:
.. figure:: ../../_static/esp32-devkitc-v2-functional-overview.png .. figure:: ../../../_static/esp32-devkitc-v2-functional-overview.png
:align: center :align: center
:alt: ESP32-DevKitC V2 开发板 :alt: ESP32-DevKitC V2 开发板
:figclass: align-center :figclass: align-center
@ -74,7 +74,7 @@ ESP32-DevKitC V2 开发板
ESP32-DevKitC V2 上电前，请首先确认开发板完好无损。 ESP32-DevKitC V2 上电前，请首先确认开发板完好无损。
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。 现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
相关文档 相关文档

10
docs/zh_CN/hw-reference/get-started-devkitc.rst → docs/zh_CN/hw-reference/esp32/get-started-devkitc.rst
View file

@ -3,7 +3,7 @@ ESP32-DevKitC V4 入门指南
:link_to_translation:`en: [English]` :link_to_translation:`en: [English]`
本指南介绍了如何开始使用 ESP32-DevKitC V4 开发板。有关 ESP32-DevKitC 其他版本的介绍，请见：:doc:`../hw-reference/index`。 本指南介绍了如何开始使用 ESP32-DevKitC V4 开发板。有关 ESP32-DevKitC 其他版本的介绍，请见：:doc:`../../hw-reference/index`。
准备工作 准备工作
@ -48,7 +48,7 @@ ESP32-DevKitC V4 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp32-devkitc-board-front: .. _get-started-esp32-devkitc-board-front:
.. figure:: ../../_static/esp32-devkitc-functional-overview.jpg .. figure:: ../../../_static/esp32-devkitc-functional-overview.jpg
:align: center :align: center
:alt: ESP32-DevKitC V4（板载 ESP32-WROOM-32） :alt: ESP32-DevKitC V4（板载 ESP32-WROOM-32）
:figclass: align-center :figclass: align-center
@ -110,7 +110,7 @@ ESP32-DevKitC V4（板载 ESP32-WROOM-32）
用户如果认为 C15 可能影响开发板的使用，则可以将 C15 完全移除。C15 在开发板上的具体位置见下图黄色部分。 用户如果认为 C15 可能影响开发板的使用，则可以将 C15 完全移除。C15 在开发板上的具体位置见下图黄色部分。
.. figure:: ../../_static/esp32-devkitc-c15-location.png .. figure:: ../../../_static/esp32-devkitc-c15-location.png
:align: center :align: center
:alt: C15（黄色）在 ESP32-DevKitC V4 开发板上的位置 :alt: C15（黄色）在 ESP32-DevKitC V4 开发板上的位置
:figclass: align-center :figclass: align-center
@ -124,12 +124,12 @@ C15（黄色）在 ESP32-DevKitC V4 开发板上的位置
ESP32-DevKitC V4 上电前，请首先确认开发板完好无损。 ESP32-DevKitC V4 上电前，请首先确认开发板完好无损。
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。 现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
开发板尺寸 开发板尺寸
------------- -------------
.. figure:: ../../_static/esp32-devkitc-dimensions-back.jpg .. figure:: ../../../_static/esp32-devkitc-dimensions-back.jpg
:align: center :align: center
:alt: ESP32-DevKitC 开发板尺寸 -- 仰视图 :alt: ESP32-DevKitC 开发板尺寸 -- 仰视图
:figclass: align-center :figclass: align-center

14
docs/zh_CN/hw-reference/get-started-ethernet-kit-v1.0.rst → docs/zh_CN/hw-reference/esp32/get-started-ethernet-kit-v1.0.rst
View file

@ -24,7 +24,7 @@ ESP32-Ethernet-Kit 是一款来自 `乐鑫 <https://espressif.com>`_ 的开发
.. _get-started-esp32-ethernet-kit-b-v1.0: .. _get-started-esp32-ethernet-kit-b-v1.0:
.. figure:: ../../_static/esp32-ethernet-kit-v1.0.png .. figure:: ../../../_static/esp32-ethernet-kit-v1.0.png
:align: center :align: center
:alt: ESP32-Ethernet-Kit V1.0 :alt: ESP32-Ethernet-Kit V1.0
:figclass: align-center :figclass: align-center
@ -39,7 +39,7 @@ ESP32-Ethernet-Kit 是一款来自 `乐鑫 <https://espressif.com>`_ 的开发
ESP32-Ethernet-Kit 开发板的主要组件和连接方式见下。 ESP32-Ethernet-Kit 开发板的主要组件和连接方式见下。
.. figure:: ../../_static/esp32-ethernet-kit-block-diagram.png .. figure:: ../../../_static/esp32-ethernet-kit-block-diagram.png
:align: center :align: center
:scale: 50% :scale: 50%
:alt: ESP32-Ethernet-Kit 功能框图（点击放大） :alt: ESP32-Ethernet-Kit 功能框图（点击放大）
@ -59,7 +59,7 @@ ESP32-Ethernet-Kit 开发板的主要组件、接口及控制方式见下。
以太网子板（A 板） 以太网子板（A 板）
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
.. figure:: ../../_static/esp32-ethernet-kit-a-v1.0-layout.png .. figure:: ../../../_static/esp32-ethernet-kit-a-v1.0-layout.png
:align: center :align: center
:scale: 80% :scale: 80%
:alt: ESP32-Ethernet-Kit - 以太网子板（A 板）布局 :alt: ESP32-Ethernet-Kit - 以太网子板（A 板）布局
@ -127,7 +127,7 @@ PoE 子板（B 板）具有以下特性：
如需使用 PoE 功能，请用以太网线缆将以太网子板（A 板）上的 **RJ45 端口** 连接至 PoE 的交换机。太网子板（A 板）检测到来自 PoE 子板（B 板）的 5 V 供电后，将从 USB 供电自动切换至 PoE 供电。 如需使用 PoE 功能，请用以太网线缆将以太网子板（A 板）上的 **RJ45 端口** 连接至 PoE 的交换机。太网子板（A 板）检测到来自 PoE 子板（B 板）的 5 V 供电后，将从 USB 供电自动切换至 PoE 供电。
.. figure:: ../../_static/esp32-ethernet-kit-b-v1.0-layout.png .. figure:: ../../../_static/esp32-ethernet-kit-b-v1.0-layout.png
:align: center :align: center
:scale: 80% :scale: 80%
:alt: ESP32-Ethernet-Kit - PoE 子板（B 板） :alt: ESP32-Ethernet-Kit - PoE 子板（B 板）
@ -340,7 +340,7 @@ ESP32-Ethernet-Kit 上电前，请首先确认开发板完好无损。
正式开始开发 正式开始开发
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。 现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
如需使用较早 GNU Make 编译系统，则请参考 :ref:`get-started-step-by-step` 章节。 如需使用较早 GNU Make 编译系统，则请参考 :ref:`get-started-step-by-step` 章节。
@ -360,8 +360,8 @@ ESP32-Ethernet-Kit 上电前，请首先确认开发板完好无损。
* `ESP32-Ethernet-Kit V1.0 PoE 子板（B 板）原理图`_ (PDF) * `ESP32-Ethernet-Kit V1.0 PoE 子板（B 板）原理图`_ (PDF)
* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_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) * `《ESP32-WROVER-B 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_cn.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index` * :doc:`../../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`
.. _ESP32-Ethernet-Kit V1.0 以太网子板（A 板）原理图: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_A_V1.0_20190517.pdf .. _ESP32-Ethernet-Kit V1.0 以太网子板（A 板）原理图: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_A_V1.0_20190517.pdf
.. _ESP32-Ethernet-Kit V1.0 PoE 子板（B 板）原理图: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_B_V1.0_20190517.pdf .. _ESP32-Ethernet-Kit V1.0 PoE 子板（B 板）原理图: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_B_V1.0_20190517.pdf

1
docs/zh_CN/hw-reference/esp32/get-started-ethernet-kit.rst Normal file
View file

@ -0,0 +1 @@
.. include:: ../../../en/hw-reference/esp32/get-started-ethernet-kit.rst

8
docs/zh_CN/hw-reference/get-started-pico-kit-v3.rst → docs/zh_CN/hw-reference/esp32/get-started-pico-kit-v3.rst
View file

@ -2,7 +2,7 @@ ESP32-PICO-KIT V3 入门指南
======================================= =======================================
:link_to_translation:`en:[English]` :link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP32-PICO-KIT V3 迷你开发板。有关 ESP32-PICO-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。 本指南介绍了如何开始使用 ESP32-PICO-KIT V3 迷你开发板。有关 ESP32-PICO-KIT 其他版本的介绍，请见：:doc:`../../hw-reference/index`。
准备工作 准备工作
@ -30,7 +30,7 @@ ESP32-PICO-KIT 集成了 USB 转 UART 桥接电路，允许开发人员直接通
ESP32-PICO-KIT V3 开发板的主要组件、接口及控制方式见下。 ESP32-PICO-KIT V3 开发板的主要组件、接口及控制方式见下。
.. figure:: ../../_static/esp32-pico-kit-v3-layout.jpg .. figure:: ../../../_static/esp32-pico-kit-v3-layout.jpg
:align: center :align: center
:alt: ESP32-PICO-KIT V3 开发板布局 :alt: ESP32-PICO-KIT V3 开发板布局
:figclass: align-center :figclass: align-center
@ -68,7 +68,7 @@ ESP32-PICO-KIT 开发板的主要组件描述见下表。
ESP32-PICO-KIT V3 上电前，请首先确认开发板完好无损。 ESP32-PICO-KIT V3 上电前，请首先确认开发板完好无损。
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。 现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
相关文档 相关文档
@ -76,6 +76,6 @@ ESP32-PICO-KIT V3 上电前，请首先确认开发板完好无损。
* `ESP32-PICO-KIT V3 原理图 <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v3_schematic.pdf>`_ (PDF) * `ESP32-PICO-KIT V3 原理图 <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v3_schematic.pdf>`_ (PDF)
* `《ESP32-PICO-D4 技术规格书》 <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_cn.pdf>`_ (PDF) * `《ESP32-PICO-D4 技术规格书》 <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_cn.pdf>`_ (PDF)
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`

14
docs/zh_CN/hw-reference/get-started-pico-kit.rst → docs/zh_CN/hw-reference/esp32/get-started-pico-kit.rst
View file

@ -2,7 +2,7 @@ ESP32-PICO-KIT V4/V4.1 入门指南
======================================================= =======================================================
:link_to_translation:`en:[English]` :link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP32-PICO-KIT V4 / V4.1 迷你开发板。有关 ESP32-PICO-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。 本指南介绍了如何开始使用 ESP32-PICO-KIT V4 / V4.1 迷你开发板。有关 ESP32-PICO-KIT 其他版本的介绍，请见：:doc:`../../hw-reference/index`。
本指南仅适用于 ESP32-PICO-KIT V4 和 V4.1。ESP32-PICO-KIT V4.1 与 V4 的最大差别在于桥接器，其中 V4 搭载的 CP2102 USB-to-UART 桥接器最高速率为 1 Mbps，V4.1 搭载的 CP2102N 桥接器最高传输速率 3 Mbps。 本指南仅适用于 ESP32-PICO-KIT V4 和 V4.1。ESP32-PICO-KIT V4.1 与 V4 的最大差别在于桥接器，其中 V4 搭载的 CP2102 USB-to-UART 桥接器最高速率为 1 Mbps，V4.1 搭载的 CP2102N 桥接器最高传输速率 3 Mbps。
@ -43,7 +43,7 @@ ESP32-PICO-KIT 集成了 USB 转 UART 桥接电路，允许开发人员直接通
ESP32-PICO-KIT 开发板的主要组件和连接方式见下。 ESP32-PICO-KIT 开发板的主要组件和连接方式见下。
.. figure:: ../../_static/esp32-pico-kit-v4-functional-block-diagram.png .. figure:: ../../../_static/esp32-pico-kit-v4-functional-block-diagram.png
:align: center :align: center
:alt: ESP32-PICO-KIT 功能框图 :alt: ESP32-PICO-KIT 功能框图
:figclass: align-center :figclass: align-center
@ -58,7 +58,7 @@ ESP32-PICO-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-pico-kit-v4-board-front: .. _get-started-pico-kit-v4-board-front:
.. figure:: ../../_static/esp32-pico-kit-v4.1-f-layout.jpeg .. figure:: ../../../_static/esp32-pico-kit-v4.1-f-layout.jpeg
:align: center :align: center
:alt: ESP32-PICO-KIT 开发板布局 :alt: ESP32-PICO-KIT 开发板布局
:figclass: align-center :figclass: align-center
@ -192,7 +192,7 @@ No. Name Type Function
ESP32-PICO-KIT 上电前，请首先确认开发板完好无损。 ESP32-PICO-KIT 上电前，请首先确认开发板完好无损。
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。 现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
开发板尺寸 开发板尺寸
@ -200,14 +200,14 @@ ESP32-PICO-KIT 上电前，请首先确认开发板完好无损。
ESP32-PICO-KIT 的尺寸为 52 x 20.3 x 10 mm (2.1" x 0.8" x 0.4")。 ESP32-PICO-KIT 的尺寸为 52 x 20.3 x 10 mm (2.1" x 0.8" x 0.4")。
.. figure:: ../../_static/esp32-pico-kit-v4.1-dimensions-back.jpg .. figure:: ../../../_static/esp32-pico-kit-v4.1-dimensions-back.jpg
:align: center :align: center
:alt: ESP32-PICO-KIT 尺寸图 -- 背面 :alt: ESP32-PICO-KIT 尺寸图 -- 背面
:figclass: align-center :figclass: align-center
ESP32-PICO-KIT 尺寸图 -- 背面 ESP32-PICO-KIT 尺寸图 -- 背面
.. figure:: ../../_static/esp32-pico-kit-v4-dimensions-side.jpg .. figure:: ../../../_static/esp32-pico-kit-v4-dimensions-side.jpg
:align: center :align: center
:alt: ESP32-PICO-KIT V4 尺寸图 -- 侧面 :alt: ESP32-PICO-KIT V4 尺寸图 -- 侧面
:figclass: align-center :figclass: align-center
@ -224,7 +224,7 @@ ESP32-PICO-KIT 的尺寸为 52 x 20.3 x 10 mm (2.1" x 0.8" x 0.4")。
* `ESP32-PICO-KIT V4.1 原理图 <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4.1_schematic.pdf>`_ (PDF) * `ESP32-PICO-KIT V4.1 原理图 <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4.1_schematic.pdf>`_ (PDF)
* `ESP32-PICO-KIT 参考设计 <https://www.espressif.com/zh-hans/support/download/documents/development-board?keys=esp32-pico-kit+参考设计>`_ ，内含 OrCAD 原理图、PCB 布局、Gerbers 和 BOM 表。 * `ESP32-PICO-KIT 参考设计 <https://www.espressif.com/zh-hans/support/download/documents/development-board?keys=esp32-pico-kit+参考设计>`_ ，内含 OrCAD 原理图、PCB 布局、Gerbers 和 BOM 表。
* `《ESP32-PICO-D4 技术规格书》 <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_cn.pdf>`_ (PDF) * `《ESP32-PICO-D4 技术规格书》 <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_cn.pdf>`_ (PDF)
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`
.. toctree:: .. toctree::

28
docs/zh_CN/hw-reference/get-started-wrover-kit-v2.rst → docs/zh_CN/hw-reference/esp32/get-started-wrover-kit-v2.rst
View file

@ -2,7 +2,7 @@ ESP-WROVER-KIT V2 入门指南
=========================================== ===========================================
:link_to_translation:`en:[English]` :link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V2 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。 本指南介绍了如何开始使用 ESP-WROVER-KIT V2 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../../hw-reference/index`。
准备工作 准备工作
@ -39,7 +39,7 @@ ESP-WROVER-KIT 可选贴以下 ESP32 模组：
ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。 ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png .. figure:: ../../../_static/esp-wrover-kit-block-diagram.png
:align: center :align: center
:alt: ESP-WROVER-KIT 功能框图 :alt: ESP-WROVER-KIT 功能框图
:figclass: align-center :figclass: align-center
@ -54,7 +54,7 @@ ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v2-board-front: .. _get-started-esp-wrover-kit-v2-board-front:
.. figure:: ../../_static/esp-wrover-kit-v2-layout-front.png .. figure:: ../../../_static/esp-wrover-kit-v2-layout-front.png
:align: center :align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 俯视图 :alt: ESP-WROVER-KIT 开发板布局 -- 俯视图
:figclass: align-center :figclass: align-center
@ -63,7 +63,7 @@ ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v2-board-back: .. _get-started-esp-wrover-kit-v2-board-back:
.. figure:: ../../_static/esp-wrover-kit-v2-layout-back.png .. figure:: ../../../_static/esp-wrover-kit-v2-layout-back.png
:align: center :align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 仰视图 :alt: ESP-WROVER-KIT 开发板布局 -- 仰视图
:figclass: align-center :figclass: align-center
@ -169,7 +169,7 @@ USB 供电 使能 UART 通信
正式开始开发 正式开始开发
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。 现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
相关文档 相关文档
@ -179,16 +179,16 @@ USB 供电 使能 UART 通信
* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (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-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) * `《ESP32-WROOM-32 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_cn.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index` * :doc:`../../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`
.. |jp1-sd_io2| image:: ../../_static/wrover-jp1-sd_io2.png .. |jp1-sd_io2| image:: ../../../_static/wrover-jp1-sd_io2.png
.. |jp1-both| image:: ../../_static/wrover-jp1-both.png .. |jp1-both| image:: ../../../_static/wrover-jp1-both.png
.. |jp7-ext_5v| image:: ../../_static/wrover-jp7-ext_5v.png .. |jp7-ext_5v| image:: ../../../_static/wrover-jp7-ext_5v.png
.. |jp7-usb_5v| image:: ../../_static/wrover-jp7-usb_5v.png .. |jp7-usb_5v| image:: ../../../_static/wrover-jp7-usb_5v.png
.. |jp8| image:: ../../_static/wrover-jp8.png .. |jp8| image:: ../../../_static/wrover-jp8.png
.. |jp11-tx-rx| image:: ../../_static/wrover-jp11-tx-rx.png .. |jp11-tx-rx| image:: ../../../_static/wrover-jp11-tx-rx.png
.. |jp14| image:: ../../_static/wrover-jp14.png .. |jp14| image:: ../../../_static/wrover-jp14.png
.. _ESP-WROVER-KIT V2 原理图: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-2.pdf .. _ESP-WROVER-KIT V2 原理图: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-2.pdf

24
docs/zh_CN/hw-reference/get-started-wrover-kit-v3.rst → docs/zh_CN/hw-reference/esp32/get-started-wrover-kit-v3.rst
View file

@ -2,7 +2,7 @@ ESP-WROVER-KIT V3 入门指南
======================================= =======================================
:link_to_translation:`en:[English]` :link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V3 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。 本指南介绍了如何开始使用 ESP-WROVER-KIT V3 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../../hw-reference/index`。
准备工作 准备工作
@ -39,7 +39,7 @@ ESP-WROVER-KIT 可选贴以下 ESP32 模组：
ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。 ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png .. figure:: ../../../_static/esp-wrover-kit-block-diagram.png
:align: center :align: center
:alt: ESP-WROVER-KIT 功能框图 :alt: ESP-WROVER-KIT 功能框图
:figclass: align-center :figclass: align-center
@ -54,7 +54,7 @@ ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v3-board-front: .. _get-started-esp-wrover-kit-v3-board-front:
.. figure:: ../../_static/esp-wrover-kit-v3-layout-front.jpg .. figure:: ../../../_static/esp-wrover-kit-v3-layout-front.jpg
:align: center :align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 俯视图 :alt: ESP-WROVER-KIT 开发板布局 -- 俯视图
:figclass: align-center :figclass: align-center
@ -63,7 +63,7 @@ ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v3-board-back: .. _get-started-esp-wrover-kit-v3-board-back:
.. figure:: ../../_static/esp-wrover-kit-v3-layout-back.jpg .. figure:: ../../../_static/esp-wrover-kit-v3-layout-back.jpg
:align: center :align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 仰视图 :alt: ESP-WROVER-KIT 开发板布局 -- 仰视图
:figclass: align-center :figclass: align-center
@ -352,7 +352,7 @@ USB 供电 使能 UART 通信
正式开始开发 正式开始开发
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。 现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
相关文档 相关文档
----------------- -----------------
@ -361,14 +361,14 @@ USB 供电 使能 UART 通信
* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (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-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) * `《ESP32-WROOM-32 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_cn.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index` * :doc:`../../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`
.. |jp7-ext_5v| image:: ../../_static/esp-wrover-kit-v3-jp7-ext_5v.png .. |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 .. |jp7-usb_5v| image:: ../../../_static/esp-wrover-kit-v3-jp7-usb_5v.png
.. |jp8| image:: ../../_static/esp-wrover-kit-v3-jp8.png .. |jp8| image:: ../../../_static/esp-wrover-kit-v3-jp8.png
.. |jp11-tx-rx| image:: ../../_static/esp-wrover-kit-v3-jp11-tx-rx.png .. |jp11-tx-rx| image:: ../../../_static/esp-wrover-kit-v3-jp11-tx-rx.png
.. |jp14| image:: ../../_static/esp-wrover-kit-v3-jp14.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 .. _ESP-WROVER-KIT V3 原理图: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_SCH-3.pdf

24
docs/zh_CN/hw-reference/get-started-wrover-kit.rst → docs/zh_CN/hw-reference/esp32/get-started-wrover-kit.rst
View file

@ -2,7 +2,7 @@ ESP-WROVER-KIT V4.1 入门指南
========================================= =========================================
:link_to_translation:`en:[English]` :link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V4.1 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../hw-reference/index`。 本指南介绍了如何开始使用 ESP-WROVER-KIT V4.1 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../../hw-reference/index`。
准备工作 准备工作
@ -40,7 +40,7 @@ ESP-WROVER-KIT 开发板已集成了如下组件：
ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。 ESP-WROVER-KIT 开发板的主要组件和连接方式如下图所示。
.. figure:: ../../_static/esp-wrover-kit-block-diagram.png .. figure:: ../../../_static/esp-wrover-kit-block-diagram.png
:align: center :align: center
:alt: ESP-WROVER-KIT 功能框图 :alt: ESP-WROVER-KIT 功能框图
:figclass: align-center :figclass: align-center
@ -55,7 +55,7 @@ ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v4.1-board-front: .. _get-started-esp-wrover-kit-v4.1-board-front:
.. figure:: ../../_static/esp-wrover-kit-v4.1-layout-front.png .. figure:: ../../../_static/esp-wrover-kit-v4.1-layout-front.png
:align: center :align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 俯视图 :alt: ESP-WROVER-KIT 开发板布局 -- 俯视图
:figclass: align-center :figclass: align-center
@ -64,7 +64,7 @@ ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
.. _get-started-esp-wrover-kit-v4.1-board-back: .. _get-started-esp-wrover-kit-v4.1-board-back:
.. figure:: ../../_static/esp-wrover-kit-v4.1-layout-back.png .. figure:: ../../../_static/esp-wrover-kit-v4.1-layout-back.png
:align: center :align: center
:alt: ESP-WROVER-KIT 开发板布局 -- 仰视图 :alt: ESP-WROVER-KIT 开发板布局 -- 仰视图
:figclass: align-center :figclass: align-center
@ -420,7 +420,7 @@ USB 供电 使能 UART 通信
正式开始开发 正式开始开发
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。 现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
相关文档 相关文档
@ -429,14 +429,14 @@ USB 供电 使能 UART 通信
* `ESP-WROVER-KIT V4.1 原理图`_ (PDF) * `ESP-WROVER-KIT V4.1 原理图`_ (PDF)
* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_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) * `《ESP32-WROVER-B 技术规格书》 <https://espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_cn.pdf>`_ (PDF)
* :doc:`../api-guides/jtag-debugging/index` * :doc:`../../api-guides/jtag-debugging/index`
* :doc:`../hw-reference/index` * :doc:`../../hw-reference/index`
.. |jp7-ext_5v| image:: ../../_static/esp-wrover-kit-v4.1-jp7-ext_5v.jpg .. |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 .. |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-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 .. |jp2-tx-rx| image:: ../../../_static/esp-wrover-kit-v4.1-jp2-tx-rx.jpg
.. |jp14| image:: ../../_static/esp-wrover-kit-v4.1-jp14.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 .. _ESP-WROVER-KIT V4.1 原理图: https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_V4_1.pdf

294
docs/zh_CN/hw-reference/esp32/inc/modules-and-boards-esp32.rst Normal file
View file

@ -0,0 +1,294 @@
.. _esp-wroom-solo-wrover-modules:
WROOM、SOLO、WROVER 和 PICO 系列模组
=====================================
WROOM、SOLO、WROVER 和 PICO 系列模组内置 ESP32 芯片并集成了晶振、天线匹配电路等重要组件，可直接集成到终端产品中。如果再结合一些其他组件，例如编程接口、Bootstrapping 电阻和排针，您就可以体验 ESP32 的强大功能了。
下表总结了上述系列模组的主要特点，详细信息见后续章节。
+---------------------+--------------+-------------+-------------+------+-----------------+
| 模组 | 芯片 | Flash (MB) | PSRAM (MB) | 天线 | 尺寸 (mm) |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROOM-32 | ESP32-D0WDQ6 | 4 | – | MIFA | 18 × 25.5 × 3.1 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROOM-32D | ESP32-D0WD | 4、8 或 16 | – | MIFA | 18 × 25.5 × 3.1 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROOM-32U | ESP32-D0WD | 4、8 或 16 | – | U.FL | 18 × 19.2 × 3.1 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-SOLO-1 | ESP32-S0WD | 4 | – | MIFA | 18 × 25.5 × 3.1 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROVER (PCB) | ESP32-D0WDQ6 | 4 | 8 | MIFA | 18 × 31.4 × 3.3 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROVER (IPEX) | ESP32-D0WDQ6 | 4 | 8 | U.FL | 18 × 31.4 × 3.3 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROVER-B | ESP32-D0WD | 4、8 或 16 | 8 | MIFA | 18 × 31.4 × 3.3 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROVER-IB | ESP32-D0WD | 4、8 或 16 | 8 | U.FL | 18 × 31.4 × 3.3 |
+---------------------+--------------+-------------+-------------+------+-----------------+
* ESP32-**D**.. 代表双核芯片，ESP32-**S**.. 代表单核芯片；
* MIFA - 蛇形倒 F 天线；
* U.FL - U.FL/IPEX 天线连接器；
* ESP32-WROOM-32x、ESP32-WROVER-B 和 ESP32-WROVER-IB 模组默认内置 4 MB flash，客户可定制 8 MB 和 16 MB flash，详情见 `乐鑫产品订购信息`_ (PDF) 和《`ESP32 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_》(PDF)；
* 最初发布的 ESP32-WROVER 模组内置 4 MB PSRAM；
* *ESP-WROOM-32* 是 *ESP32-WROOM-32* 的曾用名。
.. _esp-modules-and-boards-esp32-wroom-32:
ESP32-WROOM-32 模组
--------------------
ESP32-WROOM-32 模组是 WROOM/WROVER 系列最先发布的模组，内置 ESP32-D0WDQ6 芯片，是一款基础且常用的 ESP32 模组。
有关该模组的详细信息，请查看 :ref:`esp-wroom-solo-wrover-modules` 章节中的表格。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32-front-back.jpg
:align: center
:alt: ESP32-WROOM-32 module (front and back)
:width: 45%
ESP32-WROOM-32 模组（正反面图）
相关文档
^^^^^^^^^^^^^
* 《`ESP32-WROOM-32 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_cn.pdf>`_》(PDF)；
* `ESP32-WROOM-32 参考设计 <https://www.espressif.com/zh-hans/support/download/documents?keys=ESP32-WROOM-32+%E5%8F%82%E8%80%83%E8%AE%BE%E8%AE%A1>`_，包括原理图（由 OrCAD Capture 绘制）、PCB 布局（由 Mentor PADS 绘制）、GERBER 文件和 BOM 清单。
.. _esp-modules-and-boards-esp32-wroom-32d-and-u:
ESP32-WROOM-32D/ESP32-WROOM-32U 模组
--------------------------------------
两款模组均集成了 ESP32-D0WD 芯片，与 :ref:`esp-modules-and-boards-esp32-wroom-32` 集成的 ESP32-D0WDQ6 相比，ESP32-D0WD 芯片的封装更小，在 PCB 上占用的面积更小。
有关这两款模组的详细信息，请查看 :ref:`esp-wroom-solo-wrover-modules` 中的表格和 `乐鑫产品订购信息`_。
ESP32-WROOM-32U 是整个 WROOM/WROVER 模组系列中最小的模组。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32d-front-back.jpg
:align: center
:alt: ESP32-WROOM-32D module (front and back)
:width: 45%
ESP32-WROOM-32D 模组（正反面图）
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32u-front-back.jpg
:align: center
:alt: ESP32-WROOM-32U module (front and back)
:width: 45%
ESP32-WROOM-32U 模组（正反面图）
相关文档
^^^^^^^^^^^^^
* 《`ESP32-WROOM-32D/ESP32-WROOM-32U 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32d_esp32-wroom-32u_datasheet_cn.pdf>`_》(PDF)
.. _esp-modules-and-boards-esp32-solo-1:
ESP32-SOLO-1 模组
-----------------
ESP32-SOLO-1 模组是 ESP32-WROOM-32D 模组的简化版本，内置一个 ESP32 单核芯片，支持高达 160 MHz 的时钟频率。
有关此模组的详细信息，请查看 :ref:`esp-wroom-solo-wrover-modules` 章节中的表格和 `乐鑫产品订购信息`_。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-solo-1-front-back.jpg
:align: center
:alt: ESP32-SOLO-1 module (front and back)
:width: 45%
ESP32-SOLO-1 模组（正反面图）
相关文档
^^^^^^^^^^^^^
* 《`ESP32-SOLO-1 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-solo-1c_datasheet_cn.pdf>`__》(PDF)
.. _esp-modules-and-boards-esp32-wrover:
ESP32-WROVER 系列模组
-------------------------
ESP32-WROVER 系列模组在 ESP32-WROOM-32x 模组的基础上进行了一些修改，其中包含一些功能升级，并新增 8 MB SPI PSRAM（伪静态 RAM）。
有关该模组的详细信息，请查看 :ref:`esp-wroom-solo-wrover-modules` 章节中的表格和 `乐鑫产品订购信息`_。
* **ESP32-WROVER (PCB)** 模组和 **ESP32-WROVER (IPEX)** 模组内置 1.8 V PSRAM，支持 144 MHz 时钟频率。
* **ESP32-WROVER-B** 模组和 **ESP32-WROVER-IB** 模组内置 3.3 V PSRAM，支持 133 MHz 时钟频率。
下图为配备有 PCB 天线的 ESP32-WROVER 模组：
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wrover.jpg
:align: center
:alt: ESP32-WROVER module (front and back)
:width: 40%
ESP32-WROVER 模组（正反面图）
相关文档
^^^^^^^^^^^^^
* 《`ESP32-WROVER 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32_wrover_datasheet_cn.pdf>`__》(PDF)
* 《`ESP32-WROVER-B 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_cn.pdf>`__》(PDF)
* 《`ESP-PSRAM64 & ESP-PSRAM64H 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp-psram64_esp-psram64h_datasheet_cn.pdf>`__》(PDF)
* `ESP32-WROVER 参考设计 <https://www.espressif.com/zh-hans/support/download/documents?keys=ESP32-WROVER+%E5%8F%82%E8%80%83%E8%AE%BE%E8%AE%A1>`_ 包含原理图（由 OrCAD Capture 绘制）、PCB 布局（由 Mentor PADS 绘制）、GERBER 文件和 BOM 清单。
ESP32-PICO-D4 模组
------------------
ESP32-PICO-D4 模组是一款 SiP 模组，无缝集成了所有外设，包括：
- 4 MB flash
- 晶振
- 滤波电容
- RF 匹配电路
有关该模组的详细信息，请查看 `乐鑫产品订购信息`_。
相关文档
^^^^^^^^^^^^^
* 《`ESP32-PICO-D4 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_cn.pdf>`__》(PDF)
ESP32 开发板
==================
ESP32 系列开发板功能各异，具体有以下不同点：
- 访问的 ESP32 GPIO 管脚不同；
- 接口不同，包括 USB 和 JTAG；
- 外设不同，包括 TouchPad、LCD 显示屏、SD 卡槽和相机模组排母等。
.. _esp-modules-and-boards-esp32-pico-kit:
ESP32-PICO-KIT V4.1 开发板
---------------------------
ESP32-PICO-KIT V4.1 开发板是基于 ESP32 的最小开发板，内置连接至电脑 USB 端口所需的所有组件，同时设有排针，可直接将此开发板插接于迷你面包板。
ESP32-PICO-KIT V4.1 开发板集成了 `ESP32-PICO-D4 模组`_，只需在 PCB (20 x 52 mm) 上添加少许外部组件即可构成一个功能齐全的开发板。这部分外部组件包括天线、LDO、USB 至 UART 桥接器、一个重置按钮和一个固件下载模式激活按钮。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-pico-kit-v4.1.jpg
:align: center
:alt: ESP32-PICO-KIT V4.1 board
:width: 50%
ESP32-PICO-KIT V4.1 开发板
与 ESP32-PICO-KIT V4 相比，ESP32-PICO-KIT V4.1 开发板支持 CP2102N USB 至 UART 桥接器，可提供高达 3 Mbps 的传输速率。
相关文档
^^^^^^^^^^^^^
* :doc:`../../hw-reference/esp32/get-started-pico-kit`
* `ESP32-PICO-KIT V4.1 原理图 <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4.1_schematic.pdf>`_ (PDF)
* `ESP32-PICO-KIT 参考设计 <https://www.espressif.com/zh-hans/support/download/documents?keys=ESP32-PICO-KIT+%E5%8F%82%E8%80%83%E8%AE%BE%E8%AE%A1>`_，包含原理图（由 OrCAD Capture 绘制）、PCB 布局（由 Mentor PADS 绘制）、GERBER 文件和 BOM 清单。
* 《`ESP32-PICO-D4 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_cn.pdf>`_》(PDF)
较早版本开发板
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp32-pico-kit-v4`
* :ref:`esp-modules-and-boards-esp32-pico-kit-v3`
.. _esp-modules-and-boards-esp32-devkitc:
ESP32 DevKitC V4 开发板
------------------------------
ESP32 DevKitC V4 开发板是一款小巧实用的开发板，具备以下特色功能：
- 集成了 :ref:`esp-modules-and-boards-esp32-wroom-32`
- USB 转串口编程接口同时可为开发板供电
- 设有排针
- 设有重置按钮和固件下载模式激活按钮
- 以及其他组件
与较早版本的 :ref:`esp-modules-and-boards-esp32-devkitc-v2` 相比，ESP32 DevKitC V4 开发板集成了 :ref:`esp-modules-and-boards-esp32-wrover` （而非 ESP32-WROOM-32 模组），同时内置 CP2102N 芯片，支持更高波特率。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-devkitc-v4-front.jpg
:align: center
:alt: ESP32 DevKitC V4 board
:width: 50%
ESP32 DevKitC V4 开发板
相关文档
^^^^^^^^^^^^^
* :doc:`../../hw-reference/esp32/get-started-devkitc`
* `ESP32-DevKitC 原理图 <https://dl.espressif.com/dl/schematics/esp32_devkitc_v4-sch-20180607a.pdf>`_ (PDF)
* `ESP32-DevKitC 参考设计 <https://www.espressif.com/zh-hans/support/download/documents?keys=ESP32-DevKitC+%E5%8F%82%E8%80%83%E8%AE%BE%E8%AE%A1>`_，包含原理图（由 OrCAD Capture 绘制）、PCB 布局（由 Mentor PADS 绘制）、GERBER 文件和 BOM 清单。
* `CP210x USB 至 UART 桥 VCP 驱动器 <https://cn.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers>`_
较早版本开发板
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp32-devkitc-v2`
.. _esp-modules-and-boards-esp-wrover-kit:
ESP-WROVER-KIT V4.1 开发板
-------------------------------
ESP-WROVER-KIT V4.1 开发板具备以下特色功能：
- USB 转双串口转换器（用于后续编程）
- JTAG 调试接口
- MicroSD 卡槽
- 3.2” SPI LCD 显示屏
- 相机模组排母
- RGB 发光二极管
- 支持 32.768 kHz 晶振输入用于 RTC 及低功耗模式操作
ESP-WROVER-KIT V4.1 开发板支持 USB 供电或标准的 5 毫米电源插座供电，可使用跳线选择电源，或使用独立的开关控制电源。
ESP-WROVER-KIT V4.1 开发板集成了 ESP-WROVER-B 模组，该模组集成了 8 MB PSRAM，方便用户灵活扩展存储空间，增强数据处理能力。ESP-WROVER-KIT V4.1 开发板还可以集成 :ref:`esp-wroom-solo-wrover-modules` 中所述的 ESP 其他版本模组。
与 :ref:`esp-modules-and-boards-esp-wrover-kit-v3` 相比，ESP-WROVER-KIT V4.1 开发板在设计上有以下改动：
- JP8、JP11 和 JP13 合并成了一个 JP2。
- USB 连接器的固定脚改为直插式，并移至板子右下角。
- R61 已变更为零欧姆电阻。
- 基于测试结果和采购选择，部分组件已由功能对等组件替代，例如 EN 和 Boot 按钮。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v4.1-front.jpg
:align: center
:alt: ESP-WROVER-KIT V4.1 board
:width: 90%
ESP-WROVER-KIT V4.1 开发板
上图所示开发板集成了 ESP32-WROVER-B 模组。
相关文档
^^^^^^^^^^^^^
* :doc:`../../hw-reference/esp32/get-started-wrover-kit`
* `ESP-WROVER-KIT V4.1 原理图 <https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_V4_1.pdf>`__ (PDF)
* :doc:`../../../api-guides/jtag-debugging/index`
* `FTDI 虚拟 COM 端口驱动`_
较早版本开发板
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp-wrover-kit-v3`
* :ref:`esp-modules-and-boards-esp-wrover-kit-v2`
* :ref:`esp-modules-and-boards-esp-wrover-kit-v1`
相关文档
=================
* :doc:`modules-and-boards-previous`
.. _FTDI 虚拟 COM 端口驱动: http://www.ftdichip.com/Drivers/VCP.htm
.. _乐鑫产品订购信息: https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_cn.pdf

1
docs/zh_CN/hw-reference/esp32/inc/modules-and-boards-previous-esp32.rst Normal file
View file

@ -0,0 +1 @@
.. include:: ../../en/hw-reference/esp32/inc/modules-and-boards-previous-esp32.rst

1
docs/zh_CN/hw-reference/esp32s2/inc/modules-and-boards-esp32s2.rst Normal file
View file

@ -0,0 +1 @@
.. include:: ../../en/hw-reference/esp32s2/inc/modules-and-boards-esp32s2.rst

1
docs/zh_CN/hw-reference/esp32s2/inc/modules-and-boards-previous-esp32s2.rst Normal file
View file

@ -0,0 +1 @@
.. include:: ../../en/hw-reference/esp32s2/inc/modules-and-boards-previous-esp32s2.rst

409
docs/zh_CN/hw-reference/get-started-ethernet-kit.rst
View file

@ -1,409 +0,0 @@
ESP32-Ethernet-Kit V1.1 入门指南
=================================
:link_to_translation:`en:[English]`
本指南将介绍 ESP32-Ethernet-Kit 开发板的配置以及相关功能的使用。
:ref:`ESP32-Ethernet-Kit <get-started-esp32-ethernet-kit-v1.1>` 是一款以太网转 Wi-Fi 开发板，可为以太网设备赋予 Wi-Fi 连接功能。为了提供更灵活的电源选项，ESP32-Ethernet-Kit 同时也支持以太网供电 (PoE)。
准备工作
--------
* :ref:`ESP32-Ethernet-Kit V1.1 开发板 <get-started-esp32-ethernet-kit-v1.1>`
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 Mac OS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
----
ESP32-Ethernet-Kit 是一款来自 `乐鑫 <https://espressif.com>`_ 的开发板。
它由 :ref:`以太网母板（A板）<get-started-esp32-ethernet-kit-a-v1.1-layout>` 和 `PoE 子板（B 板）`_ 两部分组成。其中 :ref:`以太网母板（A板）<get-started-esp32-ethernet-kit-a-v1.1-layout>` 集成蓝牙 / Wi-Fi 双模 ESP32-WROVER-B 模组和单端口 10/100 Mbps 快速以太网收发器 (PHY) IP101GRI。`PoE 子板（B 板）`_ 提供以太网供电功能。ESP32-Ethernet-Kit 的 A 板可在不连接 B 板的情况下独立工作。
.. _get-started-esp32-ethernet-kit-v1.1:
.. figure:: ../../_static/esp32-ethernet-kit-v1.1.png
:align: center
:alt: ESP32-Ethernet-Kit V1.1
:figclass: align-center
ESP32-Ethernet-Kit V1.1
为了实现程序下载和监控，A 板还集成了一款先进多协议 USB 桥接器（FTDI FT2232H 芯片）。FTDI FT2232H 芯片使得开发人员无需额外的 JTAG 适配器，通过 USB 桥接器使用 JTAG 接口便可对 ESP32 直接进行调试。
功能概述
---------
ESP32-Ethernet-Kit 开发板的主要组件和连接方式如下。
.. figure:: ../../_static/esp32-ethernet-kit-v1.1-block-diagram.png
:align: center
:scale: 60%
:alt: ESP32-Ethernet-Kit 功能框图（点击放大）
:figclass: align-center
ESP32-Ethernet-Kit 功能框图（点击放大）
功能说明
--------
有关 ESP32-Ethernet-Kit 开发板的主要组件、接口及控制方式，请见下方的图片和表格。
.. _get-started-esp32-ethernet-kit-a-v1.1-layout:
以太网母板（A 板）
^^^^^^^^^^^^^^^^^^^^^
.. figure:: ../../_static/esp32-ethernet-kit-a-v1.1-layout.png
:align: center
:scale: 80%
:alt: ESP32-Ethernet-Kit - Ethernet board (A) layout
:figclass: align-center
ESP32-Ethernet-Kit - 以太网母板（A 板）布局（点击放大）（请更新图片）
下表将从图片右上角开始，以顺时针顺序介绍图中的主要组件。
.. list-table:: 表格1 组件介绍
:widths: 40 150
:header-rows: 1
* - 主要组件
- 基本介绍
* - ESP32-WROVER-B 模组
- 这款 ESP32 模组内置 64-Mbit PSRAM，可提供灵活的额外存储空间和数据处理能力。
* - GPIO Header 2
- 由 5 个未引出通孔组成，可连接至 ESP32 的部分 GPIO。具体介绍，请见 `GPIO Header 2`_。
* - 功能选择开关
- 一个 4 位拨码开关，可配置 ESP32 部分 GPIO 的功能。请注意，拨码开关旁边开发板的丝印层上的 GPIO 管脚标记的位置是不正确的。有关详细信息和正确的管脚分配，请见 `功能选择开关`_。
* - Tx/Rx LEDs
- 2 个 LED，可显示 UART 传输的状态。
* - FT2232H
- FT2232H 多协议 USB 转串口桥接器。开发人员可通过 USB 接口对 FT2232H 芯片进行控制和编程，与 ESP32 建立连接。FT2232H 芯片可在通道 A 提供 USB-to-JTAG 接口功能，并在通道 B 提供 USB-to-Serial 接口功能，便利开发人员的应用开发与调试。见 `ESP32-Ethernet-Kit V1.1 以太网母板（A 板）原理图`_。
* - USB 端口
- USB 接口。可用作开发板的供电电源，或连接 PC 和开发板的通信接口。
* - 电源开关
- 电源开关。拨向 **5V0** 按键侧，开发板上电；拨向 **GND** 按键一侧，开发板掉电。
* - 5V Input
- 5V 电源接口建议仅在开发板自动运行（未连接 PC）时使用。
* - 5V Power On LED
- 当开发板通电后（USB 或外部 5V 供电），该红色指示灯将亮起。
* - DC/DC 转换器
- 直流 5 V 转 3.3 V，输出电流最高可达 2 A。
* - Board B 连接器
- 1 对 排针和排母，用于连接 `PoE 子板（B 板）`_。
* - IP101GRI (PHY)
- 物理层 (PHY) 单端口 10/100 快速以太网收发器 `IP101GRI <http://www.bdtic.com/DataSheet/ICplus/IP101G_DS_R01_20121224.pdf>`_ 芯片，允许开发人员实现与以太网线缆的物理层连接。PHY 与 ESP32 通过简化媒体独立接口 (RMII) 实现连接。RMII 是 `媒体独立接口 (MII) <https://en.wikipedia.org/wiki/Media-independent_interface>`_ 的标准简化版本。PHY 可在 10/100 Mbps 速率下支持 IEEE 802.3 / 802.3u 标准。
* - RJ45 端口
- 以太网数据传输端口。
* - 网络变压器
- 网络变压器属于以太网物理层的一部分，可保护电路，使其免受故障和电压瞬变影响，包括防止收发器芯片和线缆之间产生共模信号。同时它也可以在收发器与以太网设备之间提供电流隔绝。
* - Link/Activity LED
- 2 个 LED（绿色和红色），可分别显示 PHY 处于 “Link” 状态或 “Activity” 状态。
* - BOOT Button
- 下载按键。按下 **BOOT** 键并保持，同时按一下 **EN** 键（此时不要松开 **BOOT** 键）进入“固件下载”模式，通过串口下载固件。
* - EN 按键
- 复位按键。
* - GPIO Header 1
- 由 6 个未引出通孔组成，可连接至 ESP32 的备用 GPIO。具体介绍，请见 `GPIO Header 1`_。
PoE 子板（B 板）
^^^^^^^^^^^^^^^^^^^
PoE 子板转换以太网电缆传输的电能 (PoE)，为以太网母板（A 板）提供电源。PoE 子板（B 板）的主要组件见 `功能概述`_ 中的功能框图。
PoE 子板（B 板）具有以下特性：
* 支持 IEEE 802.3at 标准
* 电源输出：5 V，1.4 A
如需使用 PoE 功能，请用以太网线缆将以太网母板（A 板）上的 **RJ45 Port** 连接至 PoE 的交换机。以太网母板（A 板）检测到来自 PoE 子板（B 板）的 5 V 供电后，将从 USB 供电自动切换至 PoE 供电。
.. figure:: ../../_static/esp32-ethernet-kit-b-v1.0-layout.png
:align: center
:scale: 80%
:alt: ESP32-Ethernet-Kit - PoE board (B)
:figclass: align-center
ESP32-Ethernet-Kit - PoE 子板（B 板）布局（点击放大）
.. list-table:: 表格2 PoE 子板（B 板）
:widths: 40 150
:header-rows: 1
* - 主要组件
- 基本介绍
* - A 板连接器
- 4 个排针（左侧）和排母（右侧），用于将 PoE 子板（B 板）连接至 :ref:`Ethernet board (A) <get-started-esp32-ethernet-kit-a-v1.1-layout>`。左侧的管脚接受来自 PoE 交换机的电源。右侧的管脚为 以太网母板（A 板）提供 5 V 电源。
* - 外部电源终端
- PoE 子板（B 板）可选电源 (26.6 ~ 54 V)。
.. _get-started-esp32-ethernet-kit-v1.1-setup-options:
设置选项
--------
本节介绍用于 ESP32-Ethernet-Kit 开发板的硬件配置选项。
功能选择开关
^^^^^^^^^^^^^^
拨码开关打开时，拨码开关将列出的 GPIO 路由到 FT2232H 以提供JTAG功能。拨码开关关闭时，GPIO 可以用于其他目的。
========= ==========
拨码开关 GPIO 管脚
========= ==========
1 GPIO13
2 GPIO12
3 GPIO15
4 GPIO14
========= ==========
.. note::
拨码开关旁边开发板的丝印层上的 GPIO 管脚标记的位置是不正确的。请以表格中的顺序为准。
RMII 时钟源选择
^^^^^^^^^^^^^^^^
RMII 工作模式下的以太网 MAC 和 PHY 需要一个公共的 50MHz 同步时钟（即 RMII 时钟），它既可以由外部提供，也可以由内部的 ESP32 APLL 产生。
.. note::
有关 RMII 时钟源选择的更多信息，请参见 `ESP32-Ethernet-Kit V1.1 以太网母板（A 板）原理图`_，第 2 页的位置 D2。
PHY 侧提供 RMII 时钟
"""""""""""""""""""""""""""""
ESP32-Ethernet-Kit 默认配置为 IP101GRI 的 50M_CLKO 信号线提供 RMII 时钟，该时钟信号由 PHY 外侧连接的 25MHz 无源晶振经过倍频产生。详情请参见下图。
.. figure:: ../../_static/esp32-ethernet-kit-rmii-clk-from-phy.png
:align: center
:scale: 80%
:alt: RMII Clock from IP101GRI PHY
:figclass: align-center
PHY 侧提供 RMII 时钟
请注意，系统上电时 RESET_N 旁的下拉电阻会将 PHY 置于复位状态，ESP32 需要通过 GPIO5 将 RESET_N 拉高才能启动 PHY，只有这样才能保证系统的正常上电，否则 ESP32 会存在一定几率进入下载模式（当 REF_CLK_50M 时钟信号在 GPIO0 上电采样阶段刚好处于高电平）。
ESP32 APLL 内部提供的 RMII 时钟
""""""""""""""""""""""""""""""""""""
另一种选择是从 ESP32 APLL 内部获取 RMII 时钟，请参见下图。来自 GPIO0 的时钟信号首先被反相，以解决传输线延迟的问题，然后提供给 PHY。
.. figure:: ../../_static/esp32-ethernet-kit-rmii-clk-to-phy.png
:align: center
:scale: 80%
:alt: RMII Clock from ESP Internal APLL
:figclass: align-center
ESP32 APLL 内部提供的 RMII 时钟
要实现此选项，用户需要在板子上移除或添加一些阻容元器件。有关详细信息，请参见 `ESP32-Ethernet-Kit V1.1 以太网母板（A 板）原理图`_，第 2 页，位置 D2。请注意，如果 APLL 已经用于其他用途（如 I2S 外设），那么只能使用外部 RMII 时钟。
GPIO 分配
---------
本节介绍了 ESP32-Ethernet-Kit 开发板特定接口或功能的 GPIO 分配情况。
IP101GRI (PHY) 接口
^^^^^^^^^^^^^^^^^^^^^^^^^
下表显示了 ESP32 (MAC) 与 IP101GRI (PHY) 的管脚对应关系。ESP32-Ethernet-Kit 的实现默认设置为简化媒体独立接口。
==== ================ ===============
. ESP32 管脚 (MAC) IP101GRI (PHY)
==== ================ ===============
*RMII 接口*
---------------------------------------
1 GPIO21 TX_EN
2 GPIO19 TXD[0]
3 GPIO22 TXD[1]
4 GPIO25 RXD[0]
5 GPIO26 RXD[1]
6 GPIO27 CRS_DV
7 GPIO0 REF_CLK
---- ---------------- ---------------
*串行管理接口*
---------------------------------------
8 GPIO23 MDC
9 GPIO18 MDIO
---- ---------------- ---------------
*PHY 复位*
---------------------------------------
10 GPIO5 Reset_N
==== ================ ===============
.. Note::
除了 REF_CLK 之外，ESP32 的 *RMII 接口* 下的所有管脚分配都是固定的，不能通过 IOMUX 或 GPIO 矩阵进行更改。
GPIO Header 1
^^^^^^^^^^^^^
本连接器包括 ESP32-Ethernet-Kit 开发板上部分不用做他用的 GPIO。
==== ================
. ESP32 管脚
==== ================
1 GPIO32
2 GPIO33
3 GPIO34
4 GPIO35
5 GPIO36
6 GPIO39
==== ================
GPIO Header 2
^^^^^^^^^^^^^
根据“说明"描述的不同情形，本连接器包含可用做他用的 GPIO。
==== ========== ====================
. ESP32 管脚 说明
==== ========== ====================
1 GPIO17 见下方说明 1
2 GPIO16 见下方说明 1
3 GPIO4
4 GPIO2
5 GPIO13 见下方说明 2
6 GPIO12 见下方说明 2
7 GPIO15 见下方说明 2
8 GPIO14 见下方说明 2
9 GND Ground
10 3V3 3.3 V 电源
==== ========== ====================
.. note::
1. ESP32 芯片的 GPIO16 和 GPIO17 管脚没有引出至 ESP32-WROVER-B 模组的管脚，因此无法使用。如需使用 ESP32 的 GP1016 和 GPIO17 管脚，建议更换其他不含 PSRAM 的模组，比如 ESP32-WROOM-32D 或 ESP32-SOLO-1。
2. 具体功能取决与 `功能选择开关`_ 的设置。
GPIO 管脚分配总结
^^^^^^^^^^^^^^^^^^^
.. csv-table::
:header: ESP32-WROVER-B,IP101GRI,UART,JTAG,GPIO,Comments
S_VP,,,,IO36,
S_VN,,,,IO39,
IO34,,,,IO34,
IO35,,,,IO35,
IO32,,,,IO32,
IO33,,,,IO33,
IO25,RXD[0],,,,
IO26,RXD[1],,,,
IO27,CRS_DV,,,,
IO14,,,TMS,IO14,
IO12,,,TDI,IO12,
IO13,,RTS,TCK,IO13,
IO15,,CTS,TDO,IO15,
IO2,,,,IO2,
IO0,REF_CLK,,,,See note 1
IO4,,,,IO4,
IO16,,,,IO16 (NC),See note 2
IO17,,,,IO17 (NC),See note 2
IO5,Reset_N,,,,See note 1
IO18,MDIO,,,,
IO19,TXD[0],,,,
IO21,TX_EN,,,,
RXD0,,RXD,,,
TXD0,,TXD,,,
IO22,TXD[1],,,,
IO23,MDC,,,,
.. note::
1. 为防止 ESP32 侧 GPIO0 的上电状态受 PHY 侧时钟输出的影响，PHY 侧 RESET_N 默认为低，以关闭 PHY 侧时钟输出。上电后，您可通过 GPIO5 控制 RESET_N 以打开该时钟输出。参见 `PHY 侧提供 RMII 时钟`_。对于无法通过 RESET_N 关闭时钟输出的 PHY，PHY 侧建议使用可在外部禁用/使能的有源晶振。与使用 RESET_N 类似，默认情况下晶振模块应禁用，并在上电后由 ESP32 开启。有关参考设计，请参见 `ESP32-Ethernet-Kit V1.1 以太网母板（A 板）原理图`_。
2. ESP32 芯片的 GPIO16 和 GPIO17 管脚没有引出至 ESP32-WROVER-B 模组的管脚，因此无法使用。如需使用 ESP32 的 GP1016 和 GPIO17 管脚，建议更换其他不含 PSRAM 的模组，比如 ESP32-WROOM-32D 或 ESP32-SOLO-1。
应用程序开发
-------------
ESP32-Ethernet-Kit 上电前，请首先确认开发板完好无损。
初始设置
^^^^^^^^^^
1. 首先，请将 :ref:`以太网母板（A 板）<get-started-esp32-ethernet-kit-a-v1.1-layout>` 上的所有开关均拨至 **ON** 状态，使 **功能选择开关** 处于默认状态。
2. 为了方便应用程序的下载和测试，不要为开发板输入任何信号。
3. 此时可以连接 `PoE 子板（B 板）`_ ，但不要向 B 板连接任何外部电源。
4. 使用 USB 数据线将 :ref:`以太网母板（A 板）<get-started-esp32-ethernet-kit-a-v1.1-layout>` 连接至 PC。
5. 将 **电源开关** 从 GND 拨至 5V0 一侧。此时，**5V Power On LED** 应点亮。
正式开始开发
^^^^^^^^^^^^^
现在，请前往 :doc:`../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
请务必在进入下一步前，确保您已完成上述所有步骤。
配置与加载以太网示例
^^^^^^^^^^^^^^^^^^^^^^^
在完成开发环境设置和开发板测试后，您可以配置并烧录 :example:`ethernet/ethernet` 示例。本示例专门用于测试以太网功能，支持不同 PHY，包括 :ref:`get-started-esp32-ethernet-kit-v1.1` 开发板使用的 **IP101GRI** 。
针对 ESP32-Ethernet-Kit V1.0 的主要修改：
-----------------------------------------
* 原 GPIO0 反相后时钟提供给 PHY 方案改为由 PHY 侧外接无源晶振，提供时钟给 GPIO0。原用于控制有源晶振的 OSC_EN 的 IO2 释放，可用作其他用途。
* 为防止 ESP32 侧 GPIO0 的上电状态受到 PHY 侧时钟输出的影响，PHY 侧 RESET_N 默认为低，关闭 PHY 侧时钟输出。而后可通过 GPIO5 控制 RESET_N 打开该时钟输出。
* 移除 FT2232H 芯片的外部 SPI Flash U6。
* 移除流控的测试排针 J4。
* 移除 nTRST JTAG信号，相应的 GPIO4 可用作其他用途。
* GPIO15 线上的上拉电阻 R68 移至 JTAG 的 MTDO 侧。
* 为了加强 A 板和 B 板连接间的防呆设计（减少反向插入 B 板的机会），将原先 A 板上的 2 排 4 针排针改为 1 排 4 针排母和 1 排 4 针排针。相应的 4 针排针排和排母排则安装在 B 板上。
ESP32-Ethernet-Kit 的其他版本
-------------------------------
* :doc:`get-started-ethernet-kit-v1.0`
相关文档
----------
* `ESP32-Ethernet-Kit V1.1 以太网母板（A 板）原理图`_ (PDF)
* `ESP32-Ethernet-Kit V1.0 PoE 子板（B 板）原理图`_ (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`
.. _ESP32-Ethernet-Kit V1.1 以太网母板（A 板）原理图: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_A_V1.1_20190711.pdf
.. _ESP32-Ethernet-Kit V1.0 PoE 子板（B 板）原理图: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_B_V1.0_20190517.pdf
.. _ESP32-Ethernet-Kit V1.0 以太网母板（A 板）原理图: https://dl.espressif.com/dl/schematics/SCH_ESP32-ETHERNET-KIT_A_V1.0_20190517.pdf
.. toctree::
:hidden:
get-started-ethernet-kit-v1.0.rst

2
docs/zh_CN/hw-reference/index.rst
View file

@ -9,7 +9,7 @@ ESP32 H/W 硬件参考
:esp32: ESP32 技术参考手册 (PDF) <https://espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_cn.pdf> :esp32: ESP32 技术参考手册 (PDF) <https://espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_cn.pdf>
:esp32s2beta: ESP32-S2 技术参考手册 (PDF) <https://espressif.com/sites/default/files/documentation/esp32s2_technical_reference_manual_cn.pdf> :esp32s2beta: ESP32-S2 技术参考手册 (PDF) <https://espressif.com/sites/default/files/documentation/esp32s2_technical_reference_manual_cn.pdf>
:esp32: ESP32 技术规格书 (PDF) <https://espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf> :esp32: ESP32 技术规格书 (PDF) <https://espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>
:esp32s2beta: ESP32-S2 技术规格书 (PDF) <https://espressif.com/sites/default/files/documentation/esp32s2_datasheet_cn.pdf> :esp32s2: ESP32-S2 技术规格书 (PDF) <https://espressif.com/sites/default/files/documentation/esp32s2_datasheet_cn.pdf>
:esp32: ESP32 硬件设计指南 (PDF) <https://espressif.com/sites/default/files/documentation/esp32_hardware_design_guidelines_cn.pdf> :esp32: ESP32 硬件设计指南 (PDF) <https://espressif.com/sites/default/files/documentation/esp32_hardware_design_guidelines_cn.pdf>
:esp32: ESP32 勘误表及解决方法 (PDF) <https://espressif.com/sites/default/files/documentation/eco_and_workarounds_for_bugs_in_esp32_cn.pdf> :esp32: ESP32 勘误表及解决方法 (PDF) <https://espressif.com/sites/default/files/documentation/eco_and_workarounds_for_bugs_in_esp32_cn.pdf>
模组与开发板 <modules-and-boards> 模组与开发板 <modules-and-boards>

25
docs/zh_CN/hw-reference/modules-and-boards-previous.rst
View file

@ -1 +1,24 @@
.. include:: ../../en/hw-reference/modules-and-boards-previous.rst .. _esp-modules-and-boards-previous:
**************************************
{IDF_TARGET_NAME} 模组与开发板（历史版本）
**************************************
This sections contains overview and links to documentation of previous version {IDF_TARGET_NAME} Modules and Boards that have been replaced with newer versions or discontinued. It is maintained for convenience of users as previous versions of some modules and boards are still in use and some may still be available for purchase.
.. only:: esp32
.. include:: esp32/inc/modules-and-boards-previous-esp32.rst
.. only:: esp32s2
.. include:: esp32s2/inc/modules-and-boards-previous-esp32s2.rst
相关文档
=================
* :doc:`modules-and-boards`
.. _FTDI Virtual COM Port Drivers: http://www.ftdichip.com/Drivers/VCP.htm

297
docs/zh_CN/hw-reference/modules-and-boards.rst
View file

@ -1,12 +1,12 @@
.. _esp-modules-and-boards: .. _esp-modules-and-boards:
***************************** ********************************
ESP32 系列模组和开发板 {IDF_TARGET_NAME} 系列模组和开发板
***************************** ********************************
:link_to_translation:`en:[English]` :link_to_translation:`en:[English]`
乐鑫设计并提供多种模组和开发板以供用户体验 ESP32 系列芯片的强大功能。 乐鑫设计并提供多种模组和开发板以供用户体验 {IDF_TARGET_NAME} 系列芯片的强大功能。
本文档主要介绍了当前乐鑫所提供的各种模组和开发板。 本文档主要介绍了当前乐鑫所提供的各种模组和开发板。
@ -14,297 +14,16 @@ ESP32 系列模组和开发板
如需了解较早版本或已停产的模组和开发板，请参考 :ref:`esp-modules-and-boards-previous`。 如需了解较早版本或已停产的模组和开发板，请参考 :ref:`esp-modules-and-boards-previous`。
.. _esp-wroom-solo-wrover-modules: .. only:: esp32
WROOM、SOLO、WROVER 和 PICO 系列模组 .. include:: esp32/inc/modules-and-boards-esp32.rst
=====================================
WROOM、SOLO、WROVER 和 PICO 系列模组内置 ESP32 芯片并集成了晶振、天线匹配电路等重要组件，可直接集成到终端产品中。如果再结合一些其他组件，例如编程接口、Bootstrapping 电阻和排针，您就可以体验 ESP32 的强大功能了。 .. only:: esp32s2
下表总结了上述系列模组的主要特点，详细信息见后续章节。 .. include:: esp32s2/inc/modules-and-boards-esp32s2.rst
+---------------------+--------------+-------------+-------------+------+-----------------+
| 模组 | 芯片 | Flash (MB) | PSRAM (MB) | 天线 | 尺寸 (mm) |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROOM-32 | ESP32-D0WDQ6 | 4 | – | MIFA | 18 × 25.5 × 3.1 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROOM-32D | ESP32-D0WD | 4、8 或 16 | – | MIFA | 18 × 25.5 × 3.1 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROOM-32U | ESP32-D0WD | 4、8 或 16 | – | U.FL | 18 × 19.2 × 3.1 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-SOLO-1 | ESP32-S0WD | 4 | – | MIFA | 18 × 25.5 × 3.1 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROVER (PCB) | ESP32-D0WDQ6 | 4 | 8 | MIFA | 18 × 31.4 × 3.3 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROVER (IPEX) | ESP32-D0WDQ6 | 4 | 8 | U.FL | 18 × 31.4 × 3.3 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROVER-B | ESP32-D0WD | 4、8 或 16 | 8 | MIFA | 18 × 31.4 × 3.3 |
+---------------------+--------------+-------------+-------------+------+-----------------+
| ESP32-WROVER-IB | ESP32-D0WD | 4、8 或 16 | 8 | U.FL | 18 × 31.4 × 3.3 |
+---------------------+--------------+-------------+-------------+------+-----------------+
* ESP32-**D**.. 代表双核芯片，ESP32-**S**.. 代表单核芯片；
* MIFA - 蛇形倒 F 天线；
* U.FL - U.FL/IPEX 天线连接器；
* ESP32-WROOM-32x、ESP32-WROVER-B 和 ESP32-WROVER-IB 模组默认内置 4 MB flash，客户可定制 8 MB 和 16 MB flash，详情见 `乐鑫产品订购信息`_ (PDF) 和《`ESP32 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_》(PDF)；
* 最初发布的 ESP32-WROVER 模组内置 4 MB PSRAM；
* *ESP-WROOM-32* 是 *ESP32-WROOM-32* 的曾用名。
.. _esp-modules-and-boards-esp32-wroom-32:
ESP32-WROOM-32 模组
--------------------
ESP32-WROOM-32 模组是 WROOM/WROVER 系列最先发布的模组，内置 ESP32-D0WDQ6 芯片，是一款基础且常用的 ESP32 模组。
有关该模组的详细信息，请查看 :ref:`esp-wroom-solo-wrover-modules` 章节中的表格。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32-front-back.jpg
:align: center
:alt: ESP32-WROOM-32 module (front and back)
:width: 45%
ESP32-WROOM-32 模组（正反面图）
相关文档
^^^^^^^^^^^^^
* 《`ESP32-WROOM-32 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_cn.pdf>`_》(PDF)；
* `ESP32-WROOM-32 参考设计 <https://www.espressif.com/zh-hans/support/download/documents?keys=ESP32-WROOM-32+%E5%8F%82%E8%80%83%E8%AE%BE%E8%AE%A1>`_，包括原理图（由 OrCAD Capture 绘制）、PCB 布局（由 Mentor PADS 绘制）、GERBER 文件和 BOM 清单。
.. _esp-modules-and-boards-esp32-wroom-32d-and-u:
ESP32-WROOM-32D/ESP32-WROOM-32U 模组
--------------------------------------
两款模组均集成了 ESP32-D0WD 芯片，与 :ref:`esp-modules-and-boards-esp32-wroom-32` 集成的 ESP32-D0WDQ6 相比，ESP32-D0WD 芯片的封装更小，在 PCB 上占用的面积更小。
有关这两款模组的详细信息，请查看 :ref:`esp-wroom-solo-wrover-modules` 中的表格和 `乐鑫产品订购信息`_。
ESP32-WROOM-32U 是整个 WROOM/WROVER 模组系列中最小的模组。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32d-front-back.jpg
:align: center
:alt: ESP32-WROOM-32D module (front and back)
:width: 45%
ESP32-WROOM-32D 模组（正反面图）
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32u-front-back.jpg
:align: center
:alt: ESP32-WROOM-32U module (front and back)
:width: 45%
ESP32-WROOM-32U 模组（正反面图）
相关文档
^^^^^^^^^^^^^
* 《`ESP32-WROOM-32D/ESP32-WROOM-32U 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32d_esp32-wroom-32u_datasheet_cn.pdf>`_》(PDF)
.. _esp-modules-and-boards-esp32-solo-1:
ESP32-SOLO-1 模组
-----------------
ESP32-SOLO-1 模组是 ESP32-WROOM-32D 模组的简化版本，内置一个 ESP32 单核芯片，支持高达 160 MHz 的时钟频率。
有关此模组的详细信息，请查看 :ref:`esp-wroom-solo-wrover-modules` 章节中的表格和 `乐鑫产品订购信息`_。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-solo-1-front-back.jpg
:align: center
:alt: ESP32-SOLO-1 module (front and back)
:width: 45%
ESP32-SOLO-1 模组（正反面图）
相关文档
^^^^^^^^^^^^^
* 《`ESP32-SOLO-1 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-solo-1c_datasheet_cn.pdf>`__》(PDF)
.. _esp-modules-and-boards-esp32-wrover:
ESP32-WROVER 系列模组
-------------------------
ESP32-WROVER 系列模组在 ESP32-WROOM-32x 模组的基础上进行了一些修改，其中包含一些功能升级，并新增 8 MB SPI PSRAM（伪静态 RAM）。
有关该模组的详细信息，请查看 :ref:`esp-wroom-solo-wrover-modules` 章节中的表格和 `乐鑫产品订购信息`_。
* **ESP32-WROVER (PCB)** 模组和 **ESP32-WROVER (IPEX)** 模组内置 1.8 V PSRAM，支持 144 MHz 时钟频率。
* **ESP32-WROVER-B** 模组和 **ESP32-WROVER-IB** 模组内置 3.3 V PSRAM，支持 133 MHz 时钟频率。
下图为配备有 PCB 天线的 ESP32-WROVER 模组：
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wrover.jpg
:align: center
:alt: ESP32-WROVER module (front and back)
:width: 40%
ESP32-WROVER 模组（正反面图）
相关文档
^^^^^^^^^^^^^
* 《`ESP32-WROVER 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32_wrover_datasheet_cn.pdf>`__》(PDF)
* 《`ESP32-WROVER-B 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_cn.pdf>`__》(PDF)
* 《`ESP-PSRAM64 & ESP-PSRAM64H 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp-psram64_esp-psram64h_datasheet_cn.pdf>`__》(PDF)
* `ESP32-WROVER 参考设计 <https://www.espressif.com/zh-hans/support/download/documents?keys=ESP32-WROVER+%E5%8F%82%E8%80%83%E8%AE%BE%E8%AE%A1>`_ 包含原理图（由 OrCAD Capture 绘制）、PCB 布局（由 Mentor PADS 绘制）、GERBER 文件和 BOM 清单。
ESP32-PICO-D4 模组
------------------
ESP32-PICO-D4 模组是一款 SiP 模组，无缝集成了所有外设，包括：
- 4 MB flash
- 晶振
- 滤波电容
- RF 匹配电路
有关该模组的详细信息，请查看 `乐鑫产品订购信息`_。
相关文档
^^^^^^^^^^^^^
* 《`ESP32-PICO-D4 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_cn.pdf>`__》(PDF)
ESP32 开发板
==================
ESP32 系列开发板功能各异，具体有以下不同点：
- 访问的 ESP32 GPIO 管脚不同；
- 接口不同，包括 USB 和 JTAG；
- 外设不同，包括 TouchPad、LCD 显示屏、SD 卡槽和相机模组排母等。
.. _esp-modules-and-boards-esp32-pico-kit:
ESP32-PICO-KIT V4.1 开发板
---------------------------
ESP32-PICO-KIT V4.1 开发板是基于 ESP32 的最小开发板，内置连接至电脑 USB 端口所需的所有组件，同时设有排针，可直接将此开发板插接于迷你面包板。
ESP32-PICO-KIT V4.1 开发板集成了 `ESP32-PICO-D4 模组`_，只需在 PCB (20 x 52 mm) 上添加少许外部组件即可构成一个功能齐全的开发板。这部分外部组件包括天线、LDO、USB 至 UART 桥接器、一个重置按钮和一个固件下载模式激活按钮。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-pico-kit-v4.1.jpg
:align: center
:alt: ESP32-PICO-KIT V4.1 board
:width: 50%
ESP32-PICO-KIT V4.1 开发板
与 ESP32-PICO-KIT V4 相比，ESP32-PICO-KIT V4.1 开发板支持 CP2102N USB 至 UART 桥接器，可提供高达 3 Mbps 的传输速率。
相关文档
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-pico-kit`
* `ESP32-PICO-KIT V4.1 原理图 <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4.1_schematic.pdf>`_ (PDF)
* `ESP32-PICO-KIT 参考设计 <https://www.espressif.com/zh-hans/support/download/documents?keys=ESP32-PICO-KIT+%E5%8F%82%E8%80%83%E8%AE%BE%E8%AE%A1>`_，包含原理图（由 OrCAD Capture 绘制）、PCB 布局（由 Mentor PADS 绘制）、GERBER 文件和 BOM 清单。
* 《`ESP32-PICO-D4 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_cn.pdf>`_》(PDF)
较早版本开发板
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp32-pico-kit-v4`
* :ref:`esp-modules-and-boards-esp32-pico-kit-v3`
.. _esp-modules-and-boards-esp32-devkitc:
ESP32 DevKitC V4 开发板
------------------------------
ESP32 DevKitC V4 开发板是一款小巧实用的开发板，具备以下特色功能：
- 集成了 :ref:`esp-modules-and-boards-esp32-wroom-32`
- USB 转串口编程接口同时可为开发板供电
- 设有排针
- 设有重置按钮和固件下载模式激活按钮
- 以及其他组件
与较早版本的 :ref:`esp-modules-and-boards-esp32-devkitc-v2` 相比，ESP32 DevKitC V4 开发板集成了 :ref:`esp-modules-and-boards-esp32-wrover` （而非 ESP32-WROOM-32 模组），同时内置 CP2102N 芯片，支持更高波特率。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-devkitc-v4-front.jpg
:align: center
:alt: ESP32 DevKitC V4 board
:width: 50%
ESP32 DevKitC V4 开发板
相关文档
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-devkitc`
* `ESP32-DevKitC 原理图 <https://dl.espressif.com/dl/schematics/esp32_devkitc_v4-sch-20180607a.pdf>`_ (PDF)
* `ESP32-DevKitC 参考设计 <https://www.espressif.com/zh-hans/support/download/documents?keys=ESP32-DevKitC+%E5%8F%82%E8%80%83%E8%AE%BE%E8%AE%A1>`_，包含原理图（由 OrCAD Capture 绘制）、PCB 布局（由 Mentor PADS 绘制）、GERBER 文件和 BOM 清单。
* `CP210x USB 至 UART 桥 VCP 驱动器 <https://cn.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers>`_
较早版本开发板
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp32-devkitc-v2`
.. _esp-modules-and-boards-esp-wrover-kit:
ESP-WROVER-KIT V4.1 开发板
-------------------------------
ESP-WROVER-KIT V4.1 开发板具备以下特色功能：
- USB 转双串口转换器（用于后续编程）
- JTAG 调试接口
- MicroSD 卡槽
- 3.2” SPI LCD 显示屏
- 相机模组排母
- RGB 发光二极管
- 支持 32.768 kHz 晶振输入用于 RTC 及低功耗模式操作
ESP-WROVER-KIT V4.1 开发板支持 USB 供电或标准的 5 毫米电源插座供电，可使用跳线选择电源，或使用独立的开关控制电源。
ESP-WROVER-KIT V4.1 开发板集成了 ESP-WROVER-B 模组，该模组集成了 8 MB PSRAM，方便用户灵活扩展存储空间，增强数据处理能力。ESP-WROVER-KIT V4.1 开发板还可以集成 :ref:`esp-wroom-solo-wrover-modules` 中所述的 ESP 其他版本模组。
与 :ref:`esp-modules-and-boards-esp-wrover-kit-v3` 相比，ESP-WROVER-KIT V4.1 开发板在设计上有以下改动：
- JP8、JP11 和 JP13 合并成了一个 JP2。
- USB 连接器的固定脚改为直插式，并移至板子右下角。
- R61 已变更为零欧姆电阻。
- 基于测试结果和采购选择，部分组件已由功能对等组件替代，例如 EN 和 Boot 按钮。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v4.1-front.jpg
:align: center
:alt: ESP-WROVER-KIT V4.1 board
:width: 90%
ESP-WROVER-KIT V4.1 开发板
上图所示开发板集成了 ESP32-WROVER-B 模组。
相关文档
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-wrover-kit`
* `ESP-WROVER-KIT V4.1 原理图 <https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_V4_1.pdf>`__ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* `FTDI 虚拟 COM 端口驱动`_
较早版本开发板
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp-wrover-kit-v3`
* :ref:`esp-modules-and-boards-esp-wrover-kit-v2`
* :ref:`esp-modules-and-boards-esp-wrover-kit-v1`
相关文档 相关文档
================= =================
* :doc:`modules-and-boards-previous` * :doc:`modules-and-boards-previous`
.. _FTDI 虚拟 COM 端口驱动: http://www.ftdichip.com/Drivers/VCP.htm
.. _乐鑫产品订购信息: https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_cn.pdf