XIAO Board Reference

This skill provides pin definitions and board specifications for SeeedStudio XIAO series. For code implementation, use the appropriate platform sub-skill.

Platform Sub-Skills

First select your platform sub-skill, then read board reference below.

Board Selection

Read the corresponding board reference for pin definitions:

Board Quick Reference

ESP32 Series

nRF Series

RP Series

Other

Expansion Boards

XIAO expansion boards add peripherals and capabilities. For complete hardware documentation, see references/expansion_boards/.

For detailed hardware specifications, pin mappings, and compatibility, see references/expansion_boards/.

Critical Pin Restrictions

ESP32 Series Strapping Pins

These pins affect boot mode - avoid using or use carefully:

Warning: Using strapping pins incorrectly can prevent booting or uploading.

RP2040 BOOTSEL

• •Hold BOOTSEL button while connecting USB to enter firmware upload mode
• •Drive appears as RPI-RP2 mass storage

I2C/SPI/UART Pin Mappings

Pin mappings vary by board - always check board reference before wiring.

Sense Models

For camera/microphone sensor boards, see special/sense-models.md:

• •ESP32S3 Sense camera configuration
• •nRF52840 Sense PDM microphone
• •MG24 Sense built-in sensors

Low Power

Deep sleep and power optimization are platform-specific. Use your platform sub-skill:

• •Arduino: Use the /xiao-arduino skill and see the API documentation for deep sleep (ESP32, nRF52, RP2040)
• •MicroPython: Use the /xiao-micropython skill and see the API documentation for deep sleep (ESP32, nRF52, RP2040)
• •ESPHome: Use the /xiao-esphome skill and see the advanced documentation for deep sleep configuration

Bootloader Reflash

For bootloader recovery or firmware flashing procedures, see special/bootloader-reflash.md.

Reference Structure

xiao/
├── boards/              # Pin definitions for each board (READ THIS FIRST)
├── expansion_boards/    # XIAO expansion board hardware documentation
│   ├── README.md        # Expansion board overview and selection guide
│   ├── expansion-base.md
│   ├── round-display.md
│   ├── grove-shield.md
│   ├── epaper-v2.md
│   ├── can-bus.md
│   ├── rs485.md
│   ├── led-driver.md
│   ├── bus-servo.md
│   ├── gps-gnss.md
│   ├── gpio-expander.md
│   ├── rgb-matrix.md
│   └── cob-led.md
└── special/
    ├── bootloader-reflash.md  # Bootloader recovery
    └── sense-models.md        # Sense model camera/sensors

Workflow

1. •Load platform sub-skill first (/xiao-arduino, /xiao-micropython, /xiao-esphome)
2. •Read board reference for pin definitions (e.g., boards/esp32c3.md, boards/rp2040.md)
3. •Check pin restrictions for strapping/boot pins
4. •Generate code using platform sub-skill patterns

Important Notes

• •Always verify pin mappings in board reference before connecting peripherals
• •Avoid strapping pins on ESP32 boards unless necessary
• •Use appropriate sub-skill for code examples and platform patterns
• •Check Sense model docs for camera/microphone configuration