Skip to main content

Quick Start

Pick the tab for your development environment. Each one ends with the board's RGB LED (one LED with red, green and blue channels) blinking, which is the quickest way to see that everything works.

1. Install the platform​

Install the current Arduino IDE, at the 1.8 level or later. The current version is on the arduino.cc website.

2. Install the board definitions​

The board definition comes with Espressif's Arduino core for the ESP32.

  1. Start Arduino and open the Preferences window.

  2. Enter this stable release link into the Additional Board Manager URLs field. You can add several URLs, separated by commas.

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

  3. Open Boards Manager from the Tools > Board menu and install the esp32 platform.

  4. Restart the Arduino IDE.

Board definitionsArduino core for the ESP32Espressif's Arduino core. Version 3.3.12 includes the Soldered NULA Dual ESP32C5 board definition.

3. Select the board​

Select Soldered NULA Dual ESP32C5 from the Tools > Board menu. Then connect the board to your computer with the USB-C cable and choose its serial port in the Arduino IDE.

USB-C on this board goes through a CH340K USB-to-serial chip, so your computer may need a CH340 driver to show the port. If no port appears, see Troubleshooting.

4. Upload your first program​

The board has a WS2812B RGB LED on IO8, marked IO8 on the board. The board definition names it LED_BUILTIN, and digitalWrite() switches it on and off like a plain LED. This sketch blinks it once a second.

Select Board
Blink.ino
// Blink the onboard RGB LED: 0.5 s on, 0.5 s off.
// LED_BUILTIN comes from the board definition and points at the RGB LED on IO8.
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​

Upload the sketch. The automatic reset circuit puts the board into upload mode by itself, so you do not need to press any button. When the upload finishes, the RGB LED starts blinking. The Arduino core drives its red, green and blue channels together, so it lights white.

The RGB LED lights white for half a second, then stays off for half a second.

The LED marked IO8 sits between the USER and RESET buttons, near the USB-C end of the board, just beside the mounting hole on the side toward the ESP32-C5 module.

6. Troubleshooting​

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