Skip to content

Commit

Permalink
Merge branch 'docs/upgrade_s2-devkit-c-1_user_guide_for_eco1' into 'm…
Browse files Browse the repository at this point in the history 
…aster'

Docs: Updated ESP32-S2-DevKitC-1 User Guide for ECO1

See merge request espressif/esp-idf!19444
  • Loading branch information
@espwangning
espwangning committed Sep 21, 2022
2 parents 4a69a3f + 63f7bf2 commit 1f9626f
Show file tree
Hide file tree
Showing 4 changed files with 196 additions and 74 deletions.
Binary file modified docs/_static/esp32-s2-devkitc-1-v1-block-diags.png
View file
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/_static/esp32-s2-devkitc-1-v1-pinout.png
View file
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
131 changes: 96 additions & 35 deletions docs/en/hw-reference/esp32s2/user-guide-s2-devkitc-1.rst
View file
Expand Up @@ -6,9 +6,7 @@ ESP32-S2-DevKitC-1

This user guide will help you get started with ESP32-S2-DevKitC-1 and will also provide more in-depth information.

ESP32-S2-DevKitC-1 is an entry-level development board based on ESP32-S2-SOLO (on-board PCB antenna) or ESP32-S2-SOLO-U (external antenna connector), which are two general-purpose modules with a 4 MB SPI flash. This board integrates complete Wi-Fi 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-S2-DevKitC-1 on a breadboard.
ESP32-S2-DevKitC-1 is an entry-level development board. This board integrates complete Wi-Fi 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-S2-DevKitC-1 on a breadboard.

.. figure:: ../../../_static/esp32-s2-devkitc-1-v1-isometric.png
:align: center
Expand Down Expand Up @@ -49,8 +47,8 @@ The key components of the board are described in a clockwise direction.

* - Key Component
- Description
* - ESP32-S2-SOLO or ESP32-S2-SOLO-U
- ESP32-S2-SOLO and ESP32-S2-SOLO-U are two general-purpose Wi-Fi modules. ESP32-S2-SOLO comes with an on-board PCB antenna and ESP32-S2-SOLO-U comes with a connector for an external antenna. ESP32-S2-SOLO or ESP32-S2-SOLO-U on the board may come either with a 4 MB flash, or a 4 MB flash plus a 2 MB PSRAM embedded in the chip.
* - On-board module (ESP32-S2-SOLO or ESP32-S2-SOLO-U in the above figure)
- ESP32-S2-SOLO series modules with an on-board PCB antenna or a connector for an external antenna. This series of modules have multiple options for flash and PSRAM size. For more information, please refer to :ref:`user-guide-s2-devkitc-1-v1-ordering-info`.
* - 3.3 V Power On LED
- Turns on when the USB power is connected to the board.
* - USB-to-UART Bridge
Expand Down Expand Up @@ -100,6 +98,59 @@ Please proceed to `ESP-IDF Get Started <https://docs.espressif.com/projects/esp-
Contents and Packaging
----------------------

.. _user-guide-s2-devkitc-1-v1-ordering-info:

Ordering Information
^^^^^^^^^^^^^^^^^^^^

The development board has a variety of variants to choose from, as shown in the table below.

.. list-table::
:header-rows: 1
:widths: 41 24 9 8 18

* - Ordering Code
- On-board Module [#]_
- Flash
- PSRAM
- Antenna
* - ESP32-S2-DevKitC-1-N8R2
- ESP32-S2-SOLO-2

(Recommended)
- 8 MB
- 2 MB
- PCB on-board antenna
* - ESP32-S2-DevKitC-1U-N8R2
- ESP32-S2-SOLO-2U

(Recommended)
- 8 MB
- 2 MB
- External antenna connector
* - ESP32-S2-DevKitC-1
- ESP32-S2-SOLO
- 4 MB
- ---
- PCB on-board antenna
* - ESP32-S2-DevKitC-1U
- ESP32-S2-SOLO-U
- 4 MB
- ---
- External antenna connector
* - ESP32-S2-DevKitC-1R
- ESP32-S2-SOLO
- 4 MB
- 2 MB
- PCB on-board antenna
* - ESP32-S2-DevKitC-1RU
- ESP32-S2-SOLO-U
- 4 MB
- 2 MB
- External antenna connector

.. [#] 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
^^^^^^^^^^^^^

Expand Down Expand Up @@ -144,36 +195,36 @@ There are three mutually exclusive ways to provide power to the board:
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 <https://dl.espressif.com/dl/schematics/SCH_ESP32-S2-DEVKITC-1_V1_20210508.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-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
=== ==== ========== ==========================================================================
1 3V3 P 3.3 V power supply
2 3V3 P 3.3 V power supply
3 RST I CHIP_PU
4 4 I/O/T RTC_GPIO4, GPIO4, TOUCH4, ADC1_CH3
5 5 I/O/T RTC_GPIO5, GPIO5, TOUCH5, ADC1_CH4
6 6 I/O/T RTC_GPIO6, GPIO6, TOUCH6, ADC1_CH5
7 7 I/O/T RTC_GPIO7, GPIO7, TOUCH7, ADC1_CH6
8 15 I/O/T RTC_GPIO15, GPIO15, U0RTS, ADC2_CH4, XTAL_32K_P
9 16 I/O/T RTC_GPIO16, GPIO16, U0CTS, ADC2_CH5, XTAL_32K_N
10 17 I/O/T RTC_GPIO17, GPIO17, U1TXD, ADC2_CH6, DAC_1
11 18 I/O/T RTC_GPIO18, GPIO18, U1RXD, ADC2_CH7, DAC_2, CLK_OUT3, RGB LED
12 8 I/O/T RTC_GPIO8, GPIO8, TOUCH8, ADC1_CH7
13 3 I/O/T RTC_GPIO3, GPIO3, TOUCH3, ADC1_CH2
14 46 I GPIO46
15 9 I/O/T RTC_GPIO9, GPIO9, TOUCH9, ADC1_CH8, FSPIHD
16 10 I/O/T RTC_GPIO10, GPIO10, TOUCH10, ADC1_CH9, FSPICS0, FSPIIO4
17 11 I/O/T RTC_GPIO11, GPIO11, TOUCH11, ADC2_CH0, FSPID, FSPIIO5
18 12 I/O/T RTC_GPIO12, GPIO12, TOUCH12, ADC2_CH1, FSPICLK, FSPIIO6
19 13 I/O/T RTC_GPIO13, GPIO13, TOUCH13, ADC2_CH2, FSPIQ, FSPIIO7
20 14 I/O/T RTC_GPIO14, GPIO14, TOUCH14, ADC2_CH3, FSPIWP, FSPIDQS
21 5V P 5 V power supply
22 G G Ground
=== ==== ========== ==========================================================================
=== ========= ========== ==========================================================================
No. Name Type [#]_ Function
=== ========= ========== ==========================================================================
1 3V3 P 3.3 V power supply
2 3V3 P 3.3 V power supply
3 RST I CHIP_PU
4 4 I/O/T RTC_GPIO4, GPIO4, TOUCH4, ADC1_CH3
5 5 I/O/T RTC_GPIO5, GPIO5, TOUCH5, ADC1_CH4
6 6 I/O/T RTC_GPIO6, GPIO6, TOUCH6, ADC1_CH5
7 7 I/O/T RTC_GPIO7, GPIO7, TOUCH7, ADC1_CH6
8 15 I/O/T RTC_GPIO15, GPIO15, U0RTS, ADC2_CH4, XTAL_32K_P
9 16 I/O/T RTC_GPIO16, GPIO16, U0CTS, ADC2_CH5, XTAL_32K_N
10 17 I/O/T RTC_GPIO17, GPIO17, U1TXD, ADC2_CH6, DAC_1
11 18 [#]_ I/O/T RTC_GPIO18, GPIO18, U1RXD, ADC2_CH7, DAC_2, CLK_OUT3, RGB LED
12 8 I/O/T RTC_GPIO8, GPIO8, TOUCH8, ADC1_CH7
13 3 I/O/T RTC_GPIO3, GPIO3, TOUCH3, ADC1_CH2
14 46 I GPIO46
15 9 I/O/T RTC_GPIO9, GPIO9, TOUCH9, ADC1_CH8, FSPIHD
16 10 I/O/T RTC_GPIO10, GPIO10, TOUCH10, ADC1_CH9, FSPICS0, FSPIIO4
17 11 I/O/T RTC_GPIO11, GPIO11, TOUCH11, ADC2_CH0, FSPID, FSPIIO5
18 12 I/O/T RTC_GPIO12, GPIO12, TOUCH12, ADC2_CH1, FSPICLK, FSPIIO6
19 13 I/O/T RTC_GPIO13, GPIO13, TOUCH13, ADC2_CH2, FSPIQ, FSPIIO7
20 14 I/O/T RTC_GPIO14, GPIO14, TOUCH14, ADC2_CH3, FSPIWP, FSPIDQS
21 5V P 5 V power supply
22 G G Ground
=== ========= ========== ==========================================================================


J3
Expand Down Expand Up @@ -206,12 +257,13 @@ 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: 15%
:scale: 45%
:alt: ESP32-S2-DevKitC-1 (click to enlarge)
:figclass: align-center

Expand All @@ -224,11 +276,20 @@ This is the first revision of this board released.

Related Documents
=================
* `ESP32-S2 Series Chip Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf>`_ (PDF)

* `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)
* `ESP32-S2-SOLO-2 & ESP32-S2-SOLO-2U Module Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-s2-solo-2_esp32-s2-solo-2u_datasheet_en.pdf>`_ (PDF)
* `ESP32-S2-SOLO & ESP32-S2-SOLO-U Module Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-s2-solo_esp32-s2-solo-u_datasheet_en.pdf>`_ (PDF)
* `ESP32-S2-DevKitC-1 Schematic <https://dl.espressif.com/dl/schematics/SCH_ESP32-S2-DEVKITC-1_V1_20210508.pdf>`_ (PDF)
* `ESP32-S2-DevKitC-1 Schematic`_ (PDF)
* `ESP32-S2-DevKitC-1 PCB Layout <https://dl.espressif.com/dl/schematics/PCB_ESP32-S2-DevKitC-1_V1_20210508.pdf>`_ (PDF)
* `ESP32-S2-DevKitC-1 Dimensions <https://dl.espressif.com/dl/schematics/DXF_ESP32-S2-DevKitC-1_V1_20210511.pdf>`_ (PDF)
* `ESP32-S2-DevKitC-1 Dimensions source file <https://dl.espressif.com/dl/schematics/DXF_ESP32-S2-DevKitC-1_V1_20210511.dxf>`_ (DXF) - You can view it with `Autodesk Viewer <https://viewer.autodesk.com/>`_ online

For further design documentation for the board, please contact us at `sales@espressif.com <sales@espressif.com>`_.

.. _NRND: https://www.espressif.com/en/products/longevity-commitment?id=nrnd
.. _ESP32-S2 Series Chip Revision v1.0 Datasheet: https://www.espressif.com/sites/default/files/documentation/esp32-s2-v1.0_datasheet_en.pdf
.. _ESP32-S2 Series SoC Errata: https://espressif.com/sites/default/files/documentation/esp32-s2_errata_en.pdf
.. _ESP32-S2-DevKitC-1 Schematic: https://dl.espressif.com/dl/schematics/esp-idf/SCH_ESP32-S2-DEVKITC-1_V1_20220817.pdf

0 comments on commit 1f9626f

Please sign in to comment.