Add persistent native Guition rotation to screen settings

2026-09-12 18:29:06 +02:00
parent 8171629678
commit 0109bfd6d2
15 changed files with 155 additions and 12 deletions
@@ -24,6 +24,20 @@ geen `calibration.yaml` of XPT2046-correctie over.

 ## Interface

+### Montage en schermrotatie (runtime 0.2.9+)
+
+Installeer Guition-firmware 0.2.9 en ESP Screen Manager 0.2.9. Open het scherm
+in de beheerpagina, ga naar **Scherminstellingen** en kies bij **Scherm draaien**
+0°, 90°, 180° of 270°, met de klok mee. Klik op opslaan. Een firmwareflash is
+daarna niet meer nodig om de hoek te wijzigen. De instelling blijft in de appdata
+en op het scherm bewaard na een herstart.
+
+Dit gebruikt de native ESPHome/LVGL-rotatie voor beeld én touch, zonder wijzigingen
+aan de paneelinitialisatie of GT911-spiegeling. Controleer na montage de vier
+hoeken en de navigatie fysiek; een renderproef test geen aanrakingen. De optie is
+alleen zichtbaar voor de Guition nadat zijn nieuwe firmware door HA is ontdekt.
+De CYD blijft op zijn bestaande oriëntatie met zijn eigen kalibratie.
+
 Zes tegels van **218 × 108 pixels** per pagina, 12px tussenruimte en een
 aparte navigatiestrook. Vanaf zeven tegels verschijnt pagina twee; tot zes
 verdwijnt de navigatie. Grotere letters, iconen, dimmers en kleurkeuzes; de
@@ -101,3 +101,13 @@ breng de indeling eerst terug tot tien of herstel hun gegevensback-up bij rollba
 `settings.swipe_pages` is additief in opslagversie 1. Op de draad staat het buiten
 het ongewijzigde elfvelden-settingsobject. De bestaande preferences blijven gelijk;
 alleen swipe gebruikt een nieuwe eigen uint32-key `0x53575031`, standaard uit.
+
+### Compatibiliteit 0.2.9
+
+Guition-rotatie is additief als `settings.rotation` in appdata, uitsluitend
+0/90/180/270. Oude beheerpagina's die het veld weglaten behouden de opgeslagen
+hoek. Op de draad staat `rotation` naast het ongewijzigde elfvelden-settingsobject.
+De firmware bewaart de hoek als afzonderlijke uint32 op key `0x524F5431`; de
+bestaande Settings-structuur en CYD-kalibratie blijven ongewijzigd. Alleen de
+Guition activeert de rotatiecallback. De diagnostische entity `Guition schermtype`
+maakt deze capability herkenbaar, ook als het scherm offline of hernoemd is.
@@ -0,0 +1,23 @@
+# 0.2.9 — Guition-rotatie
+
+De beheerpagina biedt kwartslagen voor de Guition. De native ESPHome 2026.6.2
+LVGL-component draait beeld en touch samen. De paneelinitialisatie, GT911-transform
+en CYD-kalibratie zijn niet aangepast. De aparte opgeslagen hoek verandert de
+bestaande settingsstructuur en preference-keys niet.
+
+- 48 Python-tests geslaagd, inclusief ongeldige hoeken, behoud na appherstart en
+  opslaan vanuit een oude browser, bordherkenning bij offline status en behoud
+  van het elfvelden-wireprotocol.
+- Alle acht C++-testprogramma's geslaagd; JavaScript-syntax gecontroleerd.
+- Beide runtime- en beide handmatige firmwareprofielen gebouwd.
+- Guition-runtime op het geïdentificeerde apparaat via OTA geïnstalleerd.
+- Renderdiagnose na opdrachten voor 0°, 90°, 180° en 270°: per stand tien
+  paginacontroles en vijftig overlaycycli geslaagd. Deze controle bedient geen
+  HA-apparaten en is geen fysieke touchmeting.
+
+De definitieve Guition-build bevat daarnaast een uitlezing van de gewenste én
+werkelijk door LVGL gebruikte hoek via `ui_state`. Na de definitieve OTA-flash
+en herstart meldden beide 270°: de voorkeur bleef behouden en werd toegepast.
+Daarna is de testhoek weer naar 0° teruggezet. Fysieke touchacceptatie is
+afzonderlijk nodig; de bestaande `tools/verify_gt911.py --rotation` ondersteunt
+alle vier de hoeken.