Boards and variants
Boards we build for
Every board here is one of upstream’s, with at most a small variant of ours on
top. Add --modules to any of these:
Board |
Command |
|---|---|
Waveshare ESP32-P4-WIFI6-DEV-KIT, USB device on a USB-C wired to header P6 |
|
Waveshare ESP32-P4-WIFI6-DEV-KIT, USB device on its USB-C marked “USB” |
|
Waveshare ESP32-P4-WIFI6, the Pico-sized board, USB device on header pins 19 (D-) and 20 (D+) |
|
Waveshare ESP32-P4-WIFI6-Touch-LCD-4B |
|
Espressif ESP32-P4X-EYE |
|
Another ESP32-P4 board, chip revision 3 or later, with an ESP32-C6 for Wi-Fi |
|
Waveshare ESP32-S3-Touch-LCD-7 |
|
Waveshare ESP32-S3-Touch-LCD-4.3 |
|
LilyGO T-Embed S3 |
|
Ai-Thinker ESP32-Audio-Kit (ESP32-A1S), CPU at 240 MHz, flash and PSRAM at 80 MHz |
|
Adafruit Qualia ESP32-S3, LilyGO T-Display-S3, LilyGO T-HMI: S3 boards with octal PSRAM |
|
Adafruit QT Py ESP32-S3 that has 2 MB of PSRAM, WT32-SC01 Plus, Unexpected Maker FeatherS3 and other S3 boards with quad PSRAM |
|
An S3 board with no PSRAM, such as the QT Py ESP32-S3 that has none |
|
Adafruit QT Py ESP32 Pico (8 MB flash, 2 MB PSRAM), CPU at 240 MHz, flash and PSRAM at 80 MHz |
|
Raspberry Pi Pico (RP2040) |
|
Raspberry Pi Pico 2 (RP2350) |
|
Pimoroni Pico Plus 2 W (16 MB flash, 8 MB PSRAM, 48 GPIOs) |
|
Arduino GIGA R1 WiFi |
|
Arduino GIGA R1 WiFi, playing through its headphone jack ( |
|
Arduino GIGA R1 WiFi with the GIGA Display Shield |
|
Every ESP32 board here runs its CPU at the chip’s rated clock (240 MHz on an ESP32 or S3; 400 on a P4 of revision 3 or later, 360 before that), and its flash and PSRAM at the fastest clock its chips are rated for: 80 MHz or more, except the flash of a P4 image for revisions before 3, which ESP-IDF holds to 40 MHz. Add a board variant says how a new board does the same.
Every rp2 board runs its CPU at the chip’s rated clock too: 200 MHz on an RP2040, where the SDK’s default is 125, and 150 on an RP2350.
Our ESP32-S3 builds keep the TLS library in PSRAM, and on an S3 without it,
Wi-Fi can’t join a WPA2 network. Most S3 boards have PSRAM. For one that
doesn’t, build the NO_PSRAM variant, which keeps TLS in internal RAM. It
leaves out LVGL and the other modules that want megabytes of heap, so name the
modules you need.
Adafruit sells the QT Py ESP32-S3 with and without PSRAM, and the two need
different images. To tell which you have, plug the board in and run
esptool chip-id: a board with PSRAM has an Embedded PSRAM entry on its
Features line, and one without has none. With it, take the quad-PSRAM image
(ESP32_GENERIC_S3, no variant); without it, the NO_PSRAM image. The
quad-PSRAM image boots on a board with none, but the board can’t join a WPA2
network.
For a board that isn’t listed, see Build for a board.
Variants
Our variants, in variants/.
Port |
Variant |
What it is |
|---|---|---|
unix |
|
Upstream’s standard variant plus |
unix |
|
The interpreter inside the micropython-vst3 plug-in: no sockets, no SSL, no FFI. |
windows |
|
The same as unix |
windows |
|
The same as unix |
webassembly |
|
The browser runtime, with the |
esp32 |
|
The ESP32 Audio Kit: upstream’s PSRAM variant with flash and PSRAM at 80 MHz, which keeps Bluetooth call audio whole while a program is busy, and the CPU at 240 MHz, which lets a 48 kHz synth run with its reverb. A 128 KB ROMFS partition runs your own compiled packages from flash. |
esp32 |
|
An S3 with no PSRAM: upstream’s generic build without its PSRAM settings, TLS in internal RAM, and the caches and Wi-Fi buffers at sizes internal RAM can spare. |
esp32 |
|
The S3 boards in the table above. |
esp32 |
|
The P4 DEV-KIT, with the USB device on the two different connectors in the table above. The Pico-sized ESP32-P4-WIFI6 has the same C6 wiring, and |
esp32 |
|
The ESP32-P4X-EYE: |
esp32 |
|
The QT Py ESP32 Pico: upstream’s PSRAM variant with flash and PSRAM at 80 MHz, which keeps Bluetooth audio from falling behind, and the CPU at 240 MHz. |
rp2 |
|
The Pimoroni Pico Plus 2 W. |
stm32 |
|
The GIGA R1 WiFi with room for LVGL and the shield’s MIPI DSI panel: the Wi-Fi and Bluetooth firmware moved to QSPI flash as a second image, its Python modules in a ROMFS image instead of frozen, Bluetooth LE through NimBLE, a one-dimensional ulab with numpy’s array core and elementwise maths only (what’s out), LVGL’s 40 px font left out, and USB through TinyUSB: |
The esp32 variants/esp32/ folder also holds the sdkconfig fragments and
partition table every esp32 or every chip gets:
Add a board variant says how they combine.
CircuitPython boards
With --interpreter circuitpython, boards are CircuitPython’s own. These are
ours, in boards/circuitpython/, for boards CircuitPython has no definition for:
Board |
What it is |
|---|---|
|
A Feather RP2040 with room for LVGL. |
|
The 800x480 panel as |
|
The same 800x480 panel as |
|
The Adafruit Qualia ESP32-S3 for RGB666 displays with one 6 MB app slot and no UF2 bootloader, so LVGL and the audio packages fit; flash it with esptool. CIRCUITPY is now 10,176 KB at 0x610000, so copy your files off before you first flash one. |
|
The T-Watch S3 with one 6 MB app slot, so LVGL and the audio packages fit, and the Qualia’s 10,176 KB CIRCUITPY. |
|
A revision 3 chip, console on USB Serial/JTAG, one 6 MB app slot. |
|
Revision 1, console on the CH343 UART, one 6 MB app slot. Its panel isn’t set up. |