Zum Hauptinhalt springen

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.

Select Board
Blink.ino
// 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.