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

Überblick

Bei herkömmlichen Zigbee-Gateways erschweren Ökosystem-Barrieren zwischen den Marken die Migration oft erheblich. Der Wechsel zu einem neuen Gateway bedeutet normalerweise, dass eine große Anzahl von Untergeräten von Grund auf neu hinzugefügt werden muss.

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 Konfiguration schnell und nahtlos und mit minimalem Aufwand übertragen können. Dadurch wird das Upgrade auf einen neuen Dongle deutlich einfacher und komfortabler.

Nach mehreren Entwicklungs- und Upgrade-Runden umfasst die SONOFF-Dongle-Produktreihe nun den Dongle-M, den Dongle-PMG24 und den Dongle-LMG21 — jeweils für unterschiedliche Nutzer und Anwendungsszenarien entwickelt. Alle drei basieren auf der Ember-Lösung und unterstützen Migrationsfunktionen. Dadurch können Sie Daten von Ihrem alten Dongle übertragen und Ihr Zigbee-Ökosystem ohne Unterbrechung weiter betreiben.

In diesem Artikel verwenden wir den Dongle-M als Beispiel und zeigen Ihnen, wie Sie Ihre Konfiguration — unabhängig davon, ob sie von einem Z-Stack-basierten Dongle oder einem anderen Ember-basierten Dongle stammt — mit ZHA oder Z2M auf einen neuen SONOFF-Dongle (Dongle-M, Dongle-PMG24 und Dongle-LMG21) migrieren.

ZHA: Migration des Zigbee-Koordinators  

Offizielle ZHA-Anleitung: 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. Rufen Sie die ZHA-Konfigurationsseite auf und klicken Sie auf die Schaltfläche Radio migrieren.

2. Wählen Sie Auf neues Radio migrieren.

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

4. Trennen Sie den alten Dongle und verbinden Sie den Dongle-M mit dem USB-Anschluss des Hosts oder mit dem lokalen Netzwerk.

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

• USB-Verbindung: Wählen Sie das serielle Gerät direkt aus und stellen Sie die Verbindung her.
  
• TCP-Verbindung: Wählen Sie Manuell eingeben, wählen Sie anschließend manuell den Gerätetyp EZSP aus und geben Sie als seriellen Pfad Folgendes ein: tcp://Dongle-M.local.
  

Manuelle Einrichtung:

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

7. Migration erfolgreich.

Z2M:  Migration des Zigbee-Koordinators  

Offizielle Zigbee2MQTT-Anleitung: Wie migriere ich von einem Adapter zu einem anderen?

Migration von einem Ember-Koordinator auf den 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 in den Pfad des Dongle-M, z. B. tcp://Dongle-M.local:6638, und speichern Sie die Datei (Strg + S).

4. Starten Sie Zigbee2MQTT neu.

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

Ergebnis: 
Getestet und ohne erforderliche Neukonfiguration der Geräte

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 (falls eine Wiederherstellung erforderlich ist).

4. Bearbeiten Sie /homeassistant/zigbee2mqtt/configuration.yaml und geben Sie den seriellen Pfad des Dongle-M ein, z. B. tcp://Dongle-M.local:6638. Achten Sie darauf, den Treiber in ezsp zu ändern, und speichern Sie die Datei (Strg + S).

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

6. Starten Sie das Zigbee2MQTT-Add-on. Zigbee2MQTT erstellt das Zigbee-Netzwerk anhand der YAML-Datei neu. pan_id und extended_pan_id entsprechen dem ursprünglichen Netzwerk, während die Geräteliste leer bleibt.

7. Sobald das Zigbee-Netzwerk erfolgreich gestartet wurde und die Zigbee2MQTT-Konsole erreichbar ist, stoppen Sie das Add-on. Öffnen Sie erneut /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 so, dass für den Adapter ember festgelegt ist, und speichern Sie die Datei (Strg + S).  

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

Unabhängig davon, welche Methode Sie für die Migration Ihres Zigbee-Koordinators verwenden: Wenn Probleme auftreten, können Sie gerne den Dongle-Bereich des Forums besuchen. Unsere Dongle-Entwickler helfen Ihnen dort bei Ihren Fragen und sorgen für einen reibungslosen Übergang zu Ihrem neuen SONOFF-Dongle.