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

Merge branch 'docs/update_hw-reference' into 'master'

Browse Source 
docs: update format issues for files under hw-reference

Closes DOC-5979

See merge request espressif/esp-idf!25297
This commit is contained in:
Cai Xin Ying 2023-09-06 00:31:32 +08:00
commit 7e744db18a
62 changed files with 646 additions and 405 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/en/hw-reference/esp32/get-started-devkitc-v2.rst
View File

@ -1,5 +1,5 @@
ESP32-DevKitC V2 Getting Started Guide
==============================================
======================================
:link_to_translation:`zh_CN:[中文]`
@ -10,7 +10,7 @@ What You Need
-------------
* :ref:`ESP32-DevKitC V2 board <get-started-esp32-devkitc-v2-board-front-make>`
* USB A / micro USB B cable
* USB A/micro USB B cable
* Computer running Windows, Linux, or macOS
You can skip the introduction sections and go directly to Section `Start Application Development`_.
@ -48,7 +48,7 @@ The following figure and the table below describe the key components, interfaces
* - EN
- Reset button.
* - Boot
- Download button. Holding down **Boot** and then pressing **EN** initiates Firmware Download mode for downloading firmware through the serial port.
- Download button. Holding down **Boot** and then pressing **EN** initiates Firmware Download mode for downloading firmware through the serial port.
* - Micro USB Port
- USB interface. Power supply for the board as well as the communication interface between a computer and ESP32-WROOM-32.
* - I/O
@ -61,8 +61,8 @@ Power Supply Options
There are three mutually exclusive ways to provide power to the board:
* Micro USB port, default power supply
* 5V / GND header pins
* 3V3 / GND header pins
* 5V and GND header pins
* 3V3 and GND header pins
.. warning::

15
docs/en/hw-reference/esp32/get-started-devkitc.rst
View File

@ -10,7 +10,7 @@ What You Need
-------------
* :ref:`ESP32-DevKitC V4 board <get-started-esp32-devkitc-board-front>`
* USB A / micro USB B cable
* USB A/micro USB B cable
* Computer running Windows, Linux, or macOS
You can skip the introduction sections and go directly to Section `Start Application Development`_.
@ -77,25 +77,26 @@ The following figure and the table below describe the key components, interfaces
- Most of the pins on the ESP module are broken out to the pin headers on the board. You can program ESP32 to enable multiple functions such as PWM, ADC, DAC, I2C, I2S, SPI, etc.
Power Supply Options
--------------------
There are three mutually exclusive ways to provide power to the board:
* Micro USB port, default power supply
* 5V / GND header pins
* 3V3 / GND header pins
* 5V and GND header pins
* 3V3 and GND header pins
.. warning::
The power supply must be provided using **one and only one of the options above**, otherwise the board and/or the power supply source can be damaged.
Header Block
------------
The two tables below provide the **Name** and **Function** of I/O header pins on both sides of the board, as shown in :ref:`get-started-esp32-devkitc-board-front`.
J2
^^^
=== ==== ========== ===============================================
@ -122,6 +123,7 @@ No. Name Type [1]_ Function
19 5V P 5 V power supply
=== ==== ========== ===============================================
J3
^^^
=== ==== ========== ===============================================
@ -149,9 +151,10 @@ No. Name Type [1]_ Function
=== ==== ========== ===============================================
.. [1] P: Power supply; I: Input; O: Output.
.. [2] The pins D0, D1, D2, D3, CMD and CLK are used internally for communication between ESP32 and SPI flash memory. They are grouped on both sides near the USB connector. Avoid using these pins, as it may disrupt access to the SPI flash memory / SPI RAM.
.. [2] The pins D0, D1, D2, D3, CMD and CLK are used internally for communication between ESP32 and SPI flash memory. They are grouped on both sides near the USB connector. Avoid using these pins, as it may disrupt access to the SPI flash memory/SPI RAM.
.. [3] The pins GPIO16 and GPIO17 are available for use only on the boards with the modules ESP32-WROOM and ESP32-SOLO-1. The boards with ESP32-WROVER modules have the pins reserved for internal use.
Pin Layout
^^^^^^^^^^^
.. figure:: ../../../_static/esp32-devkitC-v4-pinout.png
@ -182,7 +185,7 @@ In case these issues occur, please remove the component. The figure below shows
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.

15
docs/en/hw-reference/esp32/get-started-ethernet-kit-v1.0.rst
View File

@ -7,6 +7,7 @@ This guide shows how to get started with the ESP32-Ethernet-Kit development boar
The :ref:`ESP32-Ethernet-Kit <get-started-esp32-ethernet-kit-b-v1.0>` is an Ethernet-to-Wi-Fi development board that enables Ethernet devices to be interconnected over Wi-Fi. At the same time, to provide more flexible power supply options, the ESP32-Ethernet-Kit also supports power over Ethernet (PoE).
What You Need
-------------
@ -16,12 +17,13 @@ What You Need
You can skip the introduction sections and go directly to Section `Start Application Development`_.
Overview
--------
ESP32-Ethernet-Kit is an ESP32-based development board produced by `Espressif <https://espressif.com>`_.
It consists of two development boards, the Ethernet board A and the PoE board B. The :ref:`Ethernet board (A) <get-started-esp32-ethernet-kit-a-v1.0-layout>` contains Bluetooth / Wi-Fi dual-mode ESP32-WROVER-B module and IP101GRI, a Single Port 10/100 Fast Ethernet Transceiver (PHY). The :ref:`PoE board (B) <get-started-esp32-ethernet-kit-b-v1.0-layout>` provides power over Ethernet functionality. The A board can work independently, without the board B installed.
It consists of two development boards, the Ethernet board A and the PoE board B. The :ref:`Ethernet board (A) <get-started-esp32-ethernet-kit-a-v1.0-layout>` contains Bluetooth®/Wi-Fi dual-mode ESP32-WROVER-B module and IP101GRI, a Single Port 10/100 Fast Ethernet Transceiver (PHY). The :ref:`PoE board (B) <get-started-esp32-ethernet-kit-b-v1.0-layout>` provides power over Ethernet functionality. The A board can work independently, without the board B installed.
.. _get-started-esp32-ethernet-kit-b-v1.0:
@ -93,13 +95,13 @@ Power Switch Power On/Off Switch. Toggling toward the **Boot** button pow
5V Input The 5V power supply interface can be more convenient when the board is operating autonomously (not connected to a computer).
5V Power On LED This red LED turns on when power is supplied to the board, either from USB or 5V Input.
5V Power On LED This red LED turns on when power is supplied to the board, either from USB or 5 V Input.
DC/DC Converter Provided DC 5 V to 3.3 V conversion, output current up to 2A.
DC/DC Converter Provided DC 5 V to 3.3 V conversion, output current up to 2 A.
Board B Connectors A pair male header pins for mounting the :ref:`PoE board (B) <get-started-esp32-ethernet-kit-b-v1.0-layout>`.
IP101GRI (PHY) The physical layer (PHY) connection to the Ethernet cable is implemented using the `IP101GRI <http://www.bdtic.com/DataSheet/ICplus/IP101G_DS_R01_20121224.pdf>`_ chip. The connection between PHY and ESP32 is done through the reduced media-independent interface (RMII), a variant of the media-independent interface `(MII) <https://en.wikipedia.org/wiki/Media-independent_interface>`_ standard. The PHY supports the IEEE 802.3 / 802.3u standard of 10/100Mbps.
IP101GRI (PHY) The physical layer (PHY) connection to the Ethernet cable is implemented using the `IP101GRI <http://www.bdtic.com/DataSheet/ICplus/IP101G_DS_R01_20121224.pdf>`_ chip. The connection between PHY and ESP32 is done through the reduced media-independent interface (RMII), a variant of the media-independent interface `(MII) <https://en.wikipedia.org/wiki/Media-independent_interface>`_ standard. The PHY supports the IEEE 802.3/802.3u standard of 10/100 Mbps.
RJ45 Port Ethernet network data transmission port.
@ -265,7 +267,7 @@ This header contains the GPIOs with specific MII functionality (except GPIO2), a
.. note::
1. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-B module and therefore not available for use. If you need to use these pins, please solder a module without SPIRAM memory inside, e.g. the ESP32-WROOM-32D or ESP32-SOLO-1.
1. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-B module and therefore not available for use. If you need to use these pins, please solder a module without SPIRAM memory inside, e.g., the ESP32-WROOM-32D or ESP32-SOLO-1.
2. Functionality depends on the settings of the `Function Switch`_.
@ -325,7 +327,7 @@ GPIO Allocation Summary
1. GPIO2 is used to enable external oscillator of the PHY.
2. GPIO0 is a source of 50 MHz reference clock for the PHY. The clock signal is first inverted, to account for transmission line delay, and then supplied to the PHY.
3. To prevent affecting the power-on state of GPIO0 by the clock output on the PHY side, the PHY external oscillator is enabled using GPIO2 after ESP32 is powered up.
4. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-B module and therefore not available for use. If you need to use these pins, please solder a module without SPIRAM memory inside, e.g. the ESP32-WROOM-32D or ESP32-SOLO-1.
4. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-B module and therefore not available for use. If you need to use these pins, please solder a module without SPIRAM memory inside, e.g., the ESP32-WROOM-32D or ESP32-SOLO-1.
Start Application Development
@ -333,6 +335,7 @@ Start Application Development
Before powering up your ESP32-Ethernet-Kit, please make sure that the board is in good condition with no obvious signs of damage.
Initial Setup
^^^^^^^^^^^^^

14
docs/en/hw-reference/esp32/get-started-ethernet-kit-v1.1.rst
View File

@ -23,7 +23,7 @@ Overview
ESP32-Ethernet-Kit is an ESP32-based development board produced by `Espressif <https://espressif.com>`_.
It consists of two development boards, the Ethernet board A and the PoE board B. The :ref:`Ethernet board (A) <get-started-esp32-ethernet-kit-a-v1.1-layout>` contains Bluetooth / Wi-Fi dual-mode ESP32-WROVER-B module and IP101GRI, a Single Port 10/100 Fast Ethernet Transceiver (PHY). The `PoE board (B)`_ provides power over Ethernet functionality. The A board can work independently, without the board B installed.
It consists of two development boards, the Ethernet board A and the PoE board B. The :ref:`Ethernet board (A) <get-started-esp32-ethernet-kit-a-v1.1-layout>` contains Bluetooth®/Wi-Fi dual-mode ESP32-WROVER-B module and IP101GRI, a Single Port 10/100 Fast Ethernet Transceiver (PHY). The `PoE board (B)`_ provides power over Ethernet functionality. The A board can work independently, without the board B installed.
.. _get-started-esp32-ethernet-kit-v1.1:
@ -101,7 +101,7 @@ The table below provides description starting from the picture's top right corne
* - Board B Connectors
- A pair male and female header pins for mounting the `PoE board (B)`_.
* - IP101GRI (PHY)
- The physical layer (PHY) connection to the Ethernet cable is implemented using the `IP101GRI <http://www.bdtic.com/DataSheet/ICplus/IP101G_DS_R01_20121224.pdf>`_ chip. The connection between PHY and ESP32 is done through the reduced media-independent interface (RMII), a variant of the media-independent interface `(MII) <https://en.wikipedia.org/wiki/Media-independent_interface>`_ standard. The PHY supports the IEEE 802.3 / 802.3u standard of 10/100 Mbps.
- The physical layer (PHY) connection to the Ethernet cable is implemented using the `IP101GRI <http://www.bdtic.com/DataSheet/ICplus/IP101G_DS_R01_20121224.pdf>`_ chip. The connection between PHY and ESP32 is done through the reduced media-independent interface (RMII), a variant of the media-independent interface `(MII) <https://en.wikipedia.org/wiki/Media-independent_interface>`_ standard. The PHY supports the IEEE 802.3/802.3u standard of 10/100 Mbps.
* - RJ45 Port
- Ethernet network data transmission port.
* - Magnetics Module
@ -178,7 +178,7 @@ DIP SW GPIO Pin
RMII Clock Selection
^^^^^^^^^^^^^^^^^^^^
The ethernet MAC and PHY under RMII working mode need a common 50 MHz reference clock (i.e. RMII clock) that can be provided either externally, or generated from internal ESP32 APLL.
The ethernet MAC and PHY under RMII working mode need a common 50 MHz reference clock (i.e., RMII clock) that can be provided either externally, or generated from internal ESP32 APLL.
.. note::
@ -214,7 +214,7 @@ Another option is to source the RMII Clock from internal ESP32 APLL, see figure
RMII Clock from ESP Internal APLL
To implement this option, users need to remove or add some RC components on the board. For details please refer to `ESP32-Ethernet-Kit V1.1 Ethernet board (A) schematic`_, sheet 2, location D2. Please note that if the APLL is already used for other purposes (e.g. I2S peripheral), then you have no choice but use an external RMII clock.
To implement this option, users need to remove or add some RC components on the board. For details please refer to `ESP32-Ethernet-Kit V1.1 Ethernet board (A) schematic`_, sheet 2, location D2. Please note that if the APLL is already used for other purposes (e.g., I2S peripheral), then you have no choice but use an external RMII clock.
GPIO Allocation
@ -295,7 +295,7 @@ This header contains GPIOs that may be used for other purposes depending on scen
.. note::
1. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-B module and therefore not available for use. If you need to use these pins, please solder a module without PSRAM memory inside, e.g. the ESP32-WROOM-32D or ESP32-SOLO-1.
1. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-B module and therefore not available for use. If you need to use these pins, please solder a module without PSRAM memory inside, e.g., the ESP32-WROOM-32D or ESP32-SOLO-1.
2. Functionality depends on the settings of the `Function Switch`_.
@ -335,9 +335,9 @@ GPIO Allocation Summary
.. note::
1. To prevent the power-on state of the GPIO0 from being affected by the clock output on the PHY side, the RESET_N signal to PHY defaults to low, turning the clock output off. After power-on you can control RESET_N with GPIO5 to turn the clock output on. See also `RMII Clock Sourced Externally by PHY`_. For PHYs that cannot turn off the clock output through RESET_N, it is recommended to use a crystal module that can be disabled / enabled externally. Similarly like when using RESET_N, the oscillator module should be disabled by default and turned on by ESP32 after power-up. For a reference design please see `ESP32-Ethernet-Kit V1.1 Ethernet board (A) schematic`_.
1. To prevent the power-on state of the GPIO0 from being affected by the clock output on the PHY side, the RESET_N signal to PHY defaults to low, turning the clock output off. After power-on you can control RESET_N with GPIO5 to turn the clock output on. See also `RMII Clock Sourced Externally by PHY`_. For PHYs that cannot turn off the clock output through RESET_N, it is recommended to use a crystal module that can be disabled/enabled externally. Similarly like when using RESET_N, the oscillator module should be disabled by default and turned on by ESP32 after power-up. For a reference design please see `ESP32-Ethernet-Kit V1.1 Ethernet board (A) schematic`_.
2. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-B module and therefore not available for use. If you need to use these pins, please solder a module without PSRAM memory inside, e.g. the ESP32-WROOM-32D or ESP32-SOLO-1.
2. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-B module and therefore not available for use. If you need to use these pins, please solder a module without PSRAM memory inside, e.g., the ESP32-WROOM-32D or ESP32-SOLO-1.
Start Application Development

20
docs/en/hw-reference/esp32/get-started-ethernet-kit.rst
View File

@ -17,6 +17,7 @@ The :ref:`ESP32-Ethernet-Kit <get-started-esp32-ethernet-kit-v1.2>` is an Ethern
ESP32-Ethernet-Kit V1.2 Overview (click to enlarge)
What You Need
-------------
@ -32,7 +33,7 @@ Overview
ESP32-Ethernet-Kit is an ESP32-based development board produced by `Espressif <https://espressif.com>`_.
It consists of two development boards, the Ethernet board A and the PoE board B. The :ref:`Ethernet board (A) <get-started-esp32-ethernet-kit-a-v1.2-layout>` contains Bluetooth/Wi-Fi dual-mode ESP32-WROVER-E module and IP101GRI, a Single Port 10/100 Fast Ethernet Transceiver (PHY). The `PoE board (B)`_ provides power over Ethernet functionality. The A board can work independently, without the board B installed.
It consists of two development boards, the Ethernet board A and the PoE board B. The :ref:`Ethernet board (A) <get-started-esp32-ethernet-kit-a-v1.2-layout>` contains Bluetooth®/Wi-Fi dual-mode ESP32-WROVER-E module and IP101GRI, a Single Port 10/100 Fast Ethernet Transceiver (PHY). The `PoE board (B)`_ provides power over Ethernet functionality. The A board can work independently, without the board B installed.
.. _get-started-esp32-ethernet-kit-v1.2:
@ -127,7 +128,8 @@ The table below provides description starting from the picture's top right corne
.. note::
Automatic firmware download is supported. If following steps and using software described in Section `Start Application Development`_, users don't need to do any operation with BOOT button or EN button.
Automatic firmware download is supported. If following steps and using software described in Section `Start Application Development`_, users do not need to do any operation with BOOT button or EN button.
PoE Board (B)
^^^^^^^^^^^^^
@ -160,8 +162,8 @@ To take advantage of the PoE functionality the **RJ45 Port** of the Ethernet boa
* - External Power Terminals
- Optional power supply (26.6 ~ 54 V) to the PoE board (B).
.. _get-started-esp32-ethernet-kit-v1.2-setup-options:
.. _get-started-esp32-ethernet-kit-v1.2-setup-options:
Setup Options
-------------
@ -187,7 +189,7 @@ DIP SW GPIO Pin
RMII Clock Selection
^^^^^^^^^^^^^^^^^^^^
The ethernet MAC and PHY under RMII working mode need a common 50 MHz reference clock (i.e. RMII clock) that can be provided either externally, or generated from internal ESP32 APLL (not recommended).
The ethernet MAC and PHY under RMII working mode need a common 50 MHz reference clock (i.e., RMII clock) that can be provided either externally, or generated from internal ESP32 APLL (not recommended).
.. note::
@ -223,7 +225,7 @@ Another option is to source the RMII Clock from internal ESP32 APLL, see figure
RMII Clock from ESP Internal APLL
To implement this option, users need to remove or add some RC components on the board. For details please refer to `ESP32-Ethernet-Kit V1.2 Ethernet board (A) schematic`_, sheet 2, location D2. Please note that if the APLL is already used for other purposes (e.g. I2S peripheral), then you have no choice but use an external RMII clock.
To implement this option, users need to remove or add some RC components on the board. For details please refer to `ESP32-Ethernet-Kit V1.2 Ethernet board (A) schematic`_, sheet 2, location D2. Please note that if the APLL is already used for other purposes (e.g., I2S peripheral), then you have no choice but use an external RMII clock.
GPIO Allocation
@ -262,7 +264,7 @@ No. ESP32 Pin (MAC) IP101GRI (PHY)
.. note::
The allocation of all pins under the ESP32's *RMII Interface* is fixed and cannot be changed either through IO MUX or GPIO Matrix. REF_CLK can only be selected from GPIO0, GPIO16 or GPIO17 and it can not be changed through GPIO Matrix.
The allocation of all pins under the ESP32's *RMII Interface* is fixed and cannot be changed either through IO MUX or GPIO Matrix. REF_CLK can only be selected from GPIO0, GPIO16 or GPIO17 and it can not be changed through GPIO Matrix.
GPIO Header 1
@ -304,7 +306,7 @@ No. ESP32 Pin Comments
.. note::
1. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-E module and therefore not available for use. If you need to use these pins, please solder a module without PSRAM memory inside, e.g. the ESP32-WROOM-32D or ESP32-SOLO-1.
1. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-E module and therefore not available for use. If you need to use these pins, please solder a module without PSRAM memory inside, e.g., the ESP32-WROOM-32D or ESP32-SOLO-1.
2. Functionality depends on the settings of the `Function Switch`_.
@ -346,7 +348,7 @@ GPIO Allocation Summary
1. To prevent the power-on state of the GPIO0 from being affected by the clock output on the PHY side, the RESET_N signal to PHY defaults to low, turning the clock output off. After power-on you can control RESET_N with GPIO5 to turn the clock output on. See also `RMII Clock Sourced Externally by PHY`_. For PHYs that cannot turn off the clock output through RESET_N, it is recommended to use a crystal module that can be disabled/enabled externally. Similarly like when using RESET_N, the oscillator module should be disabled by default and turned on by ESP32 after power-up. For a reference design please see `ESP32-Ethernet-Kit V1.2 Ethernet board (A) schematic`_.
2. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-E module and therefore not available for use. If you need to use these pins, please solder a module without PSRAM memory inside, e.g. the ESP32-WROOM-32D or ESP32-SOLO-1.
2. The ESP32 pins GPIO16 and GPIO17 are not broken out to the ESP32-WROVER-E module and therefore not available for use. If you need to use these pins, please solder a module without PSRAM memory inside, e.g., the ESP32-WROOM-32D or ESP32-SOLO-1.
Start Application Development
@ -382,7 +384,7 @@ After setting up the development environment and testing the board, you can conf
Summary of Changes from ESP32-Ethernet-Kit V1.1
-----------------------------------------------
* Correct the placement of GPIO pin number marking on the board’s silkscreen besides the DIP switch.
* Correct the placement of GPIO pin number marking on the board's silkscreen besides the DIP switch.
* Values of C1, C2, C42, and C43 are updated to 20 pF. For more information, please check `ESP32-Ethernet-Kit V1.2 Ethernet board (A) schematic`_.
* Replace ESP32-WROVER-B with ESP32-WROVER-E.

47
docs/en/hw-reference/esp32/get-started-pico-devkitm-2.rst
View File

@ -1,14 +1,14 @@
ESP32-PICO-DevKitM-2
*********************
********************
:link_to_translation:`zh_CN:[中文]`
Overview
===========
========
ESP32-PICO-DevKitM-2 is an ESP32-based development board produced by `Espressif <https://espressif.com>`_.
The core of this board is `ESP32-PICO-MINI-02(02U) <https://www.espressif.com/en/products/modules>`_ module with complete Wi-Fi and Bluetooth functionalities. The development board features a USB-to-UART Bridge circuit which allows developers to connect the board to a computer's USB port for flashing and debugging.
The core of this board is `ESP32-PICO-MINI-02(02U) <https://www.espressif.com/en/products/modules>`_ module with complete Wi-Fi and Bluetooth® functionalities. The development board features a USB-to-UART Bridge circuit which allows developers to connect the board to a computer's USB port for flashing and debugging.
All the IO signals and system power on ESP32-PICO-MINI-02(02U) are led out to two rows of 18 x 0.1" header pads on both sides of the development board for easy access. For compatibility with Dupont wires, all header pads are populated with two rows of male pin headers.
@ -30,19 +30,21 @@ This guide covers:
- `Getting Started`_: Provides an overview of the ESP32-PICO-DevKitM-2 and software setup instructions to get started.
- `Contents and Packaging`_: Provides information about packaging and contents for retail and wholesale orders.
- `Hardware Reference`_: Provides more detailed information about the ESP32-PICO-DevKitM-2’s hardware.
- `Hardware Reference`_: Provides more detailed information about the ESP32-PICO-DevKitM-2's hardware.
- `Hardware Revision Details`_: Covers revision history, known issues, and links to user guides for previous versions (if any) of the ESP32-PICO-DevKitM-2.
- `Related Documents`_: Gives links to related documentation.
Getting Started
===============
This section describes how to get started with the ESP32-PICO-DevKitM-2. It begins with a few introductory sections about the ESP32-PICO-DevKitM-2, then Section `Start Application Development`_ provides instructions on how to flash firmware onto the ESP32-PICO-DevKitM-2.
.. _get-started-pico-devkitm-2-board-front:
Description of Components
-----------------------------
-------------------------
The following figure and the table below describe the key components, interfaces, and controls of the ESP32-PICO-DevKitM-2 board. We take the board with a ESP32-PICO-MINI-02 module as an example in the following sections.
@ -79,47 +81,53 @@ Below is the description of the items identified in the figure starting from the
* - EN Button
- Reset button.
Start Application Development
-----------------------------
Before powering up your ESP32-PICO-DevKitM-2, please make sure that the board is in good condition with no obvious signs of damage.
Required Hardware
""""""""""""""""""""""""
"""""""""""""""""
- 1 x ESP32-PICO-DevKitM-2
- 1 x USB 2.0 A to Micro B cable
- 1 x Computer running Windows, Linux, or macOS
.. _user-guide-pico-devkitm-2-software-setup:
Software Setup
""""""""""""""""""""""""
""""""""""""""
Please proceed to :doc:`../../get-started/index`, where Section :ref:`get-started-step-by-step` will quickly help you set up the development environment.
Contents and Packaging
=======================
======================
Retail Orders
---------------
-------------
If you order one or several samples of the board, each ESP32-PICO-DevKitM-2 development board comes in an individual package.
For retail orders, please go to https://www.espressif.com/en/contact-us/get-samples.
Wholesale Orders
------------------
----------------
If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
Hardware Reference
=======================
==================
Block Diagram
------------------
-------------
The block diagram below shows the main components of ESP32-PICO-DevKitM-2 and their interconnections.
@ -131,6 +139,7 @@ The block diagram below shows the main components of ESP32-PICO-DevKitM-2 and th
ESP32-PICO-DevKitM-2 Block Diagram (click to enlarge)
Power Supply Options
--------------------
@ -150,8 +159,9 @@ Pin Descriptions
The two tables below provide the **Name** and **Function** of I/O header pins on both sides of the board, see :ref:`get-started-pico-devkitm-2-board-front`. The pin numbering and header names are the same as in the schematic given in `Related Documents`_.
Header J2
""""""""""""
"""""""""
.. list-table::
:widths: 5 5 5 35
@ -236,7 +246,7 @@ Header J2
Header J3
"""""""""""""
"""""""""
.. list-table::
:widths: 5 5 5 35
@ -328,10 +338,11 @@ Header J3
2. 32.768 kHz crystal oscillator:
a) input
b) output
3. The operating voltage of ESP32-PICO-DevKitM-2’s embedded SPI flash is 3.3 V. Therefore, the strapping pin MTDI should be pulled down during the module power-on reset. If connected, please make sure that this pin is not held up on reset.
3. The operating voltage of ESP32-PICO-DevKitM-2's embedded SPI flash is 3.3 V. Therefore, the strapping pin MTDI should be pulled down during the module power-on reset. If connected, please make sure that this pin is not held up on reset.
Pin Layout
""""""""""""
""""""""""
.. figure:: ../../../_static/esp32-pico-devkitm-2-pinout.png
:align: center
:scale: 50%
@ -340,13 +351,15 @@ Pin Layout
ESP32-PICO-DevKitM-2 Pin Layout (click to enlarge)
Hardware Revision Details
=========================
No previous versions available.
Related Documents
=========================
=================
* `ESP32-PICO-MINI-02 & ESP32-PICO-MINI-1U Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-pico-mini-02_datasheet_en.pdf>`_ (PDF)
* `ESP Product Selector <https://products.espressif.com/#/product-selector?names=>`_

44
docs/en/hw-reference/esp32/get-started-pico-kit-1.rst
View File

@ -1,14 +1,14 @@
ESP32-PICO-KIT-1
*****************
****************
:link_to_translation:`zh_CN:[中文]`
Overview
===========
========
ESP32-PICO-KIT-1 is an ESP32-based development board produced by `Espressif <https://espressif.com>`_.
The core of this board is `ESP32-PICO-V3 <https://www.espressif.com/en/products/socs>`_ - a System-in-Package (SiP) module with complete Wi-Fi and Bluetooth functionalities. Compared to other ESP32 modules, ESP32-PICO-V3 integrates the following peripheral components in one single package, which otherwise would need to be installed separately:
The core of this board is `ESP32-PICO-V3 <https://www.espressif.com/en/products/socs>`_ - a System-in-Package (SiP) module with complete Wi-Fi and Bluetooth® functionalities. Compared to other ESP32 modules, ESP32-PICO-V3 integrates the following peripheral components in one single package, which otherwise would need to be installed separately:
- 40 MHz crystal oscillator
- 4 MB flash
@ -39,19 +39,21 @@ This guide covers:
- `Getting Started`_: Provides an overview of the ESP32-PICO-KIT-1 and software setup instructions to get started.
- `Contents and Packaging`_: Provides information about packaging and contents for retail and wholesale orders.
- `Hardware Reference`_: Provides more detailed information about the ESP32-PICO-KIT-1’s hardware.
- `Hardware Reference`_: Provides more detailed information about the ESP32-PICO-KIT-1's hardware.
- `Hardware Revision Details`_: Covers revision history, known issues, and links to user guides for previous versions of the ESP32-PICO-KIT-1.
- `Related Documents`_: Gives links to related documentation.
Getting Started
================
===============
This section describes how to get started with the ESP32-PICO-KIT-1. It begins with a few introductory sections about the ESP32-PICO-KIT-1, then Section `Start Application Development`_ provides instructions on how to flash firmware onto the ESP32-PICO-KIT-1.
.. _get-started-pico-kit-1-board-front:
Description of Components
--------------------------
-------------------------
The following figure and the table below describe the key components, interfaces, and controls of the ESP32-PICO-KIT-1 board.
@ -89,31 +91,34 @@ Below is the description of the items identified in the figure starting from the
* - EN Button
- Reset button.
Start Application Development
-----------------------------
Before powering up your ESP32-PICO-KIT-1, please make sure that the board is in good condition with no obvious signs of damage.
Required Hardware
"""""""""""""""""""
"""""""""""""""""
- 1 x ESP32-PICO-KIT-1
- 1 x USB 2.0 A to Micro B cable
- 1 x Computer running Windows, Linux, or macOS
.. _user-guide-pico-kit-1-software-setup:
Software Setup
""""""""""""""""
""""""""""""""
Please proceed to :doc:`../../get-started/index`, where Section :ref:`get-started-step-by-step` will quickly help you set up the development environment.
Contents and Packaging
=======================
======================
Retail Orders
---------------
-------------
If you order one or several samples of the board, each ESP32-PICO-KIT-1 development board comes in an individual package.
@ -121,17 +126,18 @@ For retail orders, please go to https://www.espressif.com/en/contact-us/get-samp
Wholesale Orders
------------------
----------------
If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
Hardware Reference
===================
==================
Block Diagram
--------------
-------------
The block diagram below shows the main components of ESP32-PICO-KIT-1 and their interconnections.
@ -143,6 +149,7 @@ The block diagram below shows the main components of ESP32-PICO-KIT-1 and their
ESP32-PICO-KIT-1 Block Diagram (click to enlarge)
Power Supply Options
--------------------
@ -162,8 +169,9 @@ Pin Descriptions
The two tables below provide the **Name** and **Function** of I/O header pins on both sides of the board, see :ref:`get-started-pico-kit-1-board-front`. The pin numbering and header names are the same as in the schematic given in `Related Documents`_.
Header J2
""""""""""""
"""""""""
.. list-table::
:widths: 5 5 5 35
@ -340,11 +348,11 @@ Header J3
2. 32.768 kHz crystal oscillator:
a) input
b) output
3. The operating voltage of ESP32-PICO-KIT-1’s embedded SPI flash is 3.3 V. Therefore, the strapping pin MTDI should be pulled down during the module power-on reset. If connected, please make sure that this pin is not held up on reset.
3. The operating voltage of ESP32-PICO-KIT-1's embedded SPI flash is 3.3 V. Therefore, the strapping pin MTDI should be pulled down during the module power-on reset. If connected, please make sure that this pin is not held up on reset.
Pin Layout
""""""""""""
""""""""""
.. figure:: ../../../_static/esp32-pico-kit-1-pinout.png
:align: center
:scale: 50%
@ -353,13 +361,15 @@ Pin Layout
ESP32-PICO-KIT-1 Pin Layout(click to enlarge)
Hardware Revision Details
=========================
No previous versions available.
Related Documents
===================
=================
* `ESP32-PICO-V3 Datasheet <https://espressif.com/sites/default/files/documentation/esp32-pico-v3_datasheet_en.pdf>`_ (PDF)
* `ESP Product Selector <https://products.espressif.com/#/product-selector?names=>`_

1
docs/en/hw-reference/esp32/get-started-pico-kit-v3.rst
View File

@ -1,5 +1,6 @@
ESP32-PICO-KIT V3 Getting Started Guide
=======================================
: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`.

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

@ -1,5 +1,6 @@
ESP32-PICO-KIT V4 / V4.1 Getting Started Guide
==============================================
ESP32-PICO-KIT V4/V4.1 Getting Started Guide
============================================
: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`.
@ -22,7 +23,7 @@ Overview
ESP32-PICO-KIT is an ESP32-based mini development board produced by `Espressif <https://espressif.com>`_.
The core of this board is ESP32-PICO-D4 - a System-in-Package (SiP) module with complete Wi-Fi and Bluetooth functionalities. Compared to other ESP32 modules, ESP32-PICO-D4 integrates the following peripheral components in one single package, which otherwise would need to be installed separately:
The core of this board is ESP32-PICO-D4 - a System-in-Package (SiP) module with complete Wi-Fi and Bluetooth® functionalities. Compared to other ESP32 modules, ESP32-PICO-D4 integrates the following peripheral components in one single package, which otherwise would need to be installed separately:
- 40 MHz crystal oscillator
- 4 MB flash
@ -40,6 +41,7 @@ All the IO signals and system power on ESP32-PICO-D4 are led out to two rows of
1. There are two versions of ESP32-PICO-KIT boards, respectively with male headers and female headers. In this guide, the male header version is taken as an example.
2. The 2 x 3 pads not populated with pin headers are connected to the flash memory embedded in the ESP32-PICO-D4 SiP module. For more details, see module's datasheet in `Related Documents`_.
Functionality Overview
----------------------
@ -186,10 +188,11 @@ No. Name Type Function
1. This pin is connected to the flash pin of ESP32-PICO-D4.
2. 32.768 kHz crystal oscillator: a) input, b) output.
3. This pin is connected to the pin of the USB bridge chip on the board.
4. The operating voltage of ESP32-PICO-KIT’s embedded SPI flash is 3.3 V. Therefore, the strapping pin MTDI should hold bit zero during the module power-on reset. If connected, please make sure that this pin is not held up on reset.
4. The operating voltage of ESP32-PICO-KIT's embedded SPI flash is 3.3 V. Therefore, the strapping pin MTDI should hold bit zero during the module power-on reset. If connected, please make sure that this pin is not held up on reset.
Pin Layout
^^^^^^^^^^^
^^^^^^^^^^
.. figure:: ../../../_static/esp32-pico-kit-v4-pinout.png
:align: center
:scale: 43%
@ -197,6 +200,7 @@ Pin Layout
ESP32-PICO-KIT Pin Layout (click to enlarge)
Start Application Development
-----------------------------

4
docs/en/hw-reference/esp32/get-started-wrover-kit-v2.rst
View File

@ -1,5 +1,6 @@
ESP-WROVER-KIT V2 Getting Started Guide
=======================================
:link_to_translation:`zh_CN:[中文]`
This guide shows how to get started with the ESP-WROVER-KIT V2 development board and also provides information about its functionality and configuration options. For the description of other ESP-WROVER-KIT versions, please check :doc:`../../hw-reference/index`.
@ -9,7 +10,7 @@ What You Need
-------------
* ESP-WROVER-KIT V2 board
* USB 2.0 cable（A to Micro-B）
* USB 2.0 cable (A to Micro-B)
* Computer running Windows, Linux, or macOS
You can skip the introduction sections and go directly to Section `Start Application Development`_.
@ -169,6 +170,7 @@ Do not install any other jumpers.
Turn the **Power Switch** to ON, the **5V Power On LED** should light up.
Now to Development
^^^^^^^^^^^^^^^^^^

89
docs/en/hw-reference/esp32/get-started-wrover-kit-v3.rst
View File

@ -1,5 +1,6 @@
ESP-WROVER-KIT V3 Getting Started Guide
=======================================
: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`.
@ -9,7 +10,7 @@ What You Need
-------------
* :ref:`ESP-WROVER-KIT V3 board <get-started-esp-wrover-kit-v3-board-front>`
* USB 2.0 cable（A to Micro-B）
* USB 2.0 cable (A to Micro-B)
* Computer running Windows, Linux, or macOS
You can skip the introduction sections and go directly to Section `Start Application Development`_.
@ -80,7 +81,7 @@ The table below provides description in the following manner:
:widths: 25 75
:header-rows: 1
* - Key Component
* - Key Component
- Description
* - 32.768 kHz
- External precision 32.768 kHz crystal oscillator serves as a clock with low-power consumption while the chip is in Deep-sleep mode.
@ -123,6 +124,7 @@ The table below provides description in the following manner:
* - LCD
- Support for mounting and interfacing a 3.2” SPI (standard 4-wire Serial Peripheral Interface) LCD, as shown on figure :ref:`get-started-esp-wrover-kit-v3-board-back`.
.. _get-started-esp-wrover-kit-v3-setup-options:
Setup Options
@ -144,17 +146,17 @@ JP14 |jp14| Enable RTS/CTS flow control for serial communication
Allocation of ESP32 Pins
------------------------
Some pins / terminals of ESP32 are allocated for use with the onboard or external hardware. If that hardware is not used, e.g., nothing is plugged into the Camera (JP4) header, then these GPIOs can be used for other purposes.
Some pins/terminals of ESP32 are allocated for use with the onboard or external hardware. If that hardware is not used, e.g., nothing is plugged into the Camera (JP4) header, then these GPIOs can be used for other purposes.
Some of the pins, such as GPIO0 or GPIO2, have multiple functions and some of them are shared among onboard and external peripheral devices. Certain combinations of peripherals cannot work together. For example, it is not possible to do JTAG debugging of an application that is using SD card, because several pins are shared by JTAG and the SD card slot.
In other cases, peripherals can coexist under certain conditions. This is applicable to, for example, LCD screen and SD card that share only a single pin GPIO21. This pin is used to provide D/C (Data / Control) signal for the LCD as well as the CD (Card Detect) signal read from the SD card slot. If the card detect functionality is not essential, then it may be disabled by removing R167, so both LCD and SD may operate together.
In other cases, peripherals can coexist under certain conditions. This is applicable to, for example, LCD screen and SD card that share only a single pin GPIO21. This pin is used to provide D/C (Data/Control) signal for the LCD as well as the CD (Card Detect) signal read from the SD card slot. If the card detect functionality is not essential, then it may be disabled by removing R167, so both LCD and SD may operate together.
For more details on which pins are shared among which peripherals, please refer to the table in the next section.
Main I/O Connector / JP1
^^^^^^^^^^^^^^^^^^^^^^^^
Main I/O Connector/JP1
^^^^^^^^^^^^^^^^^^^^^^
The JP1 connector consists of 14x2 male pins whose functions are shown in the middle two "I/O" columns of the table below. The two "Shared With" columns on both sides describe where else on the board a certain GPIO is used.
@ -203,23 +205,23 @@ Legend:
.. note::
Since GPIO32 and GPIO33 are connected to the oscillator by default, they are not connected to the JP1 I/O connector to maintain signal integrity. This allocation may be changed from the oscillator to JP1 by desoldering the zero-ohm resistors from positions R11 / R23 and re-soldering them to positions R12 / R24.
Since GPIO32 and GPIO33 are connected to the oscillator by default, they are not connected to the JP1 I/O connector to maintain signal integrity. This allocation may be changed from the oscillator to JP1 by desoldering the zero-ohm resistors from positions R11/R23 and re-soldering them to positions R12/R24.
.. _get-started-esp-wrover-kit-v3-spi-flash-header:
SPI Flash / JP13
^^^^^^^^^^^^^^^^
SPI Flash/JP13
^^^^^^^^^^^^^^
==== =============
. ESP32 Pin
==== =============
1 CLK / GPIO6
2 SD0 / GPIO7
3 SD1 / GPIO8
4 SD2 / GPIO9
5 SD3 / GPIO10
6 CMD / GPIO11
1 CLK/GPIO6
2 SD0/GPIO7
3 SD1/GPIO8
4 SD2/GPIO9
5 SD3/GPIO10
6 CMD/GPIO11
==== =============
.. important::
@ -229,23 +231,23 @@ SPI Flash / JP13
.. _get-started-esp-wrover-kit-v3-jtag-header:
JTAG / JP8
JTAG/JP8
^^^^^^^^^^
==== ============== =============
. ESP32 Pin JTAG Signal
==== ============== =============
1 EN TRST_N
2 MTMS / GPIO14 TMS
3 MTDO / GPIO15 TDO
4 MTDI / GPIO12 TDI
5 MTCK / GPIO13 TCK
2 MTMS/GPIO14 TMS
3 MTDO/GPIO15 TDO
4 MTDI/GPIO12 TDI
5 MTCK/GPIO13 TCK
==== ============== =============
.. _get-started-esp-wrover-kit-v3-camera-header:
Camera / JP4
Camera/JP4
^^^^^^^^^^^^
==== ========== =============================
@ -253,22 +255,22 @@ Camera / JP4
==== ========== =============================
1 n/a 3.3V
2 n/a Ground
3 GPIO27 SIO_C / SCCB Clock
4 GPIO26 SIO_D / SCCB Data
5 GPIO25 VSYNC / Vertical Sync
6 GPIO23 HREF / Horizontal Reference
7 GPIO22 PCLK / Pixel Clock
8 GPIO21 XCLK / System Clock
9 GPIO35 D7 / Pixel Data Bit 7
10 GPIO34 D6 / Pixel Data Bit 6
11 GPIO39 D5 / Pixel Data Bit 5
12 GPIO36 D4 / Pixel Data Bit 4
13 GPIO19 D3 / Pixel Data Bit 3
14 GPIO18 D2 / Pixel Data Bit 2
15 GPIO5 D1 / Pixel Data Bit 1
16 GPIO4 D0 / Pixel Data Bit 0
17 GPIO0 RESET / Camera Reset
18 n/a PWDN / Camera Power Down
3 GPIO27 SIO_C/SCCB Clock
4 GPIO26 SIO_D/SCCB Data
5 GPIO25 VSYNC/Vertical Sync
6 GPIO23 HREF/Horizontal Reference
7 GPIO22 PCLK/Pixel Clock
8 GPIO21 XCLK/System Clock
9 GPIO35 D7/Pixel Data Bit 7
10 GPIO34 D6/Pixel Data Bit 6
11 GPIO39 D5/Pixel Data Bit 5
12 GPIO36 D4/Pixel Data Bit 4
13 GPIO19 D3/Pixel Data Bit 3
14 GPIO18 D2/Pixel Data Bit 2
15 GPIO5 D1/Pixel Data Bit 1
16 GPIO4 D0/Pixel Data Bit 0
17 GPIO0 RESET/Camera Reset
18 n/a PWDN/Camera Power Down
==== ========== =============================
* Signals D0 .. D7 denote camera data bus
@ -296,10 +298,10 @@ microSD Card
==== ============== ===============
. ESP32 Pin microSD Signal
==== ============== ===============
1 MTDI / GPIO12 DATA2
2 MTCK / GPIO13 CD / DATA3
3 MTDO / GPIO15 CMD
4 MTMS / GPIO14 CLK
1 MTDI/GPIO12 DATA2
2 MTCK/GPIO13 CD/DATA3
3 MTDO/GPIO15 CMD
4 MTMS/GPIO14 CLK
5 GPIO2 DATA0
6 GPIO4 DATA1
7 GPIO21 CD
@ -308,8 +310,8 @@ microSD Card
.. _get-started-esp-wrover-kit-v3-lcd-connector:
LCD / U5
^^^^^^^^
LCD/U5
^^^^^^
==== ============== ===============
. ESP32 Pin LCD Signal
@ -351,6 +353,7 @@ Do not install any other jumpers.
Turn the **Power Switch** to ON, the **5V Power On LED** should light up.
Now to Development
^^^^^^^^^^^^^^^^^^

17
docs/en/hw-reference/esp32/get-started-wrover-kit.rst
View File

@ -1,5 +1,6 @@
ESP-WROVER-KIT V4.1 Getting Started Guide
=========================================
: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.
@ -9,7 +10,7 @@ What You Need
-------------
* :ref:`ESP-WROVER-KIT V4.1 board <get-started-esp-wrover-kit-v4.1-board-front>`
* USB 2.0 cable（A to Micro-B）
* USB 2.0 cable (A to Micro-B)
* Computer running Windows, Linux, or macOS
You can skip the introduction sections and go directly to Section `Start Application Development`_.
@ -129,7 +130,6 @@ The table below provides description in the following manner:
- Support for mounting and interfacing a 3.2” SPI (standard 4-wire Serial Peripheral Interface) LCD, as shown in figure :ref:`get-started-esp-wrover-kit-v4.1-board-back`.
.. _get-started-esp-wrover-kit-v4.1-setup-options:
Setup Options
@ -173,8 +173,8 @@ In other cases, peripherals can coexist under certain conditions. This is applic
For more details on which pins are shared among which peripherals, please refer to the table in the next section.
Main I/O Connector / JP1
^^^^^^^^^^^^^^^^^^^^^^^^
Main I/O Connector/JP1
^^^^^^^^^^^^^^^^^^^^^^
The JP1 connector consists of 14x2 male pins whose functions are shown in the middle two "I/O" columns of the table below. The two "Shared With" columns on both sides describe where else on the board a certain GPIO is used.
@ -275,7 +275,7 @@ Legend:
.. _get-started-esp-wrover-kit-v4.1-spi-flash-header:
SPI Flash/JP2
^^^^^^^^^^^^^^^
^^^^^^^^^^^^^
==== =============
. ESP32 Pin
@ -300,7 +300,7 @@ SPI Flash/JP2
.. _get-started-esp-wrover-kit-v4.1-jtag-header:
JTAG/JP2
^^^^^^^^^^
^^^^^^^^
==== ============== =============
. ESP32 Pin JTAG Signal
@ -316,7 +316,7 @@ JTAG/JP2
.. _get-started-esp-wrover-kit-v4.1-camera-header:
Camera/JP4
^^^^^^^^^^^^
^^^^^^^^^^
==== ========== =============================
. ESP32 Pin Camera Signal
@ -379,7 +379,7 @@ microSD Card
.. _get-started-esp-wrover-kit-v4.1-lcd-connector:
LCD/U5
^^^^^^^^
^^^^^^
==== ============== ===============
. ESP32 Pin LCD Signal
@ -421,6 +421,7 @@ Do not install any other jumpers.
Turn the **Power Switch** to ON, and the **5 V Power On LED** should light up.
Now to Development
^^^^^^^^^^^^^^^^^^

45
docs/en/hw-reference/esp32/user-guide-devkitm-1.rst
View File

@ -1,6 +1,6 @@
===================
ESP32-DevKitM-1
===================
===============
ESP32-DevKitM-1
===============
:link_to_translation:`zh_CN:[中文]`
@ -28,13 +28,13 @@ The document consists of the following major sections:
Getting Started
===================
===============
This section describes how to get started with ESP32-DevKitM-1. It begins with a few introductory sections about the ESP32-DevKitM-1, then Section `Start Application Development`_ provides instructions on how to do the initial hardware setup and then how to flash firmware onto the ESP32-DevKitM-1.
Overview
-------------
--------
This is a small and convenient development board that features:
@ -46,10 +46,10 @@ This is a small and convenient development board that features:
Contents and Packaging
--------------------------
----------------------
Retail orders
^^^^^^^^^^^^^^^^^^^^^^^^^^
Retail Orders
^^^^^^^^^^^^^
If you order a few samples, each ESP32-DevKitM-1 comes in an individual package in either antistatic bag or any packaging depending on your retailer.
@ -57,14 +57,15 @@ For retail orders, please go to https://www.espressif.com/en/contact-us/get-samp
Wholesale Orders
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^
If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
Description of Components
----------------------------
-------------------------
The following figure and the table below describe the key components, interfaces and controls of the ESP32-DevKitM-1 board. We take the board with a ESP32-MINI-1 module as an example in the following sections.
@ -101,15 +102,14 @@ The following figure and the table below describe the key components, interfaces
- All available GPIO pins (except for the SPI bus for flash) are broken out to the pin headers on the board. Users can program ESP32 chip to enable multiple functions.
Start Application Development
----------------------------------
-----------------------------
Before powering up your ESP32-DevKitM-1, please make sure that it is in good condition with no obvious signs of damage.
Required Hardware
^^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^
- ESP32-DevKitM-1
- USB 2.0 cable (Standard-A to Micro-B)
@ -117,7 +117,7 @@ Required Hardware
Software Setup
^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^
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 application example onto your ESP32-DevKitM-1.
@ -125,11 +125,12 @@ Please proceed to :doc:`../../get-started/index`, where Section :ref:`get-starte
ESP32-DevKitM-1 boards manufactured before December 2, 2021 have a single core module installed. To verify what module you have, please check module marking information in `PCN-2021-021 <https://www.espressif.com/sites/default/files/pcn_downloads/PCN-2021-021%20ESP32-U4WDH%20%E5%8D%87%E7%BA%A7%E4%B8%BA%E5%8F%8C%E6%A0%B8%E5%A4%84%E7%90%86%E5%99%A8%E4%BA%A7%E5%93%81.pdf>`_ . If your board has a single core module installed, please enable single core mode (:ref:`CONFIG_FREERTOS_UNICORE`) in :ref:`menuconfig <get-started-configure>` before flashing your applications.
Hardware Reference
======================
==================
Block Diagram
----------------------
-------------
A block diagram below shows the components of ESP32-DevKitM-1 and their interconnections.
@ -142,7 +143,7 @@ A block diagram below shows the components of ESP32-DevKitM-1 and their intercon
Power Source Select
----------------------
-------------------
There are three mutually exclusive ways to provide power to the board:
@ -157,7 +158,7 @@ There are three mutually exclusive ways to provide power to the board:
Pin Descriptions
-------------------
----------------
The table below provides the Name and Function of pins on both sides of the board. For peripheral pin configurations, please refer to `ESP32 Datasheet`_.
@ -302,8 +303,9 @@ The table below provides the Name and Function of pins on both sides of the boar
.. [1] P: Power supply; I: Input; O: Output.
.. [2] MTDI, GPIO0, GPIO2, MTDO, and GPIO5 are strapping pins. These pins are used to control several chip functions depending on binary voltage values applied to the pins during chip power-up or system reset. For description and application of the strapping pins, please refer to `ESP32 Datasheet`_ > Section *Strapping Pins*.
Pin Layout
^^^^^^^^^^^
^^^^^^^^^^
.. figure:: ../../../_static/ESP32_DevKitM-1_pinlayout.png
:align: center
@ -313,14 +315,15 @@ Pin Layout
ESP32-DevKitM-1 (click to enlarge)
Hardware Revision Details
============================
=========================
No previous versions available.
Related Documents
============================
=================
* `ESP32-MINI-1 & ESP32-MINI-1U Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-mini-1_datasheet_en.pdf>`_ (PDF)
* `ESP32-DevKitM-1 Schematics <https://dl.espressif.com/dl/schematics/SCH_ESP32-DEVKITM-1_V1_20200910A.pdf>`_ (PDF)

6
docs/en/hw-reference/esp32/user-guide-devkits-r-v1.1.rst
View File

@ -34,7 +34,6 @@ This section describes how to get started with ESP32-DevKitS(-R). It begins with
Overview
--------
ESP32-DevKitS(-R) is Espressif's flashing board designed specifically for ESP32. It can be used to flash an ESP32 module without soldering the module to the power supply and signal lines. With a module mounted, ESP32-DevKitS(-R) can also be used as a mini development board like ESP32-DevKitC.
ESP32-DevKitS and ESP32-DevKitS-R boards vary only in layout of spring pins to fit the following ESP32 modules.
@ -121,7 +120,6 @@ Please mount a module of your choice onto your ESP32-DevKitS(-R) according to th
- Check whether all spring pins are inserted into castellated holes. If there are some misaligned spring pins, place them into castellated holes with tweezers.
Software Setup
^^^^^^^^^^^^^^
@ -161,7 +159,7 @@ Board Dimensions
Contents and Packaging
----------------------
Retail orders
Retail Orders
^^^^^^^^^^^^^
If you order a few samples, each ESP32-DevKitS(-R) comes in an individual package in either antistatic bag or any packaging depending on a retailer.
@ -180,7 +178,6 @@ For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales
Hardware Reference
==================
Block Diagram
-------------
@ -195,7 +192,6 @@ A block diagram below shows the components of ESP32-DevKitS(-R) and their interc
ESP32-DevKitS(-R) (click to enlarge)
Power Supply Options
^^^^^^^^^^^^^^^^^^^^

25
docs/en/hw-reference/esp32c3/user-guide-devkitc-02.rst
View File

@ -6,7 +6,7 @@ ESP32-C3-DevKitC-02
This user guide will help you get started with ESP32-C3-DevKitC-02 and will also provide more in-depth information.
ESP32-C3-DevKitC-02 is an entry-level development board based on `ESP32-C3-WROOM-02 <https://www.espressif.com/sites/default/files/documentation/esp32-c3-wroom-02_datasheet_en.pdf>`_, a general-purpose module with 4 MB SPI flash. This board integrates complete Wi-Fi and Bluetooth LE functions.
ESP32-C3-DevKitC-02 is an entry-level development board based on `ESP32-C3-WROOM-02 <https://www.espressif.com/sites/default/files/documentation/esp32-c3-wroom-02_datasheet_en.pdf>`_, a general-purpose module with 4 MB SPI flash. This board integrates complete Wi-Fi and Bluetooth® Low Energy functions.
Most of the I/O pins are broken out to the pin headers on both sides for easy interfacing. Developers can either connect peripherals with jumper wires or mount ESP32-C3-DevKitC-02 on a breadboard.
@ -24,11 +24,13 @@ The document consists of the following major sections:
- `Hardware Revision Details`_: Revision history, known issues, and links to user guides for previous versions (if any) of ESP32-C3-DevKitC-02.
- `Related Documents`_: Links to related documentation.
Getting Started
===============
This section provides a brief introduction of ESP32-C3-DevKitC-02, instructions on how to do the initial hardware setup and how to flash firmware onto it.
Description of Components
-------------------------
@ -50,7 +52,7 @@ The key components of the board are described in a counter-clockwise direction.
* - Key Component
- Description
* - ESP32-C3-WROOM-02
- ESP32-C3-WROOM-02 from Espressif is a powerful and general-purpose module that offers Wi-Fi and Bluetooth LE coexistence. It has a PCB antenna and a 4 MB SPI flash.
- ESP32-C3-WROOM-02 from Espressif is a powerful and general-purpose module that offers Wi-Fi and Bluetooth Low Energy coexistence. It has a PCB antenna and a 4 MB SPI flash.
* - 5 V to 3.3 V LDO
- Power regulator that converts a 5 V supply into a 3.3 V output.
* - 5 V Power On LED
@ -74,6 +76,7 @@ Start Application Development
Before powering up your ESP32-C3-DevKitC-02, please make sure that it is in good condition with no obvious signs of damage.
Required Hardware
^^^^^^^^^^^^^^^^^
@ -85,15 +88,17 @@ Required Hardware
Be sure to use an appropriate USB cable. Some cables are for charging only and do not provide the needed data lines nor work for programming the boards.
Software Setup
^^^^^^^^^^^^^^
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 application example into your ESP32-C3-DevKitC-02.
Contents and Packaging
----------------------
Retail orders
Retail Orders
^^^^^^^^^^^^^
If you order a few samples, each ESP32-C3-DevKitC-02 comes in an individual package in either antistatic bag or any packaging depending on your retailer.
@ -108,6 +113,7 @@ If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
Hardware Reference
==================
@ -124,6 +130,7 @@ The block diagram below shows the components of ESP32-C3-DevKitC-02 and their in
ESP32-C3-DevKitC-02 (click to enlarge)
Power Supply Options
^^^^^^^^^^^^^^^^^^^^
@ -135,6 +142,7 @@ There are three mutually exclusive ways to provide power to the board:
It is recommended to use the first option: Micro-USB Port.
.. _user-guide-c3-devkitc-02-v1-header-blocks:
Header Block
@ -142,8 +150,10 @@ Header Block
The two tables below provide the **Name** and **Function** of the pin headers on both sides of the board (J1 and J3). The pin header names are shown in :ref:`user-guide-c3-devkitc-02-v1-board-front`. The numbering is the same as in the `ESP32-C3-DevKitC-02 Schematic`_ (PDF).
J1
^^^
=== ==== ========== ===================================
No. Name Type [1]_ Function
=== ==== ========== ===================================
@ -164,8 +174,10 @@ No. Name Type [1]_ Function
15 G G Ground
=== ==== ========== ===================================
J3
^^^
=== ==== ========== ====================================
No. Name Type [1]_ Function
=== ==== ========== ====================================
@ -189,8 +201,10 @@ No. Name Type [1]_ Function
.. [1] P: Power supply; I: Input; O: Output; T: High impedance.
.. [2] GPIO2, GPIO8, and GPIO9 are strapping pins of the ESP32-C3 chip. These pins are used to control several chip functions depending on binary voltage values applied to the pins during chip power-up or system reset. For description and application of the strapping pins, please refer to Section Strapping Pins in `ESP32-C3 Datasheet`_.
Pin Layout
^^^^^^^^^^^
^^^^^^^^^^
.. figure:: ../../../_static/esp32-c3-devkitc-02-v1-pinout.png
:align: center
:scale: 50%
@ -199,13 +213,16 @@ Pin Layout
ESP32-C3-DevKitC-02 Pin Layout (click to enlarge)
Hardware Revision Details
=========================
No previous versions available.
Related Documents
=================
* `Build Secure and Cost-effective Connected Devices with ESP32-C3 <http://c3.espressif.com/>`_
* `ESP32-C3 Datasheet`_ (PDF)
* `ESP32-C3-WROOM-02 Datasheet`_ (PDF)

23
docs/en/hw-reference/esp32c3/user-guide-devkitm-1.rst
View File

@ -6,7 +6,7 @@ ESP32-C3-DevKitM-1
This user guide will help you get started with ESP32-C3-DevKitM-1 and will also provide more in-depth information.
ESP32-C3-DevKitM-1 is an entry-level development board based on `ESP32-C3-MINI-1 <https://www.espressif.com/sites/default/files/documentation/esp32-c3-mini-1_datasheet_en.pdf>`_, a module named for its small size. This board integrates complete Wi-Fi and Bluetooth LE functions.
ESP32-C3-DevKitM-1 is an entry-level development board based on `ESP32-C3-MINI-1 <https://www.espressif.com/sites/default/files/documentation/esp32-c3-mini-1_datasheet_en.pdf>`_, a module named for its small size. This board integrates complete Wi-Fi and Bluetooth® Low Energy functions.
Most of the I/O pins on the ESP32-C3-MINI-1 module are broken out to the pin headers on both sides of this board for easy interfacing. Developers can either connect peripherals with jumper wires or mount ESP32-C3-DevKitM-1 on a breadboard.
@ -24,11 +24,13 @@ The document consists of the following major sections:
- `Hardware Revision Details`_: Revision history, known issues, and links to user guides for previous versions (if any) of ESP32-C3-DevKitM-1.
- `Related Documents`_: Links to related documentation.
Getting Started
===============
This section provides a brief introduction of ESP32-C3-DevKitM-1, instructions on how to do the initial hardware setup and how to flash firmware onto it.
Description of Components
-------------------------
@ -50,7 +52,7 @@ The key components of the board are described in a counter-clockwise direction.
* - Key Component
- Description
* - ESP32-C3-MINI-1
- ESP32-C3-MINI-1 is a general-purpose Wi-Fi and Bluetooth LE combo module that comes with a PCB antenna. At the core of this module is `ESP32-C3FN4 <https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf>`_, a chip that has an embedded flash of 4 MB. Since flash is packaged in the ESP32-C3FN4 chip, rather than integrated into the module, ESP32-C3-MINI-1 has a smaller package size.
- ESP32-C3-MINI-1 is a general-purpose Wi-Fi and Bluetooth Low Energy combo module that comes with a PCB antenna. At the core of this module is `ESP32-C3FN4 <https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf>`_, a chip that has an embedded flash of 4 MB. Since flash is packaged in the ESP32-C3FN4 chip, rather than integrated into the module, ESP32-C3-MINI-1 has a smaller package size.
* - 5 V to 3.3 V LDO
- Power regulator that converts a 5 V supply into a 3.3 V output.
* - 5 V Power On LED
@ -74,6 +76,7 @@ Start Application Development
Before powering up your ESP32-C3-DevKitM-1, please make sure that it is in good condition with no obvious signs of damage.
Required Hardware
^^^^^^^^^^^^^^^^^
@ -85,11 +88,13 @@ Required Hardware
Be sure to use an appropriate USB cable. Some cables are for charging only and do not provide the needed data lines nor work for programming the boards.
Software Setup
^^^^^^^^^^^^^^
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 application example onto your ESP32-C3-DevKitM-1.
Contents and Packaging
----------------------
@ -108,6 +113,7 @@ If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
Hardware Reference
==================
@ -124,6 +130,7 @@ The block diagram below shows the components of ESP32-C3-DevKitM-1 and their int
ESP32-C3-DevKitM-1 (click to enlarge)
Power Supply Options
^^^^^^^^^^^^^^^^^^^^
@ -135,6 +142,7 @@ There are three mutually exclusive ways to provide power to the board:
It is recommended to use the first option: Micro-USB Port.
.. _user-guide-c3-devkitm-1-v1-header-blocks:
Header Block
@ -142,8 +150,10 @@ Header Block
The two tables below provide the **Name** and **Function** of the pin headers on both sides of the board (J1 and J3). The pin header names are shown in :ref:`user-guide-c3-devkitm-1-v1-board-front`. The numbering is the same as in the `ESP32-C3-DevKitM-1 Schematic`_ (PDF).
J1
^^^
=== ==== ========== ===================================
No. Name Type [1]_ Function
=== ==== ========== ===================================
@ -164,8 +174,10 @@ No. Name Type [1]_ Function
15 GND G Ground
=== ==== ========== ===================================
J3
^^^
=== ==== ========== ====================================
No. Name Type [1]_ Function
=== ==== ========== ====================================
@ -189,8 +201,10 @@ No. Name Type [1]_ Function
.. [1] P: Power supply; I: Input; O: Output; T: High impedance.
.. [2] GPIO2, GPIO8, and GPIO9 are strapping pins of the ESP32-C3FN4 chip. These pins are used to control several chip functions depending on binary voltage values applied to the pins during chip power-up or system reset. For description and application of the strapping pins, please refer to Section Strapping Pins in `ESP32-C3 Datasheet`_.
Pin Layout
^^^^^^^^^^^
^^^^^^^^^^
.. figure:: ../../../_static/esp32-c3-devkitm-1-v1-pinout.png
:align: center
:scale: 45%
@ -198,13 +212,16 @@ Pin Layout
ESP32-C3-DevKitM-1 Pin Layout (click to enlarge)
Hardware Revision Details
=========================
No previous versions available.
Related Documents
=================
* `Build Secure and Cost-effective Connected Devices with ESP32-C3 <http://c3.espressif.com/>`_
* `ESP32-C3 Datasheet`_ (PDF)
* `ESP32-C3-MINI-1 Datasheet`_ (PDF)

27
docs/en/hw-reference/esp32s2/user-guide-devkitm-1-v1.rst
View File

@ -25,14 +25,17 @@ The document consists of the following major sections:
- `Hardware Revision Details`_: Revision history, known issues, and links to user guides for previous versions (if any) of ESP32-S2-DevKitM-1.
- `Related Documents`_: Gives links to related documentation.
Getting Started
===============
This section describes how to get started with ESP32-S2-DevKitM-1. It begins with a few introductory sections about the ESP32-S2-DevKitM-1, then Section `Start Application Development`_ provides instructions on how to get the ESP32-S2-DevKitM-1 ready and flash firmware into it.
Contents and Packaging
----------------------
.. _user-guide-s2-devkitm-1-v1-ordering-info:
Ordering Information
@ -77,7 +80,7 @@ The development board has a variety of variants to choose from, as shown in the
- ESP32-S2-MINI-1
- 4 MB
- 2 MB
- PCB on-board antenna
- PCB on-board antenna
* - ESP32-S2-DevKitM-1RU
- ESP32-S2-MINI-1U
- 4 MB
@ -87,13 +90,15 @@ The development board has a variety of variants to choose from, as shown in the
.. [#] The ESP32-S2-MINI-2 and ESP32-S2-MINI-2U modules use chip revision v1.0, and the rest use chip revision v0.0. For more information about chip revisions, please refer to `ESP32-S2 Series SoC Errata`_.
Retail orders
Retail Orders
^^^^^^^^^^^^^
If you order a few samples, each ESP32-S2-DevKitM-1 comes in an individual package in either antistatic bag or any packaging depending on your retailer.
For retail orders, please go to https://www.espressif.com/en/contact-us/get-samples.
Wholesale Orders
^^^^^^^^^^^^^^^^
@ -101,6 +106,7 @@ If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
Description of Components
-------------------------
@ -149,11 +155,13 @@ The key components of the board are described in a clockwise direction.
* - External Antenna Connector
- On **ESP32-S2-MINI-2U** and **ESP32-S2-MINI-1U** module only. For connector dimensions, please refer to Section External Antenna Connector Dimensions in module datasheet.
Start Application Development
-----------------------------
Before powering up your ESP32-S2-DevKitM-1, please make sure that it is in good condition with no obvious signs of damage.
Required Hardware
^^^^^^^^^^^^^^^^^
@ -165,6 +173,7 @@ Required Hardware
Be sure to use an appropriate USB cable. Some cables are for charging only and do not provide the needed data lines nor work for programming the boards.
Software Setup
^^^^^^^^^^^^^^
@ -174,6 +183,7 @@ Please proceed to :doc:`../../get-started/index`, where Section :ref:`get-starte
ESP32-S2 series of chips only is only supported in ESP-IDF master or version v4.2 and higher.
Hardware Reference
==================
@ -190,6 +200,7 @@ A block diagram below shows the components of ESP32-S2-DevKitM-1 and their inter
ESP32-S2-DevKitM-1 (click to enlarge)
Power Supply Options
^^^^^^^^^^^^^^^^^^^^
@ -199,7 +210,8 @@ There are three mutually exclusive ways to provide power to the board:
- 5V and GND pin headers
- 3V3 and GND pin headers
It is recommended to use the first option: Micro-USB Port.
It is recommended to use the first option: micro USB Port.
.. _user-guide-devkitm-1-v1-header-blocks:
@ -208,8 +220,10 @@ Header Block
The two tables below provide the **Name** and **Function** of the pin headers on both sides of the board (J1 and J3). The pin header names are shown in :ref:`user-guide-devkitm-1-v1-board-front`. The numbering is the same as in the `ESP32-S2-DevKitM-1 Schematics <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_Schematics.pdf>`_ (PDF).
J1
^^^
=== ==== ========== =============================================================
No. Name Type [#]_ Function
=== ==== ========== =============================================================
@ -236,8 +250,10 @@ No. Name Type [#]_ Function
21 G G Ground
=== ==== ========== =============================================================
J3
^^^
=== ==== ===== ========================================================
No. Name Type Function
=== ==== ===== ========================================================
@ -266,8 +282,10 @@ No. Name Type Function
.. [#] P: Power supply; I: Input; O: Output; T: High impedance.
Pin Layout
^^^^^^^^^^^
.. figure:: ../../../_static/esp32-s2-devkitm-1-v1-pin-layout.png
:align: center
:scale: 15%
@ -276,13 +294,16 @@ Pin Layout
ESP32-S2-DevKitM-1 Pin Layout (click to enlarge)
Hardware Revision Details
=========================
This is the first revision of this board released.
Related Documents
=================
* `ESP32-S2 Series Chip Revision v1.0 Datasheet`_ (PDF)
* `ESP32-S2 Series Chip Revision v0.0 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf>`_ (PDF)
* `ESP32-S2 Series SoC Errata`_ (PDF)

1
docs/en/hw-reference/esp32s2/user-guide-esp-lyrap-cam-v1.0.rst
View File

@ -88,7 +88,6 @@ See Section :ref:`user-guide-esp32-s2-kaluga-1-kit-v1.2-software-setup` of the E
Hardware Reference
==================
Block Diagram
-------------

5
docs/en/hw-reference/esp32s2/user-guide-esp-lyrap-cam-v1.1.rst
View File

@ -90,7 +90,6 @@ See Section :ref:`user-guide-esp32-s2-kaluga-1-kit-software-setup` of the ESP32-
Hardware Reference
==================
Block Diagram
-------------
@ -110,14 +109,14 @@ Hardware Revision Details
=========================
ESP-LyraP-CAM v1.1
--------------------
------------------
* Silk screen updated
* No actual hardware updates
ESP-LyraP-CAM v1.0
--------------------
------------------
:doc:`Initial release <user-guide-esp-lyrap-cam-v1.0>`

1
docs/en/hw-reference/esp32s2/user-guide-esp-lyrap-toucha-v1.1.rst
View File

@ -90,7 +90,6 @@ See Section :ref:`user-guide-esp32-s2-kaluga-1-kit-software-setup` of the ESP32-
Hardware Reference
==================
Block Diagram
-------------

3
docs/en/hw-reference/esp32s2/user-guide-esp-lyrat-8311a_v1.2.rst
View File

@ -41,6 +41,7 @@ Overview
The ESP-LyraT-8311A is mainly designed for audio applications. However, you can use your creativity to come up with any other use cases.
Description of Components
-------------------------
@ -85,7 +86,6 @@ The description of components starts from the top right corner and then goes clo
- ES8311 audio ADC and DAC; it can convert the analog signal picked up by the microphone or convert digital signal to play it back through a speaker or headphones
Start Application Development
-----------------------------
@ -122,7 +122,6 @@ Depending on your application, see:
Hardware Reference
==================
Block Diagram
-------------

4
docs/en/hw-reference/esp32s2/user-guide-esp-lyrat-8311a_v1.3.rst
View File

@ -41,6 +41,7 @@ Overview
The ESP-LyraT-8311A is mainly designed for audio applications. However, you can use your creativity to come up with any other use cases.
Description of Components
-------------------------
@ -85,7 +86,6 @@ The description of components starts from the top right corner and then goes clo
- ES8311 audio ADC and DAC; it can convert the analog signal picked up by the microphone or convert digital signal to play it back through a speaker or headphones
Start Application Development
-----------------------------
@ -122,7 +122,6 @@ Depending on your application, see:
Hardware Reference
==================
Block Diagram
-------------
@ -150,6 +149,7 @@ ESP-LyraT-8311A v1.2
:doc:`Initial release <user-guide-esp-lyrat-8311a_v1.2>`
Related Documents
=================

6
docs/en/hw-reference/esp32s2/user-guide-esp32-s2-kaluga-1-kit-v1.2.rst
View File

@ -55,7 +55,6 @@ This guide covers:
Getting Started
===============
This section describes how to get started with the ESP32-S2-Kaluga-1. It begins with a few introductory sections about the ESP32-S2-Kaluga-1, then Section `Start Application Development`_ provides instructions on how to do the initial hardware setup and then how to flash firmware onto the ESP32-S2-Kaluga-1.
@ -217,7 +216,7 @@ The programming guide and application examples for your ESP32-S2-Kaluga-1 kit ca
Contents and Packaging
----------------------
Retail orders
Retail Orders
^^^^^^^^^^^^^
If you order one or several samples of the kit, each ESP32-S2-Kaluga-1 development kit comes in an individual package containing:
@ -250,7 +249,6 @@ For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales
Hardware Reference
==================
Block Diagram
-------------
@ -325,7 +323,7 @@ Also, all extension boards and the :ref:`JTAG interface <jtag-debugging-tip-jtag
* Debugging an application that is using an extension board
Known issues
Known Issues
============
.. list-table::

12
docs/en/hw-reference/esp32s2/user-guide-esp32-s2-kaluga-1-kit.rst
View File

@ -56,7 +56,6 @@ This guide covers:
Getting Started
===============
This section describes how to get started with the ESP32-S2-Kaluga-1. It begins with a few introductory sections about the ESP32-S2-Kaluga-1, then Section `Start Application Development`_ provides instructions on how to do the initial hardware setup and then how to flash firmware onto the ESP32-S2-Kaluga-1.
@ -230,7 +229,7 @@ A Board Support Package can be found in `IDF Component Registry <https://compone
Contents and Packaging
----------------------
Retail orders
Retail Orders
^^^^^^^^^^^^^
If you order one or several samples of the kit, each ESP32-S2-Kaluga-1 development kit comes in an individual package.
@ -273,7 +272,6 @@ For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales
Hardware Reference
==================
Block Diagram
-------------
@ -358,10 +356,10 @@ ESP32-S2-Kaluga-1 Kit v1.3
* The following pins re-assigned to fix the download issue
* Camera D2： GPIO36
* Camera D3： GPIO37
* AU_I2S1_SDI： GPIO34
* AU_WAKE_INT： GPIO46
* Camera D2: GPIO36
* Camera D3: GPIO37
* AU_I2S1_SDI: GPIO34
* AU_WAKE_INT: GPIO46
* RGB pin header moved to the board's edge
* All dip switches moved to the flip side for convenient operation

28
docs/en/hw-reference/esp32s2/user-guide-s2-devkitc-1.rst
View File

@ -1,6 +1,6 @@
===================
==================
ESP32-S2-DevKitC-1
===================
==================
:link_to_translation:`zh_CN:[中文]`
@ -22,11 +22,13 @@ The document consists of the following major sections:
- `Hardware Revision Details`_: Revision history, known issues, and links to user guides for previous versions (if any) of ESP32-S2-DevKitC-1.
- `Related Documents`_: Links to related documentation.
Getting Started
===============
This section provides a brief introduction of ESP32-S2-DevKitC-1, instructions on how to do the initial hardware setup and how to flash firmware onto it.
Description of Components
-------------------------
@ -74,6 +76,7 @@ Start Application Development
Before powering up your ESP32-S2-DevKitC-1, please make sure that it is in good condition with no obvious signs of damage.
Required Hardware
^^^^^^^^^^^^^^^^^
@ -85,16 +88,19 @@ Required Hardware
Be sure to use an appropriate USB cable. Some cables are for charging only and do not provide the needed data lines nor work for programming the boards.
Hardware Setup
^^^^^^^^^^^^^^
Connect the board with the computer using **USB-to-UART Port** or **ESP32-S2 USB Port**. In subsequent steps, **USB-to-UART Port** will be used by default.
Software Setup
^^^^^^^^^^^^^^
Please proceed to `ESP-IDF Get Started <https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html>`_, where Section `Installation Step by Step <https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html#get-started-step-by-step>`_ will quickly help you set up the development environment and then flash an application example into your ESP32-S2-DevKitC-1.
Contents and Packaging
----------------------
@ -151,13 +157,15 @@ The development board has a variety of variants to choose from, as shown in the
.. [#] The ESP32-S2-SOLO-2 and ESP32-S2-SOLO-2U modules use chip revision v1.0, and the rest use chip revision v0.0. For more information about chip revisions, please refer to `ESP32-S2 Series SoC Errata`_.
Retail orders
Retail Orders
^^^^^^^^^^^^^
If you order a few samples, each ESP32-S2-DevKitC-1 comes in an individual package in either antistatic bag or any packaging depending on your retailer.
For retail orders, please go to https://www.espressif.com/en/contact-us/get-samples.
Wholesale Orders
^^^^^^^^^^^^^^^^
@ -165,6 +173,7 @@ If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
Hardware Reference
==================
@ -181,6 +190,7 @@ The block diagram below shows the components of ESP32-S2-DevKitC-1 and their int
ESP32-S2-DevKitC-1 (click to enlarge)
Power Supply Options
^^^^^^^^^^^^^^^^^^^^
@ -190,15 +200,18 @@ There are three mutually exclusive ways to provide power to the board:
- 5V and G (GND) pins
- 3V3 and G (GND) pins
.. _user-guide-s2-devkitc-1-v1-header-blocks:
Header Block
-------------
------------
The two tables below provide the **Name** and **Function** of the pin headers on both sides of the board (J1 and J3). The pin header names are shown in :ref:`user-guide-s2-devkitc-1-v1-board-front`. The numbering is the same as in the `ESP32-S2-DevKitC-1 Schematic`_ (PDF).
J1
^^^
=== ========= ========== ==========================================================================
No. Name Type [#]_ Function
=== ========= ========== ==========================================================================
@ -229,6 +242,7 @@ No. Name Type [#]_ Function
J3
^^^
=== ==== ===== ============================================================
No. Name Type Function
=== ==== ===== ============================================================
@ -259,8 +273,10 @@ No. Name Type Function
.. [#] P: Power supply; I: Input; O: Output; T: High impedance.
.. [#] GPIO18 is not pulled up on boards with an ESP32-S2-SOLO-2 or ESP32-S2-SOLO-2U module.
Pin Layout
^^^^^^^^^^^
^^^^^^^^^^
.. figure:: ../../../_static/esp32-s2-devkitc-1-v1-pinout.png
:align: center
:scale: 45%
@ -269,11 +285,13 @@ Pin Layout
ESP32-S2-DevKitC-1 Pin Layout (click to enlarge)
Hardware Revision Details
=========================
This is the first revision of this board released.
Related Documents
=================

21
docs/en/hw-reference/esp32s2/user-guide-saola-1-v1.2.rst
View File

@ -20,11 +20,13 @@ The document consists of the following major sections:
- `Hardware Revision Details`_: Revision history, known issues, and links to user guides for previous versions (if any) of ESP32-S2-Saola-1.
- `Related Documents`_: Gives links to related documentation.
Getting Started
===============
This section describes how to get started with ESP32-S2-Saola-1. It begins with a few introductory sections about the ESP32-S2-Saola-1, then Section `Start Application Development`_ provides instructions on how to get the ESP32-S2-Saola-1 ready and flash firmware into it.
Overview
--------
@ -39,16 +41,18 @@ To cover a wide range of users' needs, ESP32-S2-Saola-1 supports:
In this guide, we take ESP32-S2-Saola-1 equipped with ESP32-S2-WROVER as an example.
Contents and Packaging
----------------------
Retail orders
Retail Orders
^^^^^^^^^^^^^
If you order a few samples, each ESP32-S2-Saola-1 comes in an individual package in either antistatic bag or any packaging depending on your retailer.
For retail orders, please go to https://www.espressif.com/en/contact-us/get-samples.
Wholesale Orders
^^^^^^^^^^^^^^^^
@ -56,6 +60,7 @@ If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
Description of Components
-------------------------
@ -93,11 +98,13 @@ The key components of the board are described in a clockwise direction.
* - RGB LED
- Addressable RGB LED (WS2812), driven by GPIO18.
Start Application Development
-----------------------------
Before powering up your ESP32-S2-Saola-1, please make sure that it is in good condition with no obvious signs of damage.
Required Hardware
^^^^^^^^^^^^^^^^^
@ -109,6 +116,7 @@ Required Hardware
Be sure to use an appropriate USB cable. Some cables are for charging only and do not provide the needed data lines nor work for programming the boards.
Software Setup
^^^^^^^^^^^^^^
@ -118,6 +126,7 @@ Please proceed to :doc:`../../get-started/index`, where Section :ref:`get-starte
ESP32-S2 series of chips only supports ESP-IDF master or version v4.2 and higher.
Hardware Reference
==================
@ -134,6 +143,7 @@ A block diagram below shows the components of ESP32-S2-Saola-1 and their interco
ESP32-S2-Saola-1 (click to enlarge)
Power Supply Options
^^^^^^^^^^^^^^^^^^^^
@ -145,13 +155,16 @@ There are three mutually exclusive ways to provide power to the board:
It is recommended to use the first option: Micro-USB Port.
Header Block
------------
The two tables below provide the **Name** and **Function** of the pin headers on both sides of the board (J2 and J3). The pin header names are shown in :ref:`user-guide-saola-1-v1.2-board-front`. The numbering is the same as in the `ESP32-S2-Saola-1 Schematics`_ (PDF).
J2
^^^
=== ==== ========== ======================================
No. Name Type [#]_ Function
=== ==== ========== ======================================
@ -178,8 +191,10 @@ No. Name Type [#]_ Function
21 GND G Ground
=== ==== ========== ======================================
J3
^^^
=== ==== ===== ====================================
No. Name Type Function
=== ==== ===== ====================================
@ -208,8 +223,10 @@ No. Name Type Function
.. [#] P: Power supply; I: Input; O: Output; T: High impedance.
Pin Layout
^^^^^^^^^^^
.. figure:: ../../../_static/esp32-s2_saola1-pinout.jpg
:align: center
:scale: 45%
@ -218,11 +235,13 @@ Pin Layout
ESP32-S2 Saola-1 Pin Layout (click to enlarge)
Hardware Revision Details
=========================
This is the first revision of this board released.
Related Documents
=================

26
docs/en/hw-reference/esp32s3/user-guide-devkitc-1-v1.0.rst
View File

@ -1,6 +1,6 @@
===================
==================
ESP32-S3-DevKitC-1
===================
==================
:link_to_translation:`zh_CN:[中文]`
@ -8,7 +8,7 @@ The latest version: :doc:`user-guide-devkitc-1`
This user guide will help you get started with ESP32-S3-DevKitC-1 and will also provide more in-depth information.
The ESP32-S3-DevKitC-1 is an entry-level development board equipped with ESP32-S3-WROOM-1, ESP32-S3-WROOM-1U, or ESP32-S3-WROOM-2, a general-purpose Wi-Fi + Bluetooth® LE MCU module that integrates complete Wi-Fi and Bluetooth LE functions.
The ESP32-S3-DevKitC-1 is an entry-level development board equipped with ESP32-S3-WROOM-1, ESP32-S3-WROOM-1U, or ESP32-S3-WROOM-2, a general-purpose Wi-Fi + Bluetooth® Low Energy MCU module that integrates complete Wi-Fi and Bluetooth Low Energy functions.
Most of the I/O pins on the module are broken out to the pin headers on both sides of this board for easy interfacing. Developers can either connect peripherals with jumper wires or mount ESP32-S3-DevKitC-1 on a breadboard.
@ -53,7 +53,7 @@ The key components of the board are described in a counter-clockwise direction.
* - Key Component
- Description
* - ESP32-S3-WROOM-1/1U/2
- ESP32-S3-WROOM-1, ESP32-S3-WROOM-1U, and ESP32-S3-WROOM-2 are powerful, generic Wi-Fi + Bluetooth LE MCU modules that have a rich set of peripherals. They provide acceleration for neural network computing and signal processing workloads. ESP32-S3-WROOM-1 and ESP32-S3-WROOM-2 comes with a PCB antenna. ESP32-S3-WROOM-1U comes with an external antenna connector.
- ESP32-S3-WROOM-1, ESP32-S3-WROOM-1U, and ESP32-S3-WROOM-2 are powerful, generic Wi-Fi + Bluetooth Low Energy MCU modules that have a rich set of peripherals. They provide acceleration for neural network computing and signal processing workloads. ESP32-S3-WROOM-1 and ESP32-S3-WROOM-2 comes with a PCB antenna. ESP32-S3-WROOM-1U comes with an external antenna connector.
* - 5 V to 3.3 V LDO
- Power regulator that converts a 5 V supply into a 3.3 V output.
* - Pin Headers
@ -109,10 +109,10 @@ Please proceed to :doc:`../../get-started/index`, where Section :ref:`get-starte
Contents and Packaging
-----------------------
----------------------
Ordering Information
^^^^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^
The development board has a variety of variants to choose from, as shown in the table below.
@ -170,6 +170,7 @@ The development board has a variety of variants to choose from, as shown in the
In the table above, QD stands for Quad SPI and OT stands for Octal SPI.
Retail Orders
^^^^^^^^^^^^^
@ -179,22 +180,19 @@ For retail orders, please go to https://www.espressif.com/en/company/contact/buy
Wholesale Orders
^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^
If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
Hardware Reference
==================
Block Diagram
-------------
The block diagram below shows the components of ESP32-S3-DevKitC-1 and their interconnections.
.. figure:: ../../../_static/ESP32-S3-DevKitC-1_v2-SystemBlock.png
@ -206,7 +204,7 @@ The block diagram below shows the components of ESP32-S3-DevKitC-1 and their int
Power Supply Options
^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^
There are three mutually exclusive ways to provide power to the board:
@ -214,10 +212,11 @@ There are three mutually exclusive ways to provide power to the board:
- 5V and G (GND) pins
- 3V3 and G (GND) pins
.. _user-guide-s3-devkitc-1-v1-header-blocks:
Header Block
-------------
------------
The two tables below provide the **Name** and **Function** of the pins on both sides of the board (J1 and J3). The pin names are shown in :ref:`user-guide-s3-devkitc-1-v1-board-front`. The numbering is the same as in the `Board Schematic <https://dl.espressif.com/dl/SCH_ESP32-S3-DEVKITC-1_V1_20210312C.pdf>`_ (PDF).
@ -291,8 +290,7 @@ For description of function names, please refer to `Chip Datasheet <https://www.
Pin Layout
^^^^^^^^^^^
^^^^^^^^^^
.. figure:: ../../../_static/ESP32-S3_DevKitC-1_pinlayout.jpg
:align: center

26
docs/en/hw-reference/esp32s3/user-guide-devkitc-1.rst
View File

@ -1,6 +1,6 @@
========================
=======================
ESP32-S3-DevKitC-1 v1.1
========================
=======================
:link_to_translation:`zh_CN:[中文]`
@ -8,7 +8,7 @@ The older version: :doc:`user-guide-devkitc-1-v1.0`
This user guide will help you get started with ESP32-S3-DevKitC-1 and will also provide more in-depth information.
The ESP32-S3-DevKitC-1 is an entry-level development board equipped with ESP32-S3-WROOM-1, ESP32-S3-WROOM-1U, or ESP32-S3-WROOM-2, a general-purpose Wi-Fi + Bluetooth® LE MCU module that integrates complete Wi-Fi and Bluetooth LE functions.
The ESP32-S3-DevKitC-1 is an entry-level development board equipped with ESP32-S3-WROOM-1, ESP32-S3-WROOM-1U, or ESP32-S3-WROOM-2, a general-purpose Wi-Fi + Bluetooth® Low Energy MCU module that integrates complete Wi-Fi and Bluetooth Low Energy functions.
Most of the I/O pins on the module are broken out to the pin headers on both sides of this board for easy interfacing. Developers can either connect peripherals with jumper wires or mount ESP32-S3-DevKitC-1 on a breadboard.
@ -53,7 +53,7 @@ The key components of the board are described in a counter-clockwise direction.
* - Key Component
- Description
* - ESP32-S3-WROOM-1/1U/2
- ESP32-S3-WROOM-1, ESP32-S3-WROOM-1U, and ESP32-S3-WROOM-2 are powerful, generic Wi-Fi + Bluetooth LE MCU modules that have a rich set of peripherals. They provide acceleration for neural network computing and signal processing workloads. ESP32-S3-WROOM-1 and ESP32-S3-WROOM-2 comes with a PCB antenna. ESP32-S3-WROOM-1U comes with an external antenna connector.
- ESP32-S3-WROOM-1, ESP32-S3-WROOM-1U, and ESP32-S3-WROOM-2 are powerful, generic Wi-Fi + Bluetooth Low Energy MCU modules that have a rich set of peripherals. They provide acceleration for neural network computing and signal processing workloads. ESP32-S3-WROOM-1 and ESP32-S3-WROOM-2 comes with a PCB antenna. ESP32-S3-WROOM-1U comes with an external antenna connector.
* - 5 V to 3.3 V LDO
- Power regulator that converts a 5 V supply into a 3.3 V output.
* - Pin Headers
@ -109,10 +109,10 @@ Please proceed to :doc:`../../get-started/index`, where Section :ref:`get-starte
Contents and Packaging
-----------------------
----------------------
Ordering Information
^^^^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^
The development board has a variety of variants to choose from, as shown in the table below.
@ -170,6 +170,7 @@ The development board has a variety of variants to choose from, as shown in the
In the table above, QD stands for Quad SPI and OT stands for Octal SPI.
Retail Orders
^^^^^^^^^^^^^
@ -179,22 +180,19 @@ For retail orders, please go to https://www.espressif.com/en/contact-us/get-samp
Wholesale Orders
^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^
If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
Hardware Reference
==================
Block Diagram
-------------
The block diagram below shows the components of ESP32-S3-DevKitC-1 and their interconnections.
.. figure:: ../../../_static/ESP32-S3-DevKitC-1_v2-SystemBlock.png
@ -206,7 +204,7 @@ The block diagram below shows the components of ESP32-S3-DevKitC-1 and their int
Power Supply Options
^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^
There are three mutually exclusive ways to provide power to the board:
@ -214,10 +212,11 @@ There are three mutually exclusive ways to provide power to the board:
- 5V and G (GND) pins
- 3V3 and G (GND) pins
.. _user-guide-s3-devkitc-1-v1.1-header-blocks:
Header Block
-------------
------------
The two tables below provide the **Name** and **Function** of the pins on both sides of the board (J1 and J3). The pin names are shown in :ref:`user-guide-s3-devkitc-1-v1.1-board-front`. The numbering is the same as in the `Board Schematic <https://dl.espressif.com/dl/schematics/SCH_ESP32-S3-DevKitC-1_V1.1_20220413.pdf>`_ (PDF).
@ -291,8 +290,7 @@ For description of function names, please refer to `ESP32-S3 Series Datasheet <h
Pin Layout
^^^^^^^^^^^
^^^^^^^^^^
.. figure:: ../../../_static/ESP32-S3_DevKitC-1_pinlayout_v1.1.jpg
:align: center

20
docs/en/hw-reference/esp32s3/user-guide-devkitm-1.rst
View File

@ -1,12 +1,12 @@
===================
==================
ESP32-S3-DevKitM-1
===================
==================
:link_to_translation:`zh_CN:[中文]`
This user guide will help you get started with ESP32-S3-DevKitM-1 and will also provide more in-depth information.
The ESP32-S3-DevKitM-1 is an entry-level development board equipped with either ESP32-S3-MINI-1 or ESP32-S3-MINI-1U, a module named for its small size. This board integrates complete Wi-Fi and Bluetooth Low Energy functions.
The ESP32-S3-DevKitM-1 is an entry-level development board equipped with either ESP32-S3-MINI-1 or ESP32-S3-MINI-1U, a module named for its small size. This board integrates complete Wi-Fi and Bluetooth® Low Energy functions.
Most of the I/O pins on the module are broken out to the pin headers on both sides of this board for easy interfacing. Developers can either connect peripherals with jumper wires or mount ESP32-S3-DevKitM-1 on a breadboard.
@ -53,7 +53,7 @@ The key components of the board are described in a counter-clockwise direction,
* - Key Component
- Description
* - ESP32-S3-MINI-1/1U
- ESP32-S3-MINI-1 and ESP32-S3-MINI-1U are two general-purpose Wi-Fi and Bluetooth LE combo modules that have a rich set of peripherals. ESP32-S3-MINI-1 comes with a PCB antenna. ESP32-S3-MINI-1U comes with an external antenna connector. At the core of the modules is ESP32-S3FN8, a chip equipped with an 8 MB flash. Since flash is packaged in the chip, rather than integrated into the module, ESP32-S3-MINI-1/1U has a smaller package size.
- ESP32-S3-MINI-1 and ESP32-S3-MINI-1U are two general-purpose Wi-Fi and Bluetooth Low Energy combo modules that have a rich set of peripherals. ESP32-S3-MINI-1 comes with a PCB antenna. ESP32-S3-MINI-1U comes with an external antenna connector. At the core of the modules is ESP32-S3FN8, a chip equipped with an 8 MB flash. Since flash is packaged in the chip, rather than integrated into the module, ESP32-S3-MINI-1/1U has a smaller package size.
* - 5 V to 3.3 V LDO
- Power regulator that converts a 5 V supply into a 3.3 V output.
* - Pin Headers
@ -97,6 +97,7 @@ Hardware Setup
Connect the board with the computer using **USB-to-UART Port** or **ESP32-S3 USB Port**. In subsequent steps, **USB-to-UART Port** will be used by default.
Software Setup
^^^^^^^^^^^^^^
@ -122,15 +123,12 @@ If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
Hardware Reference
==================
Block Diagram
-------------
The block diagram below shows the components of ESP32-S3-DevKitM-1 and their interconnections.
.. figure:: ../../../_static/ESP32-S3-DevKitM-1_v1_SystemBlock.png
@ -143,7 +141,7 @@ The block diagram below shows the components of ESP32-S3-DevKitM-1 and their int
Power Supply Options
^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^
There are three mutually exclusive ways to provide power to the board:
@ -151,10 +149,11 @@ There are three mutually exclusive ways to provide power to the board:
- 5V and G (GND) pins
- 3V3 and G (GND) pins
.. _user-guide-s3-devkitm-1-v1-header-blocks:
Header Block
-------------
------------
The two tables below provide the **Name** and **Function** of the pins on both sides of the board (J1 and J3). The pin names are shown in :ref:`user-guide-s3-devkitm-1-v1-board-front`. The numbering is the same as in the `Board Schematic <https://dl.espressif.com/dl/schematics/SCH_ESP32-S3-DEVKITM-1_V1_20210310A.pdf>`_ (PDF).
@ -229,8 +228,7 @@ For description of function names, please refer to `ESP32-S3 Datasheet <https://
Pin Layout
^^^^^^^^^^^
^^^^^^^^^^
.. figure:: ../../../_static/ESP32-S3_DevKitM-1_pinlayout.jpg
:align: center

5
docs/en/hw-reference/index.rst
View File

@ -1,6 +1,7 @@
************************************
******************
Hardware Reference
************************************
******************
:link_to_translation:`zh_CN:[中文]`
.. toctree::

6
docs/zh_CN/hw-reference/esp32/get-started-devkitc-v2.rst
View File

@ -10,10 +10,10 @@ ESP32-DevKitC V2 入门指南
--------
* :ref:`ESP32-DevKitC V2 开发板 <get-started-esp32-devkitc-v2-board-front>`
* USB A / micro USB B 数据线
* USB A/micro USB B 数据线
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
你可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
@ -74,7 +74,7 @@ ESP32-DevKitC V2 开发板的主要组件、接口及控制方式见下。
ESP32-DevKitC V2 上电前，请首先确认开发板完好无损。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至你的开发板。
相关文档

15
docs/zh_CN/hw-reference/esp32/get-started-devkitc.rst
View File

@ -13,7 +13,7 @@ ESP32-DevKitC V4 入门指南
* USB A / micro USB B 数据线
* PC（Windows、Linux 或 Mac OS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
你可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
.. _DevKitC-Overview:
@ -77,25 +77,26 @@ ESP32-DevKitC V4 开发板的主要组件、接口及控制方式见下。
- 板上模组的绝大部分管脚均已引出至开发板的排针。用户可以对 ESP32 进行编程，实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。
电源选项
--------
开发板可从以下三种供电方式中任选其一：
* Micro USB 供电（默认）
* 5V / GND 管脚供电
* 3V3 / GND 管脚供电
* 5V/GND 管脚供电
* 3V3/GND 管脚供电
.. warning::
上述供电模式 **不可同时连接**，否则可能会损坏开发板和/或电源。
排针
------------
下表列出了开发板两侧排针（J1 和 J3）的名称和功能，排针名称如图 :ref:`get-started-esp32-devkitc-board-front` 中所示。
J2
^^^
==== ==== ========== ===========================================
@ -122,6 +123,7 @@ J2
19 5V P 5 V 电源
==== ==== ========== ===========================================
J3
^^^
==== ==== ========== ===========================================
@ -149,9 +151,10 @@ J3
==== ==== ========== ===========================================
.. [1] P：电源；I：输入；O：输出。
.. [2] 管脚 D0、D1、D2、D3、CMD 和 CLK 用于 ESP32 芯片与 SPI flash 间的内部通信，集中分布在开发板两侧靠近 USB 端口的位置。通常而言，这些管脚最好不连，否则可能影响 SPI flash / SPI RAM 的工作。
.. [2] 管脚 D0、D1、D2、D3、CMD 和 CLK 用于 ESP32 芯片与 SPI flash 间的内部通信，集中分布在开发板两侧靠近 USB 端口的位置。通常而言，这些管脚最好不连，否则可能影响 SPI flash/SPI RAM 的工作。
.. [3] 管脚 GPIO16 和 GPIO17 仅适用于板载 ESP32-WROOM 系列和 ESP32-SOLO-1 的开发板，板载 ESP32-WROVER 系列开发板的管脚 GPIO16 和 GPIO17 保留内部使用。
管脚布局
^^^^^^^^^^^
.. figure:: ../../../_static/esp32-devkitC-v4-pinout.png
@ -186,7 +189,7 @@ J3
ESP32-DevKitC V4 上电前，请首先确认开发板完好无损。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至你的开发板。
开发板尺寸

15
docs/zh_CN/hw-reference/esp32/get-started-ethernet-kit-v1.0.rst
View File

@ -7,6 +7,7 @@ ESP32-Ethernet-Kit V1.0 入门指南
:ref:`ESP32-Ethernet-Kit <get-started-esp32-ethernet-kit-b-v1.0>` 是一款以太网转 Wi-Fi 开发板，可为以太网设备赋予 Wi-Fi 连接功能。为了提供更灵活的电源选项，ESP32-Ethernet-Kit 也同时支持以太网供电 (PoE)。
准备工作
-------------
@ -14,14 +15,15 @@ ESP32-Ethernet-Kit V1.0 入门指南
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
你可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
--------
ESP32-Ethernet-Kit 是一款来自 `乐鑫 <https://espressif.com>`_ 的开发板。
该开发板由以太网母板（A 板）和 PoE 子板（B 板）两部分组成。其中 :ref:`以太网母板（A 板）<get-started-esp32-ethernet-kit-a-v1.0-layout>` 贴蓝牙 / Wi-Fi 双模 ESP32-WROVER-B 模组和单端口 10/100 快速以太网收发器 (PHY) IP101GRI。:ref:`PoE 子板（B 板） <get-started-esp32-ethernet-kit-b-v1.0-layout>` 提供以太网供电功能。ESP32-Ethernet-Kit 的 A 板可在不连接 B 板的情况下独立工作。
该开发板由以太网母板（A 板）和 PoE 子板（B 板）两部分组成。其中 :ref:`以太网母板（A 板）<get-started-esp32-ethernet-kit-a-v1.0-layout>` 贴蓝牙/Wi-Fi 双模 ESP32-WROVER-B 模组和单端口 10/100 快速以太网收发器 (PHY) IP101GRI。:ref:`PoE 子板（B 板） <get-started-esp32-ethernet-kit-b-v1.0-layout>` 提供以太网供电功能。ESP32-Ethernet-Kit 的 A 板可在不连接 B 板的情况下独立工作。
.. _get-started-esp32-ethernet-kit-b-v1.0:
@ -99,7 +101,7 @@ DC/DC 转换器 直流 5 V 转 3.3 V，输出电流高达 2 A。
B 板连接器 1 对 2 针排针，用于连接 :ref:`PoE 子板（B 板）<get-started-esp32-ethernet-kit-b-v1.0-layout>`。
IP101GRI (PHY) 物理层 (PHY) 单端口10/100 快速以太网收发器 `IP101GRI`_ ，允许开发人员实现与以太网线缆的物理层连接。PHY 与 ESP32 通过简化媒体独立接口 (RMII) 实现连接。RMII 是 `媒体独立接口 (MII)`_ 的简化版本。PHY 可在 10/100 Mbps 速率下支持 IEEE 802.3 / 802.3u 标准。
IP101GRI (PHY) 物理层 (PHY) 单端口 10/100 快速以太网收发器 `IP101GRI`_ ，允许开发人员实现与以太网线缆的物理层连接。PHY 与 ESP32 通过简化媒体独立接口 (RMII) 实现连接。RMII 是 `媒体独立接口 (MII)`_ 的简化版本。PHY 可在 10/100 Mbps 速率下支持 IEEE 802.3/802.3u 标准。
RJ45 端口 以太网数据传输端口。
@ -333,6 +335,7 @@ GPIO 管脚分配
ESP32-Ethernet-Kit 上电前，请首先确认开发板完好无损。
初始设置
^^^^^^^^^^^^^
@ -346,17 +349,17 @@ 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` 章节。
请务必在进入下一步前，确保您已完成上述所有步骤。
在进入下一步前，请确保已完成上述所有步骤。
配置与加载以太网示例
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
在完成开发环境设置和开发板测试后，您可以配置并烧录 :example:`ethernet/basic` 示例。本示例专门用于测试以太网功能，支持不同 PHY，包括 :ref:`ESP32-Ethernet-Kit V1.0 开发板 <get-started-esp32-ethernet-kit-b-v1.0>` 使用的 **IP101GRI**。
在完成开发环境设置和开发板测试后，即可配置并烧录 :example:`ethernet/basic` 示例。本示例专门用于测试以太网功能，支持不同 PHY，包括 :ref:`ESP32-Ethernet-Kit V1.0 开发板 <get-started-esp32-ethernet-kit-b-v1.0>` 使用的 **IP101GRI**。
相关文档

18
docs/zh_CN/hw-reference/esp32/get-started-ethernet-kit-v1.1.rst
View File

@ -15,7 +15,7 @@ ESP32-Ethernet-Kit V1.1 入门指南
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
你可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
@ -23,7 +23,7 @@ ESP32-Ethernet-Kit V1.1 入门指南
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 板的情况下独立工作。
它由 :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:
@ -188,7 +188,7 @@ RMII 工作模式下的以太网 MAC 和 PHY 需要一个公共的 50 MHz 同步
PHY 侧提供 RMII 时钟
"""""""""""""""""""""""""""""
ESP32-Ethernet-Kit 默认配置为 IP101GRI 的 50M_CLKO 信号线提供 RMII 时钟，该时钟信号由 PHY 外侧连接的 25MHz 无源晶振经过倍频产生。详情请参见下图。
ESP32-Ethernet-Kit 默认配置为 IP101GRI 的 50M_CLKO 信号线提供 RMII 时钟，该时钟信号由 PHY 外侧连接的 25 MHz 无源晶振经过倍频产生。详情请参见下图。
.. figure:: ../../../_static/esp32-ethernet-kit-rmii-clk-from-phy.png
:align: center
@ -335,7 +335,7 @@ GPIO 管脚分配总结
.. 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 板）原理图`_。
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。
@ -359,15 +359,15 @@ ESP32-Ethernet-Kit 上电前，请首先确认开发板完好无损。
正式开始开发
^^^^^^^^^^^^^
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至你的开发板。
请务必在进入下一步前，确保您已完成上述所有步骤。
在进入下一步前，请确保已完成上述所有步骤。
配置与加载以太网示例
^^^^^^^^^^^^^^^^^^^^^^^
在完成开发环境设置和开发板测试后，您可以配置并烧录 :example:`ethernet/basic` 示例。本示例专门用于测试以太网功能，支持不同 PHY，包括 :ref:`get-started-esp32-ethernet-kit-v1.1` 开发板使用的 **IP101GRI** 。
在完成开发环境设置和开发板测试后，即可配置并烧录 :example:`ethernet/basic` 示例。本示例专门用于测试以太网功能，支持不同 PHY，包括 :ref:`get-started-esp32-ethernet-kit-v1.1` 开发板使用的 **IP101GRI** 。
针对 ESP32-Ethernet-Kit V1.0 的主要修改
@ -375,9 +375,9 @@ ESP32-Ethernet-Kit 上电前，请首先确认开发板完好无损。
* 原 GPIO0 反相后时钟提供给 PHY 方案改为由 PHY 侧外接无源晶振，提供时钟给 GPIO0。原用于控制有源晶振的 OSC_EN 的 IO2 释放，可用作其他用途。
* 为防止 ESP32 侧 GPIO0 的上电状态受到 PHY 侧时钟输出的影响，PHY 侧 RESET_N 默认为低，关闭 PHY 侧时钟输出。而后可通过 GPIO5 控制 RESET_N 打开该时钟输出。
* 移除 FT2232H 芯片的外部 SPI Flash U6。
* 移除 FT2232H 芯片的外部 SPI flash U6。
* 移除流控的测试排针 J4。
* 移除 nTRST JTAG信号，相应的 GPIO4 可用作其他用途。
* 移除 nTRST JTAG 信号，相应的 GPIO4 可用作其他用途。
* GPIO15 线上的上拉电阻 R68 移至 JTAG 的 MTDO 侧。
* 为了加强 A 板和 B 板连接间的防呆设计（减少反向插入 B 板的机会），将原先 A 板上的 2 排 4 针排针改为 1 排 4 针排母和 1 排 4 针排针。相应的 4 针排针排和排母排则安装在 B 板上。

14
docs/zh_CN/hw-reference/esp32/get-started-ethernet-kit.rst
View File

@ -17,6 +17,7 @@ ESP32-Ethernet-Kit V1.2 入门指南
ESP32-Ethernet-Kit V1.2 概图（点击放大）
准备工作
--------
@ -24,7 +25,7 @@ ESP32-Ethernet-Kit V1.2 入门指南
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
你可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
@ -129,6 +130,7 @@ ESP32-Ethernet-Kit 开发板的主要组件和连接方式如下。
开发板支持固件自动下载模式。若遵循 `应用程序开发`_ 章节中的步骤并使用了规定软件，则无需对 BOOT 或 EN 按键进行任何操作。
PoE 子板（B 板）
^^^^^^^^^^^^^^^^^^^
@ -160,8 +162,8 @@ PoE 子板（B 板）具有以下特性：
* - 外部电源终端
- PoE 子板（B 板）可选电源 (26.6 ~ 54 V)。
.. _get-started-esp32-ethernet-kit-v1.2-setup-options:
.. _get-started-esp32-ethernet-kit-v1.2-setup-options:
设置选项
--------
@ -344,7 +346,7 @@ GPIO 管脚分配总结
.. 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.2 以太网母板（A 板）原理图`_。
1. 为防止 ESP32 侧 GPIO0 的上电状态受 PHY 侧时钟输出的影响，PHY 侧 RESET_N 默认为低，以关闭 PHY 侧时钟输出。上电后，可以通过 GPIO5 控制 RESET_N 以打开该时钟输出。参见 `PHY 侧提供 RMII 时钟`_。对于无法通过 RESET_N 关闭时钟输出的 PHY，PHY 侧建议使用可在外部禁用/使能的有源晶振。与使用 RESET_N 类似，默认情况下晶振模块应禁用，并在上电后由 ESP32 开启。有关参考设计，请参见 `ESP32-Ethernet-Kit V1.2 以太网母板（A 板）原理图`_。
2. ESP32 芯片的 GPIO16 和 GPIO17 管脚没有引出至 ESP32-WROVER-E 模组的管脚，因此无法使用。如需使用 ESP32 的 GP1016 和 GPIO17 管脚，建议更换其他不含 PSRAM 的模组，比如 ESP32-WROOM-32D 或 ESP32-SOLO-1。
@ -368,15 +370,15 @@ ESP32-Ethernet-Kit 上电前，请首先确认开发板完好无损。
正式开始开发
^^^^^^^^^^^^^
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至你的开发板。
请务必在进入下一步前，确保您已完成上述所有步骤。
在进入下一步前，请确保已完成上述所有步骤。
配置与加载以太网示例
^^^^^^^^^^^^^^^^^^^^^^^
在完成开发环境设置和开发板测试后，您可以配置并烧录 :example:`ethernet/basic` 示例。本示例专门用于测试以太网功能，支持不同 PHY，包括 :ref:`get-started-esp32-ethernet-kit-v1.2` 开发板使用的 **IP101GRI** 。
在完成开发环境设置和开发板测试后，即可配置并烧录 :example:`ethernet/basic` 示例。本示例专门用于测试以太网功能，支持不同 PHY，包括 :ref:`get-started-esp32-ethernet-kit-v1.2` 开发板使用的 **IP101GRI** 。
针对 ESP32-Ethernet-Kit V1.1 的主要修改

13
docs/zh_CN/hw-reference/esp32/get-started-pico-devkitm-2.rst
View File

@ -34,11 +34,13 @@ ESP32-PICO-DevKitM-2 为用户提供了基于 ESP32 芯片应用开发的硬件
- `硬件版本`_：介绍硬件历史版本（如有），已知问题（如有），并提供链接至历史版本开发板的入门指南（如有）；
- `相关文档`_：提供相关文档的链接。
快速入门
=========
本节介绍了如何快速上手 ESP32-PICO-DevKitM-2。首先对 ESP32-PICO-DevKitM-2 开发板进行了简要介绍，然后在 `应用开发`_ 小节介绍如何将固件烧录至开发板。
.. _get-started-pico-devkitm-2-board-front:
组件描述
@ -79,11 +81,13 @@ ESP32-PICO-DevKitM-2 开发板的主要组件、接口及控制方式见下图
* - EN 按键
- 复位按键。
应用开发
---------
上电前，请确保 ESP32-PICO-DevKitM-2 完好无损。
所需硬件
"""""""""""
@ -91,6 +95,7 @@ ESP32-PICO-DevKitM-2 开发板的主要组件、接口及控制方式见下图
- 1 x USB 2.0 A 转 Micro B 数据线
- 1 x PC，运行 Windows、Linux 或 macOS 系统
.. _user-guide-pico-devkitm-2-software-setup:
软件配置
@ -98,6 +103,7 @@ ESP32-PICO-DevKitM-2 开发板的主要组件、接口及控制方式见下图
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 一节查看如何快速配置开发环境，将应用程序烧录至 ESP32-PICO-DevKitM-2 开发板。
内含组件和包装方式
===================
@ -108,6 +114,7 @@ ESP32-PICO-DevKitM-2 开发板的主要组件、接口及控制方式见下图
零售订单，请前往 https://www.espressif.com/en/contact-us/get-samples。
批量订单
-----------
@ -115,6 +122,7 @@ ESP32-PICO-DevKitM-2 开发板的主要组件、接口及控制方式见下图
批量订单请前往 https://www.espressif.com/zh-hans/contact-us/sales-questions。
硬件参考
=============
@ -131,6 +139,7 @@ ESP32-PICO-DevKitM-2 的主要组件和连接方式如下图所示。
ESP32-PICO-DevKitM-2 功能框图（点击放大）
供电方式
------------
@ -150,6 +159,7 @@ ESP32-PICO-DevKitM-2 的主要组件和连接方式如下图所示。
:ref:`get-started-pico-devkitm-2-board-front` 中所示的开发板两侧 I/O 管脚，其具体名称和功能见下表。管脚名称和编号与 `相关文档`_ 中原理图保持一致。
Header J2
""""""""""""
@ -330,6 +340,7 @@ Header J3
(b) 输出管脚；
3. ESP32-PICO-DevKitM-2 内置 SPI flash 的工作电压为 3.3 V。因此，Strapping 管脚 MTDI 在上电复位过程中应拉低。如果连接了该管脚，请确保该管脚在复位中不要拉高。
管脚布局
""""""""""""
.. figure:: ../../../_static/esp32-pico-devkitm-2-pinout.png
@ -340,11 +351,13 @@ Header J3
ESP32-PICO-DevKitM-2 管脚布局（点击放大）
硬件版本
==========
该开发板为最新硬件，尚未有历史版本。
相关文档
=========

10
docs/zh_CN/hw-reference/esp32/get-started-pico-kit-1.rst
View File

@ -43,11 +43,13 @@ ESP32-PICO-KIT-1 为用户提供了基于 ESP32 芯片应用开发的硬件，
- `硬件版本`_：介绍硬件历史版本（如有），已知问题（如有），并提供链接至历史版本开发板的入门指南（如有）；
- `相关文档`_：提供相关文档的链接。
快速入门
========
本节介绍了如何快速上手 ESP32-PICO-KIT-1。首先对 ESP32-PICO-KIT-1 开发板进行了简要介绍，然后在 `应用开发`_ 小节介绍如何将固件烧录至开发板。
.. _get-started-pico-kit-1-board-front:
组件描述
@ -89,11 +91,13 @@ ESP32-PICO-KIT-1 开发板的主要组件、接口及控制方式见下图。
* - EN 按键
- 复位按键。
应用开发
---------
上电前，请确保 ESP32-PICO-KIT-1 完好无损。
所需硬件
""""""""
@ -101,6 +105,7 @@ ESP32-PICO-KIT-1 开发板的主要组件、接口及控制方式见下图。
- 1 x USB 2.0 A 转 Micro B 数据线
- 1 x PC，运行 Windows、Linux 或 macOS 系统
.. _user-guide-pico-kit-1-software-setup:
软件配置
@ -127,6 +132,7 @@ ESP32-PICO-KIT-1 开发板的主要组件、接口及控制方式见下图。
批量订单请前往 https://www.espressif.com/zh-hans/contact-us/sales-questions。
硬件参考
========
@ -143,6 +149,7 @@ ESP32-PICO-KIT-1 的主要组件和连接方式如下图所示。
ESP32-PICO-KIT-1 功能框图（点击放大）
供电选项
---------
@ -162,6 +169,7 @@ ESP32-PICO-KIT-1 的主要组件和连接方式如下图所示。
:ref:`get-started-pico-kit-1-board-front` 中所示的开发板两侧 I/O 管脚，其具体名称和功能见下表。管脚名称和编号与 `相关文档`_ 中原理图保持一致。
Header J2
""""""""""""
@ -353,11 +361,13 @@ Header J3
ESP32-PICO-KIT-1 管脚布局（点击放大）
硬件版本
=========
该开发板为最新硬件，尚未有历史版本。
相关文档
=========

5
docs/zh_CN/hw-reference/esp32/get-started-pico-kit-v3.rst
View File

@ -1,5 +1,6 @@
ESP32-PICO-KIT V3 入门指南
=======================================
:link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP32-PICO-KIT V3 迷你开发板。有关 ESP32-PICO-KIT 其他版本的介绍，请见：:doc:`../../hw-reference/index`。
@ -12,7 +13,7 @@ ESP32-PICO-KIT V3 入门指南
* USB 2.0 线（A 型转 Micro-B 型）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
你可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
@ -68,7 +69,7 @@ ESP32-PICO-KIT 开发板的主要组件描述见下表。
ESP32-PICO-KIT V3 上电前，请首先确认开发板完好无损。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至你的开发板。
相关文档

8
docs/zh_CN/hw-reference/esp32/get-started-pico-kit.rst
View File

@ -1,5 +1,6 @@
ESP32-PICO-KIT V4/V4.1 入门指南
=======================================================
:link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP32-PICO-KIT V4/V4.1 迷你开发板。有关 ESP32-PICO-KIT 其他版本的介绍，请见：:doc:`../../hw-reference/index`。
@ -14,7 +15,7 @@ ESP32-PICO-KIT V4/V4.1 入门指南
* USB 2.0 线（A 型转 Micro-B 型）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
你可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
@ -40,6 +41,7 @@ ESP32-PICO-KIT 集成了 USB 转 UART 桥接电路，允许开发人员直接通
1. ESP32-PICO-D4 开发板目前有两种版本，分别采用排针与排母。本指南默认以排针版本为例。
2. 每排未引出至排针的 3 个管脚已连接至 ESP32-PICO-D4 SiP 模组的内置 flash 模块。更多信息，请见 `相关文档`_ 中的模组技术规格书。
功能概述
--------
@ -188,6 +190,7 @@ No. Name Type Function
3. 该管脚已连接至开发板的 USB 桥接器芯片。
4. ESP32-PICO-KIT 内置 SPI flash 的工作电压为 3.3 V。因此，strapping 管脚 MTDI 在模组上电复位过程中应保持低电平。如连接该管脚，请确保该管脚在复位中不要保持高电平。
管脚布局
^^^^^^^^^^^
.. figure:: ../../../_static/esp32-pico-kit-v4-pinout.png
@ -197,12 +200,13 @@ No. Name Type Function
ESP32-PICO-KIT 管脚布局（点击放大）
应用程序开发
------------
ESP32-PICO-KIT 上电前，请首先确认开发板完好无损。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至你的开发板。
开发板尺寸

6
docs/zh_CN/hw-reference/esp32/get-started-wrover-kit-v2.rst
View File

@ -1,5 +1,6 @@
ESP-WROVER-KIT V2 入门指南
===========================================
:link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V2 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见 :doc:`../../hw-reference/index`。
@ -12,7 +13,7 @@ ESP-WROVER-KIT V2 入门指南
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
你可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
@ -169,10 +170,11 @@ USB 供电 使能 UART 通信
打开 **电源开关**，**5V Power On LED** 应点亮。
正式开始开发
^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至你的开发板。
相关文档

87
docs/zh_CN/hw-reference/esp32/get-started-wrover-kit-v3.rst
View File

@ -1,5 +1,6 @@
ESP-WROVER-KIT V3 入门指南
=======================================
:link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V3 开发板及其功能和相关配置。有关 ESP-WROVER-KIT 其他版本的介绍，请见：:doc:`../../hw-reference/index`。
@ -12,13 +13,13 @@ ESP-WROVER-KIT V3 入门指南
* USB 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
你可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
--------
ESP-WROVER-KIT 是 `乐鑫 <https://espressif.com>`_ 一款基于 ESP32 的开发板，集成了 LCD 屏幕和 microSD 卡槽。
ESP-WROVER-KIT 是 `乐鑫 <https://espressif.com>`_ 一款基于 ESP32 的开发板，集成了 LCD 屏幕和 micro SD 卡槽。
ESP-WROVER-KIT 可选贴以下 ESP32 模组：
@ -123,6 +124,7 @@ ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
* - LCD 显示屏
- 支持贴装一款 3.2” 的 SPI（标准四线串行外设接口）LCD 显示器，请见 :ref:`get-started-esp-wrover-kit-v3-board-back`。
.. _get-started-esp-wrover-kit-v3-setup-options:
设置选项
@ -153,7 +155,7 @@ ESP32 模组的部分管脚/终端已被板上组件占用或用于外部硬件
更多外设共享管脚的介绍，请见下一章节中的表格。
主要 I/O 连接器 / JP1
主要 I/O 连接器/JP1
^^^^^^^^^^^^^^^^^^^^^^^^
JP1 连接器包括 14 x 2 个排针，具体功能可见下表中间 “I/O” 列的介绍。两侧的“共用”列则介绍了这些管脚在板上的其他用途。
@ -180,12 +182,12 @@ JTAG，microSD IO15 5V
说明：
* NC/XTAL - :ref:`32.768 kHz Oscillator <get-started-esp-wrover-kit-v3-xtal>`
* JTAG - :ref:`JTAG / JP8 <get-started-esp-wrover-kit-v3-jtag-header>`
* Boot - Boot 按键 / SW2
* 摄像头 - :ref:`摄像头 / JP4 <get-started-esp-wrover-kit-v3-camera-header>`
* JTAG - :ref:`JTAG/JP8 <get-started-esp-wrover-kit-v3-jtag-header>`
* Boot - Boot 按键/SW2
* 摄像头 - :ref:`摄像头/JP4 <get-started-esp-wrover-kit-v3-camera-header>`
* LED - :ref:`RGB LED <get-started-esp-wrover-kit-v3-rgb-led-connections>`
* microSD - :ref:`microSD Card / J4 <get-started-esp-wrover-kit-v3-microsd-card-slot>`
* LCD - :ref:`LCD / U5 <get-started-esp-wrover-kit-v3-lcd-connector>`
* LCD - :ref:`LCD/U5 <get-started-esp-wrover-kit-v3-lcd-connector>`
* PSRAM - 仅适用于选贴 ESP32-WROVER 的情况。
@ -208,18 +210,18 @@ JTAG，microSD IO15 5V
.. _get-started-esp-wrover-kit-v3-spi-flash-header:
SPI Flash / JP13
SPI Flash/JP13
^^^^^^^^^^^^^^^^
==== =============
. ESP32 管脚
==== =============
1. CLK / GPIO6
2. SD0 / GPIO7
3. SD1 / GPIO8
4. SD2 / GPIO9
5. SD3 / GPIO10
6. CMD / GPIO11
1. CLK/GPIO6
2. SD0/GPIO7
3. SD1/GPIO8
4. SD2/GPIO9
5. SD3/GPIO10
6. CMD/GPIO11
==== =============
.. important::
@ -229,23 +231,23 @@ SPI Flash / JP13
.. _get-started-esp-wrover-kit-v3-jtag-header:
JTAG / JP8
JTAG/JP8
^^^^^^^^^^
==== ============== =============
. ESP32 管脚 JTAG 信号
==== ============== =============
1. EN TRST_N
2. MTMS / GPIO14 TMS
3. MTDO / GPIO15 TDO
4. MTDI / GPIO12 TDI
5. MTCK / GPIO13 TCK
2. MTMS/GPIO14 TMS
3. MTDO/GPIO15 TDO
4. MTDI/GPIO12 TDI
5. MTCK/GPIO13 TCK
==== ============== =============
.. _get-started-esp-wrover-kit-v3-camera-header:
摄像头 / JP4
摄像头/JP4
^^^^^^^^^^^^
==== ========== =============================
@ -253,22 +255,22 @@ JTAG / JP8
==== ========== =============================
1. n/a 3.3V
2. n/a 地
3. GPIO27 SIO_C / SCCB 时钟
4. GPIO26 SIO_D / SCCB 数据
5. GPIO25 VSYNC / 垂直同步
6. GPIO23 HREF / 水平参考
7. GPIO22 PCLK / 像素时钟
8. GPIO21 XCLK / 系统时钟
9. GPIO35 D7 / 像素数据 Bit 7
10. GPIO34 D6 / 像素数据 Bit 6
11. GPIO39 D5 / 像素数据 Bit 5
12. GPIO36 D4 / 像素数据 Bit 4
13. GPIO19 D3 / 像素数据 Bit 3
14. GPIO18 D2 / 像素数据 Bit 2
15. GPIO5 D1 / 像素数据 Bit 1
16. GPIO4 D0 / 像素数据 Bit 0
17. GPIO0 RESET / 摄像头复位
18. n/a PWDN / 摄像头断电
3. GPIO27 SIO_C/SCCB 时钟
4. GPIO26 SIO_D/SCCB 数据
5. GPIO25 VSYNC/垂直同步
6. GPIO23 HREF/水平参考
7. GPIO22 PCLK/像素时钟
8. GPIO21 XCLK/系统时钟
9. GPIO35 D7/像素数据 Bit 7
10. GPIO34 D6/像素数据 Bit 6
11. GPIO39 D5/像素数据 Bit 5
12. GPIO36 D4/像素数据 Bit 4
13. GPIO19 D3/像素数据 Bit 3
14. GPIO18 D2/像素数据 Bit 2
15. GPIO5 D1/像素数据 Bit 1
16. GPIO4 D0/像素数据 Bit 0
17. GPIO0 RESET/摄像头复位
18. n/a PWDN/摄像头断电
==== ========== =============================
* D0 到 D7 为摄像头的数据总线
@ -296,10 +298,10 @@ microSD 卡
==== ============== ===============
. ESP32 管脚 microSD 信号
==== ============== ===============
1. MTDI / GPIO12 DATA2
2. MTCK / GPIO13 CD / DATA3
3. MTDO / GPIO15 CMD
4. MTMS / GPIO14 CLK
1. MTDI/GPIO12 DATA2
2. MTCK/GPIO13 CD/DATA3
3. MTDO/GPIO15 CMD
4. MTMS/GPIO14 CLK
5. GPIO2 DATA0
6. GPIO4 DATA1
7. GPIO21 CD
@ -308,7 +310,7 @@ microSD 卡
.. _get-started-esp-wrover-kit-v3-lcd-connector:
LCD / U5
LCD/U5
^^^^^^^^
==== ============== ===============
@ -351,10 +353,11 @@ USB 供电 使能 UART 通信
打开 **电源开关**，**5V Power On LED** 应点亮。
正式开始开发
^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至你的开发板。
相关文档

15
docs/zh_CN/hw-reference/esp32/get-started-wrover-kit.rst
View File

@ -1,5 +1,6 @@
ESP-WROVER-KIT V4.1 入门指南
=========================================
:link_to_translation:`en:[English]`
本指南介绍了如何开始使用 ESP-WROVER-KIT V4.1 开发板及其功能和相关配置。
@ -12,7 +13,7 @@ ESP-WROVER-KIT V4.1 入门指南
* USB 2.0 数据线（A 转 Micro-B）
* PC（Windows、Linux 或 macOS）
您可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
你可以跳过介绍部分，直接前往 `应用程序开发`_ 章节。
概述
@ -123,13 +124,12 @@ ESP-WROVER-KIT 开发板的主要组件、接口及控制方式见下。
- 红绿蓝发光二极管，可由 PMW 控制。
* - I/O 连接器
- 板上模组的所有管脚均已引出至开发板的排针。用户可以对 ESP32 进行编程，实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。
* - Micro SD 卡槽
* - microSD 卡槽
- 适用于需要扩充数据存储空间或进行备份的应用开发场景。
* - LCD 显示器
- 支持贴装一款 3.2” 的 SPI（标准四线串行外设接口）LCD 显示器，请见 :ref:`ESP-WROVER-KIT 开发板布局 -- 仰视图 <get-started-esp-wrover-kit-v4.1-board-back>`。
.. _get-started-esp-wrover-kit-v4.1-setup-options:
设置选项
@ -173,7 +173,7 @@ ESP32 模组的部分管脚或终端已被板上组件占用或用于外部硬
更多外设共享管脚的介绍，请见下一章节中的表格。
主要 I/O 连接器 / JP1
主要 I/O 连接器/JP1
^^^^^^^^^^^^^^^^^^^^^^^^
JP1 连接器包括 14 x 2 个排针，具体功能可见下表中间 “I/O” 列的介绍。两侧的“共用”列则介绍了这些管脚在板上的其他用途。
@ -290,7 +290,7 @@ SPI Flash/JP2
.. note::
SPI Flash 管脚用于访问内部闪存。因此，这些管脚不支持连接外部 SPI 设备，仅用于监测或高级选项。
SPI flash 管脚用于访问内部闪存。因此，这些管脚不支持连接外部 SPI 设备，仅用于监测或高级选项。
.. important::
@ -421,12 +421,13 @@ USB 供电 使能 UART 通信
打开 **电源开关**，**5V Power On LED** 应点亮。
正式开始开发
^^^^^^^^^^^^^^^^^^
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至你的开发板。
您可以在 `IDF 组件注册器 <https://components.espressif.com>`_ 中下载板级支持包 (BSP)。
你可以在 `ESP-IDF 组件注册器 <https://components.espressif.com>`_ 中下载板级支持包 (BSP)。
以下链接提供了与 ESP-WROVER-KIT 开发板硬件相关的示例：

11
docs/zh_CN/hw-reference/esp32/user-guide-devkitm-1.rst
View File

@ -1,5 +1,5 @@
===================
ESP32-DevKitM-1
ESP32-DevKitM-1
===================
:link_to_translation:`en: [English]`
@ -63,6 +63,7 @@ ESP32-DevKitM-1 开发板是一款小巧实用的开发板，具备以下特色
批量订单请前往 https://www.espressif.com/zh-hans/contact-us/sales-questions。
组件介绍
-----------
@ -101,7 +102,6 @@ ESP32-DevKitM-1 开发板的主要组件、接口及控制方式见下图。下
- 所有可用 GPIO 管脚（除 Flash 的 SPI 总线）均已引出至开发板的排针。用户可对 ESP32 芯片编程，开发多种功能
应用程序开发
---------------
@ -119,11 +119,12 @@ ESP32-DevKitM-1 上电前，请首先确认开发板完好无损。
软件设置
^^^^^^^^^^^
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至你的开发板。
.. attention::
对于2021年12月2日之前生产的ESP32-DevKitM-1， 其搭载的模组为单核 MCU 模组。请查看 `PCN-2021-021 <https://www.espressif.com/sites/default/files/pcn_downloads/PCN-2021-021%20ESP32-U4WDH%20%E5%8D%87%E7%BA%A7%E4%B8%BA%E5%8F%8C%E6%A0%B8%E5%A4%84%E7%90%86%E5%99%A8%E4%BA%A7%E5%93%81.pdf>`_ 以确定开发板上搭载的模组是否为单核模组。对于搭载单核模组的开发板，烧录应用程序前，需要在 :ref:`menuconfig <get-started-configure>` 中使能单核模式 (:ref:`CONFIG_FREERTOS_UNICORE`)。
对于 2021 年 12 月 2 日之前生产的 ESP32-DevKitM-1，其搭载的模组为单核 MCU 模组。请查看 `PCN-2021-021 <https://www.espressif.com/sites/default/files/pcn_downloads/PCN-2021-021%20ESP32-U4WDH%20%E5%8D%87%E7%BA%A7%E4%B8%BA%E5%8F%8C%E6%A0%B8%E5%A4%84%E7%90%86%E5%99%A8%E4%BA%A7%E5%93%81.pdf>`_ 以确定开发板上搭载的模组是否为单核模组。对于搭载单核模组的开发板，烧录应用程序前，需要在 :ref:`menuconfig <get-started-configure>` 中启用单核模式 (:ref:`CONFIG_FREERTOS_UNICORE`)。
硬件参考
===========
@ -302,6 +303,7 @@ ESP32-DevKitM-1 的主要组件和连接方式如下图所示。
.. [1] P：电源；I：输入；O：输出。
.. [2] MTDI、GPIO0、GPIO2、MTDO 和 GPIO5 为 Strapping 管脚。在芯片上电和系统复位过程中，Strapping 管脚根据管脚的二进制电压值控制芯片功能。Strapping 管脚的具体描述和应用，请参考 `《ESP32 技术规格书》`_ > 章节 Strapping 管脚。
管脚布局
^^^^^^^^
@ -313,6 +315,7 @@ ESP32-DevKitM-1 的主要组件和连接方式如下图所示。
ESP32-DevKitM-1 （点击放大）
硬件修订历史
===============

10
docs/zh_CN/hw-reference/esp32/user-guide-devkits-r-v1.1.rst
View File

@ -34,7 +34,6 @@ ESP32-DevKitS(-R) 包括两款开发板，分别是 ESP32-DevKitS 和 ESP32-DevK
概述
----
ESP32-DevKitS(-R) 是乐鑫专为 ESP32 设计的烧录底板，无需将 ESP32 模组与电源和信号线焊接便可进行烧录。ESP32-DevKitS(-R) 搭载模组后，可作为类似 ESP32-DevKitC 的小型开发板使用。
ESP32-DevKitS 和 ESP32-DevKitS-R 仅在弹簧布局上有所不同，用于适配不同的 ESP32 模组。
@ -108,7 +107,7 @@ ESP32-DevKitS 和 ESP32-DevKitS-R 仅在弹簧布局上有所不同，用于适
- 任选一款 ESP32 模组
- USB 2.0 数据线（标准 A 型转 Micro-B 型）
- 电脑 （Windows、Linux 或 macOS）
- 电脑（Windows、Linux 或 macOS）
硬件设置
@ -121,7 +120,6 @@ ESP32-DevKitS 和 ESP32-DevKitS-R 仅在弹簧布局上有所不同，用于适
- 检查所有引脚弹簧是否均已卡进邮票孔中。如发现错位，可使用镊子将引脚弹簧拨入邮票孔中。
软件设置
^^^^^^^^
@ -133,7 +131,7 @@ ESP32-DevKitS 和 ESP32-DevKitS-R 仅在弹簧布局上有所不同，用于适
备选方式
++++++++
Windows 用户也可以使用 `Flash 下载工具 <https://www.espressif.com/zh-hans/support/download/other-tools?keys=FLASH+>`_ 烧录二进制文件。请下载该工具、解压并参照 *doc* 文件夹内的使用指南。
Windows 用户也可以使用 `flash 下载工具 <https://www.espressif.com/zh-hans/support/download/other-tools?keys=FLASH+>`_ 烧录二进制文件。请下载该工具、解压并参照 *doc* 文件夹内的使用指南。
.. 注解::
1. 烧录二进制文件时需将 ESP32 芯片设置成固件下载模式。这一步骤可由烧录工具自动执行，也可按住 Boot 按键并点按 EN 按键手动执行。
@ -180,7 +178,6 @@ Windows 用户也可以使用 `Flash 下载工具 <https://www.espressif.com/zh-
硬件参考
========
功能框图
--------
@ -195,11 +192,10 @@ ESP32-DevKitS(-R) 的主要组件和连接方式如下图所示。
ESP32-DevKitS(-R)（点击放大）
电源选项
^^^^^^^^
您可从以下三种供电方式中任选其一给 ESP32-DevKitS(-R) 供电：
以下任一供电方式均可给 ESP32-DevKitS(-R) 供电：
- Micro USB 端口供电（默认）
- 5V 和 GND 管脚供电

26
docs/zh_CN/hw-reference/esp32c3/user-guide-devkitc-02.rst
View File

@ -4,7 +4,7 @@ ESP32-C3-DevKitC-02
:link_to_translation:`en: [English]`
本指南将帮助您快速上手 ESP32-C3-DevKitC-02，并提供该款开发板的详细信息。
本指南将帮助你快速上手 ESP32-C3-DevKitC-02，并提供该款开发板的详细信息。
ESP32-C3-DevKitC-02 是一款入门级开发板，使用配置 4 MB SPI flash 的通用型模组 `ESP32-C3-WROOM-02 <https://www.espressif.com/sites/default/files/documentation/esp32-c3-wroom-02_datasheet_cn.pdf>`_。该款开发板具备完整的 Wi-Fi 和低功耗蓝牙功能。
@ -24,11 +24,13 @@ ESP32-C3-DevKitC-02 是一款入门级开发板，使用配置 4 MB SPI flash
- `硬件版本`_：介绍硬件历史版本和已知问题，并提供链接至历史版本开发板的入门指南（如有）。
- `相关文档`_：列出了相关文档的链接。
入门指南
========
本小节将简要介绍 ESP32-C3-DevKitC-02，说明如何在 ESP32-C3-DevKitC-02 上烧录固件及相关准备工作。
组件介绍
--------
@ -68,27 +70,31 @@ ESP32-C3-DevKitC-02 是一款入门级开发板，使用配置 4 MB SPI flash
* - RGB LED
- 可寻址 RGB 发光二极管，由 GPIO8 驱动。
开始开发应用
------------
通电前，请确保 ESP32-C3-DevKitC-02 完好无损。
必备硬件
^^^^^^^^
- ESP32-C3-DevKitC-02
- USB 2.0 数据线（标准 A 型转 Micro-B 型）
- 电脑 （Windows、Linux 或 macOS）
- 电脑（Windows、Linux 或 macOS）
.. 注解::
请确保使用适当的 USB 数据线。部分数据线仅可用于充电，无法用于数据传输和编程。
软件设置
^^^^^^^^
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 小节查看如何快速设置开发环境，将应用程序烧录至 ESP32-C3-DevKitC-02。
内含组件和包装
--------------
@ -99,6 +105,7 @@ ESP32-C3-DevKitC-02 是一款入门级开发板，使用配置 4 MB SPI flash
零售订单请前往 https://www.espressif.com/zh-hans/company/contact/buy-a-sample。
批量订单
^^^^^^^^
@ -106,6 +113,7 @@ ESP32-C3-DevKitC-02 是一款入门级开发板，使用配置 4 MB SPI flash
批量订单请前往 https://www.espressif.com/zh-hans/contact-us/sales-questions。
硬件参考
========
@ -122,10 +130,11 @@ ESP32-C3-DevKitC-02 的主要组件和连接方式如下图所示。
ESP32-C3-DevKitC-02（点击放大）
电源选项
^^^^^^^^
您可从以下三种供电方式中任选其一给 ESP32-C3-DevKitC-02 供电：
以下任一供电方式均可为 ESP32-C3-DevKitC-02 供电：
- Micro-USB 接口供电（默认）
- 5V 和 GND 排针供电
@ -133,15 +142,18 @@ ESP32-C3-DevKitC-02 的主要组件和连接方式如下图所示。
建议选择第一种供电方式：Micro-USB 接口供电。
.. _user-guide-c3-devkitc-02-v1-header-blocks:
排针
----
下表列出了开发板两侧排针（J1 和 J3）的 **名称** 和 **功能**，排针的名称如图 :ref:`user-guide-c3-devkitc-02-v1-board-front` 所示，排针的序号与 `ESP32-C3-DevKitC-02 原理图`_ (PDF)一致。
下表列出了开发板两侧排针（J1 和 J3）的 **名称** 和 **功能**，排针的名称如图 :ref:`user-guide-c3-devkitc-02-v1-board-front` 所示，排针的序号与 `ESP32-C3-DevKitC-02 原理图`_ (PDF) 一致。
J1
^^^
==== ==== ========== ================================
序号 名称 类型 [1]_ 功能
==== ==== ========== ================================
@ -162,8 +174,10 @@ J1
15 G G 接地
==== ==== ========== ================================
J3
^^^
==== ==== ========== ================================
序号 名称 类型 [1]_ 功能
==== ==== ========== ================================
@ -191,6 +205,7 @@ J3
管脚布局
^^^^^^^^
.. figure:: ../../../_static/esp32-c3-devkitc-02-v1-pinout.png
:align: center
:scale: 50%
@ -199,13 +214,16 @@ J3
ESP32-C3-DevKitC-02 管脚布局（点击放大）
硬件版本
==========
该开发板为最新硬件，尚未有历史版本。
相关文档
========
* `使用 ESP32-C3 构建安全高性价比的互联设备 <http://c3.espressif.com/>`_
* `ESP32-C3 技术规格书`_ (PDF)
* `ESP32-C3-WROOM-02 规格书`_ (PDF)

25
docs/zh_CN/hw-reference/esp32c3/user-guide-devkitm-1.rst
View File

@ -4,7 +4,7 @@ ESP32-C3-DevKitM-1
:link_to_translation:`en: [English]`
本指南将帮助您快速上手 ESP32-C3-DevKitM-1，并提供该款开发板的详细信息。
本指南将帮助你快速上手 ESP32-C3-DevKitM-1，并提供该款开发板的详细信息。
ESP32-C3-DevKitM-1 是一款入门级开发板，使用以尺寸小而得名的 `ESP32-C3-MINI-1 <https://www.espressif.com/sites/default/files/documentation/esp32-c3-mini-1_datasheet_cn.pdf>`_ 模组。该款开发板具备完整的 Wi-Fi 和低功耗蓝牙功能。
@ -24,11 +24,13 @@ ESP32-C3-DevKitM-1 是一款入门级开发板，使用以尺寸小而得名的
- `硬件版本`_：介绍硬件历史版本和已知问题，并提供链接至历史版本开发板的入门指南（如有）。
- `相关文档`_：列出了相关文档的链接。
入门指南
========
本小节将简要介绍 ESP32-C3-DevKitM-1，说明如何在 ESP32-C3-DevKitM-1 上烧录固件及相关准备工作。
组件介绍
--------
@ -74,22 +76,25 @@ ESP32-C3-DevKitM-1 是一款入门级开发板，使用以尺寸小而得名的
通电前，请确保 ESP32-C3-DevKitM-1 完好无损。
必备硬件
^^^^^^^^
- ESP32-C3-DevKitM-1
- USB 2.0 数据线（标准 A 型转 Micro-B 型）
- 电脑 （Windows、Linux 或 macOS）
- 电脑（Windows、Linux 或 macOS）
.. 注解::
请确保使用适当的 USB 数据线。部分数据线仅可用于充电，无法用于数据传输和编程。
软件设置
^^^^^^^^
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 小节查看如何快速设置开发环境，将应用程序烧录至 ESP32-C3-DevKitM-1。
内含组件和包装
--------------
@ -108,6 +113,7 @@ ESP32-C3-DevKitM-1 是一款入门级开发板，使用以尺寸小而得名的
批量订单请前往 https://www.espressif.com/zh-hans/contact-us/sales-questions。
硬件参考
========
@ -124,10 +130,11 @@ ESP32-C3-DevKitM-1 的主要组件和连接方式如下图所示。
ESP32-C3-DevKitM-1 （点击放大）
电源选项
^^^^^^^^
您可从以下三种供电方式中任选其一给 ESP32-C3-DevKitM-1 供电：
以下任一供电方式均可为 ESP32-C3-DevKitM-1 供电：
- Micro-USB 接口供电（默认）
- 5V 和 GND 排针供电
@ -135,15 +142,18 @@ ESP32-C3-DevKitM-1 的主要组件和连接方式如下图所示。
建议选择第一种供电方式：Micro-USB 接口供电。
.. _user-guide-c3-devkitm-1-v1-header-blocks:
排针
----
下表列出了开发板两侧排针（J1 和 J3）的 **名称** 和 **功能**，排针的名称如图 :ref:`user-guide-c3-devkitm-1-v1-board-front` 所示，排针的序号与 `ESP32-C3-DevKitM-1 原理图`_ (PDF)一致。
下表列出了开发板两侧排针（J1 和 J3）的 **名称** 和 **功能**，排针的名称如图 :ref:`user-guide-c3-devkitm-1-v1-board-front` 所示，排针的序号与 `ESP32-C3-DevKitM-1 原理图`_ (PDF) 一致。
J1
^^^
==== ==== ========== ================================
序号 名称 类型 [1]_ 功能
==== ==== ========== ================================
@ -164,8 +174,10 @@ J1
15 GND G 接地
==== ==== ========== ================================
J3
^^^
==== ==== ========== ================================
序号 名称 类型 [1]_ 功能
==== ==== ========== ================================
@ -189,8 +201,10 @@ J3
.. [1] P：电源；I：输入；O：输出；T：可设置为高阻。
.. [2] GPIO2、GPIO8、GPIO9 为 ESP32-C3FN4 芯片的 Strapping 管脚。在芯片上电和系统复位过程中，Strapping 管脚根据管脚的二进制电压值控制芯片功能。Strapping 管脚的具体描述和应用，请参考 `ESP32-C3 技术规格书`_ 的 Strapping 管脚章节。
管脚布局
^^^^^^^^
.. figure:: ../../../_static/esp32-c3-devkitm-1-v1-pinout.png
:align: center
:scale: 45%
@ -198,13 +212,16 @@ J3
ESP32-C3-DevKitM-1 管脚布局（点击放大）
硬件版本
==========
该开发板为最新硬件，尚未有历史版本。
相关文档
========
* `使用 ESP32-C3 构建安全高性价比的互联设备 <http://c3.espressif.com/>`_
* `ESP32-C3 技术规格书`_ (PDF)
* `ESP32-C3-MINI-1 规格书`_ (PDF)

43
docs/zh_CN/hw-reference/esp32s2/user-guide-devkitm-1-v1.rst
View File

@ -9,9 +9,9 @@ ESP32-S2-DevKitM-1
ESP32-S2-DevKitM-1 是乐鑫一款入门级开发板。板上模组大部分管脚均已引出至两侧排针，开发人员可根据实际需求，轻松通过跳线连接多种外围设备，同时也可将开发板插在面包板上使用。
+----------------------+-----------------------+
| |ESP32-S2-DevKitM-1| | |ESP32-S2-DevKitM-1U| |
| |ESP32-S2-DevKitM-1| | |ESP32-S2-DevKitM-1U| |
+----------------------+-----------------------+
| ESP32-S2-DevKitM-1 | ESP32-S2-DevKitM-1U |
| ESP32-S2-DevKitM-1 | ESP32-S2-DevKitM-1U |
+----------------------+-----------------------+
.. |ESP32-S2-DevKitM-1| image:: ../../../_static/esp32-s2-devkitm-1-v1-isometric.png
@ -25,14 +25,17 @@ ESP32-S2-DevKitM-1 是乐鑫一款入门级开发板。板上模组大部分管
- `硬件版本`_：介绍硬件历史版本和已知问题，并提供链接至历史版本开发板的入门指南（如有）。
- `相关文档`_: 列出了相关文档的链接。
入门指南
========
本节介绍了如何快速上手 ESP32-S2-DevKitM-1。开头部分介绍了 ESP32-S2-DevKitM-1，`开始开发应用`_ 小节介绍了怎样在 ESP32-S2-DevKitM-1 上烧录固件及相关准备工作。
内含组件和包装
--------------
.. _user-guide-devkitm-1-v1-ordering-info:
订购信息
@ -77,7 +80,7 @@ ESP32-S2-DevKitM-1 是乐鑫一款入门级开发板。板上模组大部分管
- ESP32-S2-MINI-1
- 4 MB
- 2 MB
- PCB 板载天线
- PCB 板载天线
* - ESP32-S2-DevKitM-1RU
- ESP32-S2-MINI-1U
- 4 MB
@ -87,6 +90,7 @@ ESP32-S2-DevKitM-1 是乐鑫一款入门级开发板。板上模组大部分管
.. [#] ESP32-S2-MINI-2 和 ESP32-S2-MINI-2U 模组使用 v1.0 版本芯片，其余模组使用 v0.0 版本芯片。更多关于芯片版本的信息，请参考 `《ESP32-S2 系列芯片勘误表》`_。
零售订单
^^^^^^^^
@ -94,6 +98,7 @@ ESP32-S2-DevKitM-1 是乐鑫一款入门级开发板。板上模组大部分管
零售订单请前往 https://www.espressif.com/zh-hans/company/contact/buy-a-sample。
批量订单
^^^^^^^^
@ -101,6 +106,7 @@ ESP32-S2-DevKitM-1 是乐鑫一款入门级开发板。板上模组大部分管
批量订单请前往 https://www.espressif.com/zh-hans/contact-us/sales-questions。
组件介绍
--------
@ -120,7 +126,7 @@ ESP32-S2-DevKitM-1 是乐鑫一款入门级开发板。板上模组大部分管
ESP32-S2-DevKitM-1U - 正面
以下按照顺时针的顺序依次介绍开发板上的主要组件。
以下按照顺时针的顺序依次介绍开发板上的主要组件。
.. list-table::
:widths: 30 70
@ -139,7 +145,7 @@ ESP32-S2-DevKitM-1 是乐鑫一款入门级开发板。板上模组大部分管
* - Reset Button（Reset 键）
- 复位按键。
* - Micro-USB（Micro-USB 接口）
- USB 接口。可用作开发板的供电电源或 PC 和 ESP32-S2FH4 芯片的通信接口。
- USB 接口。可用作开发板的供电电源或 PC 和 ESP32-S2FH4 芯片的通信接口。
* - Boot Button（Boot 键）
- 下载按键。按住 **Boot** 键的同时按一下 **Reset** 键进入“固件下载”模式，通过串口下载固件。
* - RGB LED
@ -149,31 +155,35 @@ ESP32-S2-DevKitM-1 是乐鑫一款入门级开发板。板上模组大部分管
* - External Antenna Connector（外部天线连接器）
- 仅 **ESP32-S2-MINI-2U** 和 **ESP32-S2-MINI-1U** 模组带有外部天线连接器。连接器尺寸，请参考模组规格书的 外部天线连接器尺寸章节。
开始开发应用
------------
通电前，请确保 ESP32-S2-DevKitM-1 完好无损。
必备硬件
^^^^^^^^
- ESP32-S2-DevKitM-1
- USB 2.0 数据线（标准 A 型转 Micro-B 型）
- 电脑 （Windows、Linux 或 macOS）
- 电脑（Windows、Linux 或 macOS）
.. 注解::
请确保使用适当的 USB 数据线。部分数据线仅可用于充电，无法用于数据传输和编程。
软件设置
^^^^^^^^
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 一节查看如何快速设置开发环境，将应用程序烧录至 ESP32-S2-DevKitM-1。
.. 注解::
ESP32-S2 系列芯片仅支持 ESP-IDF master 分支或 v4.2 以上版本。
硬件参考
========
@ -190,16 +200,18 @@ ESP32-S2-DevKitM-1 的主要组件和连接方式如下图所示。
ESP32-S2-DevKitM-1 （点击放大）
电源选项
^^^^^^^^
您可从以下三种供电方式中任选其一给 ESP32-S2-DevKitM-1 供电：
以下任一供电方式均可给 ESP32-S2-DevKitM-1 供电：
- Micro-USB 接口供电（默认）
- 5V 和 GND 排针供电
- 3V3 和 GND 排针供电
建议选择第一种供电方式：Micro-USB 接口供电。
建议选择第一种供电方式：micro USB 接口供电。
.. _user-guide-devkitm-1-v1-header-blocks:
@ -208,8 +220,10 @@ ESP32-S2-DevKitM-1 的主要组件和连接方式如下图所示。
下表列出了开发板两侧排针（J1 和 J3）的 **名称** 和 **功能**，排针的名称如图 :ref:`user-guide-devkitm-1-v1-board-front` 所示，排针的序号与 `ESP32-S2-DevKitM-1 原理图 <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_Schematics.pdf>`_ (PDF)一致。
J1
^^^
==== ==== ========= =========================================================================
序号 名称 类型 [#]_ 功能
==== ==== ========= =========================================================================
@ -236,8 +250,10 @@ J1
21 G G 接地
==== ==== ========= =========================================================================
J3
^^^
==== ==== ===== ========================================================
序号 名称 类型 功能
==== ==== ===== ========================================================
@ -264,10 +280,12 @@ J3
21 18 I/O/T RTC_GPIO18, GPIO18, U1RXD, ADC2_CH7, DAC_2, CLK_OUT3, RGB LED
==== ==== ===== ========================================================
.. [#] P：电源；I：输入；O：输出；T：可设置为高阻。
.. [#] P：电源；I：输入；O：输出；T：可设置为高阻。
管脚布局
^^^^^^^^
.. figure:: ../../../_static/esp32-s2-devkitm-1-v1-pin-layout.png
:align: center
:scale: 15%
@ -276,13 +294,16 @@ J3
ESP32-S2-DevKitM-1 管脚布局（点击放大）
硬件版本
==========
无历史版本。
相关文档
========
* `ESP32-S2 系列芯片 v1.0 版本技术规格书`_ (PDF)
* `ESP32-S2 系列芯片 v0.0 版本技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_cn.pdf>`_ (PDF)
* `《ESP32-S2 系列芯片勘误表》`_ (PDF)
@ -291,7 +312,7 @@ J3
* `ESP32-S2-DevKitM-1 原理图 <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_Schematics.pdf>`_ (PDF)
* `ESP32-S2-DevKitM-1 PCB 布局 <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_PCB_Layout.pdf>`_ (PDF)
* `ESP32-S2-DevKitM-1 尺寸图 <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_Dimensions.pdf>`_ (PDF)
* `乐鑫产品选型工具 <https://products.espressif.com/#/product-selector?names=>`__
* `乐鑫产品选型工具 <https://products.espressif.com/#/product-selector?names=>`__
有关本开发板的更多设计文档，请联系我们的商务部门 `sales@espressif.com <sales@espressif.com>`_。

5
docs/zh_CN/hw-reference/esp32s2/user-guide-esp-lyrap-cam-v1.0.rst
View File

@ -10,7 +10,7 @@ ESP-LyraP-CAM v1.0
目前，ESP-LyraP-CAM v1.0 扩展板正在搭配 :doc:`user-guide-esp32-s2-kaluga-1-kit-v1.2` 销售。
ESP-LyraP-CAM 可为您的主板增加摄像头功能。
ESP-LyraP-CAM 可为你的主板增加摄像头功能。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-lyrap-cam-v1.0-3d.png
:align: center
@ -30,7 +30,7 @@ ESP-LyraP-CAM 可为您的主板增加摄像头功能。
概述
====
ESP-LyraP-CAM 扩展板可为您的主板增加一个摄像头。
ESP-LyraP-CAM 扩展板可为你的主板增加一个摄像头。
组件描述
@ -88,7 +88,6 @@ ESP-LyraP-CAM 上电前，请首先确认开发板完好无损。
硬件参考
========
功能框图
--------

5
docs/zh_CN/hw-reference/esp32s2/user-guide-esp-lyrap-cam-v1.1.rst
View File

@ -10,7 +10,7 @@ ESP-LyraP-CAM v1.1
目前，ESP-LyraP-CAM v1.1 扩展板正在搭配 :doc:`user-guide-esp32-s2-kaluga-1-kit` 销售。
ESP-LyraP-CAM 可为您的主板增加摄像头功能。
ESP-LyraP-CAM 可为你的主板增加摄像头功能。
.. Image of v1.0 is used as there are no visual changes
@ -32,7 +32,7 @@ ESP-LyraP-CAM 可为您的主板增加摄像头功能。
概述
====
ESP-LyraP-CAM 扩展板可为您的主板增加一个摄像头。
ESP-LyraP-CAM 扩展板可为你的主板增加一个摄像头。
组件描述
@ -90,7 +90,6 @@ ESP-LyraP-CAM 上电前，请首先确认开发板完好无损。
硬件参考
========
功能框图
--------

4
docs/zh_CN/hw-reference/esp32s2/user-guide-esp-lyrap-lcd32-v1.1.rst
View File

@ -10,7 +10,7 @@ ESP-LyraP-LCD32 v1.1
目前，ESP-LyraP-CAM v1.1 扩展板正在搭配 :doc:`user-guide-esp32-s2-kaluga-1-kit-v1.2` 销售。
ESP-LyraP-LCD32 可为您的主板增加 LCD 图像显示功能。
ESP-LyraP-LCD32 可为你的主板增加 LCD 图像显示功能。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-lyrap-lcd32-v1.1-3d.png
:align: center
@ -33,7 +33,7 @@ ESP-LyraP-LCD32 可为您的主板增加 LCD 图像显示功能。
概述
====
ESP-LyraP-LCD32 可为您的主板增加了一块 3.2" LCD 图形显示屏（320 x 240 分辨率）。该显示屏通过 SPI 总线连接到 ESP32-S2。
ESP-LyraP-LCD32 可为你的主板增加一块 3.2" LCD 图形显示屏（320 x 240 分辨率）。该显示屏通过 SPI 总线连接到 ESP32-S2。
组件描述

4
docs/zh_CN/hw-reference/esp32s2/user-guide-esp-lyrap-lcd32-v1.2.rst
View File

@ -10,7 +10,7 @@ ESP-LyraP-LCD32 v1.2
目前，ESP-LyraP-LCD32 v1.2 扩展板正在搭配 :doc:`user-guide-esp32-s2-kaluga-1-kit` 销售。
ESP-LyraP-LCD32 可为您的主板增加 LCD 图像显示功能。
ESP-LyraP-LCD32 可为你的主板增加 LCD 图像显示功能。
.. Image of v1.1 is used as there are no visual changes
@ -35,7 +35,7 @@ ESP-LyraP-LCD32 可为您的主板增加 LCD 图像显示功能。
概述
====
ESP-LyraP-LCD32 可为您的主板增加了一块 3.2" LCD 图形显示屏（320 x 240 分辨率）。该显示屏通过 SPI 总线连接到 ESP32-S2。
ESP-LyraP-LCD32 可为你的主板增加了一块 3.2" LCD 图形显示屏（320 x 240 分辨率）。该显示屏通过 SPI 总线连接到 ESP32-S2。
组件描述

3
docs/zh_CN/hw-reference/esp32s2/user-guide-esp-lyrap-toucha-v1.1.rst
View File

@ -13,7 +13,7 @@ ESP-LyraP-TouchA v1.1
* :doc:`user-guide-esp32-s2-kaluga-1-kit`
* :doc:`user-guide-esp32-s2-kaluga-1-kit-v1.2`
ESP-LyraP-TouchA 可为您的主板增加触摸按键功能。
ESP-LyraP-TouchA 可为你的主板增加触摸按键功能。
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-lyrap-toucha-v1.1-3d.png
:align: center
@ -90,7 +90,6 @@ ESP-LyraP-TouchA 上电前，请首先确认开发板完好无损。
硬件参考
========
功能框图
--------

7
docs/zh_CN/hw-reference/esp32s2/user-guide-esp-lyrat-8311a_v1.2.rst
View File

@ -10,7 +10,7 @@ ESP-LyraT-8311A v1.2
目前，ESP-LyraT-8311A v1.2 扩展板正在搭配 :doc:`user-guide-esp32-s2-kaluga-1-kit-v1.2` 销售。
ESP-LyraT-8311A 扩展板可为您的主板增加音频处理功能。
ESP-LyraT-8311A 扩展板可为你的主板增加音频处理功能。
- 音频播放/录音
- 音频信号处理
@ -41,6 +41,7 @@ ESP-LyraT-8311A 扩展板有多种使用方式。该应用程序包括语音用
ESP-LyraT-8311A 主要用于音频应用，但也可根据实际需求用作它用。
组件描述
--------
@ -85,7 +86,6 @@ ESP-LyraT-8311A 主要用于音频应用，但也可根据实际需求用作它
- ES8311 音频 ADC 和 DAC，可转换麦克风拾音的模拟信号；或转换数字信号，使其可通过扬声器或耳机进行播放
应用程序开发
------------
@ -113,7 +113,7 @@ ESP-LyraT-8311A 上电前，请首先确认开发板完好无损。
软件设置
^^^^^^^^
请根据您的具体应用，参考以下部分：
请根据你的具体应用，参考以下部分：
* ESP-ADF（乐鑫音频开发框架）的用户，请前往 `ESP-ADF 入门指南 <https://docs.espressif.com/projects/esp-adf/en/latest/get-started/index.html#about-esp-adf>`_。
* ESP32-IDF（乐鑫 IoT 开发框架）的用户，请前往 ESP32-S2-Kaluga-1 开发套件用户指南 :ref:`user-guide-esp32-s2-kaluga-1-kit-v1.2-software-setup` 章节。
@ -122,7 +122,6 @@ ESP-LyraT-8311A 上电前，请首先确认开发板完好无损。
硬件参考
========
功能框图
--------

8
docs/zh_CN/hw-reference/esp32s2/user-guide-esp-lyrat-8311a_v1.3.rst
View File

@ -10,7 +10,7 @@ ESP-LyraT-8311A v1.3
目前，ESP-LyraT-8311A v1.3 扩展板正在搭配 :doc:`user-guide-esp32-s2-kaluga-1-kit` 销售。
ESP-LyraT-8311A 扩展板可为您的主板增加音频处理功能。
ESP-LyraT-8311A 扩展板可为你的主板增加音频处理功能。
- 音频播放/录音
- 音频信号处理
@ -41,6 +41,7 @@ ESP-LyraT-8311A 扩展板有多种使用方式。该应用程序包括语音用
ESP-LyraT-8311A 主要用于音频应用，但也可根据实际需求用作它用。
组件描述
--------
@ -85,7 +86,6 @@ ESP-LyraT-8311A 主要用于音频应用，但也可根据实际需求用作它
- ES8311 音频 ADC 和 DAC，可转换麦克风拾音的模拟信号；或转换数字信号，使其可通过扬声器或耳机进行播放
应用程序开发
------------
@ -113,7 +113,7 @@ ESP-LyraT-8311A 上电前，请首先确认开发板完好无损。
软件设置
^^^^^^^^
请根据您的具体应用，参考以下部分：
请根据你的具体应用，参考以下部分：
* ESP-ADF（乐鑫音频开发框架）的用户，请前往 `ESP-ADF 入门指南 <https://docs.espressif.com/projects/esp-adf/en/latest/get-started/index.html#about-esp-adf>`_。
* ESP32-IDF（乐鑫 IoT 开发框架）的用户，请前往 ESP32-S2-Kaluga-1 开发套件用户指南 :ref:`user-guide-esp32-s2-kaluga-1-kit-software-setup` 章节。
@ -122,7 +122,6 @@ ESP-LyraT-8311A 上电前，请首先确认开发板完好无损。
硬件参考
========
功能框图
--------
@ -150,6 +149,7 @@ ESP-LyraT-8311A v1.2
:doc:`首次发布 <user-guide-esp-lyrat-8311a_v1.2>`
相关文档
========

12
docs/zh_CN/hw-reference/esp32s2/user-guide-esp32-s2-kaluga-1-kit-v1.2.rst
View File

@ -55,7 +55,6 @@ ESP32-S2-Kaluga-1 套件包括以下几个开发板：
快速入门
========
本节介绍如何开始使用 ESP32-S2-Kaluga-1，主要包括三大部分：首先，介绍一些关于 ESP32-S2-Kaluga-1 的基本信息；然后，在 `应用程序开发`_ 章节介绍如何进行硬件初始化；最后，介绍如何为 ESP32-S2-Kaluga-1 烧录固件。
@ -95,11 +94,11 @@ ESP32-S2-Kaluga-1 主板配备了多个连接器，可用于连接相应扩展
* 配合触控板使用，可控制音频播放和调节音量
* LCD 显示屏
* LCD 接口（8 位并行 RGB、8080 和 6800 接口)
* LCD 接口（8 位并行 RGB、8080 和 6800 接口）
* 摄像头图像采集
* 支持 OV2640 和 OV3660 摄像头模块
* 8-bit DVP 图像传感器接口（ESP32-S2 还支持 16 位 DVP 图像传感器，但需要您自行进行二次开发）
* 8-bit DVP 图像传感器接口（ESP32-S2 还支持 16 位 DVP 图像传感器，但需要你自行进行二次开发）
* 支持高达 40 MHz 时钟频率
* 优化 DMA 传输带宽，便于传输高分辨率图像
@ -193,13 +192,13 @@ ESP32-S2-Kaluga-1 上电前，请首先确认开发板完好无损。
- 用于 UART/JTAG 通信
- PC（Windows、Linux 或 macOS）
- 您选择的任何扩展板
- 你选择的任何扩展板
硬件设置
^^^^^^^^
1. 连接您选择的扩展板（更多信息，请见对应拓展板的用户指南)
1. 连接你选择的扩展板（更多信息，请见对应拓展板的用户指南）
2. 插入两根 USB 电缆
3. 打开 **电源开关** 时，**电源 LED 指示灯** 应点亮。
@ -211,7 +210,7 @@ ESP32-S2-Kaluga-1 上电前，请首先确认开发板完好无损。
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 一节查看如何快速设置开发环境。
您还可以点击 `这里 <https://github.com/espressif/esp-dev-kits/tree/master/esp32-s2-kaluga-1>`_，获取有关 ESP32-S2-Kaluga-1 套件编程指南与应用示例的更多内容。
你还可以点击 `这里 <https://github.com/espressif/esp-dev-kits/tree/master/esp32-s2-kaluga-1>`_，获取有关 ESP32-S2-Kaluga-1 套件编程指南与应用示例的更多内容。
内容和包装
@ -250,7 +249,6 @@ ESP32-S2-Kaluga-1 开发套件的批发包装为纸板箱。
硬件参考
========
功能框图
--------

14
docs/zh_CN/hw-reference/esp32s2/user-guide-esp32-s2-kaluga-1-kit.rst
View File

@ -56,7 +56,6 @@ ESP32-S2-Kaluga-1 套件包括以下几个开发板：
快速入门
========
本节介绍如何开始使用 ESP32-S2-Kaluga-1，主要包括三大部分：首先，介绍一些关于 ESP32-S2-Kaluga-1 的基本信息；然后，在 `应用程序开发`_ 章节介绍如何进行硬件初始化；最后，介绍如何为 ESP32-S2-Kaluga-1 烧录固件。
@ -96,11 +95,11 @@ ESP32-S2-Kaluga-1 主板配备了多个连接器，可用于连接相应扩展
* 配合触控板使用，可控制音频播放和调节音量
* LCD 显示屏
* LCD 接口（8 位并行 RGB、8080 和 6800 接口)
* LCD 接口（8 位并行 RGB、8080 和 6800 接口）
* 摄像头图像采集
* 支持 OV2640 和 OV3660 摄像头模块
* 8-bit DVP 图像传感器接口（ESP32-S2 还支持 16 位 DVP 图像传感器，但需要您自行进行二次开发）
* 8-bit DVP 图像传感器接口（ESP32-S2 还支持 16 位 DVP 图像传感器，但需要你自行进行二次开发）
* 支持高达 40 MHz 时钟频率
* 优化 DMA 传输带宽，便于传输高分辨率图像
@ -204,13 +203,13 @@ ESP32-S2-Kaluga-1 上电前，请首先确认开发板完好无损。
- 用于 UART/JTAG 通信
- PC（Windows、Linux 或 macOS）
- 您选择的任何扩展板
- 你选择的任何扩展板
硬件设置
^^^^^^^^
1. 连接您选择的扩展板（更多信息，请见对应拓展板的用户指南)
1. 连接你选择的扩展板（更多信息，请见对应拓展板的用户指南）
2. 插入两根 USB 电缆
3. 打开 **电源开关** 时，**电源 LED 指示灯** 应点亮。
@ -222,9 +221,9 @@ ESP32-S2-Kaluga-1 上电前，请首先确认开发板完好无损。
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 一节查看如何快速设置开发环境。
您还可以点击 `这里 <https://github.com/espressif/esp-dev-kits/tree/master/esp32-s2-kaluga-1>`_，获取有关 ESP32-S2-Kaluga-1 套件编程指南与应用示例的更多内容。
你还可以点击 `这里 <https://github.com/espressif/esp-dev-kits/tree/master/esp32-s2-kaluga-1>`_，获取有关 ESP32-S2-Kaluga-1 套件编程指南与应用示例的更多内容。
您可以在 `IDF 组件注册器 <https://components.espressif.com>`_ 中下载板级支持包 (BSP)。
你可以在 `IDF 组件注册器 <https://components.espressif.com>`_ 中下载板级支持包 (BSP)。
内容和包装
@ -273,7 +272,6 @@ ESP32-S2-Kaluga-1 开发套件的批发包装为纸板箱。
硬件参考
========
功能框图
--------

24
docs/zh_CN/hw-reference/esp32s2/user-guide-s2-devkitc-1.rst
View File

@ -4,7 +4,7 @@ ESP32-S2-DevKitC-1
:link_to_translation:`en: [English]`
本指南将帮助您快速上手 ESP32-S2-DevKitC-1，并提供该款开发板的详细信息。
本指南将帮助你快速上手 ESP32-S2-DevKitC-1，并提供该款开发板的详细信息。
ESP32-S2-DevKitC-1 是一款入门级开发板，具备完整的 Wi-Fi 功能。板上模组大部分管脚均已引出至两侧排针，开发人员可根据实际需求，轻松通过跳线连接多种外围设备，同时也可将开发板插在面包板上使用。
@ -22,11 +22,13 @@ ESP32-S2-DevKitC-1 是一款入门级开发板，具备完整的 Wi-Fi 功能。
- `硬件版本`_：介绍硬件历史版本和已知问题，并提供链接至历史版本开发板的入门指南（如有）。
- `相关文档`_：列出了相关文档的链接。
入门指南
========
本小节将简要介绍 ESP32-S2-DevKitC-1，说明如何在 ESP32-S2-DevKitC-1 上烧录固件及相关准备工作。
组件介绍
--------
@ -74,27 +76,31 @@ ESP32-S2-DevKitC-1 是一款入门级开发板，具备完整的 Wi-Fi 功能。
通电前，请确保 ESP32-S2-DevKitC-1 完好无损。
必备硬件
^^^^^^^^
- ESP32-S2-DevKitC-1
- USB 2.0 数据线（标准 A 型转 Micro-B 型）
- 电脑 （Windows、Linux 或 macOS）
- 电脑（Windows、Linux 或 macOS）
.. 注解::
请确保使用适当的 USB 数据线。部分数据线仅可用于充电，无法用于数据传输和编程。
硬件设置
^^^^^^^^
通过 **USB 转 UART 接口** 或 **ESP32-S2 USB 接口** 连接开发板与电脑。在后续步骤中，默认使用 **USB 转 UART 接口**。
软件设置
^^^^^^^^
请前往 `ESP-IDF 快速入门 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s2/get-started/index.html>`_，在 `详细安装步骤 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s2/get-started/index.html#get-started-step-by-step>`_ 小节查看如何快速设置开发环境，将应用程序烧录至 ESP32-S2-DevKitC-1。
内含组件和包装
--------------
@ -151,6 +157,7 @@ ESP32-S2-DevKitC-1 是一款入门级开发板，具备完整的 Wi-Fi 功能。
.. [#] ESP32-S2-SOLO-2 和 ESP32-S2-SOLO-2U 模组使用 v1.0 版本芯片，其余模组使用 v0.0 版本芯片。更多关于芯片版本的信息，请参考 `《ESP32-S2 系列芯片勘误表》`_。
零售订单
^^^^^^^^
@ -158,6 +165,7 @@ ESP32-S2-DevKitC-1 是一款入门级开发板，具备完整的 Wi-Fi 功能。
零售订单请前往 https://www.espressif.com/zh-hans/company/contact/buy-a-sample。
批量订单
^^^^^^^^
@ -165,6 +173,7 @@ ESP32-S2-DevKitC-1 是一款入门级开发板，具备完整的 Wi-Fi 功能。
批量订单请前往 https://www.espressif.com/zh-hans/contact-us/sales-questions。
硬件参考
========
@ -181,15 +190,17 @@ ESP32-S2-DevKitC-1 的主要组件和连接方式如下图所示。
ESP32-S2-DevKitC-1（点击放大）
电源选项
^^^^^^^^
您可从以下三种供电方式中任选其一给 ESP32-S2-DevKitC-1 供电：
以下任一供电方式均可给 ESP32-S2-DevKitC-1 供电：
- USB 转 UART 接口供电或 ESP32-S2 USB 接口供电（选择其一或同时供电），默认供电方式（推荐）
- 5V 和 G (GND) 排针供电
- 3V3 和 G (GND) 排针供电
.. _user-guide-s2-devkitc-1-v1-header-blocks:
排针
@ -197,8 +208,10 @@ ESP32-S2-DevKitC-1 的主要组件和连接方式如下图所示。
下表列出了开发板两侧排针（J1 和 J3）的 **名称** 和 **功能**，排针的名称如图 :ref:`user-guide-s2-devkitc-1-v1-board-front` 所示，排针的序号与 `ESP32-S2-DevKitC-1 原理图`_ (PDF) 一致。
J1
^^^
==== ========= ========= =========================================================================
序号 名称 类型 [#]_ 功能
==== ========= ========= =========================================================================
@ -226,6 +239,7 @@ J1
22 G G 接地
==== ========= ========= =========================================================================
J3
^^^
@ -259,8 +273,10 @@ J3
.. [#] P：电源；I：输入；O：输出；T：可设置为高阻。
.. [#] 搭载 ESP32-S2-SOLO-2 或 ESP32-S2-SOLO-2U 的开发板未上拉 GPIO18。
管脚布局
^^^^^^^^
.. figure:: ../../../_static/esp32-s2-devkitc-1-v1-pinout.png
:align: center
:scale: 45%
@ -269,11 +285,13 @@ J3
ESP32-S2-DevKitC-1 管脚布局（点击放大）
硬件版本
==========
无历史版本。
相关文档
========

27
docs/zh_CN/hw-reference/esp32s2/user-guide-saola-1-v1.2.rst
View File

@ -20,11 +20,13 @@ ESP32-S2-Saola-1
- `硬件版本`_：介绍硬件历史版本和已知问题，并提供链接至历史版本开发板的入门指南（如有）。
- `相关文档`_：列出了相关文档的链接。
入门指南
========
本节介绍了如何快速上手 ESP32-S2-Saola-1。开头部分介绍了 ESP32-S2-Saola-1，`开始开发应用`_ 小节介绍了怎样在 ESP32-S2-Saola-1 上安装模组、设置及烧录固件。
概述
----
@ -39,6 +41,7 @@ ESP32-S2-Saola-1 是乐鑫一款基于 ESP32-S2 的小型开发板。板上的
本指南以搭载 ESP32-S2-WROVER 模组的 ESP32-S2-Saola-1 为例。
内含组件和包装
--------------
@ -49,6 +52,7 @@ ESP32-S2-Saola-1 是乐鑫一款基于 ESP32-S2 的小型开发板。板上的
零售订单请前往 https://www.espressif.com/zh-hans/company/contact/buy-a-sample。
批量订单
^^^^^^^^
@ -56,6 +60,7 @@ ESP32-S2-Saola-1 是乐鑫一款基于 ESP32-S2 的小型开发板。板上的
批量订单请前往 https://www.espressif.com/zh-hans/contact-us/sales-questions。
组件介绍
--------
@ -93,22 +98,25 @@ ESP32-S2-Saola-1 是乐鑫一款基于 ESP32-S2 的小型开发板。板上的
* - RGB LED
- 可寻址 RGB 发光二极管 (WS2812)，由 GPIO18 驱动。
开始开发应用
------------
通电前，请确保 ESP32-S2-Saola-1 完好无损。
必备硬件
^^^^^^^^
- ESP32-S2-Saola-1
- USB 2.0 数据线（标准 A 型转 Micro-B型）
- 电脑 （Windows、Linux 或 macOS）
- USB 2.0 数据线（标准 A 型转 Micro-B 型）
- 电脑（Windows、Linux 或 macOS）
.. 注解::
请确保使用适当的 USB 数据线。部分数据线仅可用于充电，无法用于数据传输和编程。
软件设置
^^^^^^^^
@ -118,6 +126,7 @@ ESP32-S2-Saola-1 是乐鑫一款基于 ESP32-S2 的小型开发板。板上的
ESP32-S2 系列芯片仅支持 ESP-IDF master 分支或 v4.2 以上版本。
硬件参考
========
@ -134,10 +143,11 @@ ESP32-S2-Saola-1 的主要组件和连接方式如下图所示。
ESP32-S2-Saola-1 （点击放大）
电源选项
^^^^^^^^
您可从以下三种供电方式中任选其一给 ESP32-S2-Saola-1 供电：
以下任一供电方式均可给 ESP32-S2-Saola-1 供电：
- Micro-USB 接口供电（默认）
- 5V 和 GND 排针供电
@ -145,13 +155,16 @@ ESP32-S2-Saola-1 的主要组件和连接方式如下图所示。
建议选择第一种供电方式：Micro-USB 接口供电。
排针
----
下表列出了开发板两侧排针（J2 和 J3）的 **名称** 和 **功能**，排针的名称如图 :ref:`user-guide-saola-1-v1.2-board-front` 所示，排针的序号与 `ESP32-S2-Saola-1 原理图`_ (PDF) 一致。
J2
^^^
==== ==== ========= ======================================
序号 名称 类型 [#]_ 功能
==== ==== ========= ======================================
@ -178,8 +191,10 @@ J2
21 GND G 接地
==== ==== ========= ======================================
J3
^^^
==== ==== ===== ====================================
序号 名称 类型 功能
==== ==== ===== ====================================
@ -208,8 +223,10 @@ J3
.. [#] P：电源；I：输入；O：输出；T：可设置为高阻。
管脚布局
^^^^^^^^
.. figure:: ../../../_static/esp32-s2_saola1-pinout.jpg
:align: center
:scale: 45%
@ -218,11 +235,13 @@ J3
ESP32-S2-Saola-1 管脚布局（点击放大）
硬件版本
==========
无历史版本。
相关文档
========

12
docs/zh_CN/hw-reference/esp32s3/user-guide-devkitc-1-v1.0.rst
View File

@ -6,7 +6,7 @@ ESP32-S3-DevKitC-1
最新版本：:doc:`user-guide-devkitc-1`
本指南将帮助您快速上手 ESP32-S3-DevKitC-1，并提供该款开发板的详细信息。
本指南将帮助你快速上手 ESP32-S3-DevKitC-1，并提供该款开发板的详细信息。
ESP32-S3-DevKitC-1 是一款入门级开发板，搭载 Wi-Fi + Bluetooth® LE 模组 ESP32-S3-WROOM-1、ESP32-S3-WROOM-1U 或 ESP32-S3-WROOM-2。
@ -105,7 +105,7 @@ ESP32-S3-DevKitC-1 是一款入门级开发板，搭载 Wi-Fi + Bluetooth® LE
软件设置
^^^^^^^^
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 小节查看如何快速设置开发环境，将应用程序烧录至您的开发板。
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 小节查看如何快速设置开发环境，将应用程序烧录至你的开发板。
内含组件和包装
@ -170,6 +170,7 @@ ESP32-S3-DevKitC-1 是一款入门级开发板，搭载 Wi-Fi + Bluetooth® LE
上表中，QD 指代 Quad SPI，OT 指代 Octal SPI。
零售订单
^^^^^^^^
@ -186,15 +187,12 @@ ESP32-S3-DevKitC-1 是一款入门级开发板，搭载 Wi-Fi + Bluetooth® LE
批量订单请前往 https://www.espressif.com/zh-hans/contact-us/sales-questions。
硬件参考
========
功能框图
--------
ESP32-S3-DevKitC-1 的主要组件和连接方式如下图所示。
.. figure:: ../../../_static/ESP32-S3-DevKitC-1_v2-SystemBlock.png
@ -208,12 +206,13 @@ ESP32-S3-DevKitC-1 的主要组件和连接方式如下图所示。
电源选项
^^^^^^^^
您可从以下三种供电方式中任选其一给开发板供电：
以下任一供电方式均可给开发板供电：
- USB 转 UART 接口供电或 ESP32-S3 USB 接口供电（选择其一或同时供电），默认供电方式（推荐）
- 5V 和 G (GND) 排针供电
- 3V3 和 G (GND) 排针供电
.. _user-guide-s3-devkitc-1-v1-header-blocks:
排针
@ -293,7 +292,6 @@ J3
管脚布局
^^^^^^^^^^^
.. figure:: ../../../_static/ESP32-S3_DevKitC-1_pinlayout.jpg
:align: center
:scale: 50%

12
docs/zh_CN/hw-reference/esp32s3/user-guide-devkitc-1.rst
View File

@ -6,7 +6,7 @@ ESP32-S3-DevKitC-1 v1.1
更早版本：:doc:`user-guide-devkitc-1-v1.0`
本指南将帮助您快速上手 ESP32-S3-DevKitC-1，并提供该款开发板的详细信息。
本指南将帮助你快速上手 ESP32-S3-DevKitC-1，并提供该款开发板的详细信息。
ESP32-S3-DevKitC-1 是一款入门级开发板，搭载 Wi-Fi + Bluetooth® LE 模组 ESP32-S3-WROOM-1、ESP32-S3-WROOM-1U 或 ESP32-S3-WROOM-2。
@ -105,7 +105,7 @@ ESP32-S3-DevKitC-1 是一款入门级开发板，搭载 Wi-Fi + Bluetooth® LE
软件设置
^^^^^^^^
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 小节查看如何快速设置开发环境，将应用程序烧录至您的开发板。
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 小节查看如何快速设置开发环境，将应用程序烧录至你的开发板。
内含组件和包装
@ -170,6 +170,7 @@ ESP32-S3-DevKitC-1 是一款入门级开发板，搭载 Wi-Fi + Bluetooth® LE
上表中，QD 指代 Quad SPI，OT 指代 Octal SPI。
零售订单
^^^^^^^^
@ -186,15 +187,12 @@ ESP32-S3-DevKitC-1 是一款入门级开发板，搭载 Wi-Fi + Bluetooth® LE
批量订单请前往 https://www.espressif.com/zh-hans/contact-us/sales-questions。
硬件参考
========
功能框图
--------
ESP32-S3-DevKitC-1 的主要组件和连接方式如下图所示。
.. figure:: ../../../_static/ESP32-S3-DevKitC-1_v2-SystemBlock.png
@ -208,12 +206,13 @@ ESP32-S3-DevKitC-1 的主要组件和连接方式如下图所示。
电源选项
^^^^^^^^
您可从以下三种供电方式中任选其一给开发板供电：
以下任一供电方式均可给开发板供电：
- USB 转 UART 接口供电或 ESP32-S3 USB 接口供电（选择其一或同时供电），默认供电方式（推荐）
- 5V 和 G (GND) 排针供电
- 3V3 和 G (GND) 排针供电
.. _user-guide-s3-devkitc-1-v1.1-header-blocks:
排针
@ -293,7 +292,6 @@ J3
管脚布局
^^^^^^^^^^^
.. figure:: ../../../_static/ESP32-S3_DevKitC-1_pinlayout_v1.1.jpg
:align: center
:scale: 50%

12
docs/zh_CN/hw-reference/esp32s3/user-guide-devkitm-1.rst
View File

@ -4,7 +4,7 @@ ESP32-S3-DevKitM-1
:link_to_translation:`en: [English]`
本指南将帮助您快速上手 ESP32-S3-DevKitM-1，并提供该款开发板的详细信息。
本指南将帮助你快速上手 ESP32-S3-DevKitM-1，并提供该款开发板的详细信息。
ESP32-S3-DevKitM-1 是一款入门级开发板，搭载的是 Wi-Fi+蓝牙 LE 模组 ESP32-S3-MINI-1 或 ESP32-S3-MINI-1U，该款模组因小尺寸而得名。
@ -97,10 +97,11 @@ ESP32-S3-DevKitM-1 是一款入门级开发板，搭载的是 Wi-Fi+蓝牙 LE
通过 **USB 转 UART 接口** 或 **ESP32-S3 USB 接口** 连接开发板与电脑。在后续步骤中，默认使用 **USB 转 UART 接口**。
软件设置
^^^^^^^^
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 小节查看如何快速设置开发环境，将应用程序烧录至您的开发板。
请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 小节查看如何快速设置开发环境，将应用程序烧录至你的开发板。
内含组件和包装
@ -122,15 +123,12 @@ ESP32-S3-DevKitM-1 是一款入门级开发板，搭载的是 Wi-Fi+蓝牙 LE
批量订单请前往 https://www.espressif.com/zh-hans/contact-us/sales-questions。
硬件参考
========
功能框图
--------
ESP32-S3-DevKitM-1 的主要组件和连接方式如下图所示。
.. figure:: ../../../_static/ESP32-S3-DevKitM-1_v1_SystemBlock.png
@ -145,12 +143,13 @@ ESP32-S3-DevKitM-1 的主要组件和连接方式如下图所示。
电源选项
^^^^^^^^
您可从以下三种供电方式中任选其一给开发板供电：
以下任一供电方式均可给开发板供电：
- USB 转 UART 接口供电或 ESP32-S3 USB 接口供电（选择其一或同时供电），默认供电方式（推荐）
- 5V 和 G (GND) 排针供电
- 3V3 和 G (GND) 排针供电
.. _user-guide-s3-DevKitM-1-header-blocks:
排针
@ -231,7 +230,6 @@ J3
管脚布局
^^^^^^^^^^^
.. figure:: ../../../_static/ESP32-S3_DevKitM-1_pinlayout.jpg
:align: center
:scale: 50%

1
docs/zh_CN/hw-reference/index.rst
View File

@ -1,6 +1,7 @@
*******************************
H/W 硬件参考
*******************************
:link_to_translation:`en:[English]`
.. toctree::