Blog

Home Assistant auf einer Amazfit-Uhr: der komplette Leitfaden (2026)

Ja, du kannst dein Home-Assistant-Zuhause von einer Amazfit-Uhr aus steuern. Dieser Leitfaden zeigt, wie die Verbindung funktioniert, was du steuern kannst, auf welchen Uhren es läuft, wie du es einrichtest und was zu tun ist, wenn die Uhr meldet, dass etwas nicht stimmt.

Veröffentlicht 18 Min. Lesezeit

In diesem Artikel
  1. Die kurze Antwort
  2. Wie eine Zepp-OS-Uhr mit Home Assistant spricht
    1. Uhr ↔ Handy per Bluetooth, Handy ↔ Home Assistant per HTTP
    2. Was nie auf die Uhr gelangt
    3. Warum das Handy in der Nähe sein muss und die Uhr kein WLAN braucht
    4. Zuerst lokal, unterwegs remote
  3. Was du vom Handgelenk aus steuern kannst
  4. Welche Uhren funktionieren
  5. Was du vor dem Start brauchst
  6. Einrichtung in sechs Schritten
    1. 1. AmazHA installieren
    2. 2. Die Demo ausprobieren
    3. 3. Einmal freischalten
    4. 4. Home Assistant verbinden
    5. 5. Deine Geräte auswählen
    6. 6. AmazHA auf der Uhr öffnen
  7. Ganz nach deinem Geschmack
    1. Favoriten und Favoriten als Startseite
    2. Das Energie-Panel
    3. Start-Chips, Reihenfolge der Räume und Raumsymbole
    4. Eigene Namen
    5. Schriftgröße, Kartengröße, Vibration und Bildschirm-Timeout
  8. Das Widget auf dem Zifferblatt
  9. Die Daten deiner Uhr in Home Assistant
  10. Grenzen, die du kennen solltest
  11. Wenn etwas nicht klappt
    1. Ein Beispiel: grüner Test, leere Uhr
  12. Die Vollversion freischalten
  13. Häufige Fragen

Die kurze Antwort

Ja. AmazHA, eine Home-Assistant-App für Amazfit-Uhren, läuft auf 25 Modellen mit Zepp OS und steuert Lichter, Klima, Rollos, Schlösser, Medien, Szenen und mehr vom Handgelenk aus. Eine offizielle Home-Assistant-App für Zepp OS gibt es nicht. Die Uhr spricht per Bluetooth mit deinem Handy, das Handy mit Home Assistant, und zu Hause braucht es dafür nur deine lokale Adresse.

Auf einen Blick
Uhren 25 Amazfit-Modelle mit Zepp OS, eckig und rund
Gerätetypen 17, jeder mit eigenem Steuerbildschirm
Verbindung Uhr ↔ Handy per Bluetooth, Handy ↔ Home Assistant per HTTP
Adressen Lokale URL zu Hause, optional eine Remote-URL für unterwegs
Token Ein langlebiges Zugriffstoken eines Administrators, gespeichert auf dem Handy
Aktualisierung Alle 8 Sekunden, solange die App geöffnet ist
Geräte auf der Uhr Bis zu 100; mit ein paar Dutzend bleibt sie schnell
Widget auf dem Zifferblatt Bis zu vier Geräte
Uhrdaten in Home Assistant 18 optionale Sensoren, über die Integration Mobile App
Preismodell Kostenlose Demo, dann eine einmalige Freischaltung, kein Abo

Wie eine Zepp-OS-Uhr mit Home Assistant spricht

Die Uhr spricht nie selbst mit Home Assistant: Das übernimmt dein Handy. Eine Uhren-App unter Zepp OS kann keine Webanfragen stellen, deshalb besteht AmazHA aus zwei Hälften. Die eine läuft auf der Uhr und zeichnet die Bildschirme. Die andere läuft auf deinem Handy in der Zepp-App und ist der einzige Teil, der mit deinem Home-Assistant-Server spricht.

Uhr ↔ Handy per Bluetooth, Handy ↔ Home Assistant per HTTP

Wenn du auf der Uhr einen Raum öffnest, fragt die Uhr per Bluetooth beim Handy nach. Das Handy ruft mit deiner Adresse und deinem Token die REST-API von Home Assistant auf, kürzt die Antwort auf das, was die Uhr braucht, und schickt sie zurück. Tippst du auf ein Licht, läuft derselbe Weg umgekehrt: Die Uhr sagt es dem Handy, und das Handy ruft den Dienst in Home Assistant auf.

Daraus folgen zwei Dinge:

  • Nur was du ausgewählt hast, kommt auf der Uhr an. Das Handy lädt die Geräte, die du in den Einstellungen aktiviert hast, und sonst nichts. So bleibt der Bluetooth-Verkehr klein.
  • Der Bildschirm der Uhr hängt nicht davon ab, woher die Daten kommen. Die kostenlose Demo und dein echtes Zuhause nutzen dieselben Bildschirme; nur die Quelle ändert sich.

Was nie auf die Uhr gelangt

Deine Home-Assistant-Adresse und dein langlebiges Zugriffstoken bleiben auf dem Handy. Die Uhr bekommt Gerätenamen, Zustände und die Werte, die sie anzeigt, sonst nichts. Das Token wird nur an deinen Home-Assistant-Server gesendet, und sobald es gespeichert ist, zeigen die Einstellungen auf dem Handy Punkte statt des Tokens selbst. AmazHA hat keine Konten, keine Analyse und keinen Entwicklerserver, der irgendetwas über dich oder dein Zuhause speichert.

Warum das Handy in der Nähe sein muss und die Uhr kein WLAN braucht

Die Uhr erreicht Home Assistant über das Handy, also muss das Handy in Bluetooth-Reichweite sein, mit eingeschaltetem Bluetooth und der Zepp-App im Hintergrund. Die Uhr selbst braucht weder WLAN noch mobile Daten: Bluetooth zum Handy ist ihre einzige Verbindung.

Das Handy wiederum muss deinen Server erreichen. Zu Hause ist das dein lokales Netz. Unterwegs braucht es eine Remote-Adresse, und wenn du die Uhr nie außer Haus nutzt, brauchst du nie eine.

Zuerst lokal, unterwegs remote

Du kannst zwei Adressen eintragen: eine Lokale URL (LAN), etwa http://192.168.1.50:8123 (ein Beispiel), und eine Remote-URL für unterwegs. Jedes der beiden Felder darf leer bleiben. Sind beide ausgefüllt, bevorzugt AmazHA die lokale und wechselt von selbst zur Remote-Adresse, wenn die lokale nicht antwortet. Ein Token gilt für beide. Der Artikel zum Fernzugriff vergleicht Home Assistant Cloud, VPNs und die eigene Domain.

Was du vom Handgelenk aus steuern kannst

AmazHA unterstützt 17 Gerätetypen aus Home Assistant, und jeder bekommt seinen eigenen Steuerbildschirm. Der Startbildschirm zeigt deine Bereiche, benannt wie in Home Assistant; ein Raum zeigt seine Geräte nach Typ gruppiert; ein Tipp auf eine Kachel öffnet alle Regler. Lichter, Schalter und Ventilatoren haben außerdem einen Schalter direkt auf ihrer Kachel, und Szenen, Skripte, Automationen und Tasten starten von ihrer Kachel aus.

Gerätetyp Home-Assistant-Domains Was der Bildschirm auf der Uhr kann
Licht light Helligkeitsregler; die Krone ändert sie in Schritten von 4%. Ein nicht dimmbares Licht bekommt ein einfaches Ein/Aus-Rad
Schalter switch Ein großer Ein/Aus-Regler
Ventilator fan Geschwindigkeitsregler und Ein/Aus-Taste; Ventilatoren ohne Stufen bekommen nur den Ein/Aus-Regler
Klima climate Solltemperatur auf einem Ring, ein halbes Grad pro Kronenschritt; die Modi Aus, Heizen, Kühlen und Auto
Rollo cover Öffnen, Stopp, Schließen, dazu ein Positionsregler und die Krone, wenn das Rollo Positionen unterstützt
Schloss lock Verriegelt mit einem Tipp; zum Entriegeln braucht es einen zweiten Tipp als Bestätigung
Alarmanlage alarm_control_panel Scharfschalten in den Modi, die deine Anlage unterstützt (zu Hause, abwesend); zum Unscharfschalten fragt sie auf einem Tastenfeld nach deinem Code
Medien media_player Abspielen, Pause, zurück und weiter, ein Lautstärkeregler (die Krone stellt die Lautstärke ein) und Ein/Aus, sofern der Player das unterstützt
Saugroboter vacuum Starten, pausieren, stoppen und zurück zur Ladestation schicken
Szene scene Startet mit einem Tipp
Skript script Startet mit einem Tipp
Automation automation Wird mit einem Tipp ausgelöst
Taste button, input_button Wird mit einem Tipp gedrückt
Auswahl select, input_select Die Liste der Optionen; tippe auf eine, um sie zu wählen
Sensor sensor Der aktuelle Wert in großer Schrift; Sensoren ohne Klasse erscheinen als Text (der Zustand des Briefkastens, der Tag der Müllabfuhr)
Kamera camera Ein Standbild, das das Handy abruft, mit Aktualisieren und Live
Tracker device_tracker, person Nur zum Ansehen: zu Hause, abwesend oder die Zone, mit letzter Aktualisierung und Akkustand, wenn Home Assistant sie kennt

Sensoren werden auf die Klassen beschränkt, die auf einer Uhr Sinn ergeben: Temperatur, Luftfeuchtigkeit, Leistung, Energie, Akku, Luftqualität, Beleuchtungsstärke, Luftdruck und Ähnliches. Diagnosesensoren wie Signalstärke oder Spannung sowie Zeitstempel bleiben absichtlich außen vor.

Änderungen sind optimistisch: Die Kachel springt in dem Moment um, in dem du tippst, der Aufruf geht im Hintergrund an Home Assistant, und die nächste Aktualisierung korrigiert den Bildschirm, falls Home Assistant etwas anderes sagt.

Welche Uhren funktionieren

AmazHA läuft auf 25 Amazfit-Modellen mit Zepp OS, mit Layouts für eckige und runde Bildschirme. Auf runden Uhren sind die Titel zentriert, und die Listen nutzen das ganze Glas.

Form Modelle
Eckig Active, Active 2, Bip 6, Bip Max, Cheetah Square, GTS 4
Rund Active 2, Active 2 Golf, Active 3 Premium, Active Max, Balance, Balance 2, Balance 2 XT, Balance 3, Balance 3 Ti, Balance Ultra, Cheetah 2 Pro, Cheetah 2 Ultra, Cheetah Pro, Cheetah Round, Falcon, GTR 4, T-Rex 3, T-Rex 3 Pro, T-Rex Ultra, T-Rex Ultra 2

Drei Uhren bleiben bewusst außen vor. Active Edge und Bip 5 haben zu kleine Bildschirme für das Layout, und der T-Rex 2 fehlt der Speicher. Ältere Zepp-OS-Modelle unter API-Level 3.0 werden nicht unterstützt. Eine Ja-oder-Nein-Antwort für jedes Modell findest du unter welche Amazfit-Uhren mit Home Assistant funktionieren.

Am schnellsten prüfst du es im Store selbst: Öffne in der Zepp-App den App Store und such nach AmazHA. Wenn deine Uhr gekoppelt ist und unterstützt wird, kannst du die App installieren und die Demo ausprobieren.

Was du vor dem Start brauchst

Du brauchst vier Dinge: einen Home-Assistant-Server, den dein Handy erreicht, ein langlebiges Zugriffstoken eines Administrators, die Zepp-App und deine damit gekoppelte Uhr.

Voraussetzung Warum
Home Assistant ist vom Handy aus erreichbar Das Handy stellt jede Anfrage. Zu Hause reicht die lokale Adresse
Ein langlebiges Zugriffstoken eines Administrators AmazHA liest deine Bereiche über die Template-API, die Home Assistant Administratoren vorbehält
Die Zepp-App auf Android oder iPhone Die Einstellungen von AmazHA und seine Handy-Hälfte stecken darin
Eine unterstützte Uhr, per Bluetooth gekoppelt Die Uhr erreicht das Handy auf demselben Weg wie die Zepp-App

Um deine Geräte zu steuern, muss in Home Assistant nichts installiert werden: AmazHA nutzt die REST-API, die jeder Home-Assistant-Server hat. Das Token erstellst du in Home Assistant in deinem Profil, im Tab Sicherheit; der Artikel zum langlebigen Zugriffstoken erklärt die Schritte und warum das Token eines normalen Benutzers nicht reicht.

Einrichtung in sechs Schritten

Die ganze Einrichtung dauert ein paar Minuten, und die ersten beiden Schritte kosten nichts. Zu jedem Schritt gibt es eine kurze Video-Anleitung.

1. AmazHA installieren

Öffne in der Zepp-App auf deinem Handy den App Store, tippe auf das Suchsymbol und gib AmazHA ein. Öffne AmazHA — Home Assistant Companion App und tippe auf Installieren: Die App landet direkt auf deiner Uhr. Öffne dann auf der Uhr die App-Liste und tippe auf AmazHA. (AmazHA installieren)

2. Die Demo ausprobieren

AmazHA startet mit einem Demo-Zuhause mit Räumen und Geräten. Jeder Bildschirm funktioniert mit Beispieldaten, ohne Zeitlimit: Öffne einen Raum, leg einen Schalter um, dreh bei einem Licht die Krone. So siehst du ehrlich, wie sich die App auf deiner eigenen Uhr anfühlt, bevor du etwas bezahlst. (Auf der Uhr zurechtfinden)

3. Einmal freischalten

Tippe auf der Uhr oben auf dem Startbildschirm auf das orangefarbene Banner Demo-Modus · keine Lizenz. Die Uhr zeigt einen 5-stelligen Code. Öffne auf deinem Handy kzl.io/code im Browser, gib den Code ein, tippe auf Continue und schließ die Zahlung ab. Die Uhr zeigt Purchase Successful! und kehrt von selbst zur App zurück. Mehr dazu weiter unten. (Vollversion freischalten)

4. Home Assistant verbinden

Geh in der Zepp-App zu Profil › deine Uhr › Apps › AmazHA › Einstellungen und tippe auf Home Assistant. Trag die Lokale URL (LAN) ein und, wenn du die Uhr auch unterwegs nutzen willst, die Remote-URL. Füge das Token bei Langlebiges Zugriffstoken ein und tippe auf Verbinden. Mit einer Adresse lautet das Ergebnis Verbunden; mit beiden zeigt es LAN und Remote getrennt an. (Home Assistant verbinden, ab Schritt 4)

5. Deine Geräte auswählen

Tippe in den AmazHA-Einstellungen auf Geräte. Deine Räume sind schon da, und jedes Gerät startet ausgeblendet: Öffne einen Raum und aktiviere, was du nutzt. Lange Listen wie Sonstiges, wo Geräte ohne Raum landen, haben ein Feld Suchen; Alle anzeigen und Alle ausblenden wirken nur auf die passenden Geräte. Personen und Handys haben einen eigenen Bereich, Tracker. (Deine Geräte auswählen)

6. AmazHA auf der Uhr öffnen

Deine Räume und Geräte erscheinen auf der Uhr. Ab jetzt startet die Uhr sofort mit deinen letzten Daten und aktualisiert sie aus Home Assistant, solange die App geöffnet ist.

Ganz nach deinem Geschmack

Alles, was das Aussehen der Uhr verändert, stellst du in den Einstellungen auf dem Handy ein, und die Uhr übernimmt es von dort.

Favoriten und Favoriten als Startseite

Schalte in Geräte › Favoriten die Option Auf der Uhr anzeigen ein und wähle beliebige Geräte aus beliebigen Räumen, auch solche, die du in ihrem Raum nicht aktiviert hast. Favoriten neu ordnen legt ihre Reihenfolge fest. Die Favoriten stehen dann auf dem Startbildschirm der Uhr an erster Stelle. Schaltest du Favoriten als Startseite verwenden ein, besteht der Startbildschirm der Uhr nur noch aus dieser Liste, und nur diese Geräte werden geladen. Die Bereiche kommen zurück, wenn du es wieder ausschaltest. (Favoriten & Energie, Schritt 4)

Das Energie-Panel

Schalte in Geräte › Energie die Option Energie-Panel anzeigen ein und wähle für jede Rolle, die du hast, einen Sensor, etwa Netzleistung (vorzeichen), Solar, Batterie sowie Verbrauch und Kosten von heute. Es erscheinen nur Sensoren, die zur Rolle passen. Der Startbildschirm der Uhr bekommt einen Bereich Energie mit der aktuellen Netzleistung, Bezug oder Einspeisung, dann Solar, Batterie und den Tageswerten. (Favoriten & Energie)

Start-Chips, Reihenfolge der Räume und Raumsymbole

Unter Darstellung › Start-Chips kann jeder der drei Chips oben auf dem Startbildschirm Lichter, Schalter, Rollos, Klima, Medien, Schlösser, Kameras oder Tracker zählen oder die Alarmanlage, deine Energie oder gar nichts zeigen. Startseiten-Layout legt die Reihenfolge der Bereiche fest, und ein Tipp auf das Symbol eines Raums wählt ein anderes. In Geräte kannst du bei einem Raum mit Temperatur- oder Feuchtigkeitssensoren wählen, welcher Sensor die Chips dieses Raums speist, damit nicht der interne Messwert eines Geräts den Raumsensor verdrängt. (Ganz nach deinem Geschmack)

Eigene Namen

Lange Namen aus Home Assistant passen selten auf eine Kachel der Uhr. In Geräte hat jedes Gerät, das die Uhr zeigt, einen Stift hinter seinem Namen: Tippe auf den Namen und gib unter Name auf der Uhr einen neuen ein, bis zu 32 Zeichen. Die Uhr verwendet ihn auf jedem Bildschirm und im Widget, während Home Assistant seinen eigenen Namen behält. Originalnamen wiederherstellen führt zu ihm zurück. Die Namen werden auf dem Handy gespeichert und überstehen Cache zurücksetzen. (Eigene Namen und das Widget)

Schriftgröße, Kartengröße, Vibration und Bildschirm-Timeout

In Einstellungen:

  • Schriftgröße macht alle Texte auf der Uhr größer: 110%, 120% oder 130%. Sie gilt ab dem nächsten Öffnen von AmazHA auf der Uhr.
  • Kartengröße vergrößert die Bereichskarten auf dem Startbildschirm und die Gerätekacheln: 115%, 130% oder 145%.
  • Bei Aktionen vibrieren lässt die Uhr kurz ticken, wenn du ein Gerät antippst, eine Aktion ausführst oder auf einem Steuerbildschirm die Krone drehst. Standardmäßig ist das aus.
  • Bildschirm-Timeout legt fest, wie lange der Bildschirm anbleibt, solange AmazHA geöffnet ist: 30 Sekunden, 1 Minute, 5 Minuten oder Nie, die Standardeinstellung. „Nie“ ignoriert auch das Senken des Handgelenks: praktisch, aber akkuintensiver.

Die Sprache der Uhr folgt ihrer eigenen Systemsprache; Sprache in den Einstellungen ändert nur die Einstellungsseite. (Einstellungen)

Das Widget auf dem Zifferblatt

Das Widget legt bis zu vier deiner Geräte auf die Shortcut-Karten der Uhr, nur einen Tipp entfernt, ohne die App zu öffnen. Es gehört zur Vollversion; in der kostenlosen Version bietet es stattdessen die Freischaltung an.

Zum Einrichten öffnest du in den Einstellungen auf dem Handy Geräte › Widget auf der Uhr und tippst bis zu vier Geräte in der gewünschten Reihenfolge an: von links nach rechts, von oben nach unten. Wische dann auf der Uhr vom Zifferblatt nach rechts zu den Shortcut-Karten, tippe auf Bearbeiten und füge AmazHA hinzu. Bis du die App einmal öffnest, zeigt das Widget AmazHA öffnen; danach sind deine Geräte da. (Eigene Namen und das Widget, Schritt 4)

Was ein Tipp auf das Widget bewirkt, hängt vom Gerät ab:

Gerät im Widget Ein Tipp
Licht, Schalter, Ventilator Schaltet es ein oder aus; das Widget zeigt den neuen Zustand
Szene, Skript, Taste, Automation Führt sie aus
Alles andere (ein Schloss, ein Rollo, ein Sensor, eine Kamera) Öffnet seinen eigenen Bildschirm in AmazHA, wo ein Schloss weiterhin um Bestätigung bittet

Kommt ein Befehl nicht durch, sagt der Bildschirm warum, mit Erneut und AmazHA öffnen; Erneut führt eine Aktion nie zweimal aus. Die Kopfzeile des Widgets zeigt immer, wie alt seine Zustände sind, etwa AmazHA · vor 1 Min. Es wird grau, solange die Uhr offline ist oder sobald seine Zustände 12 Stunden alt sind, und ein Tipp öffnet dann die App, die es auf den neuesten Stand bringt. Änderungen auf dem Handy erreichen das Widget, wenn du AmazHA das nächste Mal öffnest.

Ein praktischer Hinweis: Auf den neueren Uhren läuft nach einem AmazHA-Update, das installiert wurde, während das Widget auf dem Zifferblatt liegt, ein Teil der alten Version weiter, bis die Uhr neu startet. Der Startbildschirm zeigt dann Uhr neu starten, bis du es tust.

Die Daten deiner Uhr in Home Assistant

AmazHA funktioniert auch andersherum: Es kann 18 Messwerte deiner Uhr als Sensor-Entitäten an Home Assistant senden. Sie kommen über die Home-Assistant-eigene Integration Mobile App an, als ein Gerät mit seinen Sensoren, benannt sensor.<prefix>_<key>.

Die Messwerte umfassen Aktivität (Schritte, Distanz, Kalorien, Stehstunden, intensive Minuten, PAI), Gesundheit (Herzfrequenz, Ruheherzfrequenz, SpO2, Stress, Körpertemperatur, Schlaf-Score, Schlafdauer, Schlafzustand), Umgebung (Luftdruck, Höhe) und das Gerät (Uhr-Akku, Tragestatus). Anfangs sind alle aus, und du aktivierst nur die, die du willst, unter Uhr-Sensoren › An Home Assistant senden.

Die Uhr sendet ihre Daten bei jedem Öffnen von AmazHA. Für Updates bei geschlossener App stellst du Aktualisieren alle ein (1 bis 6 Minuten) und erlaubst Hintergrundaktivität, wenn die Uhr danach fragt; für jedes Update muss das Handy in der Nähe sein. In Home Assistant findest du die Uhr unter Einstellungen › Geräte & Dienste › Mobile App. Der Artikel zu den Uhr-Sensoren hat die vollständige Tabelle und Beispiele für Automationen. (Uhr-Sensoren)

Grenzen, die du kennen solltest

Eine Uhren-App, die über das Handy läuft, hat ein paar bauartbedingte Grenzen, und es ist besser, sie vor dem Kauf zu kennen.

Grenze Was das in der Praxis bedeutet
Das Handy muss in der Nähe sein Keine Bluetooth-Verbindung zum Handy, keine Steuerung. Die Uhr zeigt Offline · Telefon antwortet nicht
Zustände werden aktualisiert, solange die App geöffnet ist Alle 8 Sekunden, eine anderswo gemachte Änderung erscheint also innerhalb weniger Sekunden. Bei geschlossener App wird nichts aktualisiert
Kein Push von Home Assistant Die Uhr fragt die Zustände ab; Home Assistant kann über AmazHA keine Benachrichtigungen oder Updates an die Uhr senden
Höchstens 100 Geräte Mit ein paar Dutzend bleibt sie schnell. Der Bildschirm Geräte empfiehlt 40 oder weniger pro Bereich: Auf manchen Uhren kann einem Bereich mit 70 oder mehr der Speicher ausgehen, und der Bildschirm bleibt schwarz
Unterwegs braucht es eine Remote-Adresse Nur wenn du die Uhr außer Haus nutzen willst; zu Hause reicht die lokale Adresse
Sensor-Updates im Hintergrund Brauchen die Berechtigung Hintergrundaktivität und das Handy in Reichweite; sonst sendet die Uhr ihre Daten, wenn du die App öffnest
Nur Zepp OS Eine Version für Wear OS ist in Entwicklung, ohne Termin

Die ersten beiden Zeilen erklären die meisten Überraschungen. Lässt du das Handy in einem anderen Raum liegen und gehst aus der Bluetooth-Reichweite, zeigt die Uhr weiter deine letzten Daten, kann aber nichts ändern. Und ändert sich ein Licht, während AmazHA geschlossen ist, zeigt die Uhr den neuen Zustand beim nächsten Öffnen.

Wenn etwas nicht klappt

Wenn etwas nicht funktioniert, sagt die Uhr, woran es liegt, und jede Meldung hat eine übliche Ursache. Diese Tabelle folgt der Anleitung Wenn etwas nicht klappt, die für jede Meldung einen Schritt hat.

Die Uhr zeigt Ursache Lösung
Keine Geräte gewählt Jedes Gerät startet ausgeblendet Aktiviere die gewünschten Geräte in den AmazHA-Einstellungen unter Geräte (Schritt 1)
Offline · Telefon antwortet nicht Die Uhr erreicht dein Handy nicht Halte das Handy in der Nähe, mit eingeschaltetem Bluetooth und laufender Zepp-App (Schritt 2)
Offline · Home Assistant nicht erreichbar Das Handy erreicht Home Assistant nicht Öffne deine Adresse im Browser des Handys: Sie muss von dort aus funktionieren, wo das Handy gerade ist, und unterwegs braucht sie HTTPS mit einem gültigen Zertifikat (Schritt 3)
Falsche Adresse Die Adresse antwortet, aber es ist nicht die Home-Assistant-API Trag nur die Server-Adresse ein, ohne etwas dahinter (kein /lovelace) (Schritt 4)
Admin-Token nötig Das Token gehört einem Benutzer ohne Administratorrechte Erstelle als Administrator ein neues langlebiges Token und füge es ein (Schritt 5)
Token prüfen Das Token enthält ein Zeichen, das in keinem Token vorkommt, meist wegen einer abgeschnittenen Kopie (…) Kopiere es noch einmal vollständig und füge es ein (Schritt 6)
Die Uhr ist langsam oder startet neu Zu viele Geräte Halte die Auswahl klein: Mit ein paar Dutzend bleibt die Uhr schnell, 100 ist die Grenze (Schritt 7)
Demo-Modus · keine Lizenz Die App ist nicht freigeschaltet Tippe auf das Banner und schalte sie frei (Vollversion freischalten)
Demo-Modus · HA-Server in der Phone-App einrichten Freigeschaltet, aber noch kein Server eingetragen Trag deine Adresse und dein Token in den Einstellungen unter Home Assistant ein (Home Assistant verbinden)
Uhr neu starten Ein Update wurde installiert, während das Widget auf dem Zifferblatt lag Starte die Uhr neu

Unter einem Banner Offline ergänzt die Uhr Erneut alle 8 s, du musst also nichts tun, sobald die Ursache behoben ist, und darunter steht eine kleine Codezeile, die dem Support genau verrät, was schiefgelaufen ist. Ein Foto der Uhr ist das Nützlichste, was du schicken kannst.

Passt nichts aus der Liste, öffne Einstellungen, tippe auf Cache zurücksetzen und dann auf Zum Bestätigen erneut tippen. Das löscht die zwischengespeicherten Daten auf Uhr und Handy und behält deine Verbindung, deine Geräte und deine Lizenz; öffne AmazHA danach erneut auf der Uhr (Schritt 8). Hilft auch das nicht, sendet das Formular Support in den Einstellungen einen Bericht mit deiner Nachricht. Er enthält nie deine Home-Assistant-Adresse, dein Token oder deine Gerätenamen.

Ein Beispiel: grüner Test, leere Uhr

Eine häufige Meldung am ersten Tag: Verbinden wird grün, aber die Uhr zeigt nichts. Zwei Ursachen decken fast jeden Fall ab. Entweder ist noch kein Gerät aktiviert, und die Uhr zeigt Keine Geräte gewählt, oder das Token gehört einem Benutzer, der kein Administrator ist, und die Uhr zeigt Admin-Token nötig. Die zweite überrascht viele, weil der Verbindungstest die Zustände erfolgreich liest; es ist die Zuordnung der Bereiche über die Template-API, die Home Assistant einem normalen Benutzer verweigert. Ein neues Token, erstellt als angemeldeter Administrator, behebt das.

Die Vollversion freischalten

Die Freischaltung ist eine einmalige Zahlung, die du von der Uhr aus über KiezelPay erledigst: kein Konto, kein Abo, keine Werbung. Sie verbindet AmazHA mit deinem eigenen Home Assistant, lokal und remote, und schaltet die Uhr-Sensoren und das Widget frei. Bis dahin ist die App eine Demo mit Beispieldaten, und nichts erreicht einen echten Server.

  1. Tippe auf der Uhr auf das orangefarbene Banner Demo-Modus · keine Lizenz. Die Uhr zeigt einen 5-stelligen Code.
  2. Öffne auf deinem Handy kzl.io/code im Browser.
  3. Gib den Code ein und tippe auf Continue.
  4. Zahle einmal, per Karte oder PayPal. Es ist eine lebenslange Lizenz.
  5. Die Uhr zeigt Purchase Successful! und kehrt von selbst zur App zurück.

Die Anleitung Vollversion freischalten zeigt jeden Bildschirm, und der Abschnitt zu den Preisen auf der Startseite listet, was jede Version enthält.

Häufige Fragen

Gibt es eine offizielle Home-Assistant-App für Amazfit?

Nein. Die offiziellen Companion-Apps von Home Assistant gibt es für Android, iPhone und die Uhren, die mit ihnen gekoppelt werden, nicht für Zepp OS. AmazHA ist eine unabhängige Zepp-OS-App, weder von Home Assistant, Nabu Casa, Amazfit noch Zepp Health entwickelt oder unterstützt. Du installierst sie aus dem App Store in der Zepp-App.

Braucht die Uhr WLAN?

Nein. Die Uhr spricht nur mit deinem Handy, über die Bluetooth-Verbindung, die sie ohnehin mit der Zepp-App nutzt. Das Handy erreicht Home Assistant, über dein Heimnetz oder eine Remote-Adresse.

Funktioniert es auch unterwegs?

Zu Hause nutzt AmazHA deine lokale Adresse und braucht nichts weiter. Unterwegs funktioniert es, wenn du zusätzlich eine Remote-URL einträgst, die dein Handy erreichen kann, etwa Home Assistant Cloud, ein VPN oder deine eigene Domain mit HTTPS. AmazHA wechselt selbst zwischen beiden. Mehr dazu im Artikel zum Fernzugriff.

Brauche ich Home Assistant Cloud (Nabu Casa)?

Nein. Es ist ein Weg, Home Assistant von außen zu erreichen, und spielt nur eine Rolle, wenn du die Uhr unterwegs nutzen willst. Ein VPN oder deine eigene Domain mit gültigem HTTPS-Zertifikat funktionieren auch, und zu Hause reicht die lokale Adresse.

Warum muss das Token von einem Administrator stammen?

AmazHA liest über die Template-API von Home Assistant, in welchem Bereich jedes Gerät liegt, und diese API ist Administratoren vorbehalten. Mit dem Token eines normalen Benutzers klappt der Verbindungstest, aber die Uhr kann deine Geräte nicht laden und zeigt Admin-Token nötig. Mehr dazu im Artikel zum Token.

Auf welchen Amazfit-Uhren läuft es?

Auf 25 Amazfit-Modellen mit Zepp OS, eckig und rund: GTS 4, GTR 4, Bip 6, Bip Max, Falcon und die Reihen Active, Balance, Cheetah und T-Rex. Active Edge, Bip 5 und T-Rex 2 werden nicht unterstützt. Die vollständige Liste geht Modell für Modell durch.

Ist AmazHA kostenlos?

Die Installation ist kostenlos, und die App startet mit einem vollständigen Demo-Zuhause mit Beispieldaten, ohne Zeitlimit. Die Verbindung mit deinem eigenen Home Assistant ist eine einmalige Freischaltung: kein Abo, keine Werbung, keine ablaufende Testphase. Du schaltest sie über das Banner auf der Uhr und kzl.io/code frei.

Funktioniert es mit einem iPhone?

Ja. AmazHA läuft über die Zepp-App, auf Android wie auf dem iPhone, und die Einrichtung ist dieselbe. iOS schränkt ein, was Apps im Hintergrund tun dürfen, also lass die Zepp-App im Hintergrund laufen und Bluetooth eingeschaltet.

Im Video ansehen

Die kurzen Anleitungen, auf denen dieser Artikel aufbaut: Videos auf Englisch, jeder Schritt auf Deutsch ausgeschrieben.

Alle Artikel