Zigbee2mqtt: Zigbee Devices koppeln

Bevor das erste Zigbee-Gerät mit dem neu eingerichteten Zigbee2mqtt-Controller gekoppelt wird, sollte sichergestellt werden, dass die Auto-Discovery-Funktion in Home Assistant aktiviert ist (siehe auch Zigbee2mqtt absichern und in Home Assistant einbinden). So spart man sich das das nachträgliche manuelle Einrichten der Zigbee-Geräte in Home Assistant.

Kopplungsmodus in Zigbee2mqtt aktivieren

Damit neue Geräte in das Zigbee-Netzwerk integriert werden können, muss der Coordinator in den entsprechenden Modus gebracht werden. Dies kann auf unterschiedliche Art und Weise erfolgen.

Wurde die im Artikel Turris Omnia: Zigbee2mqtt im LXC-Container vorgeschlagene Home Assistant Integration eingerichtet. so kann über das Lovelace-Interface der Kopplungsmodus durch das Aktivieren des Schalters "Zigbee2mqtt Main join" für zwei Minuten aktiviert werden (siehe Screenshot).

Alternativ kann auch eine MQTT Nachricht an das Topic zigbee2mqtt/bridge/config/permit_join mit dem Inhalt true gesendet werden.

Als dritte Möglichkeit kann aber auch in der Konfigurationsdatei configuration.yaml von Zigbee2mqtt der Eintrag permit_join: true hinzugefügt werden. Dadurch wird der Kopplungsmodus dauerhaft aktiviert.

Hinweis: Wenn die Integration von neuen Geräten abgeschlossen ist, so sollte der Kopplungsmodus wieder deaktiviert werden. Solange neue Geräte in das Netzwerk integriert werden können, kann dies beispielsweise genutzt werden um sogenannte Rogue Devices in das Netzwerk zu integrieren, mit denen beliebige Zigbee Nachrichten empfangen und gesendet werden können.

Einbinden des Zigbee-Gerätes

Wie ein Gerät in das Netzwerk zu integrieren ist, ist abhängig vom Modell und Hersteller des Zigbee Devices. Die Informationen zum Inkludieren eines Gerätes findet man am leichtesten auf der Seite mit den den von Zigbee2mqqt unterstützten Geräten. In der Detailansicht der Geräte finden sich üblicherweise Hinweise, wie die Geräte am besten einzubinden sind. Ansonsten sollte auch ein Blick in die Beschreibung des Zigbee-Gerätes helfen. Auf jeden Fall empfiehlt sich ein vorheriges zurücksetzen des Gerätes. So ist sichergestellt, dass auch bereits ab Werk eingerichtete Kopplungen (z.B. bei komplett Sets) aufgehoben werden.

Der Status der Kopplung kann in den Zigbee2mqtt-Logdateien nachvollzogen werden und sieht ungefähr so aus:

info  2020-04-18 00:34:24: Starting interview of '0x000b57fffef40d2e'
info  2020-04-18 00:34:24: MQTT publish: topic 'zigbee2mqtt/bridge/log', payload '{"type":"pairing","message":"interview_started","meta":{"friendly_name":"0x000b57fffef40d2e"}}'
info  2020-04-18 00:34:43: MQTT publish: topic 'zigbee2mqtt/bridge/log', payload '{"type":"device_announced","message":"announce","meta":{"friendly_name":"0x000b57fffef40d2e"}}'
info  2020-04-18 00:34:48: MQTT publish: topic 'homeassistant/light/0x000b57fffef40d2e/light/config', payload '{"brightness":true,"color_temp":true,"schema":"json","command_topic":"zigbee2mqtt/0x000b57fffef40d2e/set","state_topic":"zigbee2mqtt/0x000b57fffef40d2e","json_attributes_topic":"zigbee2mqtt/0x000b57fffef40d2e","name":"0x000b57fffef40d2e_light","unique_id":"0x000b57fffef40d2e_light_zigbee2mqtt","device":{"identifiers":["zigbee2mqtt_0x000b57fffef40d2e"],"name":"0x000b57fffef40d2e","sw_version":"Zigbee2mqtt 1.12.2","model":"TRADFRI LED bulb E12/E14 400 lumen, dimmable, white spectrum, opal white (LED1536G5)","manufacturer":"IKEA"},"availability_topic":"zigbee2mqtt/bridge/state"}'
info  2020-04-18 00:34:48: MQTT publish: topic 'homeassistant/sensor/0x000b57fffef40d2e/linkquality/config', payload '{"icon":"mdi:signal","unit_of_measurement":"lqi","value_template":"{{ value_json.linkquality }}","state_topic":"zigbee2mqtt/0x000b57fffef40d2e","json_attributes_topic":"zigbee2mqtt/0x000b57fffef40d2e","name":"0x000b57fffef40d2e_linkquality","unique_id":"0x000b57fffef40d2e_linkquality_zigbee2mqtt","device":{"identifiers":["zigbee2mqtt_0x000b57fffef40d2e"],"name":"0x000b57fffef40d2e","sw_version":"Zigbee2mqtt 1.12.2","model":"TRADFRI LED bulb E12/E14 400 lumen, dimmable, white spectrum, opal white (LED1536G5)","manufacturer":"IKEA"},"availability_topic":"zigbee2mqtt/bridge/state"}'
info  2020-04-18 00:34:48: MQTT publish: topic 'homeassistant/binary_sensor/0x000b57fffef40d2e/update_available/config', payload '{"payload_on":true,"payload_off":false,"value_template":"{{ value_json.update_available}}","state_topic":"zigbee2mqtt/0x000b57fffef40d2e","json_attributes_topic":"zigbee2mqtt/0x000b57fffef40d2e","name":"0x000b57fffef40d2e_update_available","unique_id":"0x000b57fffef40d2e_update_available_zigbee2mqtt","device":{"identifiers":["zigbee2mqtt_0x000b57fffef40d2e"],"name":"0x000b57fffef40d2e","sw_version":"Zigbee2mqtt 1.12.2","model":"TRADFRI LED bulb E12/E14 400 lumen, dimmable, white spectrum, opal white (LED1536G5)","manufacturer":"IKEA"},"availability_topic":"zigbee2mqtt/bridge/state"}'
info  2020-04-18 00:34:48: Successfully interviewed '0x000b57fffef40d2e', device has successfully been paired
info  2020-04-18 00:34:48: Device '0x000b57fffef40d2e' is supported, identified as: IKEA TRADFRI LED bulb E12/E14 400 lumen, dimmable, white spectrum, opal white (LED1536G5)
info  2020-04-18 00:34:48: MQTT publish: topic 'zigbee2mqtt/bridge/log', payload '{"type":"pairing","message":"interview_successful","meta":{"friendly_name":"0x000b57fffef40d2e","model":"LED1536G5","vendor":"IKEA","description":"TRADFRI LED bulb E12/E14 400 lumen, dimmable, white spectrum, opal white","supported":true}}'

Sollte die Kopplung nicht auf Anhieb funktionieren, dann helfen in der Regel mehrere Versuche. Bei klappt es in der Regel spätestens nach dem dritten Versuch. Wichtig ist jedoch, dass sich das zu integrierende Gerät in unmittelbarer Nähe zum Controller befindet.