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

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