Moin zusammen
Ergänzend zu meiner (Kurz)Anleitung zu dem Z2M Onboarding-Prozess und weil es ja auch User gibt die Schwierigkeiten haben einen MQTT Broker unter HA einzurichten, hier dann noch einmal eine Anleitung für die Einrichtung von HA Mosquitto broker Addon + HA MQTT Integration + Z2M unter HA.
Vorab: Ich habe das eben kurz nebenbei bei einer HA Test-VM gemacht und daher möge man mir verzeihen wenn ich jetzt nicht auf jede Kleinigkeit dabei eingehe und es nicht perfekt ist. 
Los geht’s. 
Noch eine Anmerkung. Diese (Kurz)Anleitung beschreibt die erstmalige Einrichtung von Mosquitto broker Addon + HA MQTT Integration + Z2M. Falls man bei der Z2M Einrichtung bereits irgendwelche vergeblichen Versuche durchgeführt hat dann wäre die Vorgehensweise eine andere, die dann in der o.g. (Kurz)Anleitung zu dem Z2M Onboarding-Prozess beschrieben ist.
-
Unter HA das Mosquitto broker Addon installieren. Den HA Add-on Store aufrufen und nach MQTT suchen.
Installieren anklicken
Nachdem die Installation erfolgt ist weicht die Installation von früheren Anleitungen und auch von der offiziellen Mosquitto broker Doku ab. Es müssen bei der Mosquitto broker Konfiguration keinerlei Einstellungen vorgenommen werden. D.h. es muss dort kein User eingerichtet werden. Auch muss - wieder im Gegensatz zu früher - unter HA auch kein extra User für den MQTT Broker angelegt werden. All das macht HA jetzt automatisch. Daher folgt als nächster Schritt den MQTT Broker direkt zu starten
Wenn man das gemacht hat und das Mosquitto broker Addon läuft, kann man mal einen Blick in das Mosquitto broker Protokoll werfen. Das sollte dann so aussehen und man sieht das das Mosquitto broker Addon und somit auch der MQTT Server, läuft.
-
Die MQTT Integration unter HA installieren. Dazu geht man bei HA zu Einstellungen —> Geräte & Integrationen und klickt dann unten rechts auf Integrationen hinzufügen.
Dann einfach nach MQTT suchen und als Suchergebnis wird einem dann das angeboten. Davon installiert man dann MQTT
Anschließend wird man gefragt ob man das offizielle Mosquitto MQTT Broker Add-on verwenden will, oder eben selber irgendeinen (externen) MQTT Broker einrichten möchte. Da wir ja das HA Mosquitto broker Addon verwendet wählt man also den ersten Punkt aus.
Die Installation erfolgt dann kompl. automatisch und man braucht nichts weiter eingeben. Anschließend erscheint das.
Damit ist die MQTT Installation unter HA bereits abgeschlossen. Um noch einmal zu überprüfen ruft man bei dem Mosquitto broker Addon noch einmal das Protokoll auf, das dann so in der Art aussehen sollte. Wie man unten sehen kann hat HA über den Supervisor und dessen IP 172.30.32.1, jetzt eine lokale Verbindung mit dem Mosquitto broker Addon hergestellt.
Anm.: Die root/administrator Warnung kann man kompl. ignorieren. Die ist so normal.
Damit wäre die MQTT Broker Installation und Einrichtung unter HA abgeschlossen.
Wenn ich schon mal dabei bin dann zeige ich jetzt auch noch einmal wie man dann im Anschluss Z2M installiert und einrichtet. Voraussetzung dafür ist das das Z2M Addon über den HA Add-on Store bereits als Repo hinzugefügt wurde, dort vorhanden ist
und bereits unter HA installiert wurde.
Ebenso wird vorausgesetzt das ein Zigbee Dongle bereits bei dem HA Host vorhanden ist und nicht bereits irgendwie von ZHA benutzt wird, oder in Beschlag genommen wurde. Sprich ZHA darf nicht aktiv sein und somit den Zugriff auf den Dongle irgendwie verhindern.
Bei der folgenden Z2M Installation nutze ich dafür wieder meinen Sonoff Dongle-P der an dem HA Host (oder genauer gesagt der HA VM) angeschlossen ist.
Wenn das Z2M Addon unter HA installiert und erstmalig gestartet wurde, sollten die Einträge in dem Z2M Protokoll so in der Art aussehen und Z2M “wartet” darauf über den Z2M Onboarding-Prozess erstmalig eingerichtet zu werden. Da dies bisher noch nicht passiert ist erscheint auch die Fehlermeldung zu der Supervisor API.
Als nächsten Schritt klickt man jetzt auf Benutzerfläche öffnen
und es startet dann automatisch der Z2M Onboarding-Prozess.
Dort wählt man dann seinen Dongle aus, der unter Select a device vorhanden sein sollte. Hier bei mir also der Sonoff Dongle-P.
Da ich bei der HA VM den Dongle über seine ttyUSB0 Schnittstelle und nicht über seine ID eingebunden habe, sieht die Konfiguration für ihn bei dem Z2M Onboarding-Prozess dann so aus.
Je nach verwendeten Dongle und wie dieser mit dem HA Host verbunden ist, können dort natürlich ganz unterschiedliche Einträge notwendig sein, auf die ich hier aber nicht weiter eingehe. Wenn der Dongle von Z2M offiziell unterstützt wird findet man die für ihn notwendigen Einstellungen bei den Z2M Infos zu den Adapter-Einstellungen:
Bei dem Z2M Onboarding-Prozess müssen auch keinerlei Einträge für den MQTT Broker vorgenommen werden, sofern man das Mosquitto broker Addon benutzt und es so eingerichtet hat wie ich es hier jetzt beschrieben habe. D.h. dort lässt man alles so stehen wie es automatisch eingetragen wurde.
Der Z2M Onboarding-Prozess kann dann über den Submit Button abgeschlossen und beendet werden.
Wenn man bei der Einrichtung keinen Fehler gemacht hat kommt als Nächstes das.
Dort klick man oben auf den Pfeil und dann sollte sich die Z2M Benutzeroberfläche öffnen, die dann so aussieht.
Dann kann man über den Button Beitritt erlauben anfangen seine Zigbee Geräte unter Z2M anzulernen. Was hier in dem Beispiel gerade für einen Tuya Tür-/Fenstersensor erfolgt ist.
Wenn man ein Gerät unter Z2M angelernt hat kann man bei der HA MQTT Integration auch prüfen ob dieses dort auch vorhanden ist - wie hier jetzt der Tuya Tür-/Fenstersensor
Auch kann man in dem Protokoll des Mosquitto broker Addon überprüfen ob das Gerät Daten an den MQTT Broker sendet. Das sollte dann so in der Art aussehen.
Die Z2M configuration.yaml Datei die der Z2M Onboarding-Prozess dann automatisch erstellt sieht in dem Beispiel hier dann wie folgt aus:
version: 4
mqtt:
base_topic: zigbee2mqtt
server: mqtt://core-mosquitto:1883
user: addons
password: pequ2kee1maeVooxoocheiGhez0naishohHaezeexaekaeceiDaikut3too1eipi
serial:
port: /dev/ttyUSB0
adapter: zstack
baudrate: 115200
rtscts: false
advanced:
log_level: info
channel: 11
network_key:
- 79
- 232
- 222
- 86
- 121
- 120
- 115
- 209
- 206
- 129
- 5
- 145
- 243
- 101
- 244
- 4
pan_id: 12782
ext_pan_id:
- 154
- 165
- 134
- 187
- 136
- 243
- 212
- 37
frontend:
enabled: true
port: 8099
homeassistant:
enabled: true
devices:
'0xa4c138bd7fa5bbbd':
friendly_name: '0xa4c138bd7fa5bbbd'
Somit wurde jetzt das HA Mosquitto broker Addon, die HA MQTT Integration und Z2M unter HA installiert. Sollte es dabei zu evtl. Problemen oder Fehlern kommen dann am besten hier im Forum erst einmal nach dem Problem/Fehler suchen, denn häufig findet man dann auch Beiträge oder Postings von anderen Usern, die bereits das gleiche Problem und/oder den gleichen Fehler hatten.
VG Jim
