Die Ulanzi TC001 in Home Assistant zu integrieren, macht die Pixel-Uhr zu einer Anzeige für Smart-Home-Werte und Benachrichtigungen. Dafür wird eine alternative Firmware installiert und die Uhr über MQTT mit Home Assistant verbunden. Diese Anleitung führt dich von den Voraussetzungen bis zu einer ersten Automation.

Wichtig: Das Flashen ersetzt die mitgelieferte Firmware. Die ursprüngliche Ulanzi-Oberfläche und ihre Funktionen werden dadurch nicht automatisch übernommen. Wenn du zur Originalsoftware zurückkehren möchtest, sichere sie vorab. Die Installation löscht außerdem die gespeicherten WLAN-Daten. Eine aktuelle Home-Assistant-Sicherung ist vor Änderungen am Smart Home ebenfalls sinnvoll.

Werbung / Affiliate-Links: Die mit einem Sternchen (*) gekennzeichneten Links sind Amazon-Partnerlinks. Wenn du darüber etwas kaufst, erhalte ich möglicherweise eine Provision. Für dich entstehen dadurch keine zusätzlichen Kosten. Als Amazon-Partner verdiene ich an qualifizierten Verkäufen.

Was die Ulanzi TC001 mit Home Assistant kann

Mit der Community-Firmware AWTRIX NG kann die Ulanzi TC001 Informationen aus Home Assistant auf ihrer LED-Matrix anzeigen. Dazu gehören zum Beispiel Temperaturwerte, Energieverbrauch, der Status eines Geräts oder kurze Hinweise wie „Waschmaschine fertig“. Auch Displayhelligkeit und einzelne Anzeigeelemente lassen sich über Home Assistant steuern.

Die Verbindung läuft über MQTT. Wenn die automatische Geräteerkennung aktiviert ist, legt Home Assistant die Uhr als Gerät mit passenden Entitäten an. Eine zusätzliche HACS-Integration ist für diesen Grundaufbau nicht erforderlich. Die Funktionen hängen teilweise davon ab, welche Sensoren und Hardware in der TC001 vorhanden sind.

AWTRIX NG ist der Nachfolger von AWTRIX 3 und hat eine eigene API. Vorhandene AWTRIX-3-Automationen oder Blueprints funktionieren deshalb nicht zwingend unverändert. Prüfe außerdem die Lizenzhinweise zu AWTRIX NG: Das Projekt ist für nicht-kommerzielle Nutzung lizenziert; für einen gewerblichen Einsatz verlangt der Projektautor eine separate Vereinbarung.

Voraussetzungen für die Integration

  • Eine Ulanzi TC001 und ein Computer mit Chrome, Edge oder Opera
  • Ein USB-Datenkabel: Ein Kabel, das nur lädt, reicht zum Flashen nicht aus
  • Home Assistant 2024.11 oder neuer für die AWTRIX-NG-Geräteerkennung
  • Ein erreichbarer MQTT-Broker, zum Beispiel Mosquitto, und die MQTT-Integration in Home Assistant
  • Ein gemeinsames Netzwerk, über das Home Assistant und die Uhr den MQTT-Broker erreichen

Falls Home Assistant noch neu für dich ist, findest du in unserer Anleitung zu den ersten Schritten mit Home Assistant Hinweise zu Grundeinstellungen, Netzwerk und Backups.

AWTRIX NG auf der Ulanzi TC001 installieren

Verwende zum Flashen die Installationsseite des AWTRIX-Projekts. Sie stellt den aktuellen Flasher für die TC001 bereit und beschreibt auch den Weg zurück zur Originalsoftware.

  1. Schließe die Uhr mit einem USB-Datenkabel an den Computer an.
  2. Öffne den offiziellen AWTRIX-NG-Flasher in einem unterstützten Desktop-Browser.
  3. Wähle für eine neue Installation „Fresh install“ und anschließend den von der Uhr angebotenen seriellen Anschluss.
  4. Warte, bis der Flasher den Abschluss meldet. Trenne die Uhr während des Vorgangs nicht vom Computer.

Nach dem ersten Start richtet die Uhr einen WLAN-Zugangspunkt ein. Verbinde sie mit deinem WLAN und notiere ihre IP-Adresse. Sie wird beim Start auf dem Display angezeigt. Wenn du später zur Ulanzi-Firmware zurückkehren möchtest, erstelle vor dem Flashen ein Backup des Originalsystems.

Die Standardfunktionen aus der ursprünglichen Ulanzi-Software – etwa Social-Media-Zähler oder deren App-Oberfläche – werden beim Firmwarewechsel nicht automatisch übernommen. Mit AWTRIX NG kannst du eigene Anzeigen und Apps einrichten. Für einen Social-Media-Zähler muss Home Assistant zunächst einen passenden Zählerwert als Entität bereitstellen.

Ulanzi TC001 mit MQTT in Home Assistant verbinden

Öffne zunächst die Weboberfläche der Uhr. Wechsle dort zu den Systemeinstellungen und zum MQTT-Bereich. Trage die Adresse und den Port deines Brokers ein. Falls dein Broker einen Benutzernamen und ein Passwort verlangt, hinterlege auch diese Zugangsdaten.

  1. Aktiviere MQTT und gib die Broker-Adresse sowie den passenden Port ein.
  2. Aktiviere „HA discovery“ beziehungsweise die Home-Assistant-Geräteerkennung.
  3. Speichere die Einstellungen und starte die Uhr neu, damit sie sich mit dem Broker verbindet.
  4. Öffne in Home Assistant Einstellungen → Geräte & Dienste → MQTT und prüfe, ob die TC001 dort als Gerät erscheint.

Die genaue Bezeichnung einzelner Einstellungen kann sich mit Firmwareversionen ändern. Die aktuelle AWTRIX-NG-Anleitung für Home Assistant beschreibt die Einrichtung und die automatisch bereitgestellten Entitäten.

Je nach TC001 können in Home Assistant unter anderem die LED-Matrix, Helligkeit, Tasten, WLAN-Status, Temperatur, Luftfeuchtigkeit, Umgebungslicht und Akkuzustand erscheinen. Die Temperaturmessung sitzt nahe an der LED-Matrix und kann dadurch beeinflusst werden. Für genaue Raumtemperaturen eignet sich ein separater Temperatursensor besser.

Ersten Sensorwert auf der Pixel-Uhr anzeigen

Eine Automation kann einen Home-Assistant-Sensor als eigene Anzeige an die Uhr schicken. Das folgende Beispiel aktualisiert die Anzeige bei einer Änderung des Sensors und nach einem Neustart von Home Assistant. Ersetze sensor.wohnzimmer_temperatur durch deine Sensor-Entität.

alias: AWTRIX – Wohnzimmer-Temperatur
description: Zeigt die Temperatur auf der Ulanzi TC001 an
triggers:
  - trigger: state
    entity_id: sensor.wohnzimmer_temperatur
  - trigger: homeassistant
    event: start
conditions:
  - condition: template
    value_template: >-
      {{ states('sensor.wohnzimmer_temperatur') not in ['unknown', 'unavailable'] }}
actions:
  - action: mqtt.publish
    data:
      topic: awtrixNG/cmd/apps/pushed/wohnzimmer
      payload: >-
        {{ {"text": (states('sensor.wohnzimmer_temperatur') | float(0) | round(1) | string) ~ " °C"} | to_json }}
mode: restart

Im Beispiel ist awtrixNG das MQTT-Präfix der Uhr. Wenn du in der Weboberfläche ein anderes Präfix eingestellt hast, passe den Topic entsprechend an. Die Anzeige wird als App angelegt und aktualisiert sich, sobald die Automation erneut läuft.

Du kannst denselben Aufbau für Stromverbrauch, Luftfeuchtigkeit oder andere Messwerte verwenden. Für Wetterdaten muss Home Assistant eine passende Wetterintegration oder Sensor-Entität bereitstellen. Für einen Pomodoro-Timer kannst du einen Home-Assistant-Timer mit einer eigenen Anzeige oder einem passenden AWTRIX-Skript kombinieren.

Benachrichtigungen aus Home Assistant senden

Für kurze Hinweise verwendest du den Benachrichtigungs-Topic der Uhr. Ein Beispiel für eine Automation, die bei einem fertigen Gerät eine Meldung auf dem Display zeigt:

alias: AWTRIX – Waschmaschine fertig
triggers:
  - trigger: state
    entity_id: binary_sensor.waschmaschine_fertig
    to: "on"
actions:
  - action: mqtt.publish
    data:
      topic: awtrixNG/cmd/notify
      payload: '{"text":"Waschmaschine fertig","textColor":"#00FF00","durationMs":8000}'
mode: single

Auch hier muss awtrixNG mit dem MQTT-Präfix deiner Uhr übereinstimmen. Passe außerdem binary_sensor.waschmaschine_fertig an die Entität an, die den Status deiner Waschmaschine meldet. AWTRIX NG unterscheidet zwischen einer kurz eingeblendeten Benachrichtigung und einer App, die in der Anzeige-Rotation bleibt.

Fehler bei der Einrichtung beheben

  • Die Uhr erscheint nicht in Home Assistant: Prüfe, ob MQTT aktiviert ist, die Broker-Adresse stimmt und die Geräteerkennung eingeschaltet ist. Kontrolliere auch, ob beide Geräte den Broker im Netzwerk erreichen.
  • Die Uhr verbindet sich nicht mit dem Broker: Prüfe Port, Zugangsdaten und Netzwerkregeln. Nach einer Änderung der Broker-Einstellungen muss die Uhr neu gestartet werden.
  • Der Flasher erkennt die Uhr nicht: Verwende ein USB-Datenkabel und einen unterstützten Desktop-Browser. Ein reines Ladekabel stellt keine Datenverbindung her.
  • Eine Anzeige bleibt nach einem Neustart leer: Eine per MQTT gesendete App wird nicht dauerhaft gespeichert. Sende ihren Inhalt erneut, zum Beispiel beim Start von Home Assistant.
  • Die Temperatur wirkt zu hoch: Die Messung kann durch die Nähe zur LED-Matrix beeinflusst werden. Nutze für präzise Raumwerte einen separaten Sensor.

Wenn du Energie- oder Leistungswerte auf der Uhr anzeigen möchtest, müssen diese zuerst in Home Assistant verfügbar sein. Beim Einrichten hilft unser Beitrag zum Home-Assistant-Energie-Dashboard.

Häufige Fragen zur Ulanzi TC001 in Home Assistant

Benötige ich HACS für die Ulanzi TC001?

Für die grundlegende Verbindung mit AWTRIX NG nicht. Die Uhr meldet sich über MQTT und kann mit aktivierter Geräteerkennung automatisch in Home Assistant erscheinen.

Kann ich Social-Media-Zähler anzeigen?

Ja, sofern Home Assistant den Zählerwert als Entität erhält. Die TC001 zeigt diesen Wert dann als eigene Anzeige an. Die Datenquelle oder Plattformanbindung musst du separat einrichten.

Bleiben die Ulanzi-Funktionen nach dem Flashen erhalten?

Nein, die Installation ersetzt die mitgelieferte Firmware. Funktionen der Originalsoftware werden nicht automatisch in AWTRIX NG übernommen. Erstelle vorab ein Backup, wenn du zurückwechseln möchtest.

Kann ich die TC001 auch ohne Home Assistant nutzen?

Ja. AWTRIX NG lässt sich über die Weboberfläche sowie über MQTT und HTTP steuern. Home Assistant ist eine Möglichkeit, Werte und Benachrichtigungen an die Uhr zu senden.

Ulanzi TC001 und optionales Zubehör

Die Ulanzi TC001 ist der Hauptartikel für diese Anleitung. Der Link führt zu dem von uns ausgewählten Produkt. Preis und Verfügbarkeit können sich ändern.

* Ulanzi TC001 Smart Pixel Clock bei Amazon ansehen

Für das Flashen brauchst du ein USB-Datenkabel. Prüfe zuerst, ob das vorhandene Kabel Daten überträgt; ein zusätzliches Kabel ist nur nötig, wenn es fehlt oder ein reines Ladekabel ist.

* USB-C-Datenkabel bei Amazon suchen

Wenn du eine größere Pixelanzeige suchst, kannst du außerdem die Ulanzi TC002 als Alternative prüfen. Sie ist ein anderes Gerät und nicht Teil der TC001-Schritt-für-Schritt-Anleitung.

* Ulanzi TC002 bei Amazon suchen

Fazit: Ulanzi TC001 in Home Assistant integrieren

Mit AWTRIX NG und MQTT wird die Ulanzi TC001 zu einer flexibel steuerbaren Anzeige für Home Assistant. Nach dem Flashen und der Broker-Konfiguration kann Home Assistant das Gerät automatisch erkennen. Sensorwerte und Meldungen schickst du anschließend mit MQTT-Automationen auf das Display.

Plane den Firmwarewechsel bewusst: Er ersetzt die Ulanzi-Software und setzt WLAN-Einstellungen zurück. Sichere das Originalsystem, falls du es später wiederherstellen möchtest, und prüfe bei AWTRIX NG die Lizenzbedingungen für deinen Einsatzzweck.