[[Uebersicht|← Zurück zur Homepage]] # Zigbee-Datenweg zu Home Assistant > Die technischen Grundlagen von Zigbee (Mesh, Verschlüsselung, Gerätetypen) sind in [[05 Zigbee Grundlagen|Zigbee – Grundlagen]] beschrieben. Diese Notiz zeigt, **wie die Daten vom Gerät bis in Home Assistant gelangen**. ## Übersicht der Testgeräte ![[ZiggbeeNetwork.webp]] --- ## Datenfluss: Vom Gerät zu Home Assistant Vom physischen Zigbee-Gerät bis zur Sensor-Entität in Home Assistant führt bei uns der Weg über **Zigbee2MQTT + MQTT-Broker**. ![[Zigbee-Datenweg-HomeAssistant.webp]] ### Datenfluss-Diagramm ``` Zigbee-Gerät (Sensor, Schalter, Lampe) ↓ 2,4 GHz Funksignal Zigbee-Dongle (USB-Stick) ← USB-Passthrough in Proxmox ↓ Serielle Datenübertragung Zigbee2MQTT (Software) ← LXC-Container auf Proxmox ↓ MQTT-Protokoll über TCP MQTT-Broker Mosquitto ← HA Add-on oder separater Container ↓ Lokales Netzwerk Home Assistant MQTT-Integration ← abonniert und verarbeitet Nachrichten ↓ Sensor-Entität im HA-Dashboard ``` ### Komponenten und ihre Funktionen | Komponente | Funktion | Details | |---|---|---| | **Zigbee-Dongle** | Empfängt/sendet Zigbee-Funk | USB-Passthrough erforderlich bei Proxmox | | **Zigbee2MQTT** | Dekodiert Protokoll, konvertiert zu JSON | Unterstützt 4000+ Gerätemodelle | | **Mosquitto-Broker** | Zentrale Nachrichtenverteilung | Kommunikation über MQTT-Topics | | **HA MQTT-Integration** | Empfängt Daten, erstellt Entitäten | Auto-Discovery erkennt neue Geräte | ### Stärken dieser Variante ✅ **Maximale Gerätekompatibilität** – unterstützt fast alle Zigbee-Geräte auf dem Markt ✅ **Flexible Konfiguration** – detailliertes Logging und Debugging möglich ✅ **Unabhängig von Home Assistant** – funktioniert auch bei HA-Updates ✅ **MQTT ist Standard** – kann mit anderen Smart-Home-Systemen kommunizieren ### Herausforderungen ⚠️ **Mehr Komponenten** – mehrere Dienste müssen aktiv sein ⚠️ **Höherer Aufwand** – Einrichtung und Troubleshooting komplexer ⚠️ **Ressourcen-Verbrauch** – mehrere Container benötigen CPU/RAM --- ## Netzwerk-Sicherheit bei Zigbee - **Verschlüsselung**: AES-128 (Standard) - **Pairing-Prozess**: Geräte müssen manuell „gejoint" werden - **Isolierung**: Das Zigbee-Netzwerk ist lokal und braucht kein Internet - **Best Practice**: Join-Fenster nach dem Pairing wieder schließen --- ## Hardware-Anforderungen ### Zigbee-Dongle (Coordinator) Bei uns im Einsatz: **SONOFF Zigbee/Thread PoE Dongle Max** – Details siehe [[04 Zigbee Sonoff Dongle M|Sonoff Dongle M]]. Weitere gängige Modelle: - **SONOFF Zigbee 3.0 USB Dongle Plus** (beliebt, zuverlässig) - **ConBee II/III** (sehr kompatibel, etwas teurer) - [Zigbee2MQTT Adapter-Liste](https://www.zigbee2mqtt.io/guide/adapters/) ### USB-Passthrough bei Proxmox Bei einer Proxmox-VM/LXC muss der USB-Dongle durchgereicht werden. Die konkreten Schritte stehen in [[02 Zigbee2MQTT auf Proxmox#USB-Passthrough für den Zigbee-Dongle|Zigbee2MQTT auf Proxmox]]. --- ## Troubleshooting-Tipps | Problem | Lösung | |---|---| | Geräte verbinden sich nicht | Dongle-Position überprüfen, Join-Fenster offen? | | Verzögerte Reaktion | Mesh-Netzwerk schwach, Router-Geräte hinzufügen | | Geräte fallen oft weg | Netzwerk-Interferenz? 2,4-GHz-WiFi-Kanal anpassen | | Zigbee2MQTT startet nicht | Logs prüfen – siehe [[02 Zigbee2MQTT auf Proxmox#Troubleshooting|Proxmox-Note]] | --- ## Setup in dieser Installation (Moni's Elektro Base) - **Zigbee-Dongle**: SONOFF Zigbee/Thread PoE Dongle Max - **Platzierung**: Zentral im Haus für beste Reichweite - **Stromversorgung**: PoE oder USB - **Betrieb**: Zigbee2MQTT als LXC-Container auf [[06 Hardware Hypervisor PVE|Proxmox]] --- ## Dokumentation & Weitere Ressourcen - [📖 Zigbee2MQTT Dokumentation](https://www.zigbee2mqtt.io/) - [📖 ZHA Home Assistant Integration](https://www.home-assistant.io/integrations/zha/) - [📖 Mosquitto MQTT Broker](https://mosquitto.org/) - [📋 Zigbee2MQTT Geräte-Support](https://www.zigbee2mqtt.io/supported-devices/) - [🎓 Zigbee-Standard IEEE 802.15.4](https://en.wikipedia.org/wiki/IEEE_802.15.4) - [🐧 Docker Hub Zigbee2MQTT](https://hub.docker.com/r/koenkk/zigbee2mqtt) --- [[Impressum|Impressum]] | [[Datenschutzerklärung|Datenschutz]]