Skip to main content

Quick Start

The quickest first success on this board is to light its RGB LED. Pick your environment below: each tab installs the tools, uploads a program that blinks the LED, and shows what you should see.

1. Install the platform​

Install the Arduino IDE from arduino.cc, then open it.

2. Install the board definitions​

The board runs on Espressif's Arduino core for the ESP32. In the Arduino IDE, open the Preferences window and enter this URL into the Additional Board Manager URLs field:

https://espressif.github.io/arduino-esp32/package_esp32_index.json

Then open Boards Manager from the Tools > Board menu and install the esp32 platform.

3. Select the board​

The ESP32 core has no entry of its own for this board yet, so use the generic one for its chip:

  1. Connect the board to your computer with the USB-C cable.
  2. Choose Tools > Board > esp32 > ESP32S3 Dev Module.
  3. Set Tools > Flash Size to 8MB (64Mb) and Tools > PSRAM to OPI PSRAM. These match the module's 8 MB of flash and 8 MB of octal PSRAM.
  4. 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. Keep Tools > USB CDC On Boot at its default, Disabled: Serial then uses UART0, and that is where the CH340K is wired.

4. Upload your first program​

The board's RGB LED is a WS2812B, an addressable LED that takes colour data on one pin rather than a plain on/off level. It sits on GPIO6, and the core's rgbLedWrite() function drives it. This sketch blinks it white once a second, which is the quickest way to see that the upload worked.

Select Board
Blink.ino
// Blink the onboard WS2812B RGB LED (next to the IO6 label): 0.5 s on, 0.5 s off.
// The generic ESP32S3 Dev Module defines RGB_BUILTIN as GPIO48,
// so the pin is set here to this board's LED pin.
const uint8_t RGB_LED_PIN = 6;

void setup()
{
}

void loop()
{
rgbLedWrite(RGB_LED_PIN, 64, 64, 64); // LED on, white at a quarter of full brightness
delay(500);
rgbLedWrite(RGB_LED_PIN, 0, 0, 0); // LED off
delay(500);
}

rgbLedWrite(pin, red, green, blue) comes with the ESP32 board package. Equal red, green and blue values give white, and all three at 0 turn the LED off.

5. What to expect​

Click Upload in the Arduino IDE. The board has automatic reset, so the upload starts without you pressing a button. The sketch prints nothing to Serial Monitor; its result is on the board.

The RGB LED next to the IO6 label, just above the USER and RESET buttons, turns white for half a second and off for half a second.

6. Troubleshooting​

If the board is not detected or the upload fails, continue with Troubleshooting.