M5Stack-ATOM

Ultra-compact ESP32 board with RGB LED and button - ideal for simple wireless triggers and automation nodes.

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

M5Stack-ATOM Pinout

19 pins
M5Stack-ATOM pinout diagram
PinGPIOLabelsStatusCapabilitiesNotes
10G0strapping-
21TXPWMuartuart
33RXPWMuartuart
49G9PWMstrapping-
510G10PWMstrapping-
612G12PWMstrapping-
719G19SSPWMsafespi
821G21PWMsafe-
922G22SCKPWMsafespi
1023G23MISOPWMsafespi
1125G25DAC1PWMsafedac
1226RXD2SDAG26DAC2PWMsafei2c · dac
1327G27PWMsafe-
1432TXD2SCLG32PWMsafei2c
1533G33MOSIPWMsafespi
1635ADC1strapping-
1736G36ADC2strapping-
1837G37strapping-
1939G39strapping-
19 GPIOs broken out 9 free · 8 need care · 2 to avoid

Start with these

9 pins with no boot or system involvement
G19GPIO19G21GPIO21G22GPIO22G23GPIO23G25GPIO25RXD2GPIO26G27GPIO27TXD2GPIO32G33GPIO33

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

Fine - with a little care

8 pins · 6 things to know
G0GPIO0 Bootstrapping pin (enter bootloader when low); internal pull-up. Strapping

Must be HIGH during boot for normal startup; if held LOW on reset, forces flash programming mode.

TXGPIO1 Default UART0 TX pin for USB-serial programming and console. UART

Connected to on-board USB-UART for uploading and logs; drives serial output at boot, so using as GPIO can disrupt programming or console.

RXGPIO3 Default UART0 RX pin for USB-serial programming (console input). UART

Used for receiving data from USB-UART (programming); also pulled HIGH at boot for console communication, so using as GPIO can disrupt uploads.

G12GPIO12 Bootstrapping pin; JTAG TDI; sets flash voltage (VDD_SDIO); also HSPIQ (flash data line). Strapping

Keep LOW during boot (internal PD); pulling HIGH at reset selects 1.8V flash mode, causing flash brownout if 3.3V flash is used.

ADC1GPIO35G37GPIO37G39GPIO39 Input-only GPIOs with ADC1 channels - no output driver Other

Cannot be used as output; only suitable for input.

  • ADC1Input-only GPIO (no output driver); ADC1 channel 7.
  • G37Input-only GPIO (no output); ADC1 channel 1.
  • G39Input-only GPIO (no output); ADC1 channel 3, Hall sensor VN.
G36GPIO36 Input-only GPIO (no output); ADC1 channel 0, Hall sensor VP. Other

Cannot be used as output; only suitable for input (e.g., analog read).

Only if you know the tricks

2 pins · 1 thing to know
G9GPIO9G10GPIO10 SPI flash/PSRAM data lines SD2 and SD3 (flash HOLD and WP) Flash

Used by internal flash/PSRAM; typically not exposed on modules, avoid using as GPIO.

  • G9Connected to SPI flash/PSRAM data 2 (SD2, flash HOLD).
  • G10Connected to SPI flash/PSRAM data 3 (SD3, flash WP).
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.

The M5Stack-ATOM pinout brings out 19 GPIO pins - every one of them usable in your project.

For peripherals, I²C is mapped to SDA on GPIO26 and SCL on GPIO32; 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, G19, G21, G22, G23 and 5 more are free of any such role - the safest first picks. 8 of the exposed pins carry boot-time or system duties on the ESP32 (G0, TX, RX and 5 more).

Getting started

flash your first firmware in ~2 minutes
Tool:
1
Connect over USB
Install your USB-serial driver (CH340 / CP210x) 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
GPIO19 toggles - wire an LED and resistor to it, or change the pin to your board's own LED.
Set these in Tools · leave everything else at default
Arduino IDE 2.x - Tools Copy
Board: "ESP32 Dev Module"▸
Flash Size: "4MB (32Mb)"▸
Flash Mode: "DIO"▸
Partition Scheme: "Default 4MB with spiffs (1.2MB APP/1.5MB SPIFFS)" (default)▸
Upload Speed: "921600"▸
▸ every other Tools option - leave at default
Board: ESP32 Dev Module
Flash Size: 4MB (32Mb)
Flash Mode: DIO
Partition Scheme: Default 4MB with spiffs (1.2MB APP/1.5MB SPIFFS)
Upload Speed: 921600
Find it: Tools ▸ Board ▸ ESP32 Arduino ▸ ESP32 Dev Module
blink.ino Copy
// toggle GPIO19 - wire an LED and resistor to it
void setup() {
  pinMode(19, OUTPUT);
}
void loop() {
  digitalWrite(19, HIGH); delay(500);
  digitalWrite(19, LOW);  delay(500);
}
board to selectesp32dev⧉ copy
platformio.ini Copy
[env:m5stack-atom]
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: esp32
  framework:
    type: esp-idf

# blink - GPIO19
output:
  - platform: gpio
    pin: 19
    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 0x1000 firmware.bin
--port = your /dev/tty* (macOS/Linux) or COMx (Windows).
Build details: sketch space 1310720 B · data 327680 B · DIO

Specifications

ESP32 · 24 × 24 mm · vs other ESP32 chips →
Compute
MCU
ESP32
Clock
240 MHz
SRAM · Flash
520 KB · 4MB
Radio
Wi-Fi
802.11 b/g/n
Bluetooth
4.2 LE
Antenna
3D
I/O
GPIO · ADC
19 · Two 12-bit, 18 Channels
UART · I²C · SPI
3 · 2 · 2
PWM
16 channels
Power
USB
USB-C
Serial
-
Boot address
0x1000
Electrical
Input
5V
Consumption
-
Regulator
-
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · DIO
Sketch · Data
1.25 MB · 320 KB

Dimensions

24 mm24 mm
24 × 24 mm
The M5Stack-ATOM 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 $7.50 - less than the ~$20 most ESP32 boards go for.

Only 19 GPIO are broken out, where most ESP32 boards manage about 24 - worth checking the pinout covers what you need.

Onboard you'll find a Grove connector, an addressable RGB LED (GPIO27), an IR transceiver and User buttons.

Where to buy

prices are typical street prices
M5Stack-ATOM
M5Stack-ATOM
$7.50per unit, typical
The M5 Stack store link is an affiliate link - ESPboards may earn a commission on purchases, at no extra cost to you.

Resources

Similar boards