firmware: scaffold optional cargo OLED display

2026-06-08 08:45:24 -06:00
parent bc56514489
commit 46d52052e3
4 changed files with 315 additions and 0 deletions
@@ -103,3 +103,28 @@ UI direction:
 - Add QR code display for joining Cargo AP.
 - Add dashboard settings UI.
 - Add LVGL on-screen keyboard only after core dashboard functionality is stable.
+
+
+## Cargo OLED firmware foundation
+
+Status: planned / scaffolded
+
+Initial OLED firmware goals:
+
+- Add optional SSD1306 128x64 support behind a compile-time flag.
+- Keep OLED support disabled by default so the controller firmware builds without extra libraries.
+- Display boot/setup status.
+- Display AP SSID/password/IP for phone-first setup.
+- Display rotating service pages:
+  - battery
+  - relays
+  - network
+  - alarms
+
+Future OLED goals:
+
+- Add setup/status button.
+- Short press cycles pages.
+- Long press shows AP credentials.
+- Extended hold enters recovery/reset mode.
+- Add first-boot setup screen once AP password generation is finalized.