Espressif Systems ESP32-S3-WROOM-2 User manual

ESP32-S3-WROOM-2
User Manual
2.4 GHz Wi-Fi (802.11 b/g/n) and Bluetooth®5 (LE) module
Built around ESP32-S3R8V SoC, Xtensa®dual-core 32-bit LX7 microprocessor
Flash up to 32 MB, PSRAM up to 8 MB
33 GPIOs, rich set of peripherals
On-board PCB antenna
ESP32-S3-WROOM-2
Pre-release v0.6
Espressif Systems
Copyright © 2022
www.espressif.com

About This Document
This user manual shows how to get started with the ESP32-S3-WROOM-2 module.
Document Updates
Please always refer to the latest version on https://www.espressif.com/en/support/download/documents.
Revision History
For revision history of this document, please refer to the last page.
Documentation Change Notification
Espressif provides email notifications to keep you updated on changes to technical documentation. Please sub-
scribe at www.espressif.com/en/subscribe.
Certification
Download certificates for Espressif products from www.espressif.com/en/certificates.

Contents
Contents
1 Overview 4
1.1 Module Overview 4
1.2 Pin Description 4
2 Get Started 8
2.1 What You Need 8
2.2 Hardware Connection 8
2.3 Set up Development Environment 9
2.3.1 Install Prerequisites 9
2.3.2 Get ESP-IDF 9
2.3.3 Set up Tools 10
2.3.4 Set up Environment Variables 10
2.4 Create Your First Project 10
2.4.1 Start a Project 10
2.4.2 Connect Your Device 10
2.4.3 Configure 10
2.4.4 Build the Project 11
2.4.5 Flash onto the Device 12
2.4.6 Monitor 13
3 U.S. FCC Statement 15
4 Related Documentation and Resources 19
Revision History 20
Espressif Systems 3
Submit Documentation Feedback
ESP32-S3-WROOM-2 User Manual v0.6

1 Overview
1 Overview
1.1 Module Overview
ESP32-S3-WROOM-2 is a powerful, generic Wi-Fi + Bluetooth LE MCU module that has a rich set of peripherals. It
provides acceleration for neural network computing and signal processing workloads. It is an ideal choice for a wide
variety of application scenarios related to AI and Artificial Intelligence of Things (AIoT), such as wake word detection
and speech commands recognition, face detection and recognition, smart home, smart appliances, smart control
panel, smart speaker, etc. The module comes with a PCB antenna. It has ESP32-S3R8V SoC embedded. A
selection of module variants are available for customers with flash memory of 16/32 MB and PSRAM memory of
8 MB.
Table 1: ESP32-S3-WROOM-2 Specifications
Categories Items Specifications
Wi-Fi Protocols 802.11 b/g/n (802.11n up to 150 Mbps) A-MPDU and A-MSDU aggregation and 0.4 µs guard
interval support
Center frequency range of operating
channel 2412 ~2462 MHz
Bluetooth®
Protocols Bluetooth®LE: Bluetooth 5 and Bluetooth mesh
Radio Class-1, class-2, and class-3 transmitter
AFH
Audio CVSD and SBC
Hardware
Module peripherals
GPIO, SPI, LCD interface, Camera interface, UART,
I2C, I2S, remote control, pulse counter, LED PWM,
USB 1.1 OTG, USB Serial/JTAG controller, MCPWM,
SDIO host, GDMA, TWAI®controller (compatible with
ISO 11898-1), ADC, touch sensor, temperature sen-
sor, timers and watchdogs
Integrated crystal 40 MHz crystal
Integrated SPI flash Up to 32 MB
Integrated PSRAM Up to 8 MB
Operating voltage/Power supply 3.0 ~3.6 V
Operating current Average: 80 mA
Minimum current delivered by power
supply 500 mA
Recommended operating tempera-
ture range –40 °C ~+65 °C
Moisture sensitivity level (MSL) Level 3
1.2 Pin Description
The pin diagram below shows the approximate location of pins on ESP32-S3-WROOM-2.
Espressif Systems 4
Submit Documentation Feedback
ESP32-S3-WROOM-2 User Manual v0.6

1 Overview
GND
3V3
EN
IO4
IO5
IO6
IO7
IO20
40
39
38
37
36
35
34
33
32
31
30
29
28
27
GND
IO1
IO2
TXD0
RXD0
IO42
IO41
IO40
IO39
IO38
NC
NC
NC
IO0
41
GND
Keepout Zone
GND
GND GND GND
GND
GNDGNDGND
18 19
20
IO10
IO11
IO12
21
22
23
IO13
IO14
IO21
15
16 17
IO3
IO46
IO9
24
25
26
IO47 IO48
IO45
1
2
3
4
5
6
7
8
9
10
11
12
13
14
IO15
IO16
IO17
IO18
IO8
IO19
Figure 1: Pin Layout (Top View)
The module has 41 pins. See pin definitions in Table 2.
For peripheral pin configurations, please refer to ESP32-S3 Series Datasheet.
Table 2: Pin Definitions
Name No. Type aFunction
GND 1 P GND
3V3 2 P Power supply
EN 3 I
High: on, enables the chip.
Low: off, the chip powers off.
Note: Do not leave the EN pin floating.
Cont’d on next page
Espressif Systems 5
Submit Documentation Feedback
ESP32-S3-WROOM-2 User Manual v0.6

1 Overview
Table 2 – cont’d from previous page
Name No. Type aFunction
IO4 4 I/O/T RTC_GPIO4, GPIO4, TOUCH4, ADC1_CH3
IO5 5 I/O/T RTC_GPIO5, GPIO5, TOUCH5, ADC1_CH4
IO6 6 I/O/T RTC_GPIO6, GPIO6, TOUCH6, ADC1_CH5
IO7 7 I/O/T RTC_GPIO7, GPIO7, TOUCH7, ADC1_CH6
IO15 8 I/O/T RTC_GPIO15, GPIO15, U0RTS, ADC2_CH4, XTAL_32K_P
IO16 9 I/O/T RTC_GPIO16, GPIO16, U0CTS, ADC2_CH5, XTAL_32K_N
IO17 10 I/O/T RTC_GPIO17, GPIO17, U1TXD, ADC2_CH6
IO18 11 I/O/T RTC_GPIO18, GPIO18, U1RXD, ADC2_CH7, CLK_OUT3
IO8 12 I/O/T RTC_GPIO8, GPIO8, TOUCH8, ADC1_CH7, SUBSPICS1
IO19 13 I/O/T RTC_GPIO19, GPIO19, U1RTS, ADC2_CH8, CLK_OUT2, USB_D-
IO20 14 I/O/T RTC_GPIO20, GPIO20, U1CTS, ADC2_CH9, CLK_OUT1, USB_D+
IO3 15 I/O/T RTC_GPIO3, GPIO3, TOUCH3, ADC1_CH2
IO46 16 I/O/T GPIO46
IO9 17 I/O/T RTC_GPIO9, GPIO9, TOUCH9, ADC1_CH8, FSPIHD, SUBSPIHD
IO10 18 I/O/T RTC_GPIO10, GPIO10, TOUCH10, ADC1_CH9, FSPICS0, FSPIIO4,
SUBSPICS0
IO11 19 I/O/T RTC_GPIO11, GPIO11, TOUCH11, ADC2_CH0, FSPID, FSPIIO5,
SUBSPID
IO12 20 I/O/T RTC_GPIO12, GPIO12, TOUCH12, ADC2_CH1, FSPICLK, FSPIIO6,
SUBSPICLK
IO13 21 I/O/T RTC_GPIO13, GPIO13, TOUCH13, ADC2_CH2, FSPIQ, FSPIIO7,
SUBSPIQ
IO14 22 I/O/T RTC_GPIO14, GPIO14, TOUCH14, ADC2_CH3, FSPIWP, FSPIDQS,
SUBSPIWP
IO21 23 I/O/T RTC_GPIO21, GPIO21
IO47 24 I/O/T SPICLK_P_DIFF, GPIO47, SUBSPICLK_P_DIFF
IO48 25 I/O/T SPICLK_N_DIFF, GPIO48, SUBSPICLK_N_DIFF
IO45 26 I/O/T GPIO45
IO0 27 I/O/T RTC_GPIO0, GPIO0
NC 28 - NC
NC 29 - NC
NC 30 - NC
IO38 31 I/O/T GPIO38, FSPIWP, SUBSPIWP
IO39 32 I/O/T MTCK, GPIO39, CLK_OUT3, SUBSPICS1
IO40 33 I/O/T MTDO, GPIO40, CLK_OUT2
IO41 34 I/O/T MTDI, GPIO41, CLK_OUT1
IO42 35 I/O/T MTMS, GPIO42
RXD0 36 I/O/T U0RXD, GPIO44, CLK_OUT2
TXD0 37 I/O/T U0TXD, GPIO43, CLK_OUT1
IO2 38 I/O/T RTC_GPIO2, GPIO2, TOUCH2, ADC1_CH1
IO1 39 I/O/T RTC_GPIO1, GPIO1, TOUCH1, ADC1_CH0
GND 40 P GND
Cont’d on next page
Espressif Systems 6
Submit Documentation Feedback
ESP32-S3-WROOM-2 User Manual v0.6

1 Overview
Table 2 – cont’d from previous page
Name No. Type aFunction
EPAD 41 P GND
aP: power supply; I: input; O: output; T: high impedance. Pin functions in bold font are the default
pin functions.
Espressif Systems 7
Submit Documentation Feedback
ESP32-S3-WROOM-2 User Manual v0.6

2 Get Started
2 Get Started
2.1 What You Need
To develop applications for module you need:
• 1 x ESP32-S3-WROOM-2
• 1 x Espressif RF testing board
• 1 x USB-to-Serial board
• 1 x Micro-USB cable
• 1 x PC running Linux
In this user guide, we take Linux operating system as an example. For more information about the configuration
on Windows and macOS, please refer to ESP-IDF Programming Guide.
2.2 Hardware Connection
1. Solder the ESP32-S3-WROOM-2 module to the RF testing board as shown in Figure 2.
Figure 2: Hardware Connection
2. Connect the RF testing board to the USB-to-Serial board via TXD, RXD, and GND.
3. Connect the USB-to-Serial board to the PC.
4. Connect the RF testing board to the PC or a power adapter to enable 5 V power supply, via the Micro-USB
cable.
5. During download, connect IO0 to GND via a jumper. Then, turn ”ON” the testing board.
6. Download firmware into flash. For details, see the sections below.
Espressif Systems 8
Submit Documentation Feedback
ESP32-S3-WROOM-2 User Manual v0.6

2 Get Started
7. After download, remove the jumper on IO0 and GND.
8. Power up the RF testing board again. The module will switch to working mode. The chip will read programs
from flash upon initialization.
Note:
IO0 is internally logic high. If IO0 is set to pull-up, the Boot mode is selected. If this pin is pull-down or left floating, the
Download mode is selected. For more information on ESP32-S3-WROOM-2, please refer to ESP32-S3 Series Datasheet.
2.3 Set up Development Environment
The Espressif IoT Development Framework (ESP-IDF for short) is a framework for developing applications based
on the Espressif ESP32. Users can develop applications with ESP32-S3 in Windows/Linux/macOS based on
ESP-IDF. Here we take Linux operating system as an example.
2.3.1 Install Prerequisites
To compile with ESP-IDF you need to get the following packages:
• CentOS 7 & 8:
sudo yum -y update && sudo yum install git wget flex bison gperf python3 python3-pip
python3-setuptools cmake ninja-build ccache dfu-util libusbx
• Ubuntu and Debian:
sudo apt-get install git wget flex bison gperf python3 python3-pip python3-setuptools
cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
• Arch:
sudo pacman -S --needed gcc git make flex bison gperf python-pip cmake ninja ccache
dfu-util libusb
Note:
• This guide uses the directory ~/esp on Linux as an installation folder for ESP-IDF.
• Keep in mind that ESP-IDF does not support spaces in paths.
2.3.2 Get ESP-IDF
To build applications for ESP32-S3-WROOM-2 module, you need the software libraries provided by Espressif in
ESP-IDF repository.
To get ESP-IDF, create an installation directory (~/esp) to download ESP-IDF to and clone the repository with ‘git
clone’:
mkdir -p ~/esp
cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf.git
Espressif Systems 9
Submit Documentation Feedback
ESP32-S3-WROOM-2 User Manual v0.6

2 Get Started
ESP-IDF will be downloaded into ~/esp/esp-idf. Consult ESP-IDF Versions for information about which ESP-IDF
version to use in a given situation.
2.3.3 Set up Tools
Aside from the ESP-IDF, you also need to install the tools used by ESP-IDF, such as the compiler, debugger, Python
packages, etc. ESP-IDF provides a script named ’install.sh’ to help set up the tools in one go.
cd ~/esp/esp-idf
./install.sh
2.3.4 Set up Environment Variables
The installed tools are not yet added to the PATH environment variable. To make the tools usable from the command
line, some environment variables must be set. ESP-IDF provides another script ’export.sh’ which does that. In the
terminal where you are going to use ESP-IDF, run:
. $HOME/esp/esp-idf/export.sh
Now everything is ready, you can build your first project on ESP32-S3-WROOM-2 module.
2.4 Create Your First Project
2.4.1 Start a Project
Now you are ready to prepare your application for ESP32-S3-WROOM-2 module. You can start with get-started/hello_world
project from examples directory in ESP-IDF.
Copy get-started/hello_world to ~/esp directory:
cd ~/esp
cp -r $IDF_PATH/examples/get-started/hello_world .
There is a range of example projects in the examples directory in ESP-IDF. You can copy any project in the same
way as presented above and run it. It is also possible to build examples in-place, without copying them first.
2.4.2 Connect Your Device
Now connect your module to the computer and check under what serial port the module is visible. Serial ports in
Linux start with ‘/dev/tty’ in their names. Run the command below two times, first with the board unplugged, then
with plugged in. The port which appears the second time is the one you need:
ls /dev/tty*
Note:
Keep the port name handy as you will need it in the next steps.
2.4.3 Configure
Navigate to your ‘hello_world’ directory from Step 2.4.1. Start a Project, set ESP32-S3 chip as the target and run
the project configuration utility ‘menuconfig’.
Espressif Systems 10
Submit Documentation Feedback
ESP32-S3-WROOM-2 User Manual v0.6