feat(display): add air quality pages, history and display settings

This commit is contained in:
root
2026-11-11 22:24:29 +00:00
parent 62e9d249cb
commit dde4736cc2
24 changed files with 3634 additions and 481 deletions
+63
View File
@@ -179,3 +179,66 @@ automatisch freigegeben.
mit Portal `http://192.168.4.1` aktiv; keine STA-IP oder erfolgreichen
Influx-Schreibvorgänge beobachtet. WLAN und bei Bedarf Organisation `Home` /
Bucket `nanoPSX` im Portal einstellen; Tokens lokal eingeben.
## Displayseiten und Bedienung
Die vier EEZ-Seiten sind `Main` (bisherige Messwertansicht), `Page_2` (Raumluft),
`History` (Verlauf) und `Device` (Gerät). Nach links zur nächsten, nach rechts zur
vorherigen Seite wischen; an den äußeren Seiten gibt es keinen Umlauf. Vier kleine
Markierungen am oberen Rand zeigen die aktuelle Seite. Tippen auf ein Statussymbol
der Hauptseite öffnet die Geräteseite. Dropdowns und Helligkeitsregler verarbeiten
ihre Berührungen selbst, ohne dabei versehentlich die Seite zu wechseln.
- Raumluft: CO₂ in ppm, VOC-/NOx-Index und ein kleiner CO₂-Verlauf. Nicht verfügbare
Kanäle erscheinen als `--`; SEN54 erzeugt keine künstlichen CO₂-Werte.
- Verlauf: Auswahl zwischen CO₂, PM2.5, Temperatur, Feuchte, VOC und NOx. Gezeigt
werden 180 Zehn-Sekunden-Mittelwerte über die letzten 30 Minuten. Die angezeigte
Wertespanne entspricht der automatisch angepassten Diagrammachse. Fehlende
Zeitabschnitte bleiben Lücken. Der feste RAM-Ringpuffer wird bei Neustart geleert;
SD-Karte, WLAN und InfluxDB sind für den lokalen Verlauf nicht erforderlich.
- Gerätestatus: WLAN/IP, Alter der letzten bestätigten Influx-Übertragung (HTTP 204)
und Sensoraktualität. Ein WLAN-Erfolg gilt nicht als erfolgreiche Datenübertragung.
- Helligkeit: 20–100 %, Standard 100 %. Automatisches Abdunkeln: aus oder nach
30/60/120 Sekunden, Standard 60 Sekunden. Abgedunkelt wird auf 15 %. Die erste
Berührung weckt nur das Display und wird bis zum Loslassen verbraucht.
- Display-Einstellungen werden erst nach Änderung gespeichert: Helligkeit beim
Loslassen, Zeitwahl beim Auswählen. Eigener NVS-Namespace `ui_display`, keine
WLAN-/Influx-Einstellungen. Beim ersten Start werden nur die Defaults gelesen.
- Vor dem ersten Sensorpaket erscheint ein Starthinweis. Nach mehr als fünf
Sekunden ohne erfolgreiches Paket werden die aktuellen Anzeigen als veraltet
markiert und die Zahlen durch `--` ersetzt; der vorhandene Verlauf bleibt sichtbar.
## EEZ-Projekt und Firmware zusammen bearbeiten
`eez/nanopsx.eez-project` enthält Layout, Beschriftungen, Namen und Grundkonfiguration
der Widgets. PlatformIO ruft vor jedem Build `tools/export_display.py` auf und hält
`screens.c`/`screens.h` automatisch synchron. Kein manueller EEZ-Studio-Export nötig.
Der projektspezifische Exporter unterstützt die hier verwendeten statischen Screen-,
Panel-, Label-, Image-, Chart-, Slider- und Dropdown-Widgets und deren verwendete
Stile. Nicht unterstützte Widgettypen/Stile brechen den Build ab, statt unbemerkt
wegzufallen; bei Erweiterungen zuerst den Exporter ergänzen. EEZ Flow bleibt aus.
Navigation, dynamische Texte, Chart-Daten, Touch-Aufwecken und Einstellungen liegen
außerhalb der generierten Dateien in `ui_navigation.c`, `ui_dashboard.c` und
`ui_model.c`. Diese werden nach `ui_init()` unter dem LVGL-Lock initialisiert.
Der Sensorproducer übergibt skalierte Zahlen an `ui_model_publish()` und ruft
keine LVGL-Funktionen auf. Snapshot und begrenzter Ringpuffer sind auf dem ESP
mit einem Spinlock geschützt. Die Diagramme werden im GUI-Task aktualisiert.
Prüfungen aus dem Repository-Hauptverzeichnis:
```bash
python3 firmware/tools/export_display.py --check
python3 firmware/test/ui/run_tests.py
bash firmware/test/sensors/run.sh
```
Die UI-Tests verwenden echte LVGL-Quellen und exportierte Displayobjekte bei
48 KiB LVGL-Speicher. Sie prüfen vierseitige Navigation, Tippen, kurze/vertikale
Gesten, äußere Grenzen, Kindobjekte, Dropdown-Isolation, Helligkeitsregler,
Aufweckberührung, Abdunkeln, fehlende/veraltete Werte und Verlaufsmittelwerte,
Lücken und Verdrängung alter Daten. Voraussetzung sind ein C-Compiler und die
bereits aufgelöste LVGL-Komponente unter `firmware/managed_components`.
Ein optionaler Verzeichnispfad hinter dem UI-Testbefehl speichert vier gerenderte
PPM-Vorschauen mit simulierten Messwerten. Physische Darstellung und Fingerbedienung
müssen zusätzlich am Gerät geprüft werden.