m5-onboard

Automate M5Stack ESP32 board onboarding with UIFlow 2.0 firmware and MicroPython apps.

197|20|Updated May 9, 2026
One-click install
npx skills add https://github.com/dakshaymehta/cardputer-claude-os --skill m5-onboard-dakshaymehta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: m5-onboard
Source: https://github.com/dakshaymehta/cardputer-claude-os/tree/main/.claude/skills/m5-onboard
Command: npx skills add https://github.com/dakshaymehta/cardputer-claude-os --skill m5-onboard-dakshaymehta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires esptool, pyserial, and includes scripts (resource) and references (resource) components.

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.

Frequently Asked Questions about m5-onboard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I flash UIFlow 2.0 firmware onto a new M5Stack ESP32 device?▼

The Skill installs MicroPython app payloads to the /flash/ directory, supporting nested layouts like /flash/apps/ for UIFlow 2.0 discovery on your M5Stack device.

How do I install a MicroPython app bundle on an M5Stack Cardputer?▼

The Skill installs MicroPython app payloads to the /flash/ directory, supporting nested layouts like /flash/apps/ for UIFlow 2.0 discovery on your M5Stack device.

What do I need to set up before flashing an M5Stack Core device?▼

Before flashing an M5Stack Core device, you need Python installed, along with the pyserial and esptool packages, to ensure reliable UART and native-USB flashing across macOS, Linux, and Windows.

What should I do if my M5Stack ESP32-S3 fails to flash via native USB?▼

If your M5Stack ESP32-S3 fails to flash via native USB, you need to enter download mode using explicit hardware button dance guidance, followed by post-flash reset and recovery logic to handle known flakiness.

Can I reinstall MicroPython apps on an M5Stack device that is already flashed?▼

Yes, you can refresh already-flashed M5Stack devices by installing new MicroPython app bundles and running a hardware smoke test to confirm peripheral functionality without repeating the full firmware flashing process.