M5Stack-Core-ESP32

Modular ESP32 development kit with display and case - perfect for rapid IoT and UI-based prototyping.

USB-C
M5Stack-Core-ESP32 board
54 × 54 mm
ESP32
MCU
240MHz
clock
16MB
flash
520KB
SRAM
20· Two 12-bit, 18 Channels ADC
GPIO
BLE 4.2+ WiFi
radio
On this page

Pinout

20 pins
View:
M5Stack-Core-ESP32 pinout diagram
PinGPIOLabelsStatusCapabilitiesNotes
10G0strapping-
21TXG1PWMuartuart
32G2PWMstrapping-
43RXG3PWMuartuart
55SSG5PWMstrappingspi
612G12PWMstrapping-
713G13PWMstrapping-
815G15PWMstrapping-
916RXD2G16PWMstrapping-
1017TXD2G17PWMstrapping-
1118SCKG18PWMsafespi
1219MISOG19PWMsafespi
1321SDAG21PWMsafei2c
1422SCLG22PWMsafei2c
1523MOSIG23PWMsafespi
1625G25DAC1PWMsafedac
1726G26DAC2PWMsafedac
1834G34strapping-
1935G35ADC1strapping-
2036G36ADC2strapping-

Start with these

7 pins with no boot or system involvement
SCKG18MISOG19SDAG21SCLG22MOSIG23G25DAC1G26DAC2

Freely assignable - no strapping, flash, USB or JTAG duties. Ideal first picks for buttons, sensors and LEDs.

Fine - with a little care

sampled at boot or shared with debug/serial
PinLabelWhat to knowRole
G0GPIO0Must be HIGH during boot for normal startup; if held LOW on reset, forces flash programming mode.Strapping
G2GPIO2If driven HIGH on reset (while IO0 is LOW), selects an unsupported SDIO boot mode, causing boot failure.Strapping
SSGPIO5Must be HIGH during boot; if pulled LOW at reset, alters SDIO slave timing and may prevent normal boot.Strapping
G12MTDI (GPIO12)Keep LOW during boot (internal PD); pulling HIGH at reset selects 1.8V flash mode, causing flash brownout if 3.3V flash is used.Strapping
G13MTCK (GPIO13)Used for JTAG debugging (TCK); avoid using as GPIO if JTAG is needed.Other
G15MTDO (GPIO15)Keep HIGH during boot (internal PU); if LOW on reset, bootloader log is silenced and boot mode may change.Strapping
G34GPIO34Cannot be used as output (no drive capability); only suitable for analog/digital input.Other
G35GPIO35Cannot be used as output; only suitable for input.Other
G36GPIO36 (SENSOR_VP)Cannot be used as output; only suitable for input (e.g., analog read).Other

Only if you know the tricks

wired to flash or USB - expect a fight
PinLabelWhat to knowRole
TXU0TXD (GPIO1)Connected to on-board USB-UART for uploading and logs; drives serial output at boot, so using as GPIO can disrupt programming or console.USB
RXU0RXD (GPIO3)Used for receiving data from USB-UART (programming); also pulled HIGH at boot for console communication, so using as GPIO can disrupt uploads.USB
RXD2GPIO16Connected to internal PSRAM on PSRAM-enabled modules; not usable as GPIO on those modules.Flash
TXD2GPIO17Connected to internal PSRAM on PSRAM-enabled modules; not usable as GPIO on those modules.Flash
These are recommendations, not hard rules - with the right pull-ups, timing and boot-state awareness most pins can be made to work. When in doubt, start green.
Pinout notes The M5Stack-Core-ESP32 pinout brings out 20 GPIO pins - every one of them usable in your project. For peripherals, I²C is mapped to SDA on GPIO21 and SCL on…

The M5Stack-Core-ESP32 pinout brings out 20 GPIO pins - every one of them usable in your project.

For peripherals, I²C is mapped to SDA on GPIO21 and SCL on GPIO22; the SPI bus (MOSI, MISO, SCK, SS) is broken out in full; TX/RX on GPIO1 and GPIO3 cover serial logging and flashing.

On the analog side there are 2 true DAC outputs.

If you want zero surprises, SCK, MISO, SDA, SCL and 3 more are free of any such role - the safest first picks. 9 of the exposed pins carry boot-time or system duties on the ESP32 (G0, G2, SS and 6 more).

Getting started

flash your first firmware in ~2 minutes
Tool:
1
Connect over USB
Uses a CP2104 bridge - install the CP210x driver if no port appears. Not detected? Hold BOOT while plugging in.
2
Match & flash
Set the Tools options shown, then click Upload.
3
Verify it runs
The onboard LED on GPIO18 blinks - swap the pin if your board's LED differs.
Set these in Tools · leave everything else at default
Arduino IDE 2.x — Tools Copy
Board: "ESP32 Dev Module"
Flash Size: "16MB (128Mb)"
Flash Mode: "DIO"
Partition Scheme: "16M Flash (3MB APP / 9.9MB FATFS)" (default)
Upload Speed: "921600"
▸ every other Tools option — leave at default
Board: ESP32 Dev Module
Flash Size: 16MB (128Mb)
Flash Mode: DIO
Partition Scheme: 16M Flash (3MB APP / 9.9MB FATFS)
Upload Speed: 921600
Find it: Tools ▸ Board ▸ ESP32 Arduino ▸ ESP32 Dev Module
blink.ino Copy
// blink the onboard LED
void setup() {
  pinMode(18, OUTPUT);
}
void loop() {
  digitalWrite(18, HIGH); delay(500);
  digitalWrite(18, LOW);  delay(500);
}
board to selectesp32dev⧉ copy
platformio.ini Copy
[env:m5stack-core-esp32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600
Find it: PlatformIO Home ▸ Boards, search esp32dev — or type it after board =.
board to selectesp32dev⧉ copy
device.yaml Copy
esp32:
  board: esp32dev
  variant: m5stack_core_esp32
  framework:
    type: esp-idf

# blink - GPIO18
output:
  - platform: gpio
    pin: 18
    id: led_out
light:
  - platform: binary
    name: "LED"
    output: led_out
Find it: search ESPHome's board list for esp32dev (same ids as PlatformIO).
esptool doesn't pick board settings — a prebuilt .bin already has them baked in. This is just the raw flash command.
terminal Copy
esptool.py --chip esp32 --port /dev/ttyACM0 \
  --baud 921600 write_flash 0x0 firmware.bin
--port = your /dev/tty* (macOS/Linux) or COMx (Windows).
Build details: sketch space 1310720 B · data 327680 B · DIO

Specifications

ESP32 · 54 × 54 mm
Compute
MCU
ESP32
Clock
240 MHz
SRAM · Flash
520 KB · 16MB
Radio
Wi-Fi
802.11 b/g/n
Bluetooth
4.2 LE
Antenna
3D
I/O
GPIO · ADC
20 · Two 12-bit, 18 Channels
UART · I²C · SPI
3 · 2 · 4
PWM
16 channels
Power
USB
USB-C
Serial
CP2104
Boot address
0x1000
Display
Screen
LCD · 2.0" · 320x240
Driver
ILI9342C
Touch
No
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · DIO
Sketch · Data
1.25 MB · 320 KB
54 mm54 mm
54 × 54 mm
The M5Stack-Core-ESP32 uses esptool_py for firmware uploads, esp_ota for over-the-air (OTA) updates. Flash mode is DIO with DIO boot mode. The maximum sketch size is 1.25 MB with 320 KB available for data.

About this board

At its core is the ESP32 - a dual-core Xtensa with both Bluetooth Classic and BLE.

Expect to pay about $39.90 - above the ~$20 typical for ESP32 boards.

Onboard you'll find an LCD 2.0" 320x240 display, a microSD slot, a speaker (1W), battery charging (IP5306) and Button A/Button B/Button C buttons.

  • Built-in 110mAh LiPo battery
  • Grove HY2.0-4P (I2C / UART / IO) port
  • M-Bus stackable bottom connector

Where to buy

prices are typical street prices
M5Stack-Core-ESP32
M5Stack-Core-ESP32
$39.90per unit, typical

Resources

Similar boards