| name | firmware-bringup |
| description | Bring up a new embedded board or create a minimal working firmware project with PlatformIO. Use when setting up a new project, identifying a connected board, creating a blink or serial smoke test, verifying build/flash/boot, or confirming the board is alive. |
Firmware Bringup
Purpose
Use this skill when the user wants to bring up a new embedded board or create a minimal working firmware project.
Safety Rules
- Do not flash firmware without explicit user approval.
- Do not erase flash unless the user explicitly asks.
- Do not assume the serial port. Discover connected devices first.
- Preserve logs and task IDs for debugging.
Workflow
- List connected devices.
- Search for the likely PlatformIO board ID.
- Initialize or inspect the project.
- Add a minimal boot marker, such as
BOOT_OK, to serial output.
- Build the project.
- If build succeeds, ask the user before flashing.
- Flash the firmware after approval.
- Start serial monitoring.
- Verify expected boot output.
- Summarize result and next steps.
Preferred Commands
Use available repo tools or CLI commands equivalent to:
pio-mcp devices
pio-mcp boards search esp32
pio-mcp init --board esp32dev --framework arduino
pio-mcp build
pio-mcp flash --port auto
pio-mcp monitor --timeout 30
