AWTRIX auf der Ulanzi TC001 – die Pixel-Uhr fürs Smart Home

Passende Hardware im Überblick

Die Pixel-Uhr selbst:
Ulanzi TC001 Smart Pixel Clock – die Basis für AWTRIX (Link)*

Selbstbau statt Fertiggerät – alles auf ESP32-Basis:
ELEGOO ESP32-Boards im 3er-Pack – der passende Chip (Link)*
BTF WS2812B LED-Streifen 5m für eine eigene Matrix (Link)*
Breadboard-Set mit Netzteil zum Aufbauen (Link)*
USB-TTL-Kabel (FTDI) für Boards ohne USB-Buchse (Link)*

Die Smart-Home-Zentrale dahinter:
Raspberry Pi 5 mit 8GB RAM – die Empfehlung für Home Assistant (Link)*
Raspberry Pi 5 mit 16GB RAM für viele Dienste (Link)*
Raspberry Pi 5 mit 4GB RAM – wenn es günstig sein soll (Link)*
Raspberry Pi 4 Starter-Set (Link)*
Home Assistant Green – fertig eingerichtet aus der Schachtel (Link)*
Offizielles 27-W-Netzteil für den Pi 5 (Link)*
Geekworm X1001 M.2-HAT (Link)*
Crucial P310 NVMe SSD 500GB (Link)*
SanDisk Extreme A2 128GB microSD (Link)*

Funk und Sensorik, die Daten auf das Display liefern:
Sonoff Zigbee-Stick MG24 (Link)*
Home Assistant Connect ZBT-2 (Link)*
Home Assistant Voice Preview Edition (Link)*

Kurz gesagt: Was kann AWTRIX auf der Ulanzi TC001?

Die Kurzfassung:

• Aus der Uhr wird ein Display fürs Haus: AWTRIX ersetzt die Werksfirmware der Ulanzi TC001 und macht aus der Pixel-Uhr eine 32×8-Anzeige, die alles zeigt, was das Smart Home hergibt – Temperatur, Strompreis, Paketstatus, Türklingel.
• Wichtig 2026: AWTRIX 3 wird nicht mehr weiterentwickelt; letzte Version ist 0.98 vom Januar 2025. Nachfolger ist AWTRIX NG, eine komplette Neuentwicklung, die im August 2026 bei Version 1.1.0 steht.
• Flashen im Browser: Chrome, Edge oder Opera genügen. Ein USB-C-Datenkabel anstecken, den Web-Flasher öffnen, Port wählen – fertig. Es muss nichts installiert werden.
• Zwei Arten von Inhalt: Eine App belegt dauerhaft einen Platz in der Anzeigerotation, eine Notification drängt sich einmalig davor und verschwindet wieder.
• Home Assistant ohne YAML: Über MQTT meldet sich das Gerät selbst per Auto-Discovery an. Danach lässt es sich in Automationen genauso ansprechen wie jede Lampe.
• Neu in NG: Kleine Programme laufen direkt auf dem Gerät. Der Code wird im Browser eingegeben, bleibt gespeichert und läuft weiter, selbst wenn der Server im Keller aus ist.

Was AWTRIX ist – und was aus AWTRIX 3 geworden ist

Die Ulanzi TC001 ist ab Werk eine hübsche, aber begrenzte Pixel-Uhr: Zeit, Datum, Temperatur, ein paar Effekte. Im Inneren steckt allerdings ein ESP32 mit einer Matrix aus 256 einzeln ansteuerbaren WS2812-Pixeln, dazu ein Helligkeitssensor, ein Klima-Sensor, ein Summer, drei Tasten und ein Akku. Das ist deutlich mehr, als die Werksfirmware daraus macht – und genau hier setzt AWTRIX an.

Die alternative Firmware stammt von Blueforcer und verwandelt das Gerät in eine Netzwerkanzeige, die über HTTP und MQTT jeden Text, jede Zahl und jedes Symbol entgegennimmt. Wichtig ist dabei das Grundprinzip: Die Uhr denkt nicht selbst mit. Sie zeigt, was ihr geschickt wird. Die Logik – wann welcher Wert erscheint – liegt im Smart-Home-System.

Wer 2026 einsteigt, muss allerdings eine Weggabelung kennen. AWTRIX 3 war jahrelang der Standard, ist aber eingestellt: Das Projekt wurde archiviert, die letzte Version 0.98 stammt vom 5. Januar 2025, neue Funktionen gibt es nicht mehr. Die Firmware läuft auf vorhandenen Geräten weiter, doch Fehler werden nicht mehr behoben.

Der Nachfolger heißt AWTRIX NG und ist von Grund auf neu geschrieben. Er bringt eine eigene API in Version 1, eine Weboberfläche mit Live-Vorschau der Matrix und – der eigentliche Sprung – einen Skript-Editor direkt im Gerät. Ein Wechsel von AWTRIX 3 auf NG ist kein Update: Nichts wird übernommen, alte Integrationen müssen neu gebaut werden, das Gerät wird frisch eingerichtet. Für Neueinsteiger ist die Sache damit klar, für Bestandsnutzer eine bewusste Entscheidung.

AWTRIX auf die Ulanzi TC001 flashen – Schritt für Schritt

1. Kabel prüfen: Ein reines Ladekabel taucht am Rechner nicht als serieller Port auf. Es braucht ein USB-C-Datenkabel – der häufigste Grund, warum der Flasher nichts findet.
2. Werksfirmware sichern: Vor dem Überschreiben lohnt eine Kopie mit esptool: python -m esptool --chip esp32 --port /dev/ttyUSB0 --baud 921600 read_flash 0x0 0x400000 tc001-stock-4mb.bin. Die Datei muss exakt 4.194.304 Bytes groß sein, sonst war der Lesevorgang unvollständig.
3. Browser-Flasher öffnen: Die Dokumentation von AWTRIX NG enthält einen Flasher, der im Browser läuft. Chrome, Edge oder Opera am Desktop beherrschen die nötige Web-Serial-Schnittstelle; Firefox und Safari nicht.
4. „Fresh install" wählen: Bei der Erstinstallation werden Einstellungen, WLAN-Daten, Symbole und Skripte gelöscht. Der Flasher erkennt Chip und Speichergröße selbst und schreibt die passende aktuelle Version.
5. WLAN einrichten: Nach dem Neustart zeigt die Matrix „AP MODE" in Regenbogenfarben und das Gerät spannt ein offenes Funknetz auf. Damit verbinden, die Einrichtungsseite öffnet sich meist von selbst – sonst hilft die Adresse 192.168.4.1.
6. Adresse notieren: Nach dem nächsten Start läuft die IP-Adresse einmal über das Display. Wer sie verpasst, startet das Gerät neu oder findet es per mDNS unter awtrix-ng.local.
7. Erste Nachricht schicken: Der Test in einer Zeile: curl -X POST http://awtrix-ng.local/api/v1/notifications -H "Content-Type: application/json" -d '{"text":"Hallo","textColor":"#FF0000"}' – der Schriftzug läuft in Rot über die Matrix.
8. Helligkeit automatisieren: Mit autoBrightness folgt das Display dem Lichtsensor und bleibt nachts angenehm dunkel, ohne bei Tageslicht unlesbar zu werden.

Apps, Benachrichtigungen und Skripte – so kommt Inhalt aufs Display

AWTRIX kennt drei Wege, Inhalte anzuzeigen. Sie unterscheiden sich vor allem in ihrer Lebensdauer:

Der Inhalt selbst ist in beiden Fällen dasselbe JSON-Objekt: Text, Farben, Symbole, Balken- und Liniendiagramme, Hintergrundeffekte. Ein Wetterwert landet damit so auf dem Panel: curl -X PUT http://<ip>/api/v1/apps/pushed/wetter -H "Content-Type: application/json" -d '{"text":"21.5C","textColor":"#00AAFF"}'.

Die Skripte sind das wirklich Neue an AWTRIX NG. Geschrieben werden sie in Berry, einer kleinen Sprache, die sich an Python anlehnt. Das Programm wird in den Editor eingefügt, gespeichert – und reiht sich als eigene Seite in die Rotation ein. Es darf selbst HTTP-Anfragen stellen, MQTT sprechen und Zustände über einen Neustart hinweg behalten. Stürzt ein Skript ab, färbt sich nur dessen eigene Seite rot; alles andere läuft weiter.

AWTRIX mit Home Assistant verbinden

Der übliche Weg ins Smart Home führt über MQTT. Auf dem Server – meist ein Raspberry Pi mit Home Assistant – läuft ohnehin ein Broker; das Gerät bekommt dessen Adresse, einen eigenen Präfix und einen Neustart, denn die MQTT-Einstellungen werden nur beim Start gelesen. Danach meldet es sich per Auto-Discovery von selbst an: Helligkeit, Lautstärke, Anzeige und Sensoren erscheinen als Entitäten, ganz ohne Konfigurationsdatei.

Praktisch ist dabei, dass MQTT- und HTTP-Befehle identisch aufgebaut sind. Was per curl funktioniert, funktioniert unverändert auch als MQTT-Nachricht unter <praefix>/cmd/notify. Jede Anweisung wird auf einem Antwort-Topic quittiert, was die Fehlersuche stark vereinfacht.

Was in der Community am häufigsten auf solchen Displays landet:

• Energie: aktueller Verbrauch, Ertrag des Balkonkraftwerks oder der günstigste Stromtarif der nächsten Stunden.
• Klima: Werte von Temperatursensoren aus anderen Räumen, Luftfeuchte, CO₂-Gehalt im Büro.
• Ereignisse: Die Türklingel löst eine Notification samt Melodie aus, die Waschmaschine meldet sich zum Ende des Programms.
• Alltag: Abfallkalender, nächster Termin, Ankunftszeit des Busses, ungelesene Nachrichten.
• Status: offene Fenster, Anwesenheit, Erreichbarkeit des Servers.

Wer lieber grafisch arbeitet, baut die Logik in Node-RED zusammen. Und wer die Anzeige mit selbst gebauten Sensoren füttern will, kommt an ESPHome oder ESP32-Funkgeräten selten vorbei – dieselbe Chip-Familie, dieselbe Werkzeugkette.

Fehler & Stolpersteine

• Ladekabel statt Datenkabel: Der mit Abstand häufigste Fehler beim Flashen. Ohne Datenleitungen erscheint kein serieller Port, und der Browser zeigt eine leere Auswahl.
• Falscher Browser: Der Web-Flasher braucht Web Serial. Firefox und Safari beherrschen das nicht – dort bleibt nur der manuelle Weg über esptool.
• Kein Rückweg ohne Sicherung: Wer die Werksfirmware nicht vorher ausliest, bekommt sie nicht zurück. Die Sicherung geht nur vor dem Flashen, nicht danach.
• Anleitungen aus der AWTRIX-3-Zeit: Ältere Beiträge und fertige Vorlagen beziehen sich auf die alte API. Unter AWTRIX NG gelten neue Endpunkte – wer beides mischt, sucht lange nach dem Fehler.
• MQTT-Präfix vergessen: Ohne eigenen Präfix nutzt das Gerät seine Hardware-Adresse als Topic. Zwei Uhren mit demselben Präfix reagieren beide auf jeden Befehl.
• Einstellungen ohne Neustart: MQTT-Zugangsdaten und der Pin-Belegungsplan werden erst beim Start eingelesen. Speichern allein reicht nicht.
• Offenes Einrichtungsnetz: Im AP-Modus ist das Funknetz unverschlüsselt und für jeden in Reichweite offen. Die Einrichtung gehört deshalb zügig abgeschlossen.
• Lizenz beachten: AWTRIX NG steht unter einer nichtkommerziellen Lizenz. Privat, in Schulen und in der Forschung ist alles erlaubt, der gewerbliche Einsatz braucht eine gesonderte Vereinbarung.

Häufige Fragen zu AWTRIX und der Ulanzi TC001

Soll ich noch AWTRIX 3 installieren oder gleich AWTRIX NG?
Bei einem neuen Gerät führt kein Weg an NG vorbei: AWTRIX 3 bekommt keine Updates mehr. Nur wer eine bestehende Installation mit vielen fertigen Abläufen betreibt, hat einen Grund zu warten – ein Umzug bedeutet Neuaufbau.

Brauche ich zwingend Home Assistant?
Nein. Alles, was HTTP oder MQTT spricht, kann die Anzeige füttern – ein Shell-Skript, ein Cronjob, Node-RED oder ioBroker. Mit den Skripten auf dem Gerät kommt AWTRIX NG sogar ganz ohne Server aus.

Kann ich zur Werksfirmware zurück?
Ja, aber nur mit der vorher angelegten Sicherungsdatei. Diese wird mit esptool wieder an Adresse 0 geschrieben, danach ist das Gerät im Auslieferungszustand samt gespeicherter WLAN-Daten.

Funktioniert AWTRIX auch auf selbst gebauten Matrizen?
Ja. AWTRIX NG nutzt ein Firmware-Abbild je Chip, nicht je Gerät. Panels mit 8 Pixeln Höhe und 32 bis 128 Pixeln Breite werden unterstützt, die Pin-Belegung ist eine Einstellung in der Weboberfläche.

ESP32 oder ESP32-S3 für den Eigenbau?
Beide laufen. Ein ESP32-S3 mit PSRAM hat deutlich mehr Luft für viele Skripte und ist die einzige Variante, die Internetradio abspielen kann. Für den klassischen Anzeigebetrieb genügt der einfache ESP32.

Kann die Uhr Töne ausgeben?
Ja, über den eingebauten Summer als RTTTL-Melodie. Wer mehr will, hängt einen DFPlayer oder einen Lautsprecher an und spielt eigene Dateien ab, jeweils mit eigener Lautstärke.

Lässt sich die Uhr ohne Steckdose betreiben?
Nur zeitweise. Der eingebaute Akku überbrückt einen Umzug in einen anderen Raum, für den Dauerbetrieb als Statusanzeige gehört das Gerät an ein Netzteil – helle Pixel verbrauchen spürbar Strom.

Fazit

AWTRIX auf der Ulanzi TC001 ist eines der wenigen Smart-Home-Projekte, bei denen aus einem Fertiggerät für kleines Geld etwas wird, das man täglich ansieht – und das nach zwei Stunden Arbeit fertig ist. Unsere klare Empfehlung: Steig direkt mit AWTRIX NG ein und ignoriere die alten Anleitungen zu AWTRIX 3. Die Version 3 ist eingestellt, jede Stunde, die in ihre API fließt, ist verloren – und NG kann mit den Skripten auf dem Gerät ohnehin mehr. Zwei Dinge sollte man dabei nicht überspringen: die Sicherung der Werksfirmware vor dem ersten Flashen und einen sprechenden MQTT-Präfix. Beides kostet fünf Minuten und erspart später sehr viel Ärger.

* = Affiliate Link (raspi-config.de ist Teilnehmer des Partnerprogramms von Amazon EU, das zur Bereitstellung eines Mediums für Websites konzipiert wurde, mittels dessen durch die Platzierung von Werbeanzeigen und Links zu Amazon.de Werbekostenerstattung verdient werden kann.)