Zum Inhalt

Setup cod.m ZigBee Coordinator (CZC) mit Home Assistant (zha)#

Den cod.m ZigBee Coordinator wie in der Anleitung beschrieben in Betrieb nehmen und Verbindung zum lokalen Netzwerk herstellen.

Automatische Erkennung#

Hinweis

Wir warten auf einen Pull-Request bei Home Asssistant. Die automatische Erkennung wird in einer der nächsten Versionen funktionieren.

Ab Version 2024.7.0 findet Home Assistant den cod.m ZigBee Coordinator automatisch. Bei der Erkennung und der darauffolgenden Bestätigung wird alles automatisch installiert. Keine manuelle Konfiguration notwendig, man kann direkt zum Anlernen der Geräte übergehen.

Manuelle Installation#

Installation Integration#

Unter dem Punkt Geräte & Dienste in den Einstellungen die Integration "Zigbee Home Automation" hinzufügen indem man nach "zha" sucht.

Integration hinzufügen cod.m ZigBee Coordinator

Konfiguration#

Beim folgenden Dialog ZNP für Texas Instruments CC2652 Z-Stack ZNP wählen.

Funktyp für cod.m ZigBee Coordinator wählen

Für den seriellen Gerätepfad nutzt man die Adresse des Netzwerk-Coordinators mit socket:// vorangestellt. Bei Datenflußkontrolle braucht nichts eingestellt zu werden.

Einstellunge der seriellen Schnittstelle

IPV4#

socket://xx.xx.xx.xx:6638
xx.xx.xx.xx natürlich durch die ensprechende echte IP-Adresse des Coordinators ersetzen.

Hostname#

Da jeder lokale Router bei der DHCP-Vergabe typischerweise auch eine Hosteintrag vornimmt, kann man natürlich auch den Hostnamen der lokalen Domäne nutzen. Dadurch spart man sich zum Beispiel die DHCP-Adressreservierung oder die Vergabe einer festen IP.

socket://czc-XXXX.fritz.box:6638

Alternativ über zeroconf

socket://czc-XXXX.local:6638

Achtung

Jeder cod.m ZigBee Coordinator hat einen eindeutigen Hostnamen. Das XXXX ist also entsprechend je Coordinator unterschiedlich.

Abschluss#

Das Laden der Integration kann beim ersten Start ein paar Minuten dauern. Eventuelle Fehler beim Starten der Integration im Protokoll unter Einstellungen > System > Protokolle eingesehen werden.

Nach dem Abschluss der Konfiguration steht der cod.m ZigBee Coordinator zur Verfügung und es können Geräte angelernt werden.

Details zur ZigBee Integration in Home Assistant (zha) lassen sich in der offiziellen Dokumentation nachschlagen: https://www.home-assistant.io/integrations/zha/.

Geräte anlernen#

Unter Einstellungen > Geräte & Dienste > ZigBee Home Automation auf Konfigurieren klicken.

Home Assistant ZHA konfigurieren

Danach unten Rechts auf Gerät hinzufügen um beim Coordinator das Pairing einzuschalten - erkennbar am Leuchten der der gelben LED.

Home Assistant ZHA Gerät hinzufügen

Entsprechend das Gerät, das man anlernen will, in den Pairing-Modus bringen und anlernen. Gefundene Geräte werden direkt angezeigt und können hinzugefügt werden.