feat(display): add air quality pages, history and display settings
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user