SONOFF Dongle Max: Matter over Thread Integration

Diese Anleitung beschreibt detailliert, wie du den SONOFF Dongle Max (Zigbee/Thread PoE Dongle | Dongle-M) als Thread-Adapter verwendest. Dabei verbindet sich Home Assistant über das Netzwerk (TCP) mit dem Dongle, um ein eigenes Thread-Netzwerk aufzubauen und anschließend Matter over Thread Smart-Home-Geräte hinzuzufügen.

1. Systemumgebung & Voraussetzungen

• Hardware-Plattformen: Raspberry Pi 4/5 oder Generic x86-64 Systeme
• Betriebssystem: Home Assistant Operating System (HAOS) ab Version 17.0
• Home Assistant Core: Version 2026.2.0 oder neuer
• OpenThread Border Router App (OTBR): Version 2.16.5 oder neuer
• Matter Server App: Version 8.2.2 oder neuer
• Mobiles Endgerät: Home Assistant Companion App (Google Play Store / Apple App Store)

2. Vorbereitung

2.1. Zugriff auf Home Assistant

Stelle sicher, dass dein Home Assistant Operating System erfolgreich installiert, gestartet und über die Weboberfläche im Browser erreichbar ist.

2.2. Firmware flashen & Betriebsmodus umstellen

Flashe die aktuelle OpenThread RCP-Firmware auf deinen Dongle Max. SONOFF bietet hierzu drei offizielle Methoden über den SONOFF Dongle Flasher an (per Web App via USB, direkt als HA-Add-on oder als Docker-Image).

Alternativ kannst du den Modus direkt über die integrierte Web-UI des Dongle Max wechseln: Navigiere dort auf die Seite EFP32MG24 Operation Mode und aktiviere den Thread RCP Mode.

2.3. Optional: Bluetooth-Integration aktivieren

Falls du neue Matter-Geräte später direkt über die Weboberfläche des Matter-Servers statt über die Smartphone-App anlernen möchtest, musst du die Bluetooth-Integration in Home Assistant aktivieren.

3. OpenThread Border Router (OTBR) einrichten

3.1. Installation

Navigiere in Home Assistant zu Einstellungen > Apps > App installieren. Suche im App Store nach OpenThread Border Router und klicke auf Installieren.

3.2. Konfiguration

Wechsle nach der Installation zum Reiter Konfiguration der OTBR-App und nimm folgende Einstellungen vor (aktiviere vorher die Option "Ungenutzte optionale Konfigurationsoptionen anzeigen"):

• Device: Wähle ein beliebiges Gerät aus (dies hat bei Netzwerkkopplung keine Auswirkung).
• Baudrate: 115200
• Hardware flow control: Deaktiviert (false)
• Network Device: dongle-m.local:6638 *(Ersetze dies durch die IP-Adresse oder den mDNS-Namen deines Dongle Max)*

3.3. Start & Netzwerk-Prüfung

Aktiviere unter Informationen die Optionen "Mit dem System starten" sowie "Watchdog" und klicke auf Starten. Überprüfe den Reiter Protokoll. Sobald Dienste wie der otbr-agent-configure erfolgreich gestartet sind, läuft die App korrekt.

Home Assistant aktiviert nun automatisch die Thread-Integration. Überprüfe unter Einstellungen > Geräte & Dienste > Thread das neu erstellte Netzwerk (beginnend mit ha-thread). Stelle sicher, dass dieses Netzwerk als **bevorzugtes Netzwerk (Preferred Thread network)** gesetzt ist. Klicke auf das Info-Symbol des Netzwerks und notiere dir die **Active dataset TLVs**.

4. Matter Server App einrichten

4.1. Installation & Optionale Konfiguration

Installiere die **Matter Server App** über den HA-App-Store. Falls du die Web-UI zum Anlernen nutzt, konfiguriere unter Konfiguration die korrekte Bluetooth Adapter ID (Standard ist 0 für hci0).

4.2. Starten

Aktiviere "Mit dem System starten", "Watchdog" sowie "An Seitenleiste anheben" und klicke auf Starten. Das Protokoll muss die Meldung Matter Server successfully initialized ausgeben.

5. Matter over Thread Geräte hinzufügen

Methode A: Über die Matter Server Web-UI

Versetze dein Smart-Home-Gerät in den Pairing-Modus und halte den 11- oder 21-stelligen Pairing-Code bereit. Öffne die Matter Server Web-UI (über die Seitenleiste oder den Button "Web-UI öffnen"), klicke auf Commission node, wähle Commission new Thread device, füge deine zuvor kopierten **Active dataset TLVs** ein, gib den Pairing-Code ein und starte den Vorgang mit einem Klick auf Commission.

Methode B: Über die Home Assistant Companion App

Navigiere in der App zu Einstellungen > Thread, klicke auf das Drei-Punkte-Menü deines ha-thread-Netzwerks und wähle **"Für Android + iOS Anmeldedaten verwenden"**. Versetze das Gerät in den Pairing-Modus.

Gehe in der Companion App zu Einstellungen > Geräte & Dienste > Matter, klicke auf **Gerät hinzufügen**, wähle *“Nein, es ist neu”* und folge den Anweisungen zum Scannen des QR-Codes.