Leitfaden zur Fehlerbehebung bei der Home Assistant-Gerätekopplung für ZHA, HomeKit, HACS und LinknLink
Das Hinzufügen eines Geräts zu Home Assistant sollte sich einfach anfühlen: Entdecken Sie es, koppeln Sie es, benennen Sie es und verwenden Sie es in einer Automatisierung. In echten Häusern kann die Kopplung auf vielen Ebenen fehlschlagen. Ein Gerät kann erkannt werden, aber keine nützliche Entität offenlegen. Ein Zigbee-Sensor verbindet sich möglicherweise mit dem Netzwerk, befindet sich aber zu weit vom Router entfernt. Ein HomeKit-Gerät ist möglicherweise immer noch an einen anderen Controller gebunden. Eine HACS-Integration wird möglicherweise korrekt installiert, es fehlen jedoch Anmeldeinformationen, Netzwerkzugriff oder ein Neustart.
Diese Anleitung ist ein praktischer Fehlerbehebungspfad für die Kopplung von Home Assistant-Geräten mit ZHA-, Zigbee2MQTT-, HomeKit-Controller-, HACS-, MQTT- und LinknLink-Geräten. Es ist für die Verwendung in lokalen Smart Homes geschrieben HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, und eHome HA.
Beginnen Sie mit der Identifizierung der Paarungsschicht
Die meisten Home Assistant-Kopplungsprobleme sind nicht zufällig. Sie gehören normalerweise zu einer Ebene: Transport, Erkennung, Anmeldeinformationen, Entitätszuordnung oder Automatisierungslogik. Erstellen Sie das gesamte Setup erst dann neu, wenn Sie wissen, welche Ebene ausfällt.
| Schicht | Typisches Symptom | Was Sie zuerst überprüfen sollten | Beste nächste Aktion |
|---|---|---|---|
| Transport | Gerät wird nie angezeigt | Leistung, Entfernung, LAN-Segment, Zigbee-Koordinator, Wi-Fi-Band. | Bewegen Sie das Gerät näher, überprüfen Sie die Netzwerkerreichbarkeit oder setzen Sie den Kopplungsmodus zurück. |
| Entdeckung | Das Gerät wird angezeigt, kann aber nicht hinzugefügt werden | Integrationstyp, Kopplungsmodus, Gerätebesitz, HomeKit-Code. | Entfernen Sie es vom alten Controller, starten Sie die Integration neu und versuchen Sie es erneut mit einem sauberen Kopplungsstatus. |
| Anmeldeinformationen | Anmeldung oder Token schlagen fehl | Lokale IP, MQTT-Broker, HACS-Integrationseinstellungen, Benutzerberechtigungen. | Geben Sie die Anmeldeinformationen erneut ein und überprüfen Sie, ob Home Assistant den lokalen Endpunkt erreichen kann. |
| Entitätszuordnung | Gerät wird hinzugefügt, aber Entitäten fehlen | Nicht unterstützte Funktionen, deaktivierte Diagnoseeinheiten, Integrationsversion. | Aktivieren Sie versteckte Entitäten, aktualisieren Sie die Integration oder wählen Sie die richtige Plattform aus. |
| Automatisierungslogik | Die Entität arbeitet manuell, aber die Automatisierung schlägt fehl | Auslöserstatus, Bedingung, Modus, Abklingzeit, Raumkontext. | Verwenden Sie den Automatisierungs-Trace und testen Sie jede Bedingung separat. |
Fehlerbehebung beim ZHA-Pairing
ZHA ist der direkteste Zigbee-Pfad in Home Assistant. Es funktioniert gut, wenn der Koordinator stabil ist, das Gerät beim Pairing nahe genug ist und das Mesh über gute Router verfügt. Wenn ein Zigbee-Gerät gekoppelt wird, aber nicht verfügbar ist, liegt das Problem häufig eher an der Mesh-Qualität als am Gerät selbst.
Paaren Sie sich zuerst in der Nähe des Koordinators
Bringen Sie das Gerät für die erste Verbindung in die Nähe des Koordinators. Wenn es stabil ist, bringen Sie es in den letzten Raum und lassen Sie das Netz ruhen.
Überprüfen Sie die Kanalüberlappung
Wi-Fi 2,4 GHz und Zigbee können Störungen verursachen. Wenn die Kopplung unzuverlässig ist, halten Sie den Koordinator vom Router und den USB 3.0-Anschlüssen fern.
Verwenden Sie ein Router-Gerät mit eigener Stromversorgung
Batteriesensoren leiten nicht weiter. Fügen Sie Zigbee-Geräte mit Stromversorgung zwischen dem Koordinator und entfernten Räumen hinzu, um die Mesh-Zuverlässigkeit zu verbessern.
Für einen dedizierten Koordinatorpfad verwenden Sie ZG-808Z. Wenn Sie einen tiefergehenden Ablauf der Zigbee-Diagnose benötigen, lesen Sie die Zigbee2MQTT ZG-808Z Anleitung zur Fehlerbehebung.
Zigbee2MQTT Fehlerbehebung beim Pairing
Zigbee2MQTT bietet mehr Einblick in Geräteverbindungen, Routen und Konverterunterstützung. Dies ist nützlich, wenn ein Gerät zwar beitritt, aber unerwartete Entitäten offenlegt, oder wenn Sie die Verbindungsqualität und den Interviewstatus überprüfen müssen.
| Problem | Wo suchen | Wahrscheinlicher Grund | Beheben |
|---|---|---|---|
| Das Vorstellungsgespräch ist fehlgeschlagen | Zigbee2MQTT-Frontend | Schwaches Signal, nicht unterstütztes Gerät, Gerät hat den Kopplungsmodus verlassen. | Führen Sie die Kopplung in der Nähe des Koordinators erneut durch und lassen Sie das Gerät wach. |
| Keine Home Assistant-Entität | MQTT-Erkennung | Erkennung deaktiviert oder Thema stimmt nicht überein. | Überprüfen Sie das MQTT-Erkennungspräfix und starten Sie Home Assistant neu, nachdem Sie die Konfiguration korrigiert haben. |
| Die Entität scheint nicht verfügbar zu sein | Verfügbarkeitseinstellungen | Akku-Gerät im Ruhezustand oder Routing-Problem. | Warten Sie auf den nächsten Batteriebericht oder verbessern Sie die Mesh-Routen. |
| Falscher Gerätetyp | Konverterunterstützung | Der Fingerabdruck des Geräts weist eine teilweise Unterstützung auf. | Aktualisieren Sie Zigbee2MQTT und prüfen Sie die Hinweise zum Konverter. |
Fehlerbehebung beim Koppeln des HomeKit-Controllers
Der HomeKit-Controller ist leistungsstark, da viele HomeKit-Geräte lokal mit Home Assistant gekoppelt werden können. Der häufigste Fehler ist der Besitz: Das Gerät gehört noch zu einer anderen Home-App, Bridge, einem anderen Konto oder einem Controller.
- Entfernen Sie das Gerät vom vorherigen HomeKit-Controller, bevor Sie es mit Home Assistant koppeln.
- Halten Sie Home Assistant und das Gerät während der Einrichtung im selben lokalen Netzwerk.
- Verwenden Sie den ursprünglichen HomeKit-Kopplungscode und lassen Sie ihn sichtbar, bis die Einrichtung abgeschlossen ist.
- Schalten Sie das Zubehör aus und wieder ein, wenn es in der Erkennung angezeigt wird, die Kopplung jedoch nie abgeschlossen wird.
Nachdem die HomeKit-Kopplung funktioniert hat, verbinden Sie die Entität mit der Raumlogik die LinknLink-App-Room-Dashboard-Anleitung Dadurch lässt sich das Gerät je nach Raum einfacher steuern.
Fehlerbehebung bei der HACS-Integration
HACS ist keine eigenständige Gerätekopplungsschicht. Es installiert benutzerdefinierte Integrationen. Die Kopplung hängt immer noch von der Integration, den Anmeldeinformationen, dem LAN-Zugriff, dem Cloud-Token oder der MQTT-Brücke dahinter ab. Behandeln Sie HACS-Probleme zunächst als Installations-, Kompatibilitäts- und Neustartprobleme.
| HACS-Symptom | Was es bedeutet | Beheben |
|---|---|---|
| Integration installiert, aber nicht sichtbar | Home Assistant hat die benutzerdefinierte Komponente nicht neu geladen. | Starten Sie Home Assistant neu und leeren Sie den Browser-Cache. |
| Der Konfigurationsablauf schlägt fehl | Anmeldeinformationen oder Netzwerkendpunkt sind falsch. | Bestätigen Sie die lokale IP, das Token, die Kontoregion und die erforderlichen Berechtigungen. |
| Entitäten verschwinden nach dem Update | Wichtige Änderungen oder umbenannte Entitäten. | Lesen Sie Versionshinweise und aktualisieren Sie Automatisierungen nach Entitäts-ID. |
| Die Automatisierung funktioniert nur manuell | Die Entität existiert, aber die Bedingungen oder Auslöser sind falsch. | Überprüfen Sie die Automatisierungsspuren und testen Sie sie zunächst mit einem einfachen Trigger. |
MQTT-Erkennungsprüfungen für LinknLink-Geräte
MQTT-Pairing-Probleme sind in der Regel einfacher zu debuggen als Cloud-Integrationen, da jeder Schritt lokal und sichtbar ist. Wenn ein LinknLink-Gerät nicht korrekt angezeigt wird, überprüfen Sie die Brokerverbindung, das Erkennungsthema, die aufbewahrten Nachrichten und die Entitätskategorie.
MQTT checklist: - Confirm the LinknLink device is online - Confirm Home Assistant can reach the MQTT broker - Confirm username, password and port - Confirm discovery is enabled - Confirm the topic prefix matches Home Assistant - Restart Home Assistant only after fixing broker settings - Test one simple entity before rebuilding scenes
Verwenden Sie für Fernbedienungsgeräte die Anleitung zur Home Assistant-Fernbedienung. Bei IR-Befehlsfehlern nach dem Pairing verwenden Sie die Anleitung zur Fehlerbehebung beim IR-Blaster.
eMotion-Sensor-Kopplung und Entitätsprüfungen
Präsenzsensoren können je nach Modell verschiedene Entitätstypen erstellen: Anwesenheit, Bewegung, Entfernung, Beleuchtungsstärke, Zonen, Batterie, Temperatur oder Luftfeuchtigkeit. Das Pairing ist nur dann erfolgreich, wenn die nützlichen Entitäten zuverlässig angezeigt und aktualisiert werden.
| Produkt | Paarungsfokus | Zu überprüfende Entität | Bester Anwendungsfall |
|---|---|---|---|
| eMotion Air | Batteriebetriebene Platzierung und lokale Präsenzmeldung. | Präsenz, Batterie, Raumzustand. | Flexible Räume, in denen die Verkabelung schwierig ist. |
| eMotion Pro | mmWave-Präsenz plus integrierte IR-Raumsteuerung. | Präsenz, Beleuchtungsstärke, IR-Befehlseinheiten. | Räume, die sowohl eine Sensorik als auch eine Gerätesteuerung benötigen. |
| eMotion Ultra | 60GHz-Präsenz, integrierter IR und Temperatur-/Feuchtigkeitsdatenkabelkontext. | Präsenz, Zonen, IR, Komfortdaten. | Präzise Räume, Schlafszenen und HVAC-Logik. |
Wenn Sie sich für eine der drei Optionen entscheiden, lesen Sie die Kaufratgeber für eMotion Air vs. Pro vs. Ultra.
Überprüfung der Kopplung von Remote- und RF-Geräten
IR- und RF-Geräte können verwirrend sein, da die Originalfernbedienung möglicherweise ähnlich aussieht, auch wenn das Protokoll unterschiedlich ist. Ein Fan kann RF verwenden. Ein TV verwendet normalerweise IR. Ein Rollo kann RF, Wi-Fi oder eine proprietäre Brücke verwenden. Koppeln Sie den Steuerpfad mit dem Protokoll, bevor Sie Automatisierungen schreiben.
- Benutzen eRemote HA für lokale IR-Szenen.
- Benutzen eHome HA wenn die RF-Steuerung Teil des Raums ist.
- Benutzen eMotion Pro oder eMotion Ultra wenn Präsenz und IR zusammenleben sollten.
Für einen RF-Hub-Vergleich lesen Sie die Leitfaden eHome HA vs. Bond Bridge.
Verwenden Sie HomeClaw als lokale Wiederherstellungsschicht
Wenn ein Gerät gekoppelt, aber unzuverlässig ist, ist die Gateway-Schicht wichtig. HomeClaw kann die Home Assistant-Logik lokal halten, Raum-Dashboards koordinieren und dabei helfen, Gerätezustände in Automatisierungen zu organisieren, die einfacher zu debuggen sind.
Informationen zur App- und Raumsteuerungsstruktur finden Sie im Leitfaden zur LinknLink-App-Automatisierung und die Raum-Dashboard-Anleitung.
Entscheidungstabelle zur Fehlerbehebung beim Pairing
| Wenn das passiert | Tun Sie dies zuerst | Dann verwenden Sie diesen LinknLink-Pfad |
|---|---|---|
| Der Zigbee-Sensor tritt bei, wird aber offline geschaltet | Bewegen Sie es in die Nähe, überprüfen Sie die Router-Geräte und prüfen Sie den LQI. | ZG-808Z plus die Anleitung zur Fehlerbehebung Zigbee2MQTT. |
| Das HomeKit-Gerät verweigert die Kopplung | Entfernen Sie es vom alten Controller und setzen Sie die Kopplung zurück. | HomeClaw lokaler Home Assistant-Workflow. |
| Präsenzentität existiert, aber Automatisierungen schlagen fehl | Überprüfen Sie die Änderungen des Automatisierungs-Trace und des Entitätsstatus. | eMotion Air, Pro oder Ultra mit Raummodus-Helfern. |
| Die IR/RF-Befehlseinheit ist vorhanden, aber die Appliance antwortet nicht | Überprüfen Sie Protokoll, Platzierung und gelerntes Kommando. | eRemote HA für IR oder eHome HA für RF/IR. |
| Die benutzerdefinierte Integration wird installiert, erstellt jedoch keine Entitäten | Starten Sie Home Assistant neu und überprüfen Sie die Konfigurationsflussprotokolle. | Lokale HomeClaw-Fehlerbehebung plus kanonische Anleitungen. |
Verwandte Leitfäden und aktuelle Produkte
Verwenden Sie diese kanonischen Produkt- und Artikellinks, um vom Pairing zur stabilen lokalen Automatisierung überzugehen.
Heiße Produkte
HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, eHome HA.
Paarung und Integrationen
Zigbee2MQTT Fehlerbehebung, Beste Home Assistant-Integrationen, Raspberry Pi vs. HomeClaw Gateway-Anleitung.
Präsenz und Fernbedienungen
Beste mmWave-Präsenzsensoren, Anleitung zur Fernbedienung, IR-Fehlerbehebungsanleitung.
Korrigieren Sie die Kopplungsschicht, bevor Sie die Automatisierung neu erstellen
Zuverlässige Home Assistant-Automatisierungen beginnen mit zuverlässigen Einheiten. Bestätigen Sie Transport, Erkennung, Anmeldeinformationen und Entitätszuordnung, bevor Sie Szenen, Raum-Dashboards oder Agent+-Gespräche hinzufügen.
FAQ
Warum erkennt Home Assistant ein Gerät, erstellt aber nicht die richtigen Entitäten?
Erkennung und Entitätserstellung sind separate Schritte. Überprüfen Sie den Integrationstyp, die Geräteberechtigungen, das MQTT-Thema, den Zustand des Koordinators und ob die Integration die Funktion als Sensor, Schalter, Taste, Klimaeinheit oder Diagnoseeinheit verfügbar macht.
Soll ich Zigbee-Geräte über ZHA oder Zigbee2MQTT koppeln?
Verwenden Sie ZHA, wenn Sie ein einfacheres natives Home Assistant-Setup wünschen. Verwenden Sie Zigbee2MQTT, wenn Sie eine breitere Geräteunterstützung, mehr Diagnosemöglichkeiten und eine feinere Kontrolle über das Zigbee-Routing durch einen Koordinator wie ZG-808Z benötigen.
Können HomeKit-Geräte lokal zu Home Assistant hinzugefügt werden?
Ja. Viele HomeKit-Geräte können über die HomeKit-Controller-Integration hinzugefügt werden. Lassen Sie das Gerät im selben lokalen Netzwerk, entfernen Sie es bei Bedarf vom vorherigen Controller und verwenden Sie den Pairing-Code während der Einrichtung.
Was sollte ich überprüfen, wenn LinknLink-Geräte nicht in Home Assistant angezeigt werden?
Stellen Sie sicher, dass das Gerät online ist, lokaler Netzwerkzugriff verfügbar ist, die MQTT- oder Integrations-Anmeldeinformationen korrekt sind und die Home Assistant-Instanz dasselbe LAN-Segment wie das LinknLink-Gerät erreichen kann.
Welche LinknLink-Produkte helfen beim Home Assistant-Pairing und der lokalen Steuerung?
Verwenden Sie HomeClaw als lokales Home Assistant-Gateway, ZG-808Z für die Zigbee-Koordination, eMotion-Sensoren für die Anwesenheitsautomatisierung, eRemote HA für die lokale IR-Steuerung und eHome HA für RF- und IR-Remote-Workflows.