Adafruit MagTag 2.9"

Development Board

Code name: MAGTAG29_ESP32S2

ESP32S2 ADAFRUIT

Adafruit MagTag 2.9" is a development board based on the ESP32S2 microcontroller using XTENSA architecture.

This board features a maximum CPU frequency of 240 MHz and 4MB flash memory.

About Adafruit MagTag 2.9"

ESP32-S2 board with a 2.9" E-Ink display - perfect for low-power dashboards, signage, and to-do lists.

Technical Specifications

Complete technical specification details for Adafruit MagTag 2.9"

Display

Type ePaper

Size 2.9"

Resolution 296x128

Connectivity

WiFi 802.11 b/g/n 2.4 GHz

Bluetooth -

BLE -

Microcontroller

Model esp32s2

Clock Speed 240 MHz

Flash Size 4MB

PSRAM 2MB

Architecture xtensa

✨ Features & Pins

Digital IO 48

Analog Input 20

PWM 28

Interrupts 46

Quick Setup

Copy-paste configs for Adafruit MagTag 2.9" - auto‑generated from this board's exact hardware specs.

ESP32S2 240 MHz 4MB DIO Xtensa

In Arduino IDE 2 select Magtag29 Esp32s2 from the esp32 by Espressif package. In PlatformIO use board = esp32-s2-saola-1. ESP32S2 · 240 MHz · 4MB · DIO.

Tools menu settings

Board (select in Arduino IDE) Magtag29 Esp32s2

CPU Frequency 240 MHz

Flash Size 4MB

Flash Mode DIO

Upload Speed 921600

Architecture Xtensa

In Arduino IDE 2, open Boards Manager, search "esp32" by Espressif and install it. Then go to Tools → Board and select "Magtag29 Esp32s2" for the Adafruit MagTag 2.9".

platformio.ini


[env:adafruit_magtag29_esp32s2]
platform  = espressif32
board     = esp32-s2-saola-1
framework = arduino

; Exact hardware config for Adafruit MagTag 2.9&quot;
board_build.mcu        = esp32s2
board_build.f_cpu      = 240000000L
board_build.flash_size = 4MB
board_build.flash_mode = dio
board_upload.flash_size = 4MB

The board value is a close generic match - check PlatformIO board registry for an exact fit.

esp32: block (YAML)


esp32:
  board: esp32-s2-saola-1
  framework:
    type: arduino   # or "esp-idf"

# Adafruit MagTag 2.9&quot; - 240 MHz ESP32S2
# Flash: 4MB | USB: N/A

Paste into your device's .yaml. See ESPHome ESP32 docs for full options.

esptool.py - flash command


esptool.py \
  --chip esp32s2 \
  --baud 921600 \
  write_flash \
    --flash_mode dio \
    --flash_size 4MB \
    0x1000 bootloader.bin \
    0x8000    partitions.bin \
    0xe000    boot_app0.bin \
    0x10000   firmware.bin

Install: pip install esptool - replace firmware.bin with your binary - bootloader at 0x1000

Adafruit MagTag 2.9" Pinout Diagram

Complete pin reference for Adafruit MagTag 2.9"

Useful Links

Datasheets and resources for Adafruit MagTag 2.9"

ESP32S2 Datasheet

Microcontroller reference

Pin Mappings

Complete pinout and GPIO mapping for Adafruit MagTag 2.9"

Digital I/O Pins

Interrupt Pins

Analog Inputs

PWM Pins

Pin	Analog	Touch	PWM	Other
0
1	A2		PWM
2	A3		PWM
3	A4		PWM	LIGHT_SENSOR
4	A5		PWM	NEOPIXEL_NUM BATT_MONITOR
5	A6		PWM	EPD_BUSY
6	A7		PWM	EPD_RESET
7	A8		PWM	EPD_DC
8	A9		PWM	EPD_CS SS
9	A10		PWM	ACCEL_IRQ
10	A11	T10	PWM
11	A12		PWM
12	A13		PWM
13	A14		PWM	LED_BUILTIN
14	A15		PWM
15	A16		PWM
16	A17		PWM	SPEAKER_SHUTDOWN
17	A0		PWM	DAC1
18	A1		PWM	DAC2
19	A18		PWM
20	A19		PWM
21			PWM	NEOPIXEL_POWER
33			PWM	SDA
34			PWM	SCL
35			PWM	MOSI
36			PWM	SCK
37			PWM	MISO
43			PWM	TX
44			PWM	RX
PIN_BUTTON1				BUTTON_A
PIN_BUTTON2				BUTTON_B
PIN_BUTTON3				BUTTON_C
PIN_BUTTON4				BUTTON_D

Legend

A0 Analog input

T0 Touch sensor

PWM PWM capable

RX/TX Serial pins

LED Built-in LED

# Pin number

Default Tools & Configuration

Build and upload settings for Adafruit MagTag 2.9"

Setting	Value
Bootloader tool	esptool_py
Uploader tool	esptool_py
Network uploader tool	esp_ota
Bootloader address	`0x1000`
Flash mode	dio
Boot mode	qio
Maximum upload size	1280 KB (1310720 bytes)
Maximum data size	320 KB (327680 bytes)