docs/update_esp32-s2_devkit_user_guides

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

@@ -6,9 +6,9 @@ ESP32-S2-DevKitM-1(U)
 
 This user guide provides information on Espressif's small-sized development board ESP32-S2-DevKitM-1(U).
 
-ESP32-S2-DevKitM-1(U) is a general-purpose development board based on `ESP32-S2FH4 <https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf>`__ chip, which falls into ESP32-S2 chip family. With a rich peripheral set and optimized pinout, this board allows rapid prototyping.
+ESP32-S2-DevKitM-1(U) is a general-purpose development board based on `ESP32-S2FH4 <https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf>`__ chip, which falls into ESP32-S2 chip series. With a rich peripheral set and optimized pinout, this board allows rapid prototyping.
 
-ESP32-S2-DevKitM-1 is embedded with `ESP32-S2-MINI-1 <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_en.pdf>`__ module (on-board PCB antenna), while ESP32-S2-DevKitM-1U with `ESP32-S2-MINI-1U <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_en.pdf>`__ module (U.FL connector to support external IPEX antenna).
+ESP32-S2-DevKitM-1 is embedded with `ESP32-S2-MINI-1 <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_en.pdf>`__ module (on-board PCB antenna), while ESP32-S2-DevKitM-1U with `ESP32-S2-MINI-1U <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_en.pdf>`__ module (external antenna connector).
 
 +----------------------+-----------------------+
 | |ESP32-S2-DevKitM-1| | |ESP32-S2-DevKitM-1U| | 
@@ -24,6 +24,7 @@ The document consists of the following major sections:
 
 - `Getting started`_: Provides an overview of the ESP32-S2-DevKitM-1(U) and hardware/software setup instructions to get started.
 - `Hardware reference`_: Provides more detailed information about the ESP32-S2-DevKitM-1(U)'s hardware.
+- `Hardware Revision Details`_: Revision history, known issues, and links to user guides for previous versions (if any) of ESP32-S2-DevKitM-1(U).
 - `Related Documents`_: Gives links to related documentation.
 
 Getting Started
@@ -73,6 +74,8 @@ Description of Components
 
     ESP32-S2-DevKitM-1U - front
 
+The key components of the board are described in a clockwise direction. 
+
 .. list-table::
    :widths: 30 70
    :header-rows: 1
@@ -80,13 +83,13 @@ Description of Components
    * - Key Component
      - Description
    * - ESP32-S2-MINI-1 or ESP32-S2-MINI-1U
-     - ESP32-S2-MINI-1 and ESP32-S2-MINI-1U are two powerful, generic Wi-Fi MCU modules that integrate ESP32-S2FH4 chip. ESP32-S2-MINI-1 comes with a PCB antenna, and ESP32-S2-MINI-1U with a U.FL connector for external IPEX antenna. They both feature a 4 MB external SPI flash.
+     - ESP32-S2-MINI-1 and ESP32-S2-MINI-1U are two powerful, generic Wi-Fi MCU modules that integrate ESP32-S2FH4 chip. ESP32-S2-MINI-1 comes with a PCB antenna, and ESP32-S2-MINI-1U with an external antenna connector. They both feature a 4 MB external SPI flash.
+   * - Pin Headers
+     - 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-S2FH4 chip to enable multiple functions such as SPI, I2S, UART, I2C, touch sensors, PWM etc. For details, please see :ref:`user-guide-devkitm-1-v1-header-blocks`.
    * - 3.3 V Power On LED
      - Turns on when the USB power is connected to the board.
    * - USB to UART Bridge
      - Single USB-UART bridge chip provides transfer rates up to 3 Mbps.
-   * - I/O Connector
-     - 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-S2FH4 chip to enable multiple functions such as SPI, I2S, UART, I2C, touch sensors, PWM etc. For details, please see :ref:`user-guide-devkitm-1-v1-header-blocks`.
    * - Reset Button
      - Reset button.
    * - Micro-USB Port
@@ -94,12 +97,11 @@ Description of Components
    * - Boot Button
      - Download button. Holding down **Boot** and then pressing **Reset** initiates Firmware Download mode for downloading firmware through the serial port.
    * - RGB LED
-     - Addressable RGB LED (WS2812), driven by GPIO18.
+     - Addressable RGB LED, driven by GPIO18.
    * - 5 V to 3.3 V LDO
      - Power regulator that converts a 5 V supply into a 3.3 V output.
-   * - U.FL Connector
-     - On **ESP32-S2-MINI-1U** module only. Connects to an external IPEX antenna.
-
+   * - External Antenna Connector
+     - On **ESP32-S2-MINI-1U** module only. For connector dimensions, please refer to Section External Antenna Connector Dimensions in `ESP32-S2-MINI-1 & ESP32-S2-MINI-1U Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_en.pdf>`_. 
 
 Start Application Development
 -----------------------------
@@ -111,11 +113,15 @@ Required Hardware
 
 - ESP32-S2-DevKitM-1(U)
 
-  + For ESP32-S2-DevKitM-1U, an IPEX antenna is also required.
+  + For ESP32-S2-DevKitM-1U, an antenna is also required.
   
 - USB 2.0 cable (Standard-A to Micro-B)
 - Computer running Windows, Linux, or macOS
 
+.. note::
+
+  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
 ^^^^^^^^^^^^^^
 
@@ -123,7 +129,7 @@ Please proceed to :doc:`../../get-started/index`, where Section :ref:`get-starte
 
 .. note::
     
-    ESP32-S2 family chip only is only supported in ESP-IDF master or version v4.2 and higher.
+    ESP32-S2 series of chips only is only supported in ESP-IDF master or version v4.2 and higher.
 
 Hardware Reference
 ==================
@@ -146,46 +152,46 @@ Power Supply Options
 
 There are three mutually exclusive ways to provide power to the board:
 
-- Micro USB port, default power supply
-- 5V and GND header pins
-- 3V3 and GND header pins
+- Micro-USB Port, default power supply
+- 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:
 
 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:`user-guide-devkitm-1-v1-board-front`. The numbering and names are the same as in the `ESP32-S2-DevKitM-1(U) Schematics <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_Schematics.pdf>`_ (PDF).
+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(U) Schematics <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_Schematics.pdf>`_ (PDF).
 
 J1
 ^^^
-===  ====  =====  ========================================================
-No.  Name  Type   Function
-===  ====  =====  ========================================================
-1    3V3   P      3.3 V power supply
-2    0     I/O/T  RTC_GPIO0, GPIO0
-3    1     I/O/T  RTC_GPIO1, GPIO1, TOUCH1, ADC1_CH0
-4    2     I/O/T  RTC_GPIO2, GPIO2, TOUCH2, ADC1_CH1
-5    3     I/O/T  RTC_GPIO3, GPIO3, TOUCH3, ADC1_CH2
-6    4     I/O/T  RTC_GPIO4, GPIO4, TOUCH4, ADC1_CH3
-7    5     I/O/T  RTC_GPIO5, GPIO5, TOUCH5, ADC1_CH4
-8    6     I/O/T  RTC_GPIO6, GPIO6, TOUCH6, ADC1_CH5
-9    7     I/O/T  RTC_GPIO7, GPIO7, TOUCH7, ADC1_CH6
-10   8     I/O/T  RTC_GPIO8, GPIO8, TOUCH8, ADC1_CH7
-11   9     I/O/T  RTC_GPIO9, GPIO9, TOUCH9, ADC1_CH8, FSPIHD
-12   10    I/O/T  RTC_GPIO10, GPIO10, TOUCH10, ADC1_CH9, FSPICS0, FSPIIO4
-13   11    I/O/T  RTC_GPIO11, GPIO11, TOUCH11, ADC2_CH0, FSPID, FSPIIO5
-14   12    I/O/T  RTC_GPIO12, GPIO12, TOUCH12, ADC2_CH1, FSPICLK, FSPIIO6
-15   13    I/O/T  RTC_GPIO13, GPIO13, TOUCH13, ADC2_CH2, FSPIQ, FSPIIO7
-16   14    I/O/T  RTC_GPIO14, GPIO14, TOUCH14, ADC2_CH3, FSPIWP, FSPIDQS
-17   15    I/O/T  RTC_GPIO15, GPIO15, U0RTS, ADC2_CH4, XTAL_32K_P
-18   16    I/O/T  RTC_GPIO16, GPIO16, U0CTS, ADC2_CH5, XTAL_32K_N
-19   17    I/O/T  RTC_GPIO17,  GPIO17, U1TXD, ADC2_CH6, DAC_1
-20   5V    P      5 V power supply
-21   G     G      Ground
-===  ====  =====  ========================================================
+===  ====  ==========  =============================================================
+No.  Name  Type [#]_    Function 
+===  ====  ==========  =============================================================
+1    3V3    P           3.3 V power supply
+2    0      I/O/T       RTC_GPIO0, GPIO0
+3    1      I/O/T       RTC_GPIO1, GPIO1, TOUCH1, ADC1_CH0
+4    2      I/O/T       RTC_GPIO2, GPIO2, TOUCH2, ADC1_CH1
+5    3      I/O/T       RTC_GPIO3, GPIO3, TOUCH3, ADC1_CH2
+6    4      I/O/T       RTC_GPIO4, GPIO4, TOUCH4, ADC1_CH3
+7    5      I/O/T       RTC_GPIO5, GPIO5, TOUCH5, ADC1_CH4
+8    6      I/O/T       RTC_GPIO6, GPIO6, TOUCH6, ADC1_CH5
+9    7      I/O/T       RTC_GPIO7, GPIO7, TOUCH7, ADC1_CH6
+10   8      I/O/T       RTC_GPIO8, GPIO8, TOUCH8, ADC1_CH7
+11   9      I/O/T       RTC_GPIO9, GPIO9, TOUCH9, ADC1_CH8, FSPIHD
+12   10     I/O/T       RTC_GPIO10, GPIO10, TOUCH10, ADC1_CH9, FSPICS0, FSPIIO4
+13   11     I/O/T       RTC_GPIO11, GPIO11, TOUCH11, ADC2_CH0, FSPID, FSPIIO5
+14   12     I/O/T       RTC_GPIO12, GPIO12, TOUCH12, ADC2_CH1, FSPICLK, FSPIIO6
+15   13     I/O/T       RTC_GPIO13, GPIO13, TOUCH13, ADC2_CH2, FSPIQ, FSPIIO7
+16   14     I/O/T       RTC_GPIO14, GPIO14, TOUCH14, ADC2_CH3, FSPIWP, FSPIDQS
+17   15     I/O/T       RTC_GPIO15, GPIO15, U0RTS, ADC2_CH4, XTAL_32K_P
+18   16     I/O/T       RTC_GPIO16, GPIO16, U0CTS, ADC2_CH5, XTAL_32K_N
+19   17     I/O/T       RTC_GPIO17,  GPIO17, U1TXD, ADC2_CH6, DAC_1
+20   5V     P           5 V power supply
+21   G      G           Ground
+===  ====  ==========  =============================================================
 
 J3
 ^^^
@@ -212,16 +218,33 @@ No.  Name  Type   Function
 18   21    I/O/T  RTC_GPIO21, GPIO21
 19   20    I/O/T  RTC_GPIO20, GPIO20, U1CTS, ADC2_CH9, CLK_OUT1, USB_D+
 20   19    I/O/T  RTC_GPIO19, GPIO19, U1RTS, ADC2_CH8, CLK_OUT2, USB_D-
-21   18    I/O/T  RTC_GPIO18, GPIO18, U1RXD, ADC2_CH7, DAC_2, CLK_OUT3
+21   18    I/O/T  RTC_GPIO18, GPIO18, U1RXD, ADC2_CH7, DAC_2, CLK_OUT3, RGB LED
 ===  ====  =====  ========================================================
 
+.. [#] 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%
+    :alt: ESP32-S2-DevKitM-1(U) (click to enlarge)
+    :figclass: align-center
+
+    ESP32-S2-DevKitM-1(U) Pin Layout (click to enlarge)
+    
+Hardware Revision Details
+=========================
+
+This is the first revision of this board released.
+
 Related Documents
 =================
 * `ESP32-S2-DevKitM-1(U) Schematics <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_Schematics.pdf>`_ (PDF)
 * `ESP32-S2-DevKitM-1(U) PCB Layout <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_PCB_Layout.pdf>`_ (PDF)
 * `ESP32-S2-DevKitM-1(U) Dimensions <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_Dimensions.pdf>`_ (PDF)
-* `ESP32-S2 Family Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf>`_ (PDF)
+* `ESP32-S2 Series Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf>`_ (PDF)
 * `ESP32-S2-MINI-1 & ESP32-S2-MINI-1U Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_en.pdf>`_ (PDF)
 * `ESP Product Selector <https://products.espressif.com/#/product-selector?names=>`_ 
 
-For other design documentation for the board, please contact us at sales@espressif.com.
+For other design documentation for the board, please contact us at `sales@espressif.com <sales@espressif.com>`_.

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

@@ -17,6 +17,7 @@ The document consists of the following major sections:
 
 - `Getting started`_: Provides an overview of the ESP32-S2-Saola-1 and hardware/software setup instructions to get started.
 - `Hardware reference`_: Provides more detailed information about the ESP32-S2-Saola-1's hardware.
+- `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
@@ -48,7 +49,6 @@ If you order a few samples, each ESP32-S2-Saola-1 comes in an individual package
 
 For retail orders, please go to https://www.espressif.com/en/company/contact/buy-a-sample.
 
-
 Wholesale Orders
 ^^^^^^^^^^^^^^^^
 
@@ -59,6 +59,8 @@ For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales
 Description of Components
 -------------------------
 
+.. _user-guide-saola-1-v1.2-board-front:
+
 .. figure:: ../../../_static/esp32-s2-saola-1-v1.2-annotated-photo.png
     :align: center
     :alt: ESP32-S2-Saola-1 - front/back
@@ -66,6 +68,8 @@ Description of Components
 
     ESP32-S2-Saola-1 - front
 
+The key components of the board are described in a clockwise direction. 
+
 .. list-table::
    :widths: 30 70
    :header-rows: 1
@@ -74,22 +78,21 @@ Description of Components
      - Description
    * - ESP32-S2-WROVER
      - ESP32-S2-WROVER is a powerful, generic Wi-Fi MCU module that integrates ESP32-S2. It has a PCB antenna, a 4 MB external SPI flash and an additional 2 MB PSRAM.
-   * - I/O Connector
+   * - Pin Headers
      - All available GPIO pins (except for the SPI bus for flash and PSRAM) are broken out to the pin headers on the board. Users can program ESP32-S2 chip to enable multiple functions such as SPI, I2S, UART, I2C, touch sensors, PWM etc.
-   * - USB to UART Bridge
+   * - 3.3 V Power On LED
+     - Turns on when the USB power is connected to the board.
+   * - USB-to-UART Bridge
      - Single USB-UART bridge chip provides transfer rates up to 3 Mbps.
-   * - Boot Button
-     - Download button. Holding down **Boot** and then pressing **Reset** initiates Firmware Download mode for downloading firmware through the serial port.
    * - Reset Button
      - Reset button.
-   * - 3.3 V Power On LED
-     - Turns on when the USB power is connected to the board.
    * - Micro-USB Port
      - USB interface. Power supply for the board as well as the communication interface between a computer and the ESP32-S2 chip.
+   * - Boot Button
+     - Download button. Holding down **Boot** and then pressing **Reset** initiates Firmware Download mode for downloading firmware through the serial port.
    * - RGB LED
      - Addressable RGB LED (WS2812), driven by GPIO18.
 
-
 Start Application Development
 -----------------------------
 
@@ -102,6 +105,10 @@ Required Hardware
 - USB 2.0 cable (Standard-A to Micro-B)
 - Computer running Windows, Linux, or macOS
 
+.. note::
+
+  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
 ^^^^^^^^^^^^^^
 
@@ -109,7 +116,7 @@ Please proceed to :doc:`../../get-started/index`, where Section :ref:`get-starte
 
 .. note::
     
-    ESP32-S2 only supports ESP-IDF master or version v4.2 and higher.
+    ESP32-S2 series of chips only supports ESP-IDF master or version v4.2 and higher.
 
 Hardware Reference
 ==================
@@ -132,42 +139,44 @@ Power Supply Options
 
 There are three mutually exclusive ways to provide power to the board:
 
-- Micro USB port, default power supply
-- 5V and GND header pins
-- 3V3 and GND header pins
+- Micro-USB port, default power supply
+- 5V and GND pin headers
+- 3V3 and GND pin headers
+
+It is recommended to use the first option: Micro-USB Port.
 
 Header Block
 ------------
 
-The two tables below provide the **Name** and **Function** of I/O header pins on both sides of the board. The numbering and names are the same as in the `ESP32-S2-Saola-1 Schematics`_ (PDF).
+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
-===  ====  =====  ===================================
-1    3V3   P      3.3 V power supply
-2    IO0   I/O    GPIO0, Boot
-3    IO1   I/O    GPIO1, ADC1_CH0, TOUCH_CH1
-4    IO2   I/O    GPIO2, ADC1_CH1, TOUCH_CH2
-5    IO3   I/O    GPIO3, ADC1_CH2, TOUCH_CH3
-6    IO4   I/O    GPIO4, ADC1_CH3, TOUCH_CH4
-7    IO5   I/O    GPIO5, ADC1_CH4, TOUCH_CH5
-8    IO6   I/O    GPIO6, ADC1_CH5, TOUCH_CH6
-9    IO7   I/O    GPIO7, ADC1_CH6, TOUCH_CH7
-10   IO8   I/O    GPIO8, ADC1_CH7, TOUCH_CH8
-11   IO9   I/O    GPIO9, ADC1_CH8, TOUCH_CH9
-12   IO10  I/O    GPIO10, ADC1_CH9, TOUCH_CH10
-13   IO11  I/O    GPIO11, ADC2_CH0, TOUCH_CH11
-14   IO12  I/O    GPIO12, ADC2_CH1, TOUCH_CH12
-15   IO13  I/O    GPIO13, ADC2_CH2, TOUCH_CH13
-16   IO14  I/O    GPIO14, ADC2_CH3, TOUCH_CH14
-17   IO15  I/O    GPIO15, ADC2_CH4, XTAL_32K_P
-18   IO16  I/O    GPIO16, ADC2_CH5, XTAL_32K_N
-19   IO17  I/O    GPIO17, ADC2_CH6, DAC_1
-20   5V0   P      5 V power supply
-21   GND   G      Ground
-===  ====  =====  ===================================
+===  ====  ==========  ======================================
+No.  Name  Type [#]_    Function 
+===  ====  ==========  ======================================
+1    3V3    P           3.3 V power supply
+2    IO0    I/O         GPIO0, Boot
+3    IO1    I/O         GPIO1, ADC1_CH0, TOUCH_CH1
+4    IO2    I/O         GPIO2, ADC1_CH1, TOUCH_CH2
+5    IO3    I/O         GPIO3, ADC1_CH2, TOUCH_CH3
+6    IO4    I/O         GPIO4, ADC1_CH3, TOUCH_CH4
+7    IO5    I/O         GPIO5, ADC1_CH4, TOUCH_CH5
+8    IO6    I/O         GPIO6, ADC1_CH5, TOUCH_CH6
+9    IO7    I/O         GPIO7, ADC1_CH6, TOUCH_CH7
+10   IO8    I/O         GPIO8, ADC1_CH7, TOUCH_CH8
+11   IO9    I/O         GPIO9, ADC1_CH8, TOUCH_CH9
+12   IO10   I/O         GPIO10, ADC1_CH9, TOUCH_CH10
+13   IO11   I/O         GPIO11, ADC2_CH0, TOUCH_CH11
+14   IO12   I/O         GPIO12, ADC2_CH1, TOUCH_CH12
+15   IO13   I/O         GPIO13, ADC2_CH2, TOUCH_CH13
+16   IO14   I/O         GPIO14, ADC2_CH3, TOUCH_CH14
+17   IO15   I/O         GPIO15, ADC2_CH4, XTAL_32K_P
+18   IO16   I/O         GPIO16, ADC2_CH5, XTAL_32K_N
+19   IO17   I/O         GPIO17, ADC2_CH6, DAC_1
+20   5V0    P           5 V power supply
+21   GND    G           Ground
+===  ====  ==========  ======================================
 
 J3
 ^^^
@@ -194,24 +203,26 @@ No.  Name  Type   Function
 18   IO21  I/O    GPIO21
 19   IO20  I/O    GPIO20, ADC2_CH3, USB_D+
 20   IO19  I/O    GPIO19, ADC2_CH3, USB_D-
-21   IO18  I/O    GPIO18, ADC2_CH3, DAC_2
+21   IO18  I/O    GPIO18, ADC2_CH3, DAC_2, RGB LED
 ===  ====  =====  ====================================
 
-    P: Power supply;
-    I: Input;
-    O: Output;
-    T: High impedance.
+.. [#] P: Power supply; I: Input; O: Output; T: High impedance. 
 
 Pin Layout
 ^^^^^^^^^^^
 .. figure:: ../../../_static/esp32-s2_saola1-pinout.jpg
     :align: center
     :scale: 45%
-    :alt: ESP32-S2-Saola1 (click to enlarge)
+    :alt: ESP32-S2-Saola-1 (click to enlarge)
     :figclass: align-center
 
     ESP32-S2 Saola-1 Pin Layout (click to enlarge)
 
+Hardware Revision Details
+=========================
+
+This is the first revision of this board released.
+
 Related Documents
 =================
 
@@ -222,7 +233,7 @@ Related Documents
 * `ESP32-S2-WROOM and ESP32-S2-WROOM-I Datasheet`_ (PDF)
 * `ESP Product Selector`_
 
-For other design documentation for the board, please contact us at sales@espressif.com.
+For other design documentation for the board, please contact us at `sales@espressif.com <sales@espressif.com>`_.
 
 .. _ESP32-S2-Saola-1 Schematics: https://dl.espressif.com/dl/schematics/ESP32-S2-SAOLA-1_V1.1_schematics.pdf
 .. _ESP32-S2-Saola-1 Dimensions: https://dl.espressif.com/dl/schematics/ESP32-S2-Saola-1_V1.2_Dimensions.pdf

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

@@ -8,7 +8,7 @@ ESP32-S2-DevKitM-1(U)
 
 ESP32-S2-DevKitM-1(U) 是一款基于 `ESP32-S2FH4 <https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_cn.pdf>`__ 芯片（ESP32-S2 系列）的通用型开发板。该款开发板具有丰富的外设和优化的引脚布局，令产品开发更快捷。
 
-ESP32-S2-DevKitM-1 搭载的是 `ESP32-S2-MINI-1 <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_cn.pdf>`__ 模组 （PCB 板载天线），ESP32-S2-DevKitM-1U 搭载的是 `ESP32-S2-MINI-1U <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_cn.pdf>`__ 模组 （U.FL 座子连接外部 IPEX 天线）。
+ESP32-S2-DevKitM-1 搭载的是 `ESP32-S2-MINI-1 <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_cn.pdf>`__ 模组 （PCB 板载天线），ESP32-S2-DevKitM-1U 搭载的是 `ESP32-S2-MINI-1U <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_cn.pdf>`__ 模组 （外部天线连接器）。
 
 +----------------------+-----------------------+
 | |ESP32-S2-DevKitM-1| | |ESP32-S2-DevKitM-1U| | 
@@ -24,6 +24,7 @@ ESP32-S2-DevKitM-1 搭载的是 `ESP32-S2-MINI-1 <https://www.espressif.com/site
 
 - `入门指南`_: 简要介绍了 ESP32-S2-DevKitM-1(U) 和硬件、软件设置指南。
 - `硬件参考`_: 详细介绍了 ESP32-S2-DevKitM-1(U) 的硬件。
+- `硬件版本`_：介绍硬件历史版本和已知问题，并提供链接至历史版本开发板的入门指南（如有）。
 - `相关文档`_: 列出了相关文档的链接。
 
 入门指南
@@ -73,6 +74,8 @@ ESP32-S2-DevKitM-1(U) 是乐鑫一款搭载 ESP32-S2-MINI-1 或 ESP32-S2-MINI-1U
 
     ESP32-S2-DevKitM-1U - 正面
 
+以下按照顺时针的顺序依次介绍开发板上的主要组件。 
+
 .. list-table::
    :widths: 30 70
    :header-rows: 1
@@ -80,25 +83,25 @@ ESP32-S2-DevKitM-1(U) 是乐鑫一款搭载 ESP32-S2-MINI-1 或 ESP32-S2-MINI-1U
    * - 主要组件
      - 介绍
    * - ESP32-S2-MINI-1 或 ESP32-S2-MINI-1U
-     - ESP32-S2-MINI-1 和 ESP32-S2-MINI-1U 是集成 ESP32-S2FH4 的通用型 Wi-Fi MCU 模组，ESP32-S2-MINI-1 采用 PCB 板载天线，ESP32-S2-MINI-1U 采用 U.FL 座子连接外部 IPEX 天线。两款模组均配置了 4 MB SPI flash。
-   * - 3.3 V 电源指示灯
+     - ESP32-S2-MINI-1 和 ESP32-S2-MINI-1U 是集成 ESP32-S2FH4 的通用型 Wi-Fi MCU 模组，ESP32-S2-MINI-1 采用 PCB 板载天线，ESP32-S2-MINI-1U 采用外部天线连接器。两款模组均配置了 4 MB SPI flash。
+   * - Pin Headers（排针）
+     - 所有可用 GPIO 管脚（除 flash 的 SPI 总线）均已引出至开发板的排针。用户可对 ESP32-S2FH4 芯片编程，使能 SPI、I2S、UART、I2C、触摸传感器、PWM 等多种功能。请查看 :ref:`user-guide-devkitm-1-v1-header-blocks` 获取更多信息。
+   * - 3.3 V Power On LED（3.3 V 电源指示灯）
      - 开发板连接 USB 电源后，该指示灯亮起。
-   * - USB 至 UART 桥接器
+   * - USB-to-UART Bridge（USB 转 UART 桥接器）
      - 单芯片 USB 至 UART 桥接器，可提供高达 3 Mbps 的传输速率。
-   * - I/O 连接器 
-     - 所有可用 GPIO 管脚（除 flash 的 SPI 总线）均已引出至开发板的排针。用户可对 ESP32-S2FH4 芯片编程，使能 SPI、I2S、UART、I2C、触摸传感器、PWM 等多种功能。请查看 :ref:`user-guide-devkitm-1-v1-header-blocks` 获取更多信息。
-   * - Reset 键。
+   * - Reset Button（Reset 键）
      - 复位按键。
-   * - Micro-USB 接口
+   * - Micro-USB（Micro-USB 接口）
      - USB 接口。可用作开发板的供电电源或 PC 和 ESP32-S2FH4 芯片的通信接口。     
-   * - Boot 键。
+   * - Boot Button（Boot 键）
      - 下载按键。按住 **Boot** 键的同时按一下 **Reset** 键进入“固件下载”模式，通过串口下载固件。
    * - RGB LED
-     - 可寻址 RGB 发光二极管 (WS2812)，由 GPIO18 驱动。
-   * - 5 V 转 3.3 V LDO
+     - 可寻址 RGB 发光二极管，由 GPIO18 驱动。
+   * - 5 V to 3.3 V LDO（5 V 转 3.3 V LDO）
      - 电源转换器，输入 5 V，输出 3.3 V。
-   * - U.FL 座子
-     - 仅 **ESP32-S2-MINI-1U** 模组带有 U.FL 座子，用于连接外部 IPEX 天线。
+   * - External Antenna Connector（外部天线连接器）
+     - 仅 **ESP32-S2-MINI-1U** 模组带有外部天线连接器。连接器尺寸，请参考 `《ESP32-S2-MINI-1 & ESP32-S2-MINI-1U 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_cn.pdf>`_ 的外部天线连接器尺寸章节。
 
 开始开发应用
 ------------
@@ -110,11 +113,15 @@ ESP32-S2-DevKitM-1(U) 是乐鑫一款搭载 ESP32-S2-MINI-1 或 ESP32-S2-MINI-1U
 
 - ESP32-S2-DevKitM-1(U)
 
-  + 如使用 ESP32-S2-DevKitM-1U，还需准备 IPEX 天线
+  + 如使用 ESP32-S2-DevKitM-1U，还需准备天线
 
-- USB 2.0 数据线（标准 A 型转 Micro-B型）
+- USB 2.0 数据线（标准 A 型转 Micro-B 型）
 - 电脑 （Windows、Linux 或 macOS）
 
+.. 注解::
+
+  请确保使用适当的 USB 数据线。部分数据线仅可用于充电，无法用于数据传输和编程。
+
 软件设置
 ^^^^^^^^
 
@@ -145,46 +152,46 @@ ESP32-S2-DevKitM-1(U) 的主要组件和连接方式如下图所示。
 
 您可从以下三种供电方式中任选其一给 ESP32-S2-DevKitM-1(U) 供电：
 
-- Micro USB 端口供电（默认）
-- 5V 和 GND 管脚供电
-- 3V3 和 GND 管脚供电
+- Micro-USB 接口供电（默认）
+- 5V 和 GND 排针供电
+- 3V3 和 GND 排针供电
 
-建议选择第一种供电方式：Micro USB 端口供电。
+建议选择第一种供电方式：Micro-USB 接口供电。
 
 .. _user-guide-devkitm-1-v1-header-blocks:
 
 排针
 ----
 
-下表列出了开发板两侧排针的 **名称** 和 **功能**，开发板排针图可前往 :ref:`user-guide-devkitm-1-v1-board-front` 查看。表格中的序号和名称与 `ESP32-S2-DevKitM-1(U) 原理图 <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_Schematics.pdf>`_ (PDF)一致。
+下表列出了开发板两侧排针（J1 和 J3）的 **名称** 和 **功能**，排针的名称如图 :ref:`user-guide-devkitm-1-v1-board-front` 所示，排针的序号与 `ESP32-S2-DevKitM-1(U) 原理图 <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_Schematics.pdf>`_ (PDF)一致。
 
 J1
 ^^^
-====  ====  =====  ============================================================
-序号  名称   类型    功能
-====  ====  =====  ============================================================
-1     3V3   P      3.3 V 电源
-2     0     I/O/T  RTC_GPIO0, GPIO0
-3     1     I/O/T  RTC_GPIO1, GPIO1, TOUCH1, ADC1_CH0
-4     2     I/O/T  RTC_GPIO2, GPIO2, TOUCH2, ADC1_CH1
-5     3     I/O/T  RTC_GPIO3, GPIO3, TOUCH3, ADC1_CH2
-6     4     I/O/T  RTC_GPIO4, GPIO4, TOUCH4, ADC1_CH3
-7     5     I/O/T  RTC_GPIO5, GPIO5, TOUCH5, ADC1_CH4
-8     6     I/O/T  RTC_GPIO6, GPIO6, TOUCH6, ADC1_CH5
-9     7     I/O/T  RTC_GPIO7, GPIO7, TOUCH7, ADC1_CH6
-10    8     I/O/T  RTC_GPIO8, GPIO8, TOUCH8, ADC1_CH7
-11    9     I/O/T  RTC_GPIO9, GPIO9, TOUCH9, ADC1_CH8, FSPIHD
-12    10    I/O/T  RTC_GPIO10, GPIO10, TOUCH10, ADC1_CH9, FSPICS0, FSPIIO4
-13    11    I/O/T  RTC_GPIO11, GPIO11, TOUCH11, ADC2_CH0, FSPID, FSPIIO5
-14    12    I/O/T  RTC_GPIO12, GPIO12, TOUCH12, ADC2_CH1, FSPICLK, FSPIIO6
-15    13    I/O/T  RTC_GPIO13, GPIO13, TOUCH13, ADC2_CH2, FSPIQ, FSPIIO7
-16    14    I/O/T  RTC_GPIO14, GPIO14, TOUCH14, ADC2_CH3, FSPIWP, FSPIDQS
-17    15    I/O/T  RTC_GPIO15, GPIO15, U0RTS, ADC2_CH4, XTAL_32K_P
-18    16    I/O/T  RTC_GPIO16, GPIO16, U0CTS, ADC2_CH5, XTAL_32K_N
-19    17    I/O/T  RTC_GPIO17, GPIO17, U1TXD, ADC2_CH6, DAC_1
-20    5V    P      5 V 电源
-21    G     G      接地
-====  ====  =====  ============================================================
+==== ====  =========   =========================================================================
+序号 名称  类型 [#]_    功能
+==== ====  =========   =========================================================================
+1    3V3    P          3.3 V 电源
+2    0      I/O/T      RTC_GPIO0, GPIO0
+3    1      I/O/T      RTC_GPIO1, GPIO1, TOUCH1, ADC1_CH0
+4    2      I/O/T      RTC_GPIO2, GPIO2, TOUCH2, ADC1_CH1
+5    3      I/O/T      RTC_GPIO3, GPIO3, TOUCH3, ADC1_CH2
+6    4      I/O/T      RTC_GPIO4, GPIO4, TOUCH4, ADC1_CH3
+7    5      I/O/T      RTC_GPIO5, GPIO5, TOUCH5, ADC1_CH4
+8    6      I/O/T      RTC_GPIO6, GPIO6, TOUCH6, ADC1_CH5
+9    7      I/O/T      RTC_GPIO7, GPIO7, TOUCH7, ADC1_CH6
+10   8      I/O/T      RTC_GPIO8, GPIO8, TOUCH8, ADC1_CH7
+11   9      I/O/T      RTC_GPIO9, GPIO9, TOUCH9, ADC1_CH8, FSPIHD
+12   10     I/O/T      RTC_GPIO10, GPIO10, TOUCH10, ADC1_CH9, FSPICS0, FSPIIO4
+13   11     I/O/T      RTC_GPIO11, GPIO11, TOUCH11, ADC2_CH0, FSPID, FSPIIO5
+14   12     I/O/T      RTC_GPIO12, GPIO12, TOUCH12, ADC2_CH1, FSPICLK, FSPIIO6
+15   13     I/O/T      RTC_GPIO13, GPIO13, TOUCH13, ADC2_CH2, FSPIQ, FSPIIO7
+16   14     I/O/T      RTC_GPIO14, GPIO14, TOUCH14, ADC2_CH3, FSPIWP, FSPIDQS
+17   15     I/O/T      RTC_GPIO15, GPIO15, U0RTS, ADC2_CH4, XTAL_32K_P
+18   16     I/O/T      RTC_GPIO16, GPIO16, U0CTS, ADC2_CH5, XTAL_32K_N
+19   17     I/O/T      RTC_GPIO17, GPIO17, U1TXD, ADC2_CH6, DAC_1
+20   5V     P          5 V 电源
+21   G      G          接地
+==== ====  =========   =========================================================================
 
 J3
 ^^^
@@ -211,9 +218,26 @@ J3
 18    21    I/O/T  RTC_GPIO21, GPIO21
 19    20    I/O/T  RTC_GPIO20, GPIO20, U1CTS, ADC2_CH9, CLK_OUT1, USB_D+
 20    19    I/O/T  RTC_GPIO19, GPIO19, U1RTS, ADC2_CH8, CLK_OUT2, USB_D-
-21    18    I/O/T  RTC_GPIO18, GPIO18, U1RXD, ADC2_CH7, DAC_2, CLK_OUT3
+21    18    I/O/T  RTC_GPIO18, GPIO18, U1RXD, ADC2_CH7, DAC_2, CLK_OUT3, RGB LED
 ====  ====  =====  ========================================================
 
+.. [#] P：电源；I：输入；O：输出；T：可设置为高阻。 
+
+管脚布局
+^^^^^^^^
+.. figure:: ../../../_static/esp32-s2-devkitm-1-v1-pin-layout.png
+    :align: center
+    :scale: 15%
+    :alt: ESP32-S2-DevKitM-1(U) 管脚布局（点击放大）
+    :figclass: align-center
+
+    ESP32-S2-DevKitM-1(U) 管脚布局（点击放大）
+
+硬件版本
+==========
+
+无历史版本。
+
 相关文档
 ========
 * `ESP32-S2-DevKitM-1(U) 原理图 <https://dl.espressif.com/dl/schematics/ESP32-S2-DevKitM-1_V1_Schematics.pdf>`_ (PDF)
@@ -223,4 +247,4 @@ J3
 * `ESP32-S2-MINI-1 & ESP32-S2-MINI-1U 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-s2-mini-1_esp32-s2-mini-1u_datasheet_cn.pdf>`_ (PDF)
 * `乐鑫产品选型工具 <https://products.espressif.com/#/product-selector?names=>`__ 
 
-有关本开发板的更多设计文档，请联系我们的商务部门 sales@espressif.com。
+有关本开发板的更多设计文档，请联系我们的商务部门 `sales@espressif.com <sales@espressif.com>`_。

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

@@ -15,9 +15,10 @@ ESP32-S2-Saola-1
 
 本指南包括如下内容：
 
-- `入门指南`_: 简要介绍了 ESP32-S2-Saola-1 和硬件、软件设置指南。
-- `硬件参考`_: 详细介绍了 ESP32-S2-Saola-1 的硬件。
-- `相关文档`_: 列出了相关文档的链接。
+- `入门指南`_：简要介绍了 ESP32-S2-Saola-1 和硬件、软件设置指南。
+- `硬件参考`_：详细介绍了 ESP32-S2-Saola-1 的硬件。
+- `硬件版本`_：介绍硬件历史版本和已知问题，并提供链接至历史版本开发板的入门指南（如有）。
+- `相关文档`_：列出了相关文档的链接。
 
 入门指南
 ========
@@ -58,6 +59,8 @@ ESP32-S2-Saola-1 是乐鑫一款基于 ESP32-S2 的小型开发板。板上的
 组件介绍
 --------
 
+.. _user-guide-saola-1-v1.2-board-front:
+
 .. figure:: ../../../_static/esp32-s2-saola-1-v1.2-annotated-photo.png
     :align: center
     :alt: ESP32-S2-Saola-1 - 正面
@@ -65,6 +68,8 @@ ESP32-S2-Saola-1 是乐鑫一款基于 ESP32-S2 的小型开发板。板上的
 
     ESP32-S2-Saola-1 - 正面
 
+以下按照顺时针的顺序依次介绍开发板上的主要组件。 
+
 .. list-table::
    :widths: 30 70
    :header-rows: 1
@@ -73,18 +78,18 @@ ESP32-S2-Saola-1 是乐鑫一款基于 ESP32-S2 的小型开发板。板上的
      - 介绍
    * - ESP32-S2-WROVER
      - ESP32-S2-WROVER 集成 ESP32-S2，是通用型 Wi-Fi MCU 模组，功能强大。该模组采用 PCB 板载天线，配置了 4 MB SPI flash 和 2 MB SPI PSRAM。
-   * - I/O 连接器
+   * - Pin Headers（排针）
      - 所有可用 GPIO 管脚（除 Flash 和 PSRAM 的 SPI 总线）均已引出至开发板的排针。用户可对 ESP32-S2 芯片编程，使能 SPI、I2S、UART、I2C、触摸传感器、PWM 等多种功能。
-   * - USB 至 UART 桥接器
+   * - 3.3 V Power On LED（3.3 V 电源指示灯）
+     - 开发板连接 USB 电源后，该指示灯亮起。
+   * - USB-to-UART Bridge（USB 转 UART 桥接器）
      - 单芯片 USB 至 UART 桥接器，可提供高达 3 Mbps 的传输速率。
-   * - Boot 键。
-     - 下载按键。按住 **Boot** 键的同时按一下 **Reset** 键进入“固件下载”模式，通过串口下载固件。
-   * - Reset 键。
+   * - Reset Button（Reset 键）
      - 复位按键。
-   * - 3.3 V 电源指示灯
-     - 开发板连接 USB 电源后，该指示灯亮起。
-   * - Micro-USB 接口
+   * - Micro-USB Port（Micro-USB 接口）
      - USB 接口。可用作开发板的供电电源或 PC 和 ESP32-S2 芯片的通信接口。
+   * - Boot Button（Boot 键）
+     - 下载按键。按住 **Boot** 键的同时按一下 **Reset** 键进入“固件下载”模式，通过串口下载固件。
    * - RGB LED
      - 可寻址 RGB 发光二极管 (WS2812)，由 GPIO18 驱动。
 
@@ -100,6 +105,10 @@ ESP32-S2-Saola-1 是乐鑫一款基于 ESP32-S2 的小型开发板。板上的
 - USB 2.0 数据线（标准 A 型转 Micro-B型）
 - 电脑 （Windows、Linux 或 macOS）
 
+.. 注解::
+
+  请确保使用适当的 USB 数据线。部分数据线仅可用于充电，无法用于数据传输和编程。
+
 软件设置
 ^^^^^^^^
 
@@ -107,7 +116,7 @@ ESP32-S2-Saola-1 是乐鑫一款基于 ESP32-S2 的小型开发板。板上的
 
 .. 注解::
     
-    ESP32-S2 仅支持 ESP-IDF master 分支或 v4.2 以上版本。
+    ESP32-S2 系列芯片仅支持 ESP-IDF master 分支或 v4.2 以上版本。
 
 硬件参考
 ========
@@ -130,19 +139,105 @@ ESP32-S2-Saola-1 的主要组件和连接方式如下图所示。
 
 您可从以下三种供电方式中任选其一给 ESP32-S2-Saola-1 供电：
 
-- Micro USB 端口供电（默认）
-- 5V 和 GND 管脚供电
-- 3V3 和 GND 管脚供电
+- Micro-USB 接口供电（默认）
+- 5V 和 GND 排针供电
+- 3V3 和 GND 排针供电
+
+建议选择第一种供电方式：Micro-USB 接口供电。
+
+排针 
+---- 
+ 
+下表列出了开发板两侧排针（J2 和 J3）的 **名称** 和 **功能**，排针的名称如图 :ref:`user-guide-saola-1-v1.2-board-front` 所示，排针的序号与 `ESP32-S2-Saola-1 原理图`_ (PDF) 一致。 
+
+J2
+^^^
+==== ====  =========   ======================================
+序号 名称  类型 [#]_    功能
+==== ====  =========   ======================================
+1    3V3    P          3.3 V 电源
+2    IO0    I/O        GPIO0, 启动
+3    IO1    I/O        GPIO1, ADC1_CH0, TOUCH_CH1
+4    IO2    I/O        GPIO2, ADC1_CH1, TOUCH_CH2
+5    IO3    I/O        GPIO3, ADC1_CH2, TOUCH_CH3
+6    IO4    I/O        GPIO4, ADC1_CH3, TOUCH_CH4
+7    IO5    I/O        GPIO5, ADC1_CH4, TOUCH_CH5
+8    IO6    I/O        GPIO6, ADC1_CH5, TOUCH_CH6
+9    IO7    I/O        GPIO7, ADC1_CH6, TOUCH_CH7
+10   IO8    I/O        GPIO8, ADC1_CH7, TOUCH_CH8
+11   IO9    I/O        GPIO9, ADC1_CH8, TOUCH_CH9
+12   IO10   I/O        GPIO10, ADC1_CH9, TOUCH_CH10
+13   IO11   I/O        GPIO11, ADC2_CH0, TOUCH_CH11
+14   IO12   I/O        GPIO12, ADC2_CH1, TOUCH_CH12
+15   IO13   I/O        GPIO13, ADC2_CH2, TOUCH_CH13
+16   IO14   I/O        GPIO14, ADC2_CH3, TOUCH_CH14
+17   IO15   I/O        GPIO15, ADC2_CH4, XTAL_32K_P
+18   IO16   I/O        GPIO16, ADC2_CH5, XTAL_32K_N
+19   IO17   I/O        GPIO17, ADC2_CH6, DAC_1
+20   5V0    P          5 V 电源
+21   GND    G          接地
+==== ====  =========   ======================================
+
+J3
+^^^
+====  ====  =====  ====================================
+序号  名称   类型    功能
+====  ====  =====  ====================================
+1     GND   G      接地
+2     RST   I      CHIP_PU, 复位
+3     IO46  I      GPIO46
+4     IO45  I/O    GPIO45
+5     IO44  I/O    GPIO44, U0RXD
+6     IO43  I/O    GPIO43, U0TXD
+7     IO42  I/O    GPIO42, MTMS
+8     IO41  I/O    GPIO41, MTDI
+9     IO40  I/O    GPIO40, MTDO
+10    IO39  I/O    GPIO39, MTCK
+11    IO38  I/O    GPIO38
+12    IO37  I/O    GPIO37
+13    IO36  I/O    GPIO36
+14    IO35  I/O    GPIO35
+16    IO34  I/O    GPIO34
+17    IO33  I/O    GPIO33
+17    IO26  I/O    GPIO26
+18    IO21  I/O    GPIO21
+19    IO20  I/O    GPIO20, ADC2_CH3, USB_D+
+20    IO19  I/O    GPIO19, ADC2_CH3, USB_D-
+21    IO18  I/O    GPIO18, ADC2_CH3, DAC_2, RGB LED
+====  ====  =====  ====================================
+
+.. [#] P：电源；I：输入；O：输出；T：可设置为高阻。 
+
+管脚布局
+^^^^^^^^
+.. figure:: ../../../_static/esp32-s2_saola1-pinout.jpg
+    :align: center
+    :scale: 45%
+    :alt: ESP32-S2-Saola-1 管脚布局（点击放大）
+    :figclass: align-center
 
-建议选择第一种供电方式：Micro USB 端口供电。
+    ESP32-S2-Saola-1 管脚布局（点击放大）
+
+硬件版本
+==========
+
+无历史版本。
 
 相关文档
 ========
-* `ESP32-S2-Saola-1 原理图 <https://dl.espressif.com/dl/schematics/ESP32-S2-SAOLA-1_V1.1_schematics.pdf>`_ (PDF)
-* `ESP32-S2-Saola-1 尺寸图 <https://dl.espressif.com/dl/schematics/ESP32-S2-Saola-1_V1.2_Dimensions.pdf>`_ (PDF)
-* `ESP32-S2 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_cn.pdf>`_ (PDF)
-* `ESP32-S2-WROVER & ESP32-S2-WROVER-I 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-s2-wrover_esp32-s2-wrover-i_datasheet_cn.pdf>`_ (PDF)
-* `ESP32-S2-WROOM & ESP32-S2-WROOM-I 技术规格书 <https://www.espressif.com/sites/default/files/documentation/esp32-s2-wroom_esp32-s2-wroom-i_datasheet_cn.pdf>`_ (PDF)
-* `乐鑫产品选型工具 <https://products.espressif.com/#/product-selector?names=>`__
-
-有关本开发板的更多设计文档，请联系我们的商务部门 sales@espressif.com。
+
+* `ESP32-S2-Saola-1 原理图`_ (PDF)
+* `ESP32-S2-Saola-1 尺寸图`_ (PDF)
+* `ESP32-S2 技术规格书`_ (PDF)
+* `ESP32-S2-WROVER & ESP32-S2-WROVER-I 技术规格书`_ (PDF)
+* `ESP32-S2-WROOM & ESP32-S2-WROOM-I 技术规格书`_ (PDF)
+* `乐鑫产品选型工具`_
+
+有关本开发板的更多设计文档，请联系我们的商务部门 `sales@espressif.com <sales@espressif.com>`_。
+
+.. _ESP32-S2-Saola-1 原理图: https://dl.espressif.com/dl/schematics/ESP32-S2-SAOLA-1_V1.1_schematics.pdf
+.. _ESP32-S2-Saola-1 尺寸图: https://dl.espressif.com/dl/schematics/ESP32-S2-Saola-1_V1.2_Dimensions.pdf
+.. _ESP32-S2 技术规格书: https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_cn.pdf
+.. _ESP32-S2-WROVER & ESP32-S2-WROVER-I 技术规格书: https://www.espressif.com/sites/default/files/documentation/esp32-s2-wrover_esp32-s2-wrover-i_datasheet_cn.pdf
+.. _ESP32-S2-WROOM & ESP32-S2-WROOM-I 技术规格书: https://www.espressif.com/sites/default/files/documentation/esp32-s2-wroom_esp32-s2-wroom-i_datasheet_cn.pdf
+.. _乐鑫产品选型工具: https://products.espressif.com/#/product-selector?names=