Hoe migreer je je Zigbee-coördinator naar de nieuwe SONOFF-dongle?

Overzicht

Voor traditionele Zigbee-gateways zorgen ecosysteembarrières tussen merken er vaak voor dat migratie een echte hoofdpijn wordt. Overschakelen naar een nieuwe gateway betekent meestal dat je een groot aantal subapparaten helemaal opnieuw moet toevoegen.

Voor Zigbee-coördinatoren in de vorm van Dongles—die vaak worden gebruikt met open-source platforms—is het verhaal echter heel anders. Als je je Dongle moet vervangen, bieden zowel ZHA als Z2M Zigbee-coördinator-migratiefuncties waarmee je je setup snel en naadloos kunt overzetten, met minimale inspanning. Dit maakt het upgraden naar een nieuwe Dongle veel eenvoudiger en veel handiger.

Na verschillende iteraties en upgrades is de SONOFF Dongle-lijn geëvolueerd en omvat nu de Dongle-M, Dongle-PMG24 en Dongle-LMG21—elk ontworpen voor verschillende gebruikers en scenario’s. Alle drie zijn gebaseerd op de Ember-oplossing en ondersteunen migratiefuncties, zodat je gegevens van je oude Dongle kunt overzetten en je Zigbee-ecosysteem zonder onderbreking kunt blijven gebruiken.

In dit artikel nemen we de Dongle-M als voorbeeld en laten we je zien hoe je je configuratie migreert—of dat nu van een Z-Stack-gebaseerde Dongle is of een andere Ember-gebaseerde Dongle—naar een nieuwe SONOFF Dongle (Dongle-M, Dongle-PMG24 en Dongle-LMG21) met behulp van ZHA of Z2M.

ZHA: Zigbee-coördinator-migratie  

Officiële ZHA-handleiding: https://www.home-assistant.io/integrations/zha/#migrating-to-a-new-zigbee-coordinator-adapter-inside-zha

Resultaat:

Geen herconfiguratie van apparaten nodig  

Migratiestappen:

1. Ga naar de ZHA-configuratiepagina en klik op de knop Migrate Radio.

2. Selecteer Migrate to new radio.

3. Bevestig de migratiegegevens en klik op Submit.

4. Koppel de oude Dongle los en sluit de Dongle-M aan op de USB-poort van de host of het lokale netwerk.

5. Bevestig de verbindingsmethode voor Dongle-M:

• USB-verbinding: Selecteer het seriële apparaat direct en maak verbinding.
  
• TCP-verbinding: Kies Enter Manually, selecteer vervolgens handmatig het apparaattype EZSP en stel het seriële pad in op: tcp://Dongle-M.local.
  

Handmatige setup:

6. Kies om te herstellen vanaf automatische back-up.

7. Migratie geslaagd.

Z2M:  Zigbee-coördinator-migratie  

Officiële Zigbee2MQTT-handleiding: https://www.zigbee2mqtt.io/guide/faq/#how-do-i-migrate-from-one-adapter-to-another

Migreren van een Ember-coördinator naar Dongle-M

Resultaat:

Geen herconfiguratie van apparaten nodig

Stappen:

1. Stop de Zigbee2MQTT-add-on.

2. Gebruik de File Editor-add-on om toegang te krijgen tot /homeassistant/zigbee2mqtt/configuration.yaml.

3. Verander de poort naar het Dongle-M-pad, bijvoorbeeld tcp://Dongle-M.local:6638, en sla op (Ctrl + S).

4. Start Zigbee2MQTT opnieuw.

Migreren van een Z-Stack-coördinator naar Dongle-M (onofficiële aanbeveling)

Resultaat: 
Getest zonder dat herconfiguratie van apparaten nodig is

Stappen:

1. Stop de Zigbee2MQTT-add-on.

2. Gebruik de File Editor-add-on om toegang te krijgen tot /homeassistant/zigbee2mqtt/.

3. Maak een back-up van configuration.yaml, coordinator_backup.json en database.db op je lokale computer (voor het geval herstel nodig is).

4. Pas /homeassistant/zigbee2mqtt/configuration.yaml aan en voer het seriële pad van Dongle-M in, bijvoorbeeld tcp://Dongle-M.local:6638. Zorg ervoor dat je de driver wijzigt naar ezsp en sla op (Ctrl + S).

5. Verwijder /homeassistant/zigbee2mqtt/coordinator_backup.json.

6. Start de Zigbee2MQTT-add-on. Zigbee2MQTT zal het Zigbee-netwerk opnieuw aanmaken op basis van het YAML-bestand. De pan_id en extended_pan_id zullen overeenkomen met het originele netwerk, terwijl de apparatenlijst leeg zal zijn.

7. Zodra het Zigbee-netwerk succesvol is gestart en de Zigbee2MQTT-console toegankelijk is, stop je de add-on. Ga terug naar /homeassistant/zigbee2mqtt/, verwijder de nieuw aangemaakte database.db en hernoem de originele database.db.backup naar database.db.

8. Pas ook configuration.yaml aan om adapter op ember te zetten en sla op (Ctrl + S).  

9. Start Zigbee2MQTT opnieuw. De originele apparatenlijst wordt nu hersteld vanuit database.db.  

Tot slot, ongeacht welke methode je gebruikt om je Zigbee-coördinator te migreren, als je problemen ondervindt, bezoek dan gerust de Dongle-sectie van het forum. Onze Dongle-ontwikkelaars staan klaar om je vragen te beantwoorden en zorgen voor een soepele, naadloze overgang naar je nieuwe SONOFF Dongle.