diff --git a/docs/_static/esp32-s2-devkitm-1-v1-annotated-photo.png b/docs/_static/esp32-s2-devkitm-1-v1-annotated-photo.png index e2e82962da..7da28ae225 100644 Binary files a/docs/_static/esp32-s2-devkitm-1-v1-annotated-photo.png and b/docs/_static/esp32-s2-devkitm-1-v1-annotated-photo.png differ diff --git a/docs/_static/esp32-s2-devkitm-1-v1-pin-layout.png b/docs/_static/esp32-s2-devkitm-1-v1-pin-layout.png new file mode 100644 index 0000000000..7b24a546d3 Binary files /dev/null and b/docs/_static/esp32-s2-devkitm-1-v1-pin-layout.png differ diff --git a/docs/_static/esp32-s2-devkitm-1u-v1-annotated-photo.png b/docs/_static/esp32-s2-devkitm-1u-v1-annotated-photo.png index db9b4349ac..3cb77d6ae0 100644 Binary files a/docs/_static/esp32-s2-devkitm-1u-v1-annotated-photo.png and b/docs/_static/esp32-s2-devkitm-1u-v1-annotated-photo.png differ diff --git a/docs/_static/esp32-s2-saola-1-v1.2-annotated-photo.png b/docs/_static/esp32-s2-saola-1-v1.2-annotated-photo.png index 10fd2b1a78..0178b16129 100644 Binary files a/docs/_static/esp32-s2-saola-1-v1.2-annotated-photo.png and b/docs/_static/esp32-s2-saola-1-v1.2-annotated-photo.png differ diff --git a/docs/en/hw-reference/esp32s2/user-guide-devkitm-1-v1.rst b/docs/en/hw-reference/esp32s2/user-guide-devkitm-1-v1.rst index 1c6c536221..ef10353df1 100644 --- a/docs/en/hw-reference/esp32s2/user-guide-devkitm-1-v1.rst +++ b/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 `__ 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 `__ 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 `__ module (on-board PCB antenna), while ESP32-S2-DevKitM-1U with `ESP32-S2-MINI-1U `__ module (U.FL connector to support external IPEX antenna). +ESP32-S2-DevKitM-1 is embedded with `ESP32-S2-MINI-1 `__ module (on-board PCB antenna), while ESP32-S2-DevKitM-1U with `ESP32-S2-MINI-1U `__ 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 `_. 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 `_ (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 `_ (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 `_ (PDF) * `ESP32-S2-DevKitM-1(U) PCB Layout `_ (PDF) * `ESP32-S2-DevKitM-1(U) Dimensions `_ (PDF) -* `ESP32-S2 Family Datasheet `_ (PDF) +* `ESP32-S2 Series Datasheet `_ (PDF) * `ESP32-S2-MINI-1 & ESP32-S2-MINI-1U 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 `_. diff --git a/docs/en/hw-reference/esp32s2/user-guide-saola-1-v1.2.rst b/docs/en/hw-reference/esp32s2/user-guide-saola-1-v1.2.rst index 21ce8a9885..acb98224b1 100644 --- a/docs/en/hw-reference/esp32s2/user-guide-saola-1-v1.2.rst +++ b/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 - - 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. + * - USB-to-UART Bridge + - Single USB-UART bridge chip provides transfer rates up to 3 Mbps. + * - Reset Button + - Reset button. * - 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 `_. .. _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 diff --git a/docs/zh_CN/hw-reference/esp32s2/user-guide-devkitm-1-v1.rst b/docs/zh_CN/hw-reference/esp32s2/user-guide-devkitm-1-v1.rst index b7e1ea5739..f4e1670afb 100644 --- a/docs/zh_CN/hw-reference/esp32s2/user-guide-devkitm-1-v1.rst +++ b/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 `__ 芯片（ESP32-S2 系列）的通用型开发板。该款开发板具有丰富的外设和优化的引脚布局，令产品开发更快捷。 -ESP32-S2-DevKitM-1 搭载的是 `ESP32-S2-MINI-1 `__ 模组 （PCB 板载天线），ESP32-S2-DevKitM-1U 搭载的是 `ESP32-S2-MINI-1U `__ 模组 （U.FL 座子连接外部 IPEX 天线）。 +ESP32-S2-DevKitM-1 搭载的是 `ESP32-S2-MINI-1 `__ 模组 （PCB 板载天线），ESP32-S2-DevKitM-1U 搭载的是 `ESP32-S2-MINI-1U `__ 模组 （外部天线连接器）。 +----------------------+-----------------------+ | |ESP32-S2-DevKitM-1| | |ESP32-S2-DevKitM-1U| | @@ -24,6 +24,7 @@ ESP32-S2-DevKitM-1 搭载的是 `ESP32-S2-MINI-1 `_ 的外部天线连接器尺寸章节。 开始开发应用 ------------ @@ -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) 原理图 `_ (PDF)一致。 +下表列出了开发板两侧排针（J1 和 J3）的 **名称** 和 **功能**，排针的名称如图 :ref:`user-guide-devkitm-1-v1-board-front` 所示，排针的序号与 `ESP32-S2-DevKitM-1(U) 原理图 `_ (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) 原理图 `_ (PDF) @@ -223,4 +247,4 @@ J3 * `ESP32-S2-MINI-1 & ESP32-S2-MINI-1U 技术规格书 `_ (PDF) * `乐鑫产品选型工具 `__ -有关本开发板的更多设计文档，请联系我们的商务部门 sales@espressif.com。 +有关本开发板的更多设计文档，请联系我们的商务部门 `sales@espressif.com `_。 diff --git a/docs/zh_CN/hw-reference/esp32s2/user-guide-saola-1-v1.2.rst b/docs/zh_CN/hw-reference/esp32s2/user-guide-saola-1-v1.2.rst index bf69d1e2b6..2964cbadd7 100644 --- a/docs/zh_CN/hw-reference/esp32s2/user-guide-saola-1-v1.2.rst +++ b/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 桥接器 - - 单芯片 USB 至 UART 桥接器，可提供高达 3 Mbps 的传输速率。 - * - Boot 键。 - - 下载按键。按住 **Boot** 键的同时按一下 **Reset** 键进入“固件下载”模式，通过串口下载固件。 - * - Reset 键。 - - 复位按键。 - * - 3.3 V 电源指示灯 + * - 3.3 V Power On LED（3.3 V 电源指示灯） - 开发板连接 USB 电源后，该指示灯亮起。 - * - Micro-USB 接口 + * - USB-to-UART Bridge（USB 转 UART 桥接器） + - 单芯片 USB 至 UART 桥接器，可提供高达 3 Mbps 的传输速率。 + * - Reset Button（Reset 键） + - 复位按键。 + * - 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 端口供电。 +建议选择第一种供电方式：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 + + ESP32-S2-Saola-1 管脚布局（点击放大） + +硬件版本 +========== + +无历史版本。 相关文档 ======== -* `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。 +* `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 `_。 + +.. _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=