1================
2ESP32-S2-Saola-1
3================
4
5:link_to_translation:`zh_CN:[中文]`
6
7This user guide provides information on ESP32-S2-Saola-1, a small-sized `ESP32-S2 Datasheet`_ based development board produced by Espressif.
8
9.. figure:: ../../../_static/esp32-s2-saola-1-v1.2-isometric.png
10    :align: center
11    :alt: ESP32-S2-Saola-1
12    :figclass: align-center
13
14    ESP32-S2-Saola-1
15
16The document consists of the following major sections:
17
18- `Getting started`_: Provides an overview of the ESP32-S2-Saola-1 and hardware/software setup instructions to get started.
19- `Hardware reference`_: Provides more detailed information about the ESP32-S2-Saola-1's hardware.
20- `Hardware Revision Details`_: Revision history, known issues, and links to user guides for previous versions (if any) of ESP32-S2-Saola-1.
21- `Related Documents`_: Gives links to related documentation.
22
23Getting Started
24===============
25
26This 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.
27
28Overview
29--------
30
31ESP32-S2-Saola-1 is a small-sized ESP32-S2 based development board produced by Espressif. 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-Saola-1 on a breadboard.
32
33To cover a wide range of users' needs, ESP32-S2-Saola-1 supports:
34
35- `ESP32-S2-WROVER <https://www.espressif.com/sites/default/files/documentation/esp32-s2-wrover_esp32-s2-wrover-i_datasheet_en.pdf>`_
36- `ESP32-S2-WROVER-I <https://www.espressif.com/sites/default/files/documentation/esp32-s2-wrover_esp32-s2-wrover-i_datasheet_en.pdf>`_
37- `ESP32-S2-WROOM <https://www.espressif.com/sites/default/files/documentation/esp32-s2-wroom_esp32-s2-wroom-i_datasheet_en.pdf>`_
38- `ESP32-S2-WROOM-I <https://www.espressif.com/sites/default/files/documentation/esp32-s2-wroom_esp32-s2-wroom-i_datasheet_en.pdf>`_
39
40In this guide, we take ESP32-S2-Saola-1 equipped with ESP32-S2-WROVER as an example.
41
42Contents and Packaging
43----------------------
44
45Retail orders
46^^^^^^^^^^^^^
47
48If 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.
49
50For retail orders, please go to https://www.espressif.com/en/company/contact/buy-a-sample.
51
52Wholesale Orders
53^^^^^^^^^^^^^^^^
54
55If you order in bulk, the boards come in large cardboard boxes.
56
57For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
58
59Description of Components
60-------------------------
61
62.. _user-guide-saola-1-v1.2-board-front:
63
64.. figure:: ../../../_static/esp32-s2-saola-1-v1.2-annotated-photo.png
65    :align: center
66    :alt: ESP32-S2-Saola-1 - front/back
67    :figclass: align-center
68
69    ESP32-S2-Saola-1 - front
70
71The key components of the board are described in a clockwise direction.
72
73.. list-table::
74   :widths: 30 70
75   :header-rows: 1
76
77   * - Key Component
78     - Description
79   * - ESP32-S2-WROVER
80     - 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.
81   * - Pin Headers
82     - 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.
83   * - 3.3 V Power On LED
84     - Turns on when the USB power is connected to the board.
85   * - USB-to-UART Bridge
86     - Single USB-UART bridge chip provides transfer rates up to 3 Mbps.
87   * - Reset Button
88     - Reset button.
89   * - Micro-USB Port
90     - USB interface. Power supply for the board as well as the communication interface between a computer and the ESP32-S2 chip.
91   * - Boot Button
92     - Download button. Holding down **Boot** and then pressing **Reset** initiates Firmware Download mode for downloading firmware through the serial port.
93   * - RGB LED
94     - Addressable RGB LED (WS2812), driven by GPIO18.
95
96Start Application Development
97-----------------------------
98
99Before powering up your ESP32-S2-Saola-1, please make sure that it is in good condition with no obvious signs of damage.
100
101Required Hardware
102^^^^^^^^^^^^^^^^^
103
104- ESP32-S2-Saola-1
105- USB 2.0 cable (Standard-A to Micro-B)
106- Computer running Windows, Linux, or macOS
107
108.. note::
109
110  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.
111
112Software Setup
113^^^^^^^^^^^^^^
114
115Please 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-S2-Saola-1.
116
117.. note::
118
119    ESP32-S2 series of chips only supports ESP-IDF master or version v4.2 and higher.
120
121Hardware Reference
122==================
123
124Block Diagram
125-------------
126
127A block diagram below shows the components of ESP32-S2-Saola-1 and their interconnections.
128
129.. figure:: ../../../_static/esp32-s2-saola-1-v1.2-block-diags.png
130    :align: center
131    :scale: 70%
132    :alt: ESP32-S2-Saola-1 (click to enlarge)
133    :figclass: align-center
134
135    ESP32-S2-Saola-1 (click to enlarge)
136
137Power Supply Options
138^^^^^^^^^^^^^^^^^^^^
139
140There are three mutually exclusive ways to provide power to the board:
141
142- Micro-USB port, default power supply
143- 5V and GND pin headers
144- 3V3 and GND pin headers
145
146It is recommended to use the first option: Micro-USB Port.
147
148Header Block
149------------
150
151The 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).
152
153J2
154^^^
155===  ====  ==========  ======================================
156No.  Name  Type [#]_    Function
157===  ====  ==========  ======================================
1581    3V3    P           3.3 V power supply
1592    IO0    I/O         GPIO0, Boot
1603    IO1    I/O         GPIO1, ADC1_CH0, TOUCH_CH1
1614    IO2    I/O         GPIO2, ADC1_CH1, TOUCH_CH2
1625    IO3    I/O         GPIO3, ADC1_CH2, TOUCH_CH3
1636    IO4    I/O         GPIO4, ADC1_CH3, TOUCH_CH4
1647    IO5    I/O         GPIO5, ADC1_CH4, TOUCH_CH5
1658    IO6    I/O         GPIO6, ADC1_CH5, TOUCH_CH6
1669    IO7    I/O         GPIO7, ADC1_CH6, TOUCH_CH7
16710   IO8    I/O         GPIO8, ADC1_CH7, TOUCH_CH8
16811   IO9    I/O         GPIO9, ADC1_CH8, TOUCH_CH9
16912   IO10   I/O         GPIO10, ADC1_CH9, TOUCH_CH10
17013   IO11   I/O         GPIO11, ADC2_CH0, TOUCH_CH11
17114   IO12   I/O         GPIO12, ADC2_CH1, TOUCH_CH12
17215   IO13   I/O         GPIO13, ADC2_CH2, TOUCH_CH13
17316   IO14   I/O         GPIO14, ADC2_CH3, TOUCH_CH14
17417   IO15   I/O         GPIO15, ADC2_CH4, XTAL_32K_P
17518   IO16   I/O         GPIO16, ADC2_CH5, XTAL_32K_N
17619   IO17   I/O         GPIO17, ADC2_CH6, DAC_1
17720   5V0    P           5 V power supply
17821   GND    G           Ground
179===  ====  ==========  ======================================
180
181J3
182^^^
183===  ====  =====  ====================================
184No.  Name  Type   Function
185===  ====  =====  ====================================
1861    GND   G      Ground
1872    RST   I      CHIP_PU, Reset
1883    IO46  I      GPIO46
1894    IO45  I/O    GPIO45
1905    IO44  I/O    GPIO44, U0RXD
1916    IO43  I/O    GPIO43, U0TXD
1927    IO42  I/O    GPIO42, MTMS
1938    IO41  I/O    GPIO41, MTDI
1949    IO40  I/O    GPIO40, MTDO
19510   IO39  I/O    GPIO39, MTCK
19611   IO38  I/O    GPIO38
19712   IO37  I/O    GPIO37
19813   IO36  I/O    GPIO36
19914   IO35  I/O    GPIO35
20016   IO34  I/O    GPIO34
20117   IO33  I/O    GPIO33
20217   IO26  I/O    GPIO26
20318   IO21  I/O    GPIO21
20419   IO20  I/O    GPIO20, ADC2_CH9, USB_D+
20520   IO19  I/O    GPIO19, ADC2_CH8, USB_D-
20621   IO18  I/O    GPIO18, ADC2_CH7, DAC_2, RGB LED
207===  ====  =====  ====================================
208
209.. [#] P: Power supply; I: Input; O: Output; T: High impedance.
210
211Pin Layout
212^^^^^^^^^^^
213.. figure:: ../../../_static/esp32-s2_saola1-pinout.jpg
214    :align: center
215    :scale: 45%
216    :alt: ESP32-S2-Saola-1 (click to enlarge)
217    :figclass: align-center
218
219    ESP32-S2 Saola-1 Pin Layout (click to enlarge)
220
221Hardware Revision Details
222=========================
223
224This is the first revision of this board released.
225
226Related Documents
227=================
228
229* `ESP32-S2-Saola-1 Schematics`_ (PDF)
230* `ESP32-S2-Saola-1 Dimensions`_ (PDF)
231* `ESP32-S2 Datasheet`_ (PDF)
232* `ESP32-S2-WROVER and ESP32-S2-WROVER-I Datasheet`_ (PDF)
233* `ESP32-S2-WROOM and ESP32-S2-WROOM-I Datasheet`_ (PDF)
234* `ESP Product Selector`_
235
236For other design documentation for the board, please contact us at `sales@espressif.com <sales@espressif.com>`_.
237
238.. _ESP32-S2-Saola-1 Schematics: https://dl.espressif.com/dl/schematics/ESP32-S2-SAOLA-1_V1.1_schematics.pdf
239.. _ESP32-S2-Saola-1 Dimensions: https://dl.espressif.com/dl/schematics/ESP32-S2-Saola-1_V1.2_Dimensions.pdf
240.. _ESP32-S2 Datasheet: https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf
241.. _ESP32-S2-WROVER and ESP32-S2-WROVER-I Datasheet: https://www.espressif.com/sites/default/files/documentation/esp32-s2-wrover_esp32-s2-wrover-i_datasheet_en.pdf
242.. _ESP32-S2-WROOM and ESP32-S2-WROOM-I Datasheet: https://www.espressif.com/sites/default/files/documentation/esp32-s2-wroom_esp32-s2-wroom-i_datasheet_en.pdf
243.. _ESP Product Selector: https://products.espressif.com/#/product-selector?names=
244