MagicBit
ESP32-based educational board with sensors, display, and expansion - great for IoT learning and STEM kits.
MagicBit Pinout
26 pins| Pin | GPIO | Labels | Status | Capabilities | Notes |
|---|---|---|---|---|---|
| 1 | 0 | A11T1 | strapping | adc · touch | |
| 2 | 1 | TXPWM | uart | uart | |
| 3 | 2 | A12T2PWM | strapping | adc · touch | |
| 4 | 3 | RXPWM | uart | uart | |
| 5 | 4 | A10T0PWM | strapping | adc · touch | |
| 6 | 5 | SSPWM | strapping | spi | |
| 7 | 12 | A15T5PWM | strapping | adc · touch | |
| 8 | 13 | A14T4PWM | strapping | adc · touch | |
| 9 | 14 | A16T6PWM | strapping | adc · touch | |
| 10 | 15 | A13T3PWM | strapping | adc · touch | |
| 11 | 16 | GREEN_LEDMOTOR2APWM | strapping | - | |
| 12 | 17 | BLUE_LEDMOTOR2BPWM | strapping | - | |
| 13 | 18 | SCKYELLOW_LEDMOTOR1BPWM | safe | spi | |
| 14 | 19 | MISOPWM | safe | spi | |
| 15 | 21 | SDAPWM | safe | i2c | |
| 16 | 22 | SCLPWM | safe | i2c | |
| 17 | 23 | MOSIPWM | safe | spi | |
| 18 | 25 | A18DAC1BUZZERPWM | safe | adc · dac | |
| 19 | 26 | A19DAC2PWM | safe | adc · dac | |
| 20 | 27 | A17T7RED_LEDMOTOR1APWM | safe | adc · touch | |
| 21 | 32 | A4T9PWM | safe | adc · touch | |
| 22 | 33 | A5T8PWM | safe | adc · touch | |
| 23 | 34 | A6RIGHT_BUTTON | strapping | adc | |
| 24 | 35 | A7LEFT_BUTTON | strapping | adc | |
| 25 | 36 | A0LDR | strapping | adc | |
| 26 | 39 | A3POT | strapping | adc |
Start with these
10 pins with no boot or system involvementFreely assignable - no strapping, flash, USB or JTAG duties. Ideal first picks for buttons, sensors and LEDs.
Fine - with a little care
16 pins · 14 things to knowA11GPIO0 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.
A12GPIO2 Bootstrapping pin (must be low or floating at reset); internal pull-down. Strapping
If driven HIGH on reset (while IO0 is LOW), selects an unsupported SDIO boot mode, causing boot failure.
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.
A10GPIO4 Bootstrapping pin; internal pull-down; also HSPIHD (flash data line) on modules with internal flash. Strapping
Sampled at reset for boot config; should not be driven at boot (affects boot mode timing).
SSGPIO5 Bootstrapping pin; internal pull-up; VSPI CS0 (default SPI chip-select); acts as FSPIWP (flash write-protect) on internal-flash variants. Strapping
Must be HIGH during boot; if pulled LOW at reset, alters SDIO slave timing and may prevent normal boot.
A15GPIO12 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.
A14GPIO13 JTAG clock pin (TCK); also ADC2 channel 4 / Touch4 input. JTAG
Used for JTAG debugging (TCK); avoid using as GPIO if JTAG is needed.
A16GPIO14 JTAG mode select pin (TMS); also HSPI CLK and PWM-capable GPIO. JTAG
Used for JTAG debugging (TMS); driving it as GPIO may interfere with JTAG or produce spurious signals at boot.
A13GPIO15 Bootstrapping pin; JTAG TDO; controls UART0 boot log output; also HSPICS0 (secondary SPI CS). Strapping
Keep HIGH during boot (internal PU); if LOW on reset, bootloader log is silenced and boot mode may change.
GREEN_LEDGPIO16BLUE_LEDGPIO17 PSRAM chip select and clock on WROVER-class modules; in-package flash lines on ESP32-U4WDH. Both also carry UART2 PSRAM
Wired to the memory die on PSRAM-equipped modules (WROVER, PICO-V3-02) and on in-package-memory chip variants (U4WDH, D0WDRH2-V3); an ordinary GPIO on a plain WROOM-32.
- GREEN_LEDPSRAM CS# on WROVER-class modules and on ESP32-D0WDRH2-V3; in-package flash CS# on ESP32-U4WDH. Also UART2 RX.
- BLUE_LEDPSRAM clock on WROVER-class modules; in-package flash IO1/DO on ESP32-U4WDH. Also UART2 TX.
A6GPIO34 Input-only GPIO (no output driver); ADC1 channel 6. Other
Cannot be used as output (no drive capability); only suitable for analog/digital input.
A7GPIO35A3GPIO39 Input-only GPIOs with ADC1 channels - no output driver Other
Cannot be used as output; only suitable for input.
- A7Input-only GPIO (no output driver); ADC1 channel 7.
- A3Input-only GPIO (no output); ADC1 channel 3, Hall sensor VN.
A0GPIO36 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).
The MagicBit pinout brings out 26 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 16 ADC-capable pins for sensors and battery monitoring, 10 capacitive-touch inputs and 2 true DAC outputs.
If you want zero surprises, SCK, MISO, SDA, SCL and 6 more are free of any such role - the safest first picks. 16 of the exposed pins carry boot-time or system duties on the ESP32 (A11, TX, A12 and 13 more).
Getting started
flash your first firmware in ~2 minutesBoard: 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
// toggle GPIO18 - wire an LED and resistor to it
void setup() {
pinMode(18, OUTPUT);
}
void loop() {
digitalWrite(18, HIGH); delay(500);
digitalWrite(18, LOW); delay(500);
}[env:magicbit]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600esp32dev - or type it after board =.esp32:
board: esp32dev
variant: esp32
framework:
type: esp-idf
# blink - GPIO18
output:
- platform: gpio
pin: 18
id: led_out
light:
- platform: binary
name: "LED"
output: led_outesp32dev (same ids as PlatformIO).esptool.py --chip esp32 --port /dev/ttyACM0 \
--baud 921600 write_flash 0x1000 firmware.bin--port = your /dev/tty* (macOS/Linux) or COMx (Windows).Specifications
ESP32 · vs other ESP32 chips →About this board
At its core is the ESP32 - a dual-core Xtensa with both Bluetooth Classic and BLE.
Onboard you'll find an OLED 0.96" 128x64 display, a buzzer, an ambient-light sensor, battery charging, status LEDs (Red, Yellow, Green, Blue) and Left/Right buttons.
Resources
Similar boards
