Hello world with Arduino on ESP32-S3

Updated on 12 October 2022
dev board ESP32-S3-DevKitC-1
chip ESP32-S3-WROOM-1-N8R2
features chip core version serial esp32s3
This tutorial is more than 1 year old. If the steps below do not work, then please check the latest versions and the documentations of the individual tools used.

Before starting

Dependancies

Ensure the following dependancies are downloaded and available:

Buy the components

  1. ESP32-S3-DevKitC-1-N8R2

Code

Download code hello-arduino-esp32s3.ino 
void setup() {
  delay(500);
  Serial.begin(115200);
  delay(500);
  Serial.println("\n\n================================");
  Serial.print("Chip Model: ");
  Serial.println(ESP.getChipModel());
  Serial.print("Chip version: ");
  Serial.println(ESP.getChipRevision());
  Serial.print("Numer of cores: ");
  Serial.println(ESP.getChipCores());
  Serial.print("Flash Chip Size: ");
  Serial.println(ESP.getFlashChipSize());
  Serial.print("Flash Chip Speed: ");
  Serial.println(ESP.getFlashChipSpeed());

  Serial.println("================================");
}

void loop() { }

Makefile

BOARD?=esp32:esp32:esp32s3:CDCOnBoot=cdc
PORT?=/dev/tty.usbmodem14*
BUILD=build

.PHONY: default lint all flash clean

default: lint all flash clean

lint:
	cpplint --extensions=ino --filter=-legal/copyright *.ino

all:
	arduino-cli compile --fqbn $(BOARD) --output-dir $(BUILD) ./

flash:
	arduino-cli upload --fqbn $(BOARD) --port $(PORT) --input-dir $(BUILD)

clean:
	rm -r build

Prototype

A photo of the actual setup.

Hello world with Arduino on ESP32-S3 prototype

Serial console

Serial output from the firmware.

Hello world with Arduino on ESP32-S3 serial console

Description

Installing ESP32 Arduino on Arduino IDE

  1. Check Supported SoCs
  2. Copy the Development release link 
     https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_dev_index.json
  3. Go to Arduino IDE > Preferences > Additional Boards Manager URLs and paste the JSON link
  4. Go to Tools > Boards > Boards Manager > Search ESP32 > Install the latest version
  5. Plug in the USB cable to USB port of the dev board
  6. Check the board can be detected on the computer with linux command ls /dev/tty.usb*
  7. Back in the Arduino IDE choose the Board and the Port with USB CDC Enabled on Boot
  8. Compile and upload the firmware
  9. View the serial monitor

Add menu option in arduino-cli

  1. Run command arduino-cli board details -b esp32:esp32:esp32s3 to get the CDC USB on Boot menu item to enable it

     $ arduino-cli board details -b esp32:esp32:esp32s3
 Board name:            ESP32S3 Dev Module
 FQBN:                  esp32:esp32:esp32s3
 Board version:         2.0.4

 Package name:          esp32
 Package maintainer:    Espressif Systems
 Package URL:           https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
 Package website:       https://github.com/espressif/arduino-esp32
 Package online help:   http://esp32.com

 Platform name:         esp32
 Platform category:     ESP32
 Platform architecture: esp32
 Platform URL:          https://github.com/espressif/arduino-esp32/releases/download/2.0.4/esp32-2.0.4.zip
 Platform file name:    esp32-2.0.4.zip
 Platform size (bytes): 259715595
 Platform checksum:     SHA-256:832609d6f4cd0edf4e471f02e30b7f0e1c86fdd1b950990ef40431e656237214

 Required tool:         esp32:riscv32-esp-elf-gcc      gcc8_4_0-esp-2021r2-patch3
 Required tool:         esp32:xtensa-esp32-elf-gcc     gcc8_4_0-esp-2021r2-patch3
 Required tool:         esp32:xtensa-esp32s2-elf-gcc   gcc8_4_0-esp-2021r2-patch3
 Required tool:         esp32:xtensa-esp32s3-elf-gcc   gcc8_4_0-esp-2021r2-patch3
 Required tool:         esp32:esptool_py               3.3.0
 Required tool:         esp32:mkspiffs                 0.2.3
 Required tool:         esp32:mklittlefs               3.0.0-gnu12-dc7f933

 Option:              PSRAM                                                PSRAM
                     Disabled                                     ✔       PSRAM=disabled
                     QSPI PSRAM                                           PSRAM=enabled
                     OPI PSRAM                                            PSRAM=opi
 Option:              Flash Mode                                           FlashMode
                       QIO 80MHz                                    ✔       FlashMode=qio
                       QIO 120MHz                                           FlashMode=qio120
                       DIO 80MHz                                            FlashMode=dio
                       OPI 80MHz                                            FlashMode=opi
 Option:              Flash Size                                           FlashSize
                     4MB (32Mb)                                   ✔       FlashSize=4M
                     8MB (64Mb)                                           FlashSize=8M
                     16MB (128Mb)                                         FlashSize=16M
 Option:              Arduino Runs On                                      LoopCore
                     Core 1                                       ✔       LoopCore=1
                     Core 0                                               LoopCore=0
 Option:              Events Run On                                        EventsCore
                     Core 1                                       ✔       EventsCore=1
                     Core 0                                               EventsCore=0
 Option:              USB Mode                                             USBMode
                     Hardware CDC and JTAG                        ✔       USBMode=hwcdc
                     USB-OTG (TinyUSB)                                    USBMode=default
 Option:              USB CDC On Boot                                      CDCOnBoot
                     Disabled                                     ✔       CDCOnBoot=default
                     Enabled                                              CDCOnBoot=cdc
 Option:              USB Firmware MSC On Boot                             MSCOnBoot
                     Disabled                                     ✔       MSCOnBoot=default
                     Enabled (Requires USB-OTG Mode)                      MSCOnBoot=msc
 Option:              USB DFU On Boot                                      DFUOnBoot
                     Disabled                                     ✔       DFUOnBoot=default
                     Enabled (Requires USB-OTG Mode)                      DFUOnBoot=dfu
 Option:              Upload Mode                                          UploadMode
                     UART0 / Hardware CDC                         ✔       UploadMode=default
                     USB-OTG CDC (TinyUSB)                                UploadMode=cdc
 Option:              Partition Scheme                                     PartitionScheme
                     Default 4MB with spiffs (1.2MB APP/1.5MB SPIFFS) ✔       PartitionScheme=default
                     Default 4MB with ffat (1.2MB APP/1.5MB FATFS)         PartitionScheme=defaultffat
                     8M Flash (3MB APP/1.5MB FAT)                         PartitionScheme=default_8MB
                     Minimal (1.3MB APP/700KB SPIFFS)                     PartitionScheme=minimal
                     No OTA (2MB APP/2MB SPIFFS)                          PartitionScheme=no_ota
                     No OTA (1MB APP/3MB SPIFFS)                          PartitionScheme=noota_3g
                     No OTA (2MB APP/2MB FATFS)                           PartitionScheme=noota_ffat
                     No OTA (1MB APP/3MB FATFS)                           PartitionScheme=noota_3gffat
                     Huge APP (3MB No OTA/1MB SPIFFS)                     PartitionScheme=huge_app
                     Minimal SPIFFS (1.9MB APP with OTA/190KB SPIFFS)         PartitionScheme=min_spiffs
                     16M Flash (2MB APP/12.5MB FAT)                       PartitionScheme=fatflash
                     16M Flash (3MB APP/9MB FATFS)                        PartitionScheme=app3M_fat9M_16MB
                     RainMaker                                            PartitionScheme=rainmaker
 Option:              CPU Frequency                                        CPUFreq
                     240MHz (WiFi)                                ✔       CPUFreq=240
                     160MHz (WiFi)                                        CPUFreq=160
                     80MHz (WiFi)                                         CPUFreq=80
                     40MHz                                                CPUFreq=40
                     20MHz                                                CPUFreq=20
                     10MHz                                                CPUFreq=10
 Option:              Upload Speed                                         UploadSpeed
                     921600                                       ✔       UploadSpeed=921600
                     115200                                               UploadSpeed=115200
                     230400                                               UploadSpeed=230400
                     460800                                               UploadSpeed=460800
 Option:              Core Debug Level                                     DebugLevel
                     None                                         ✔       DebugLevel=none
                     Error                                                DebugLevel=error
                     Warn                                                 DebugLevel=warn
                     Info                                                 DebugLevel=info
                     Debug                                                DebugLevel=debug
                     Verbose                                              DebugLevel=verbose
 Programmers:         Id                                           Name
                     esptool                                      Esptool                                         Esptool

  2. Add on the full FBQN format of esp32:esp32:esp32s3:CDCOnBoot=cdc as part of the arduino-cli compile command

References

  1. Buy the official Espressif devkit
  2. Schematic of ESP32-S3-DEVKITC-1 V1
  3. Pinouts
  4. arduino-esp32 2.0.3 add support for ESP32-S3, to develope in Arduino IDE
  5. Arduino Pins
  6. Cannot view serial monitor after compiling and uploading to ESP32S3