hardware-audit

What problem does it solve?

Provides a two-layer electrical and functional audit for the ESP32 Emu Turbo hardware design, combining deterministic automated geometry, DFM, and connectivity gates with a manual domain-by-domain review to find issues that would prevent board power-on, component operation, or emulator functionality.

Core Features & Use Cases

• Layer 1 Automated Gates: Run an exhaustive script suite to detect trace-through-pad overlaps, same-layer trace crossings, copper-clearance DANGER zones, per-net connectivity fragmentation, DFM/DFA violations, datasheet pin→net mismatches, and power-path integrity issues.
• Layer 2 Manual Review: Guided prose audits across power chain, ESP32 boot strapping, display wiring, audio path, SD card routing, buttons, USB, and emulator performance expectations.
• Deterministic Halt & Reporting: If any Layer 1 gate fails, the workflow stops and writes a structured finding into hardware-audit-bugs.md; otherwise the auditor proceeds to documented manual checks with severity-tagged bug entries.
• Use Case: Pre-fabrication validation of an ESP32-S3 handheld console PCB to catch manufacturing and functional regressions before ordering panels or populating assemblies.

Quick Start

Run the Layer 1 automated gate suite, then perform the Layer 2 domain-by-domain review and save findings to hardware-audit-bugs.md.