Updates

UPDATES fragt GitHub, welches Release der Panel-Firmware das neueste ist, und installiert es. Der Bildschirm öffnet über die Taste UPDATES unter Setup. Eine Erinnerung beim Start stellt dieselbe Frage einmal pro Start des Panels. 0.22 ist das letzte Release für das ESP32-S3-Panel; dem ESP32-P4-Panel wird jedes neuere Release angeboten, siehe Die Release-Linie.

Was die Suche braucht

Die Karte nennt die laufende Version und das gespeicherte Heimnetz. Suche und Download brauchen:

• ein unter WLAN gespeichertes Heimnetz. Ohne eines sagt die Karte Kein Heimnetz gespeichert., und NACH UPDATES SUCHEN ist grau;
• den Prüfstand SAFE, den Netzteilausgang aus und keinen offenen Log-Lauf. Sonst ist die Taste grau, und die Karte sagt Für WLAN muss SAFE aktiv und das Netzteil aus sein.;
• kein laufendes Update des IOmcu und keine Panel-Installation im Gang.

Der Download braucht außerdem, dass keine Platinenzeichnung geladen oder gespeichert wird.

Die Suche

Eine ungerade Minor-Nummer ist ein Testing-Release, auf GitHub als Pre-Release veröffentlicht (0.21.x). Eine gerade Minor-Nummer ist ein Stable-Release (0.22.x).

Das Panel verbindet sich mit dem Heimnetz, sendet eine HTTPS-Anfrage (HTTP über Transport Layer Security) und liest den Tag des neuesten Release aus der Antwort. Danach geht der Funk aus. Verbinden, Adresse und Anfrage dauern zusammen höchstens 30s. Die Karte zeigt den Schritt und die verbleibenden Sekunden.

In beiden Einstellungen wird ein Release nur angeboten, wenn es zur Release-Linie des Panels gehört und neuer als der laufende Build ist. Die Linie des ESP32-P4-Panels enthält jedes Release, siehe Die Release-Linie.

Der Tag lautet v und MAJOR.MINOR.PATCH, nur Ziffern, jede Zahl von 0 bis 65535 in höchstens 5 Ziffern und ohne führende Null. Ein Release ist neuer, wenn sein MAJOR größer ist, oder MAJOR gleich und MINOR größer, oder beide gleich und PATCH größer.

Die Release-Linie

0.22 ist das letzte Release für das ESP32-S3-Panel. Spätere Releases sind für das 7-Zoll-Display-Board mit ESP32-P4 von Waveshare.

Die Linie des ESP32-P4-Panels enthält jedes Release: Eine Suche bietet in beiden Einstellungen jedes Release an, das neuer als der laufende Build ist.

Die Linie des ESP32-S3-Panels, 0.22, bietet nur 0.22.x an, und der Fuß ihrer Karte sagt das in seinen ersten Zeilen:

Liegt mit TESTING das höchste der 10 neuesten Releases hinter der Linie, wird an seiner Stelle das höchste Release der Linie unter ihnen angeboten, sobald es neuer als der laufende Build ist. Liegt mit STABLE das Latest-Release von GitHub hinter der Linie und ist neuer als der laufende Build, sendet das Panel diese Anfrage einmal mehr und bietet das neueste 0.22.x unter diesen 10 an, wenn es neuer ist. Scheitert diese Anfrage, lautet die Karte wie ohne sie.

Der Download

Das Halten über 2s ist die einzige Bestätigung: Es folgt keine Frage. Das Panel verbindet sich innerhalb von 30s mit dem Heimnetz und lädt SHA256SUMS und rcbench-panel-p4-vX.Y.Z.bin des Release über HTTPS. Es folgt höchstens 3 Redirects, nur zu github.com, release-assets.githubusercontent.com und objects.githubusercontent.com.

1. SHA256SUMS hat höchstens 4096 Bytes und genau eine Zeile für das Image.
2. Das Image kündigt zuerst seine Größe an; ein Image ohne Größe, mit 0 Bytes oder über 8.126.464 Bytes wird abgelehnt. Es liegt im PSRAM (Pseudo-Static Random-Access Memory).
3. Der SHA-256 (Secure Hash Algorithm, 256 Bit) des Image gleicht seiner Zeile in SHA256SUMS.
4. Jede Prüfung eines hochgeladenen Image läuft, und das Image nennt die Version des Release.

Erst dann schreibt das Panel-Update es, so wie INSTALL. Vorher berührt nichts den Flash.

ABBRECHEN beendet den Download. STOP, ARMED, der Netzteilausgang, ein Log-Lauf, eine geladene Platinenzeichnung und 180s nach dem Halten beenden ihn auch. Der laufende Build bleibt; SCHLIESSEN geht zurück zu UPDATES, oder zum Menü, wenn das Halten das der Erinnerung war.

Der IOmcu

Unter den Tasten nennt UPDATES die Version, die der IOmcu laufen hat (Läuft: 0.21.2), und die Version des Images, das dieses Panel mitbringt (Auf diesem Panel: 0.22.0). 2s HALTEN ZUM IOMCU-UPDATE startet das Update, das die Frage beim Link-up startet, mit demselben Fortschritt. Endet das Update, oder verfiel der START, kehrt der Bildschirm zu UPDATES zurück.

Das Halten braucht, was die Frage braucht: einen IOmcu mit einem anderen Build, den Prüfstand SAFE, den Netzteilausgang aus, den WLAN-Funk ganz aus und keine Panel-Installation im Gang. Sonst ist es grau, und die Zeile darüber sagt, warum, das Erste davon, das gilt:

Ist das Halten aktiv, lautet die Zeile Ausgänge bleiben aus. ARMED ist bis zum Ende des Updates gesperrt., oder Die Firmware auf diesem Panel ist älter. in der Warnfarbe für ein älteres Image.

Aktuelle Einschränkungen

• Wie lange Suche und Download in einem echten Netz dauern, ist nicht gemessen.
• Ein erster DNS-Server (Domain Name System) des Heimnetzes, der nicht antwortet, verzögert nach einer Verbindung jede Namensauflösung um etwa 7s, von den 30s der Suche: lwIP fragt diesen Server 4-mal, bis zu 7s lang, vor dem nächsten.
• TESTING: GitHub beantwortet ohne Konto 60 API-Anfragen pro Stunde und öffentlicher Adresse, geteilt von allen Geräten dahinter. Das Panel wiederholt keine Anfrage.
• TESTING liest die 10 nach Datum neuesten Releases. Ein Release, das nach Datum älter ist, sieht das Panel nicht, wie hoch seine Version auch ist.
• Die Release-Liste enthält die 10 nach Datum neuesten Releases (per_page=10). Ein Patch-Release 0.22.x, nach dem 10 oder mehr Releases veröffentlicht wurden, wird in keiner Einstellung gefunden.
• Die Daten der Zertifikate werden nicht geprüft: mbedTLS ist ohne seine Ablaufprüfung gebaut (CONFIG_MBEDTLS_HAVE_TIME_DATE aus, die Vorgabe von ESP-IDF).
• Ein Release, dessen Dateien nicht rcbench-panel-p4-vX.Y.Z.bin und SHA256SUMS heißen, lässt sich nicht laden.