From 49d0396b572d5aba0789fcb2aabf06d281bf3e64 Mon Sep 17 00:00:00 2001 From: pyr0ball Date: Sat, 11 Jul 2026 22:18:00 -0700 Subject: [PATCH] docs: record Phase 1 hardware bring-up status and deferred items --- docs/build-guide-phase1-notes.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/build-guide-phase1-notes.md b/docs/build-guide-phase1-notes.md index 2aeb806..95f881f 100644 --- a/docs/build-guide-phase1-notes.md +++ b/docs/build-guide-phase1-notes.md @@ -1,5 +1,22 @@ # Phase 1 Build Notes +## Status (2026-07-11) + +Firmware flashed and running on physical hardware. Boot log confirms: +- I2C bus scan found all 3 expected devices: `0x24` (CH422G), `0x5D` (GT911), `0x76` (BME280) +- Display shows "Thermostat — Phase 1 OK" as expected +- GT911 touch attached with hardware interrupt (touch confirmed responsive via Waveshare's factory demo firmware; not yet confirmed under our own firmware/HA) +- BME280 sensor entities registered, no I2C errors +- WiFi connects cleanly, device reachable at `firecrest.local` +- Climate entity built with heat/cool modes and home/away presets, zero boot errors +- Fixed one real bug found during bring-up: ESPHome defaults ESP32-S3 logger to `USB_SERIAL_JTAG`, a different physical USB port than this board's UART-flashing port — logs were silently going nowhere until `hardware_uart: UART0` was set explicitly + +**Deferred / not yet verified (blocked on physical access to hardware):** +- [ ] Relay bench test with multimeter — user doesn't have relays on hand, will test at office on a breadboard. GPIO wiring assumed correct for now based on clean compile + boot; not electrically verified. +- [ ] Full Home Assistant pairing — `ha_api_key` in `secrets.yaml` is currently a placeholder (valid format, not a real key). Touch, sensor, switch, and climate entities not yet confirmed visible/controllable in HA itself. + +Proceeding to Phase 2 (LVGL interface design) with the above two items still open — revisit before calling Phase 1 fully signed off. + Source: Waveshare Wiki, fetched 2026-07-11. - https://www.waveshare.com/wiki/ESP32-S3-Touch-LCD-7B (confirmed this is the "Type B" product page — distinct from the non-B `ESP32-S3-Touch-LCD-7` page, same pinout on both as of this writing) - Schematic PDF: https://files.waveshare.com/wiki/ESP32-S3-Touch-LCD-7/ESP32-S3-Touch-LCD-7-Sch.pdf