Updates

Es gibt zwei Dinge, die sich aktualisieren lassen, mit ganz verschiedenen Risiken:

1. die Software auf dem PC (Oberfläche und Backend)
2. die Firmware des Masters

Beide haben eigene Versionen und wandern nicht im Gleichschritt. Was gerade aktuell ist, steht auf GitHub in den Veröffentlichungen (Releases) der Software, zusammen mit einer Datei manifest.json, die beides beschreibt (Version, Dateiname, Prüfsumme).

Wie die Software von einem Update erfährt

• Beim Start schaut sie einmal bei GitHub nach, danach höchstens alle sechs Stunden. Ohne Anmeldung erlaubt GitHub nur 60 Anfragen je Stunde, öfter bringt auch nichts.
• Schiefgehen darf das: Ohne Netz gibt es eben kein Update, und das hält nichts auf. Ein Netz, das kurz flackert, wird bis zu dreimal versucht, bevor eine Fehlermeldung erscheint.
• Installiert wird nie von selbst. Das entscheidest du.
• Wer das Nachsehen beim Start nicht will, schaltet es ab: Einstellungen → Allgemein → Beim Start nach Updates suchen. Ausdrücklich nachsehen kannst du immer.

Der Hinweis

Gibt es etwas Neues, erscheint ein Streifen unter der Leiste, auf jeder Seite:

Version 0.9.4 ist verfügbar. Installiert ist 0.9.3. [Jetzt aktualisieren] [Firmware aktualisieren] [Später]

Gibt es Software und Firmware, steht dort „… und … sind verfügbar.“ Dazu zeigt der Reiter Einstellungen einen grünen Punkt.

• Später blendet den Streifen bis zum nächsten Start aus. Gespeichert wird das nicht: Das Update bleibt ja fällig, und ein „nie wieder“ ließe jemanden ewig auf einer alten Fassung sitzen.
• Auf dem Gerät erscheint zusätzlich eine kurze Hinweiszeile, wenn die Firmware des Masters das anzeigt. Am Gerät steht man ohne Bildschirm davor.

Nach Updates suchen

Einstellungen → Updates & Sicherung → Nach Updates suchen. Solange gesucht wird, ist der Knopf aus und die Zeile sagt wird gesucht …. Danach steht dort:

Anzeige	Bedeutung
alles aktuell · geprüft 14:32	du hast das Neueste
Version 0.9.4 verfügbar (und/oder Firmware … verfügbar)	es gibt etwas
nicht abrufbar	die Suche ging schief, der Grund steht darunter
noch nicht nachgesehen	seit dem Start wurde noch nicht gesucht

Zu jedem Fund gibt es die Knöpfe Software aktualisieren, Firmware aktualisieren und Release öffnen, dazu Alle Versionen ansehen.

Eine Firmware wird nur angeboten, wenn ein Master angeschlossen ist. Ein Master, der keine Version nennt, gilt als veraltet: Er hat eine Firmware von vor diesem Feld. Ohne Master am Kabel wird nichts angeboten. Eine unleserliche Version gilt nie als neuer.

Die Software aktualisieren

1. Klicke auf Jetzt aktualisieren (Streifen) oder Software aktualisieren (Einstellungen).
2. Die Software lädt das Setup und zeigt den Fortschritt, prüft die Prüfsumme (SHA-256 aus dem Manifest) und startet es still.
3. Dann übernimmt das Setup: Es beendet die Software und ihr Hintergrundprogramm, ersetzt die Dateien und startet die Software wieder. Dass dabei nach dem Start des Setups keine Meldung mehr kommt, ist das Ende, kein Fehler.

Meldungen dabei: Setup wird geladen …, dann Setup wird gestartet. Die Software schließt sich gleich und ist danach wieder da.

• Stimmt die Prüfsumme nicht, wird die Datei gelöscht statt nur nicht gestartet. Ein fremdes Programm unter einem vertrauten Namen ist schlimmer als gar keines.
• Nach einem Fehler darfst du es noch einmal versuchen.
• Läuft das Setup schon, gehört die Leiste dem Fortschritt. Der Hinweis „Jetzt aktualisieren“ erscheint währenddessen nicht noch einmal.

Gut zu wissen: Deine Einstellungen liegen in deinem Benutzerordner und überleben das Update. Ob ohne Administratorrechte aktualisiert werden kann, hängt davon ab, für wen du installiert hast: Bei „nur für mich“ läuft es still durch, bei „für alle“ fragt Windows nach (siehe Installation).

Die Firmware aktualisieren

Hier lädt die Software die Datei von GitHub, rechnet die Prüfsumme nach und schiebt die Bytes über das USB-Kabel, das ohnehin steckt. Geschrieben wird sie vom Master selbst.

1. Klicke Firmware aktualisieren.
2. Der Fortschritt zeigt sich in Schritten: Firmware wird geladen …, dann „0 von 43 Stücken“ bis zum Ende, mit Prozentbalken.
3. Am Ende: „Firmware übertragen. Der Master startet neu und meldet sich gleich mit seiner neuen Version.“
4. Nach dem Neustart zeigt Einstellungen → Geräte (und die Seite des Masters im Reiter Gerät) die neue Firmware-Version.

Zu wissen:

• Es geht nichts kaputt, wenn unterwegs der Strom ausfällt. Der Master legt die neue Firmware in eine zweite Partition. Die alte bleibt unberührt, und fällt etwas aus, startet er mit ihr. Der Start-Code im ROM des ESP32-S3 lässt sich ohnehin nicht überschreiben.
• Jedes Stück wird einzeln bestätigt. Eine Quittung für das falsche Stück bricht ab, damit keine lückenhafte Partition entsteht.
• Antwortet der Master nicht, bricht die Software mit „Der Master antwortet nicht“ ab. Eine Firmware, die diese Nachrichten noch gar nicht kennt, lässt sich nur über den Download-Modus mit esptool erneuern. Die Software erkennt das an den ausbleibenden Antworten und sagt es.
• Nach einem Fehler darfst du es erneut versuchen. Nach einem fertigen Update nicht mehr: Der Master startet gerade neu.
• Ein Update läuft nur eines nach dem anderen („Es läuft schon eine Übertragung“).

Zusammen mit dem Setup

Die Firmware muss mit der Software zusammenpassen. Die Protokollfassung sagt, wie sie miteinander sprechen. Du siehst sie in der Karte Master der Übersicht (Feld Protokoll, zum Beispiel „2 · Software 2“). Ist eine Seite zu alt, sagt die Software welche, in Einstellungen → Geräte:

Der Master spricht Protokoll 1, diese Software 2. Ein Firmware-Update fehlt.

oder, andersherum, „… Diese Software ist zu alt.“ Ein Master, der seine Protokollversion gar nicht nennt, hat eine Firmware, die älter ist als diese Software. Abgewiesen wird nie: Ein Deck, das wegen einer Zahl den Dienst verweigert, wäre schlimmer als eines, das eine Nachricht nicht kennt. Die Software sagt nur, welche Seite zu alt ist.

Bietet die Software eine neuere Firmware an, spielst du sie mit Firmware aktualisieren ein.

---

Weiter: Einstellungen · Fehlerbehebung