hw-firmware

# HW Firmware Capability Pack > Deliverable is compilable firmware code + hardware docs, not sketches. Scope: ESP32-S3/C3 primary, Arduino framework (STM32/nRF out of scope for v1). Toolchain: arduino-cli (verified) + optional PlatformIO for static analysis. Standard kit: Seeed XIAO ESP32-S3, SH1106 OLED (I2C 0x3C), E-ink (GxEPD2), DA7280 haptic (I2C 0x4A), built-in touch/WiFi/BLE. --- ## Step 1: Context Detection | User Signal | Load Reference | |---|---| | new firmware, main loop, 架构设计, state machine, 状态机, FreeRTOS, task scheduling, 模块划分, config.h layout | `references/firmware-architecture.md` | | new peripheral, 外设驱动, I2C/SPI device, OLED, E-ink, haptic, touch, sensor init, driver library choice, 驱动封装 | `references/peripheral-drivers.md` | | battery, 电池寿命, deep sleep, 低功耗, 功耗预算, RTC memory, wake source, 唤醒, hibernation | `references/low-power-design.md` | | WiFi, BLE, MQTT, HTTP/HTTPS API, OTA update, 联网, 配网, TLS, reconnect, 断线重连 | `references/communication.md` | | compile, upload, 编译, 烧录, arduino-cli flags, partition table, 分区表, library version, FW version, sketch.yaml | `references/build-upload.md` | | test, 测试, serial debug, 串口调试, self-test, [TEST] logs, regression, mock, 自动化验证 | `references/firmware-testing.md` | | pin map, 引脚映射, wiring, 接线图, README, API docs, data flow diagram, D2/Typst 文档 | `references/firmware-documentation.md` | | before declaring ANY firmware deliverable done — acceptance / pass-fail check, 验收 | `references/quality-criteria.md` | | before gate...