# Mio Make

> A creative ESP32-S3 board with two buttons, a colorful screen and native expansion. Current tooling supports the September 29 Mio Make v0.1 prototype. This localhost implementation is not yet deployed at miomake.com.

## Start here
- [Runtime release](/runtime.json): shared firmware version, source hashes and startup policy.
- [Agent quickstart](/docs/agent-quickstart): caller-owned inference, local CLI/MCP setup and release version.
- [Hardware safety](/docs/hardware-safety): battery, charging, power domains, actual expansion and connection review.
- [Agent manifest](/agent.json): toolkit version and capabilities.
- [Electrical contract](/electrical.json): ports, power limits and evidence status for Mio Make v0.1.
- [Circuit index](/circuit.json): exact components and nets, including optional parts; not assembled-population evidence.
- [Connection plan schema](/connection-plan.schema.json): advisory check_connection input; missing facts stay unknown.
- [Live data](/docs/live-data): experimental fixed-feed HTTPS and token-hash artwork; physical validation is pending.
- [Runtime availability](/givens.json): implemented versus planned services; do not invent SDK APIs.
- [Shared system design](/docs/system): optional A+B settings, brightness, timers, sleep and connectivity.
- [Characters and nearby play](/docs/characters): ungated Mio picker, replaceable game slots and ESP-NOW.
- [Local character catalog](/api/characters): search public Mios; retrieve verified pixels at `/api/character-assets/<hash>`. MCP provides list_characters/get_character_asset. Full JSON builds carry named slots and assets; never paste pixels into C++.
- [Board contract](/board.json): machine-readable identity, exact pins, memory and limits.
- [Development skill](/skill.md): authoring, build and physical validation workflow.
- [Board reference](/docs/board): complete connector and power context.
- [SDK](/api/sdk): C++ appSetup/appLoop/appDraw and Mio canvas/button API.
- [Starter apps](/api/examples): eight complete source examples.
- [Quickstart](/docs/quickstart): connect, compile, recover, install and verify.
- [Agent tools](/docs/agents): stdio MCP and local HTTP API.
- [Sharing and versions](/docs/sharing): immutable local revisions, recovery and portable source bundles with credits.
- [KiCad schematic](/schematic.kicad_sch): preserved September 29 final schematic.
- [Schematic PDF](/schematic.pdf): native KiCad export.

Critical: this is not LilyGO or Mio Click. LCD is SPI SCLK47/MOSI48/CS9/DC45/RST46, buttons5/12, AW9364 backlight7 (pulse control), power15. Native GPIO expansion. GPIO35–37 reserved for PSRAM. GPIO logic is 3.3 V; combined I2C accessory budget100 mA.

The MCP tools do not call AI providers; the caller uses its own inference. A flashed binary and successful compilation are not evidence of physical hardware qualification. Do not claim public sharing, subscriptions, remote MCP or miomake.com deployment are already active.

- Exact drawing methods/constants: packages/runtime/drawing.json (local studio: /drawing.json; MCP: miomake://drawing).

- [Caller-owned builds](/docs/agent-builds): optional local MCP save/compile tools, durable request IDs and Studio handoff; no provider inference or device writes.
