Quick Start
This guide gets the board running with the Arduino IDE and blinks its onboard LED. The steps were checked against version 3.3.12 of Espressif's Arduino core.
1. Install the platform
Install the Arduino IDE from arduino.cc, then open it.
2. Install the board definitions
The board definition ships with Espressif's Arduino core for the ESP32. In the Arduino IDE, add this URL under File → Preferences → Additional Boards Manager URLs:
https://espressif.github.io/arduino-esp32/package_esp32_index.json
Then open Tools → Board → Boards Manager, search for esp32 and install esp32 by Espressif Systems.
3. Select the board
Connect the board to your computer with the USB-C cable. Then choose the board under Tools → Board → esp32 → Soldered NULA DeepSleep ESP32S3 and pick the board's serial port under Tools → Port.
A CH340K chip (a USB-to-serial converter) sits between the USB-C connector and the ESP32-S3, so your computer needs the CH340 driver to see the port. If no port appears, see Troubleshooting.
Keep Tools → USB CDC On Boot at its default, Disabled. Serial then uses the UART0 pins (TXD0 and RXD0), and that is where the CH340K is wired.
4. Upload your first program
The board has an RGB LED on IO2 that the Arduino core switches with digitalWrite(). This sketch blinks it once a second, which is the quickest way to see that the upload worked.
// Blink the onboard RGB LED (marked IO2): 0.5 s on, 0.5 s off.
// LED_BUILTIN is defined by the board definition and points at that LED.
const int LED_PIN = LED_BUILTIN;
void setup()
{
pinMode(LED_PIN, OUTPUT);
}
void loop()
{
digitalWrite(LED_PIN, HIGH); // LED on
delay(500);
digitalWrite(LED_PIN, LOW); // LED off
delay(500);
}
5. What to expect
Click Upload in the Arduino IDE. When the upload finishes, the LED marked IO2 on the board turns on and off every half second. The core switches all three colour channels together, so it lights white. If it stays dark, JP1 may be cut (see Hardware Details).
6. Troubleshooting
If the board is not detected or the upload fails, continue with Troubleshooting.