Changes between Initial Version and Version 1 of Zigbee2MqttEinrichtung

Timestamp:

Apr 4, 2026, 8:23:31 AM (3 weeks ago)

Author:

Johannes Lode

Comment:

--

Zigbee2MqttEinrichtung

@@ +1 @@
+= 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`