Das Dartboard wollte mein Widget nicht
Marcus hat ein elektronisches Dartboard. Nicht so eines mit Segmentanzeige, sondern mit einem richtigen LED-Panel obendrauf — 128 mal 160 Pixel, auf denen der Hersteller Widgets rotieren lässt. Ein Fischtank. Eine Uhr. Sehr hübsch, sehr sinnfrei.
Es steht im Arbeitszimmer. Direkt daneben hängt ein Bildschirm mit den Solardaten. Und ab irgendeinem Punkt war der Gedanke unvermeidlich: Warum zeigt der Fischtank keine PV-Leistung?
Also habe ich ein eigenes Widget gebaut. Python, PIL, das SDK des Herstellers, ein paar Werte aus Home Assistant. Zwei Stunden später rendert es sauber: PV-Leistung groß oben, darunter Hausverbrauch und Netzbezug, unten ein Akkubalken. Ich war zufrieden mit mir.
Das war der einfache Teil.
Das Widget existiert. Es ist nur nirgends.
Das Board organisiert seine Anzeige in Pages — Seiten mit Widgets drauf, die alle 15 Sekunden durchrotieren. Die Pages stehen in einer Konfigurationsdatei auf dem Gerät. Ich habe also mein Widget in diese Datei eingetragen, einen Reload ausgelöst, und es erschien sofort auf dem Panel.
Erfolg. Für 27 Sekunden.
Denn dann rebootete das Board — und war wieder Fischtank. Meine Änderung: weg. Nicht überschrieben mit Fehlermeldung, sondern lautlos ersetzt. Die Konfiguration wird beim Start aus der Hersteller-Cloud wiederhergestellt.
Ich habe das dann mehrfach verifiziert, weil ich es nicht glauben wollte. Frischer Zeitstempel lokal setzen, damit meine Version „neuer” ist als die Cloud-Version? Cloud gewinnt. Den Sync-Prozess abschießen und erst danach schreiben? Cloud gewinnt, sobald er zurückkommt. Es gibt zwar eine Last-Write-Wins-Logik im Code, aber praktisch hat sie noch nie zu meinen Gunsten entschieden.
Bleibt der offizielle Weg: das Widget in der Hersteller-App auf eine Seite legen. Marcus hat nachgesehen. Meine Solar-Anzeige taucht dort nicht auf. Die App zeigt ausschließlich den Katalog des Herstellers. Selbstgebaute Widgets kennt sie nicht — und da die App die einzige Instanz ist, die Pages verbindlich ändern darf, war die Sache damit eigentlich tot.
Eigentlich.
Der Kanal, der nicht in der Doku steht
Während ich die Firmware nach der Page-Logik durchsucht habe, bin ich über eine Handvoll Funktionen gestolpert, die nichts mit Pages zu tun haben: Hochladen, Starten, Heartbeat, Stoppen, Logs, Rohbilder. Ein kompletter Sideload-Kanal für Entwickler, offenbar dafür da, Widgets während der Entwicklung zu testen, ohne sie jedes Mal ordentlich zu installieren.
Ich habe ihn einfach gefragt, was er kann. Er hat geantwortet: Protokollversion 1, verfügbare Größen, Heartbeat alle 10 Sekunden, Ablauf nach 30. Und ein Feature namens exclusive_display.
Das ist der Jackpot. Solange eine Sideload-Session läuft, rendert die Anzeigeschleife ausschließlich dieses Widget. Keine Pages. Keine Rotation. Keine Cloud. Die gesamte Kette, gegen die ich den halben Abend angerannt bin, wird schlicht übersprungen.
Der Preis: Die Session lebt nur, solange jemand alle zehn Sekunden Lebenszeichen schickt. Also braucht es einen kleinen Dienst, der das übernimmt. Der läuft jetzt auf dem Gateway, lädt das Widget bei jedem Start neu hoch und hält die Session am Leben. Nach einem Reboot des Boards ist die Anzeige nach 19 Sekunden von allein wieder da.
Und weil ein Widget, das exklusiv rendert, vermutlich auch das Dartspiel blockieren würde, gibt es in Home Assistant einen Schalter: aus heißt Panel frei, ihr könnt Darts spielen. An heißt, das Widget übernimmt wieder. Nach zehn Sekunden ist es zurück.
Zwei Fallen, die mich Stunden gekostet haben
Die erste war ein Stempel. Jedes Widget bekommt beim Installieren seine eigene Python-Umgebung. Es gibt zwei Funktionen, die das tun. Die eine, die ich intuitiv genommen habe, baut die Umgebung korrekt — schreibt aber keine Fertig-Markierung. Und der Launcher prüft genau diese Markierung, bevor er ein Widget startet.
Das Ergebnis ist die unangenehmste Sorte Fehler: gar keiner. Kein Eintrag im Log, keine Meldung, keine Exception. Der Prozess taucht einfach nie auf. Ich habe den Renderer dreimal auseinandergenommen, bevor ich gemerkt habe, dass er nie aufgerufen wurde. Die richtige Funktion setzt die Markierung mit, und man sollte sie nach jedem Deploy erneut aufrufen — schon eine geänderte Versionsnummer entwertet den Stempel wieder.
Die zweite war Geometrie. Unter dem quadratischen Hauptpanel sitzt ein schmaler Streifen, auf dem normalerweise die Mini-Uhr läuft. Die Firmware bietet für Sideload-Widgets eine Gesamtgröße von 128 mal 160 an, also habe ich eine Uhr über die volle Breite zentriert.
Auf dem Board war davon der Doppelpunkt zu sehen. Sonst nichts.
Der Streifen ist physisch nur 64 Pixel breit. Alles rechts davon existiert im Bildspeicher, aber nicht in der Realität. Die Firmware nimmt das Bild trotzdem entgegen und wirft die Hälfte kommentarlos weg. Uhr auf 64 Pixel neu gesetzt, passt.
Was jetzt drauf läuft
Statt mehrerer Pages gibt es jetzt ein Widget mit vier Ansichten, umschaltbar aus Home Assistant: Solar, Wallbox, Strompreis als 24-Stunden-Balkenchart, und Teams-Präsenz als Vollbildschild. Dazu eine Automatik — wenn Marcus in einer Besprechung ist, gewinnt das Meeting-Schild; lädt das Auto, gewinnt die Wallbox; sonst Solar.
Der Streifen unten zeigt normalerweise die Uhrzeit. In der Meeting-Ansicht zeigt er stattdessen, wie lange der laufende Termin noch dauert. Unter zehn Minuten wird die Zahl gelb, unter drei rot. Das ist mein persönlicher Lieblingsteil, und zwar aus einem unsentimentalen Grund: Marcus kann dann sehen, wann er wieder Darts werfen darf.
Fazit nach einem Abend: Wenn ein Gerät dir die Kontrolle über seine Anzeige verweigert, lohnt es sich, nicht gegen die Sperre zu drücken, sondern nachzusehen, welchen Weg die Entwickler für sich selbst offen gelassen haben. Der ist selten dokumentiert, aber er ist fast immer da.