The ESP32-S2 Mini is a 34.3 × 25.4 mm Wi-Fi development board built on Espressif's ESP32-S2 (single-core 240 MHz Xtensa LX7), with 4 MB flash and native USB on a USB-C port.
It follows the LOLIN S2 Mini layout, so it is supported as the "LOLIN S2 Mini" board in Arduino IDE and has ready-made MicroPython and CircuitPython firmware. It suits small Wi-Fi projects and USB devices where you don't need Bluetooth.
Why choose it
- Native USB — the ESP32-S2 has full-speed USB OTG built in, so the USB-C port talks to your computer directly, with no separate USB-serial chip on the board.
- Room for bigger programs — 4 MB flash on top of the chip's 320 KB SRAM, enough for MicroPython, CircuitPython and web-page projects.
- Small, with lots of pins — 27 I/O pins on a 34.3 × 25.4 mm board that uses the LOLIN D1 mini shield footprint.
Specifications
| Core | |
|---|---|
| SoC | ESP32-S2 (Espressif) |
| CPU | Xtensa single-core 32-bit LX7, up to 240 MHz |
| ROM | 128 KB |
| SRAM | 320 KB (+ 16 KB RTC SRAM) |
| Flash | 4 MB (in chip package) |
| Wireless | |
| Wi-Fi | IEEE 802.11 b/g/n, 2.4 GHz |
| Bluetooth | None — the ESP32-S2 has no Bluetooth |
| I/O | |
| I/O pins | 27 |
| ADC | 12-bit SAR ADC |
| DAC | 2 × 8-bit (GPIO17, GPIO18) |
| Touch pins | GPIO1 – GPIO14 |
| Interfaces | I2C, SPI, UART, USB OTG (full-speed) |
| On-board LED | GPIO15 |
| Buttons | RST (reset) and 0 (GPIO0, BOOT) |
| Power | |
| Logic / I/O voltage | 3.3 V |
| USB input | 5 V via USB-C (VBUS pin) |
| Physical | |
| USB connector | USB-C |
| Dimensions | 34.3 × 25.4 mm |
| Weight | 2.4 g |
Compatibility
| Platform | Works | Notes |
|---|---|---|
| 5 V boards and modules (Arduino UNO / Nano) | ◐ With adapter | The I/O pins are 3.3 V. Use a logic level shifter for 5 V signals. |
| 3.3 V sensors and modules (I2C, SPI, UART) | ✓ Yes | Connect directly. Pick the I2C pins in your code (see Good to know). |
| LOLIN D1 mini shields | ✓ Yes | Same footprint (per WEMOS). Pin functions differ from the ESP8266 D1 mini, so check the shield's pins. |
| Bluetooth projects | ✗ No | No Bluetooth radio. Choose an ESP32, ESP32-C3 or ESP32-S3 board instead. |
| Arduino IDE | ✓ Yes | "esp32 by Espressif Systems", board "LOLIN S2 Mini" |
| MicroPython / CircuitPython | ✓ Yes | Official LOLIN_S2_MINI / lolin_s2_mini firmware |
| ESP-IDF | ✓ Yes | Target esp32s2 |
In the box
- 1 × ESP32-S2 Mini development board
- 4 × 8-pin male headers
Applications
- Wi-Fi sensor nodes that send readings to a home server or dashboard
- Small web-controlled switches and status lights on your home network
- USB devices such as a custom keyboard or macro pad, using the built-in USB
- Learning MicroPython or CircuitPython on a low-cost Wi-Fi board
Tutorial
What you'll build: make the on-board LED blink, list the Wi-Fi networks near you, then switch the LED on and off from your phone. No wiring needed · About 30 minutes.
Part 1 — Set up Arduino IDE (once only)
Download and install Arduino IDE 2 for Windows, macOS or Linux.
Open File → Preferences (macOS: Arduino IDE → Settings). In Additional boards manager URLs, paste:
https://espressif.github.io/arduino-esp32/package_esp32_index.jsonClick OK. (Official install guide)
Open Tools → Board → Boards Manager, search esp32, and install "esp32 by Espressif Systems". This can take a few minutes.
Go to Tools → Board → esp32 and pick LOLIN S2 Mini. Leave Tools → USB CDC On Boot on Enabled (the default) — this sends
Serial messages over the USB-C port.✓ Check: Tools → Board shows "LOLIN S2 Mini".
Part 2 — Upload your first sketch
Connect the board with a data USB-C cable (charge-only cables don't work). The first time, put it into upload mode: hold the 0 button, press and release RST, then release 0. A new port appears under Tools → Port — select it. The ESP32-S2 uses its own USB. If no port appears, use a data USB cable (not charge-only) and install the USB driver for your board.
Copy Example 1 into a new sketch and click Upload (→). When the IDE says it is done, press RST once to start your program. If the upload fails, set Tools → Upload Speed → 115200 and upload again.
▸ Example 1 — Blink the on-board LED
// ESP32-S2 Mini - Example 1: blink the on-board LED and print to the Serial Monitor
// Wiring: nothing to wire - the LED is on the board (GPIO15)
const int LED_PIN = 15; // on-board LED on GPIO15 (same as LED_BUILTIN)
const unsigned long BLINK_MS = 500; // ✏️ you can change this (milliseconds)
void setup() {
Serial.begin(115200); // speed must match the Serial Monitor
delay(1500); // give the built-in USB port time to connect
pinMode(LED_PIN, OUTPUT); // the LED pin is an output
Serial.println("OK - epartners.co.nz test");
}
void loop() {
digitalWrite(LED_PIN, HIGH); // LED on
Serial.println("LED on");
delay(BLINK_MS);
digitalWrite(LED_PIN, LOW); // LED off
Serial.println("LED off");
delay(BLINK_MS);
}
After reset the port name can change — re-select it under Tools → Port, then open Tools → Serial Monitor and set the speed to 115200 baud (115200 is the "talking speed" set in the sketch).
✓ Check: The on-board LED blinks every half second, and the Serial Monitor prints "OK - epartners.co.nz test" once, then "LED on" / "LED off". If you miss the first line, press RST.
Next uploads: with "USB CDC On Boot" enabled, you can usually just click Upload. If the port disappears or the upload won't start, use the 0 + RST button method from step 5 again.
Part 3 — First Wi-Fi projects
Upload Example 2 and open the Serial Monitor (115200 baud). The board only uses 2.4 GHz Wi-Fi — 5 GHz-only networks will not appear.
▸ Example 2 — Wi-Fi scanner
// ESP32-S2 Mini - Example 2: list the Wi-Fi networks around you
// Wiring: nothing to wire
#include <WiFi.h>
void setup() {
Serial.begin(115200);
delay(1500); // give the built-in USB port time to connect
WiFi.mode(WIFI_STA); // station mode = join networks, don't create one
WiFi.disconnect();
Serial.println("OK - epartners.co.nz test");
}
void loop() {
Serial.println("Scanning...");
int count = WiFi.scanNetworks(); // returns how many networks were found
if (count == 0) {
Serial.println("No networks found");
} else {
for (int i = 0; i < count; i++) {
Serial.print(i + 1);
Serial.print(": ");
Serial.print(WiFi.SSID(i)); // network name
Serial.print(" (");
Serial.print(WiFi.RSSI(i)); // signal strength in dBm, closer to 0 = stronger
Serial.println(" dBm)");
}
}
WiFi.scanDelete(); // free the memory used by the scan
delay(10000); // ✏️ you can change this - wait 10 s before the next scan
}
✓ Check: Every 10 seconds you see a numbered list of nearby network names with their signal strength, e.g. "1: MyHomeWiFi (-52 dBm)".
In Example 3, type your Wi-Fi name and password on the two lines marked ✏️, then upload it. Keep your phone on the same Wi-Fi network.
▸ Example 3 — Web page LED switch
// ESP32-S2 Mini - Example 3: switch the on-board LED from your phone over Wi-Fi
// Wiring: nothing to wire - the LED is on the board (GPIO15)
#include <WiFi.h>
#include <WebServer.h>
const char* WIFI_SSID = "YOUR_WIFI_NAME"; // ✏️ your 2.4 GHz Wi-Fi name
const char* WIFI_PASS = "YOUR_WIFI_PASSWORD"; // ✏️ your Wi-Fi password
const int LED_PIN = 15; // on-board LED on GPIO15
WebServer server(80); // web server on port 80 (normal http)
bool ledOn = false;
void sendPage() {
String page = "<!DOCTYPE html><html><head>";
page += "<meta name='viewport' content='width=device-width, initial-scale=1'>";
page += "</head><body style='font-family:sans-serif; text-align:center;'>";
page += "<h1>ESP32-S2 Mini</h1><p>LED is ";
page += ledOn ? "ON" : "OFF";
page += "</p><p><a href='/on'><button>ON</button></a> ";
page += "<a href='/off'><button>OFF</button></a></p></body></html>";
server.send(200, "text/html", page);
}
void handleOn() { ledOn = true; digitalWrite(LED_PIN, HIGH); sendPage(); }
void handleOff() { ledOn = false; digitalWrite(LED_PIN, LOW); sendPage(); }
void setup() {
Serial.begin(115200);
delay(1500); // give the built-in USB port time to connect
pinMode(LED_PIN, OUTPUT);
digitalWrite(LED_PIN, LOW);
Serial.println("OK - epartners.co.nz test");
WiFi.mode(WIFI_STA);
WiFi.begin(WIFI_SSID, WIFI_PASS);
Serial.print("Connecting to Wi-Fi");
int tries = 0;
while (WiFi.status() != WL_CONNECTED && tries < 40) { // wait up to 20 seconds
delay(500);
Serial.print(".");
tries++;
}
if (WiFi.status() != WL_CONNECTED) {
Serial.println();
Serial.println("Wi-Fi not connected - check the name and password");
return; // stop here; press RST to try again
}
Serial.println();
Serial.print("Open this address in your browser: http://");
Serial.println(WiFi.localIP());
server.on("/", sendPage); // home page
server.on("/on", handleOn); // LED on
server.on("/off", handleOff); // LED off
server.begin();
}
void loop() {
server.handleClient(); // answer browser requests
}
The Serial Monitor prints an address such as
http://192.168.1.42. Type it into your phone or computer browser and tap ON or OFF.✓ Check: The page shows "LED is ON" and the on-board LED lights; tap OFF and it goes out. If you see "Wi-Fi not connected", check the name and password, then press RST.
Prefer Python? Download the LOLIN_S2_MINI firmware from micropython.org and follow the install steps on that page, then use Thonny with the interpreter set to MicroPython (ESP32). CircuitPython firmware is on circuitpython.org.
Troubleshooting
| Problem | Likely cause | Fix |
|---|---|---|
| No port appears in Tools → Port | Charge-only cable, or the board isn't in upload mode | Use a data cable. Hold 0, press and release RST, release 0, then check the port list again |
| Upload fails or stops part-way | Upload speed too high for the USB cable or USB chip | Tools → Upload Speed → 115200, then upload again |
| Upload finished but nothing happens | The board is still in upload mode | Press RST once |
| Serial Monitor stays blank | USB CDC On Boot is disabled, the port changed after reset, or wrong speed | Tools → USB CDC On Boot → Enabled, re-select the port, set 115200 baud, press RST |
| Wi-Fi won't connect | 5 GHz network, or wrong name/password | Use a 2.4 GHz network and check the spelling (it is case-sensitive) |
| Bluetooth sketch won't compile | The ESP32-S2 has no Bluetooth | Use an ESP32, ESP32-C3 or ESP32-S3 board for Bluetooth projects |
Try next: add a second button to the web page that makes the LED blink, or read a 3.3 V I2C sensor and show its value on the page.
Spotted a problem in this tutorial? Email support@epartners.co.nz and we'll check it and update the tutorial.
- The I/O pins are 3.3 V only. Never connect a 5 V signal straight to a pin — use a level shifter.
- There is no Bluetooth on the ESP32-S2. For Bluetooth, choose an ESP32, ESP32-C3 or ESP32-S3 board.
- Pin cards for this board don't all agree on the I2C pins (the Arduino "LOLIN S2 Mini" definition uses SDA = GPIO33, SCL = GPIO35). Set your pins in code, e.g.
Wire.begin(33, 35);, and check the labels printed on your board.
Video guide
Datasheet
Key figures from the manufacturer's datasheet for the ESP32-S2FN4R2, the system-on-chip on this board.
| ESP32-S2FN4R2 system-on-chip | |
|---|---|
| Core | Xtensa single-core 32-bit LX7, up to 240 MHz |
| ROM | 128 KB |
| SRAM | 320 KB |
| RTC SRAM | 16 KB |
| Wi-Fi | IEEE 802.11 b/g/n, 2.4 GHz, up to 150 Mbps (1T1R) |
| Bluetooth | Not listed in the datasheet; Wi-Fi only |
| Programmable GPIOs | 43 (on the chip; fewer are broken out on the board) |
| ADC | Two 12-bit SAR ADCs, up to 20 channels |
| DAC | Two 8-bit DACs |
| Serial interfaces | 4 × SPI, 2 × I2C, 2 × UART, I2S |
| USB | Full-speed USB OTG |
| Touch sensing | 14 touch-sensing GPIOs |
| Variant ordered | ESP32-S2FN4R2: 4 MB in-package flash, 2 MB in-package PSRAM, ambient –40 to 85 °C |
| Package | QFN56 (7 × 7 mm) |
Download the ESP32-S2 datasheet (PDF)
▸ Preview the datasheet
If the preview does not load on your device, use the download link above.
Source: Espressif Systems, ESP32-S2 Series Datasheet, version 1.9.
Resources
- ESP32-S2 datasheet (PDF, Espressif)
- LOLIN S2 Mini documentation (WEMOS) · schematic (PDF)
- Arduino-ESP32 installation guide (Espressif)
- LOLIN S2 Mini pin definitions in Arduino-ESP32 (GitHub)
- MicroPython firmware for LOLIN S2 Mini · CircuitPython firmware
- Arduino IDE download · Thonny
Which one should I choose?
| Product | Key difference | Best for |
|---|---|---|
| This product — ESP32-S2 Mini | Single-core 240 MHz LX7, Wi-Fi only, native USB | Small Wi-Fi and USB-device projects |
| ESP32-C3 Mini | Single-core RISC-V up to 160 MHz, Wi-Fi + Bluetooth LE | Tiny projects that need Bluetooth LE |
| ESP32 (USB-C) | Dual-core 240 MHz, Wi-Fi + Bluetooth 4.2 (Classic + BLE) | Classic Bluetooth and the widest range of tutorials |
| ESP32-S3 N16R8 | Dual-core 240 MHz LX7, 16 MB flash, 8 MB PSRAM, Wi-Fi + Bluetooth LE | Bigger programs, cameras and displays |
FAQ
▸ Does the ESP32-S2 Mini have Bluetooth?
No. The ESP32-S2 chip has 2.4 GHz Wi-Fi only. For Bluetooth, choose an ESP32, ESP32-C3 or ESP32-S3 board.
▸ Do I need to install a USB driver?
No. The board has no separate USB-serial chip — the ESP32-S2's own USB is wired to the USB-C port, so it normally shows up as a USB serial port by itself. If no port appears, use a data USB cable (not charge-only) and install the USB driver for your board.
▸ Which board do I select in Arduino IDE?
Select LOLIN S2 Mini under Tools → Board → esp32, after installing "esp32 by Espressif Systems". Keep "USB CDC On Boot" enabled so Serial prints over USB.
▸ Why does the port disappear when I upload or press RST?
That is normal for native USB: the port is created by the chip itself, so it drops out during reset and may come back with a new name. Re-select it in Tools → Port. If it doesn't come back, hold 0, press RST, release 0.
▸ Can I connect 5 V sensors?
Not directly. The pins are 3.3 V. Power a 5 V sensor from 5 V if it needs it, but pass its signal through a logic level shifter before it reaches the board.
▸ Can I use MicroPython or CircuitPython?
Yes. There is official MicroPython firmware (LOLIN_S2_MINI) on micropython.org and CircuitPython firmware (lolin_s2_mini) on circuitpython.org — links are in Resources.
Technical question about this part? Email support@epartners.co.nz with your board and wiring, and we'll help you get it working.
Shipping: $5.99 urban, $9.99 rural. Free shipping on orders of $100 or more.
Order by 10:30am (NZT), Monday to Friday, and we dispatch the same day. Orders placed after 10:30am, on weekends or on public holidays are dispatched the next business day.
Delivery usually takes 1–2 business days after dispatch (2–3 for rural addresses). See our Shipping Policy for full details.