Zigbee2MQTT Konfiguration

Übersicht

Zigbee2MQTT (z2m) ist eine Bridge zwischen dem Zigbee-Funknetz und dem MQTT-Broker. Es übernimmt ausschließlich Protokollübersetzung und Netz-Management. Die Automationslogik liegt im IO-Broker. Der Coordinator ist ein Sonoff Dongle-Max (Silicon Labs EFR32MG21, EmberZNet-Firmware), angebunden per TCP über das interne Netz.

Coordinator

Gerät	Sonoff Dongle-Max
Protokoll	ember (EmberZNet)
Adresse	tcp://zb-dongle-max.mqtt.p21.net:6638
Baudrate	115200, rtscts: false

MQTT

Broker	zentraler Broker, internes Netz
Base-Topic	zigbee
Protocol	MQTT 3.1.1 (Version 4)
Retain	deaktiviert (force_disable_retain: true)

Bridge-State wird automatisch auf zigbee/bridge/state publiziert ({"state":"online"} / {"state":"offline"}), nutzbar als LWT-Ersatz im IO-Broker.

Availability

Aktive Geräte (netzbetrieben)	Timeout 3 min, Backoff aktiv, Pause bei >120 min
Passive Geräte (Batterie)	Timeout 240 min

OTA-Updates

Automatische Update-Checks sind deaktiviert (disable_automatic_update_check: true). Geräte-initiierte Anfragen werden von z2m mit "kein Image verfügbar" beantwortet, kein Kontakt zu Drittservern. Manuelle Prüfung bei Bedarf per MQTT:

zigbee/bridge/request/device/ota_update/check
{"id": "friendly_name_des_geraets"}

Logging

Console-Logging abgeschaltet, nur File-Logging aktiv. Entlastet den Docker-Logger bei den minütlichen z2m-Statusmeldungen erheblich. In der configuration.yaml:

advanced:
  log_output:
    - file

Schlüsseldaten (Netzwerk)

Network Key, PAN ID und Extended PAN ID liegen im Klartext in /var/www/bsp12-zigbee2mqtt/z2m-data/configuration.yaml. Diese Datei ist sicherheitsrelevant und darf nicht öffentlich zugänglich sein.

TODO: Backup läuft über dirvish.

Geräte-Strategie

Netzbetriebene Geräte (Router) zuerst pairen, danach Endgeräte (Batterie). Friendly Names nach Schema: raumname_funktion, z.B. wohnzimmer_heizung.

• Setpoint-Steuerung und Zeitpläne ausschließlich über IO-Broker
• Tuya-TRVs im Modus heat, interner Schedule deaktiviert

Für ME167-Thermostate (Tuya TS0601): kein nativer externer Sensor-Support. Externe Temperaturregelung vollständig in IO-Broker implementieren.

Metadaten abrufen (ohne Neustart)

mosquitto_pub -h broker.mqtt.p21.net -t "zigbee/bridge/request/devices" -m ""

Antwort auf: zigbee/bridge/devices