Wie Sie Ihren Zigbee-Koordinator auf den neuen SONOFF-Dongle migrieren

Übersicht

Bei herkömmlichen Zigbee-Gateways führen Ökosystem-Barrieren zwischen Marken oft zu großen Problemen bei der Migration. Der Wechsel zu einem neuen Gateway bedeutet in der Regel, eine große Anzahl von Untergeräten von Grund auf neu hinzuzufügen.

Bei Zigbee-Koordinatoren in Form von Dongles – die häufig mit Open-Source-Plattformen verwendet werden – sieht die Sache jedoch ganz anders aus. Wenn Sie Ihren Dongle ersetzen müssen, bieten sowohl ZHA als auch Z2M Funktionen zur Migration des Zigbee-Koordinators, mit denen Sie Ihre Einrichtung schnell und nahtlos mit minimalem Aufwand übertragen können. Das macht das Upgrade auf einen neuen Dongle viel einfacher und deutlich komfortabler.

Nach mehreren Iterations- und Upgrade-Runden hat sich die SONOFF Dongle-Reihe weiterentwickelt und umfasst nun den Dongle-M, den Dongle-PMG24 und den Dongle-LMG21 – jeweils für unterschiedliche Nutzer und Szenarien konzipiert. Alle drei basieren auf der Ember-Lösung und unterstützen Migrationsfunktionen, mit denen Sie Daten von Ihrem alten Dongle übertragen und Ihr Zigbee-Ökosystem ohne Unterbrechung weiter betreiben können.

In diesem Artikel nehmen wir den Dongle-M als Beispiel und zeigen Ihnen, wie Sie Ihre Konfiguration – egal ob von einem Z-Stack-basierten Dongle oder einem anderen Ember-basierten Dongle – in einen neuen SONOFF Dongle (Dongle-M, Dongle-PMG24 und Dongle-LMG21) mit ZHA oder Z2M migrieren können.

ZHA: Zigbee-Koordinator-Migration  

Offizielles ZHA-Tutorial: https://www.home-assistant.io/integrations/zha/#migrating-to-a-new-zigbee-coordinator-adapter-inside-zha

Ergebnis:

Keine Neukonfiguration der Geräte erforderlich  

Migrationsschritte:

1. Gehen Sie zur ZHA-Konfigurationsseite und klicken Sie auf die Schaltfläche Funkgerät migrieren.

2. Wählen Sie Zu neuem Funkgerät migrieren.

3. Bestätigen Sie die Migrationsinformationen und klicken Sie auf Absenden.

4. Ziehen Sie den alten Dongle ab und schließen Sie den Dongle-M an den USB-Anschluss des Hosts oder das lokale Netzwerk an.

5. Bestätigen Sie die Verbindungsart für den Dongle-M:

• USB-Verbindung: Wählen Sie das serielle Gerät direkt aus und verbinden Sie sich.
  
• TCP-Verbindung: Wählen Sie Manuell eingeben, dann manuell den Gerätetyp EZSP auswählen und den seriellen Pfad auf tcp://Dongle-M.local setzen.
  

Manuelle Einrichtung:

6. Wählen Sie die Wiederherstellung aus dem automatischen Backup.

7. Migration erfolgreich.

Z2M:  Zigbee-Koordinator-Migration  

Offizielles Zigbee2MQTT-Tutorial: https://www.zigbee2mqtt.io/guide/faq/#how-do-i-migrate-from-one-adapter-to-another

Migration von einem Ember-Koordinator zu Dongle-M

Ergebnis:

Keine Neukonfiguration der Geräte erforderlich

Schritte:

1. Stoppen Sie das Zigbee2MQTT-Add-on.

2. Verwenden Sie das File Editor-Add-on, um auf /homeassistant/zigbee2mqtt/configuration.yaml zuzugreifen.

3. Ändern Sie den Port auf den Pfad des Dongle-M, z. B. tcp://Dongle-M.local:6638, und speichern Sie (Strg + S).

4. Starten Sie Zigbee2MQTT neu.

Migration von einem Z-Stack-Koordinator zu Dongle-M (inoffizielle Empfehlung)

Ergebnis: 
Getestet, dass keine Neukonfiguration der Geräte erforderlich ist

Schritte:

1. Stoppen Sie das Zigbee2MQTT-Add-on.

2. Verwenden Sie das File Editor-Add-on, um auf /homeassistant/zigbee2mqtt/ zuzugreifen.

3. Sichern Sie configuration.yaml, coordinator_backup.json und database.db auf Ihrem lokalen Computer (für den Fall, dass eine Wiederherstellung nötig ist).

4. Ändern Sie /homeassistant/zigbee2mqtt/configuration.yaml und geben Sie den seriellen Pfad des Dongle-M ein, z. B. tcp://Dongle-M.local:6638. Stellen Sie sicher, dass der Treiber auf ezsp geändert wird, und speichern Sie (Strg + S).

5. Löschen Sie /homeassistant/zigbee2mqtt/coordinator_backup.json.

6. Starten Sie das Zigbee2MQTT-Add-on. Zigbee2MQTT wird das Zigbee-Netzwerk basierend auf der YAML-Datei neu erstellen. Die pan_id und extended_pan_id entsprechen dem ursprünglichen Netzwerk, während die Geräteliste leer sein wird.

7. Sobald das Zigbee-Netzwerk erfolgreich gestartet ist und die Zigbee2MQTT-Konsole zugänglich ist, stoppen Sie das Add-on. Gehen Sie erneut zu /homeassistant/zigbee2mqtt/, löschen Sie die neu erstellte database.db und benennen Sie die ursprüngliche database.db.backup in database.db um.

8. Ändern Sie außerdem configuration.yaml, um den Adapter auf ember zu setzen, und speichern Sie (Strg + S).  

9. Starten Sie Zigbee2MQTT neu. Die ursprüngliche Geräteliste wird nun aus database.db wiederhergestellt.  

Abschließend gilt: Egal, welche Methode Sie zur Migration Ihres Zigbee-Koordinators verwenden, wenn Sie auf Probleme stoßen, besuchen Sie gerne den Dongle-Bereich im Forum. Unsere Dongle-Entwickler stehen bereit, um Ihre Fragen zu beantworten und einen reibungslosen, nahtlosen Übergang zu Ihrem neuen SONOFF Dongle zu gewährleisten.