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.