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
@@ -113,3 +113,31 @@ Implementation:
 - Sender to ADS1115 over I2C if no suitable exposed ADC exists

 Use lookup-table interpolation.
+
+
+## Cargo OLED service display
+
+Planned optional hardware:
+
+- 0.96 inch SSD1306 OLED
+- 128x64 resolution
+- I2C interface
+- Typical address: 0x3C
+- Suggested initial pins:
+  - SDA: GPIO 21
+  - SCL: GPIO 22
+  - VCC: 3.3V
+  - GND: common ground
+
+Purpose:
+
+- Show first-boot AP setup credentials without requiring Serial Monitor.
+- Show AP SSID, password, and IP address during setup/recovery.
+- Show quick service status:
+  - battery SOC
+  - voltage/current
+  - relay states
+  - WiFi/IP
+  - active alarms
+
+Firmware support is optional and disabled by default with OLED_ENABLED set to 0. Enable only after the OLED libraries are installed and the display is wired.