= 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`