The ESP32-S3 is a small Wi-Fi and Bluetooth LE microcontroller with enough memory to run a web server, drive a display or stream sensor data. This guide takes an ESP32-S3 N16R8 development board from the bag to a working test sketch, using the Arduino IDE settings that match its memory.
It is written around the ESP32-S3 N16R8 development board we stock in Auckland, which has pre-soldered headers, two USB-C ports and an antenna connector. Most of it applies to any N16R8 board.
What N16R8 means
The suffix describes the memory fitted to the board:
- N16 is 16 MB of flash, where your program and files are stored.
- R8 is 8 MB of PSRAM, extra working memory for things like image buffers, audio and large JSON documents.
Both numbers matter during setup. The Arduino IDE assumes a 4 MB board with no PSRAM unless you tell it otherwise, so a new N16R8 board often looks as if it has a quarter of its storage and none of its extra memory.
What you need
- One ESP32-S3 N16R8 development board.
- A USB cable that carries data, not just charging power. A short one is easier on the desk: our 30cm USB-A to USB-C data and charging cable is sold separately.
- A computer with the Arduino IDE installed.
A breadboard is optional. If you would rather use screw terminals than jumper wires, a 44-pin terminal breakout board carries a compatible board and brings each pin out to a terminal. Check your board’s pin spacing and layout against the breakout before fitting it.
Set up the Arduino IDE
- Open Boards Manager, search for esp32 and install the package published by Espressif Systems.
- Connect the board with your USB cable.
- Under Tools → Board, choose ESP32S3 Dev Module.
- Under Tools → Port, choose the port that appeared when you plugged the board in.
- Change the three settings in the table below. Leave the rest at their defaults to begin with.
| Tools menu setting | Default | Set it to |
|---|---|---|
| Flash Size | 4MB (32Mb) | 16MB (128Mb) |
| PSRAM | Disabled | OPI PSRAM |
| Partition Scheme | Default 4MB with spiffs | A 16M scheme, such as 16M Flash (2MB APP/12.5MB FATFS) |
OPI PSRAM is the setting for the eight-line (octal) PSRAM that R8 chips use. If you choose QSPI PSRAM instead, the sketch still uploads but the extra memory is not found.
Which USB-C port?
This board has two USB-C ports. According to the supplier’s hardware notes, the board uses an FT232 USB-to-serial chip, so one port reaches the ESP32-S3 through that chip. Read the labels printed beside the ports on your board, and start with the serial one: it works with the default USB CDC On Boot: Disabled setting.
If no port appears, try these in order:
- Swap the cable. Charge-only cables are the most common cause.
- Try the other USB-C port.
- Install the driver for the USB-to-serial chip if your operating system does not recognise it.
Run a first check
This sketch prints what the board reports about itself and cycles the on-board RGB LED, which is wired to GPIO48 on this board.
// First check for an ESP32-S3 N16R8 board: serial output, flash, PSRAM and the on-board RGB LED.
const uint8_t RGB_PIN = 48; // on-board WS2812 RGB LED on this board
void setup() {
Serial.begin(115200);
delay(1500); // give the serial monitor time to connect
Serial.printf("Chip: %s, %d cores, %lu MHz\n", ESP.getChipModel(), ESP.getChipCores(), (unsigned long)ESP.getCpuFreqMHz());
Serial.printf("Flash: %lu MB\n", (unsigned long)(ESP.getFlashChipSize() / (1024 * 1024)));
if (psramFound()) {
Serial.printf("PSRAM: %lu bytes\n", (unsigned long)ESP.getPsramSize());
} else {
Serial.println("PSRAM not found - check Tools > PSRAM is set to OPI PSRAM");
}
}
void loop() {
rgbLedWrite(RGB_PIN, 20, 0, 0); // red (kept dim: full brightness is 255)
delay(500);
rgbLedWrite(RGB_PIN, 0, 20, 0); // green
delay(500);
rgbLedWrite(RGB_PIN, 0, 0, 20); // blue
delay(500);
}
Upload it, then open Tools → Serial Monitor at 115200 baud. You are looking for three things:
- The flash line reads 16 MB.
- The PSRAM line shows a figure a little under 8 MB, rather than the “not found” message.
- The LED steps through red, green and blue.
If the flash or PSRAM line is wrong, the Tools menu settings above are the first place to look. rgbLedWrite belongs to version 3 of the ESP32 Arduino package; on version 2 the same function is called neopixelWrite.
Pins to leave alone
An ESP32-S3 has plenty of pins, but several already have a job. Espressif’s GPIO reference for the ESP32-S3 lists the ones to treat with care:
| GPIO | Why to avoid it for general wiring |
|---|---|
| 0, 3, 45, 46 | Strapping pins, read at power-up to decide how the chip boots |
| 19, 20 | USB data lines |
| 26 to 32 | Normally used for the flash and PSRAM |
| 33 to 37 | Used by octal PSRAM, so not recommended on R8 boards |
| 43, 44 | Default serial transmit and receive, used for uploads and log output |
| 48 | The on-board RGB LED on this board |
Two more habits prevent most early mistakes:
- Keep signals at 3.3 V. The pins are not 5 V tolerant. A 5 V sensor output needs a level shifter or a voltage divider.
- Use GPIO1 to GPIO10 for analogue readings in Wi-Fi projects. Those are the ADC1 pins. ADC2, on GPIO11 to GPIO20, is shared with Wi-Fi.
Always confirm a pin against the labels printed on your own board before wiring to it.
Wi-Fi in a New Zealand home
The ESP32-S3 uses 2.4 GHz Wi-Fi only. Many home routers broadcast 2.4 GHz and 5 GHz under one network name, which normally works, but if the board cannot find your network, check that the 2.4 GHz band is switched on in the router settings.
Signal strength depends heavily on where the board sits and what it is mounted in. We cover that, and how to measure it, in ESP32-S3 Wi-Fi range in a 3D printed case.
Where to go next
- Write, flash and debug firmware with Claude Code: a repeatable way to let an AI coding agent build and test your sketches.
- Design a PETG enclosure with AI and OpenSCAD: a printed case that fits the board you measured.
- Build a filament dry-box humidity monitor: a first complete project with a sensor and a web page.
- ESP32-S3 project ideas for NZ homes: seven builds worth printing a case for.
Browse the ESP32-S3 boards and accessories we stock, with New Zealand delivery or free pickup in Torbay, Auckland.
How this guide was put together. It was drafted with AI assistance. Board details come from our product listing and Espressif’s documentation, and the sketch was compiled against version 3.3.12 of the ESP32 Arduino package with the settings above. Check each step against your own board. This article is not a current stock list: check the ESP32-S3 range and the live PETG catalogue for current products, prices and stock.