ESP32-S3-Box

Caution

This page is automatically generated from RIOT doxygen documentation. If you find any issues or have suggestions for improvement, please report them on Github.

View Doxygen Documentation View this board's documentation as generated by Doxygen.

View on GitHub View this board's source code on GitHub.

Tip

When using this board with RIOT, set the BOARD variable to esp32s3-box in your Makefile. If you follow the standard RIOT project structure, your Makefile should look like this:

./Makefile

# name of your application
APPLICATION = hello-world

# Change this to your board if you want to build for a different board
BOARD ?= esp32s3-box

# This has to be the absolute path to the RIOT base directory:
RIOTBASE ?= $(CURDIR)/RIOT

include $(RIOTBASE)/Makefile.include

Support for the ESP32-S3-Box @author Gunar Schorcht gunar@schorcht.net

\section esp32s3_box ESP32-S3-Box

Table of Contents

1. Overview
2. Hardware
   1. MCU
   2. Board Configuration
   3. Board Pinout
3. Flashing the Device

Overview

The Espressif ESP32-S3-Box is a AIoT development platform for the ESP32-S3 SoC.

The ESP32-S3-Box has following main features:

|Feature | Support | |:--------------------------------------------|:-------:| | ESP32-S3 SoC | yes | | 16 MB Flash | yes | | 8 MB Octal SPI RAM | yes | | 2.4\" LCD Display 320 x 240 with ILI9342C | yes | | Capacitive Touch Panel | no | | Dual Microphone ES7210 | no | | Speaker Codec ES8311 | no | | 3-axis Gyroscope, 3-axis Accelerometer | no | | 2 x Digilent Pmod(TM) Connectors | yes | | USB Type-C | yes |

The Espressif ESP32-S3-Box is shipped with a Dock which exposes the 2 x Digilent Pmod(TM) Connectors.

Back to table of contents

Hardware

This section describes

• the MCU,
• the default board configuration,
• the board pinout.

Back to table of contents

MCU

Most features of the ESP32-S3-Box are provided by the ESP32-S3 SoC. For detailed information about the ESP32-S3 SoC variant (family) and ESP32x SoCs, see section esp32_mcu_esp32 “ESP32 SoC Series”.

Back to table of contents

Board Configuration

The following table shows the default ESP32-S3-Box configuration, which is sorted according to the defined functionality of GPIOs. This configuration can be overridden by esp32_application_specific_configurations “application-specific configurations”.

Function | GPIOs | Remarks | Configuration :---------------|:-------|:--------|:---------------------------------- BUTTON0 | GPIO0 | Boot Mode Button | | I2C_DEV(0) SCL | GPIO40 | PMOD1 | esp32_i2c_interfaces "I2C Interfaces" I2C_DEV(0) SDA | GPIO41 | PMOD1 | esp32_i2c_interfaces "I2C Interfaces" SPI_DEV(0) CLK | GPIO12 | PMOD2, SPI2_HOST (FSPI) is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(0) MISO | GPIO13 | PMOD2, SPI2_HOST (FSPI) is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(0) MOSI | GPIO11 | PMOD2, SPI2_HOST (FSPI) is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(0) CS0 | GPIO10 | PMOD2, SPI2_HOST (FSPI) is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(1) CLK | GPIO7 | LCD SCK, SPI3_HOST is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(1) MISO | GPIO35 | not used, SPI3_HOST is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(1) MOSI | GPIO6 | LCD SDA, SPI3_HOST is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(1) CS0 | GPIO5 | LCD CS, SPI3_HOST is used | esp32_spi_interfaces "SPI Interfaces" UART_DEV(0) TxD | GPIO43 | PMOD2 | esp32_uart_interfaces "UART interfaces" UART_DEV(0) RxD | GPIO44 | PMOD2 | esp32_uart_interfaces "UART interfaces" \n

Back to table of contents

Board Pinout

The following figures show the pinouts as configured by default board definition.

The corresponding schematics can be found:

• ESP32-S3-Box
• ESP32-S3-Box Dock

Back to table of contents

Flashing the Device

Since the ESP32-S3-Box does not have a USB-to-Serial chip, the easiest way to flash it is using the USB Serial/JTAG interface. Just connect the ESP32-S3-Box to your host computer and use the following command:

BOARD=esp32s3-box make flash ...

Usually the make system resets the ESP32-S3-Box before flashing to enable the USB Serial/JTAG controller and to reboot the ESP32-S3 in download mode.

In some very special cases this reset does not work and the programmer cannot connect to the card, so the flashing is aborted with a timeout:

Serial port /dev/ttyACM0
Connecting...
...
serial.serialutil.SerialTimeoutException: Write timeout

This can happen either if RIOT is not yet installed or if the USB port was previously used with the USB OTG controller, for example with USBUS or tinyUSB. In this case, restart the ESP32-S3-Box manually into download mode by pressing and releasing the RESET button while holding down the BOOT button. In download mode, the USB Serial/JTAG interface is always available.

Note: If the USB port was previously used with the USB OTG controller, an automatic restart of the ESP32-S3 with the flashed application is not possible. In this case the ESP32-S3-Box must be reset manually using the RESET button. In all other cases the ESP32-S3 automatically restarts with the flashed application.

Back to table of contents