What problem does it solve?
Provisioning a freshly plugged-in M5Stack ESP32 device usually requires multiple manual steps (detecting the correct board, flashing the right firmware, then installing apps), which is error-prone—especially across macOS, Linux, and Windows, and across Cardputer vs other Core variants.
Core Features & Use Cases
- End-to-end onboarding workflow: Detects the correct serial port, identifies the device model/variant, fetches the matching UIFlow 2.0 firmware, and flashes it to the board.
- App bundle installation: Installs a MicroPython app payload to
/flash/ (including supported layouts like nested /flash/apps/ for UIFlow discovery).
- Device-resilient recovery: Handles native-USB ESP32-S3 download-mode entry with explicit hardware “button dance” guidance, and includes post-flash reset/recovery logic for known flakiness.
- Refesh vs full provisioning: Supports installing apps on already-flashed devices and running a hardware smoke test to confirm peripherals.
Quick Start
Provision a newly plugged-in Cardputer-Adv by running m5-onboard go.