# Mio Make v0.1: arrived prototype reference

## Identity and authority

The only supported product is **Mio Make v0.1**, the September 29 prototype. Use the exact machine identity and manufacturing source in `packages/board/board.json`.

The PCB SHA-256 is `93a713a193c1a656f96f0e72092ed5a4583f44223c00816c4d8fdf9ff695945a`. All 96 edge-seal entries and all 116 manufacturing-seal entries verified on October 12, 2026. The final XML netlist, pinout, and byte-identical schematic copy are in `references/hardware/`. Run `npm run board:verify` to check the board contract against MCU and connector net assignments. Original Mio Click and LilyGO firmware are not sources for this board's pin map.

The September 29 candidate's design checks recorded zero ERC/DRC/unrouted issues, 99 connected net partitions, four layers and 1.2 mm thickness. Those are design evidence, not a claim that the assembled board is physically qualified. Arrival was recorded in `PROJECT_BASELINE.md` on October 12. The historical manufacturing files remain named `NOT_FOR_ORDER`; software work does not rewrite their history or grant fabrication authority.

## Processor and memory

ESP32-S3-WROOM-1U-N16R8: 240 MHz, 16 MB quad flash, 8 MB octal PSRAM, external antenna. GPIO35/36/37 are unavailable due to this exact module's PSRAM. All exposed signals use 3.3 V logic. Do not attach 5 V logic or backfeed board power. Wi-Fi and Bluetooth are hardware capabilities. Experimental runtime-owned Wi-Fi setup and a fixed feed client exist; arbitrary radio access is not exposed by the beginner SDK.

For battery and peripheral decisions read [hardware safety](hardware-safety.md). The `3V3` net is designed near 3.17 V nominal, not a measured 3.300 V supply. J5/J6 share protected accessory power; J8.2 is the main rail upstream of that protection. The complete circuit index and electrical rules are in `packages/board/circuit.json` and `packages/board/electrical.json`.

The firmware has its own PlatformIO board definition `mio_make_v01`, Arduino 2.0.17 via espressif32 6.12.0, C++17 and TFT_eSPI 2.5.43. Memory configuration is `qio_opi`. The prototype partition table places NVS at 0x9000, one factory app at 0x10000 (6 MiB), and storage at 0x610000. This is a new standalone board layout, not a Mio Click compatibility image or OTA release.

## Built-in signals

| Role | GPIO | Behavior |
|---|---:|---|
| USER1 / A | 5 | Active low, external 4.7k pullup and 47nF debounce capacitor |
| USER2 / B | 12 | Active low, same input network |
| BOOT | 0 | Active-low ROM downloader strap |
| RESET | EN | Chip reset, not a GPIO |
| LCD SCLK | 47 | SPI clock, initial firmware 20 MHz |
| LCD MOSI | 48 | SPI write data |
| LCD CS | 9 | Active low |
| LCD DC | 45 | Command/data; strap-sensitive at reset |
| LCD RESET | 46 | Active low; strap-sensitive at reset |
| Display power | 15 | Enables LCD/backlight supply domain |
| Backlight | 7 | AW9364 pulse-counted control; never LEDC/PWM |
| Battery ADC | 4 | 100k/100k divider, approximate battery = 2 × pin voltage |
| Regulator MODE | 17 | Forced PWM while awake, low at reset/sleep |
| USB current select | 6 | BQ24074 EN1 through R47 |
| USB suspend | 10 | BQ24074 EN2 and CE_N together |
| USB PGOOD | 8 | Active-low valid input, through R48 |
| Qualified USB sense | 13 | TPS3710 voltage qualification, not a charge-state signal |
| USB D− / D+ | 19 / 20 | Native USB |
| I²C SDA / SCL | 16 / 18 | Start at 100 kHz |
| UART TX / RX | 43 / 44 | Service testpoints; TX may emit ROM logs |

The two user inputs must never be driven high as outputs: pressing a switch shorts its signal to ground. Debouncing is owned by the runtime, with independent sampling during display transfers. See [the input contract](input.md) for RC values, debounce windows, retained press events and validation requirements. BOOT is not a normal gameplay button.

## Display and J4

The supplied panel is GoldenMorning **T190X7-C30-01-TAA**, ST7789, 170 × 320 portrait / 320 × 170 landscape. The new PCB straps it for 4-wire SPI. Runtime uses the physically established rotation 3, `CGRAM_OFFSET`, `INIT_SEQUENCE_3`, inversion enabled and `TFT_RGB_ORDER=TFT_RGB`. Full display/power qualification remains distinct from the observed working prototype.

| J4 board contact | Panel contact | Function |
|---|---:|---|
| 1 / 30 | 30 / 1 | GND |
| 2 / 3 | 29 / 28 | GPIO1 / GPIO2, panel NC |
| 4 / 5 | 27 / 26 | External SDA / SCL, panel NC |
| 6 | 25 | GND |
| 7–10 | 24–21 | LED cathodes 4–1 |
| 11 | 20 | Backlight anode supply |
| 12 | 19 | Panel SDO unconnected |
| 13–20 | 18–11 | Unused parallel data pins tied to GND |
| 21 | 10 | MOSI |
| 22 | 9 | Unused RDX tied to GND |
| 23 | 8 | DC |
| 24 | 7 | SCLK |
| 25 | 6 | CS |
| 26 | 5 | RESET |
| 27 / 28 | 4 / 3 | IM1 / IM2 configured high for SPI |
| 29 | 2 | Switched VDD_LCD |

The LCD folds around the left edge onto the flat face. Do not treat connector contact numbers as the panel's reversed contact numbering. Alternate displays must respect the complete contact contract. There is no screen-readback/MISO path. J4 and bare GPIO1/2/I²C share signals; alternate accessories must not contend.

AW9364 starts at brightness level 16 after >2 ms low reset followed by high. Each valid short low/high pulse decrements the cyclic 16-step level. Runtime emits eight pulses for modest level 8, with interrupts excluded during the short pulse train. Never import the old Make GPIO38 PWM example.

## Expansion

J8 top row, **physical pads 1–8**: GND, 3V3, GPIO1, GPIO2, GPIO3_STRAP, GPIO11, SDA16, SCL18.

J7 right edge, **physical pads 1–8**: GPIO14, GPIO21, GPIO38, GPIO39, GPIO40, GPIO41, GPIO42, GND. Looking at the flat LCD face with USB down, **top-to-bottom** is GND, 42, 41, 40, 39, 38, 21, 14. Pad 1 is the square bottom pad nearest USB. The old 2×4 arrangement is obsolete: this is a bare 1×8 row at 2.54 mm pitch.

Eleven dedicated native pins: 1, 2, 3, 11, 14, 21, 38, 39, 40, 41, 42. GPIO3 is a boot strap; accessory loads can alter startup. GPIO1/2/3 are ADC1 channels0/1/2; GPIO11/14 are ADC2 channels0/3. Those five also have touch channels. The other native expansion pins have no ADC/touch channel. These are chip capabilities requiring advanced firmware and qualification, including ADC2 arbitration. Native SDA/SCL and service UART are counted separately. There are **no XIO0–15 ports** or expander address reserved in this hardware.

J5/J6 are parallel Qwiic/STEMMA QT style connectors, pin order GND/3V3/SDA/SCL, protected accessory power through TPS22948 and ESD on signals. Their **combined advertised budget is 100 mA**; the load switch's current-limit tolerance is not an exact 100 mA fuse. Start at 100 kHz, verify device addresses and pullups; 400 kHz and power/current behavior require qualification. Do not attach motors/relays directly to GPIO. Raw VBAT, USB VBUS and VSYS are not supported accessory supply outputs.

## Power runtime and qualification limits

Reset pull devices select USB100: EN1 GPIO6 low, EN2/CE_N GPIO10 low. Runtime only selects USB500 (6 high / 10 low) after native USB configuration and valid voltage/PGOOD. Suspend uses both high to disable charging/input; unplug returns defaults. Initialize levels before enabling GPIO outputs. This is an initial implementation requiring suspend/resume, unplug/replug, watchdog and brownout testing; it is not inherited production qualification.

Startup needs a connected battery reading >=3.5 V. Three readings below3.3 V turn the screen off and enter sleep. Current default idle settings dim at15 seconds and sleep at60 seconds on battery or USB; saved comfort settings can override these. USER1 wakes via RTC. See [system behavior](system.md). Runtime does not report battery percentage or full/charging status. BQ24074 CHG_N drives an LED/testpoint, not an MCU input. ADC error, reset timing, USB-host power admission, depleted/protector-open battery behavior and idle current all require bench measurement. The existing production battery calibration, secure provisioning and factory workflows were not copied.

## First-article record to complete

Record board marking, manufacturing provenance, module identity, port, firmware manifest hash, battery voltage measured at terminals, LCD drawing/connection, startup current, USB enumeration, reported flash/PSRAM, four color bars, orientation, button edges, repeated cold boot, BOOT/RESET recovery, unplug/replug, host suspend/resume and low-battery behavior. Then qualify expansion continuity and both I²C connectors with a current-limited fixture. Do not mark “verified on hardware” merely because firmware compiled.

The public toolkit includes `references/hardware/netlist-public.xml`. Four KiCad workstation paths use filenames in this copy. Its components, nets and pin assignments match the September 29 sealed netlist. Both file hashes are recorded in board.json.
