Hoe migreert u uw Zigbee-netwerk naar een nieuwe coördinator?

Leer hoe u uw bestaande ZHA- of Zigbee2MQTT-netwerk kunt migreren naar een nieuwe Zigbee-coördinator zonder apparaten opnieuw te hoeven koppelen.

Sinds de release van de Home Assistant Connect ZBT-2 Zigbee- en Thread-coördinator en de aankondiging van Zigbee 4.0 en de SUZI-standaard, vragen mensen zich af wat er precies nodig is om van de ene adapter naar de andere over te stappen. Wat is er vereist, welke risico’s zijn er en kan het überhaupt zonder de apparaten opnieuw te koppelen?
Want wie wil er nu honderd Zigbee-apparaten in huis resetten om ze aan een nieuwe coördinator toe te voegen? Ik denk niemand.

Dit artikel beantwoordt al uw vragen over het migreren van uw bestaande Zigbee-netwerk naar een nieuwe coördinator. Het beschrijft duidelijk de risico’s, de vereisten waaraan moet worden voldaan en begeleidt u stap voor stap door het proces.

Waarom migreren en voor wie is dit bedoeld?

Het migreren van uw Zigbee-netwerk kan intimiderend lijken, vooral als u het gebruikt voor verlichting, sensoren, schakelaars en automatiseringen in uw huis. Het goede nieuws is dat overstappen naar een nieuwe coördinator niet hoeft te betekenen dat u helemaal opnieuw moet beginnen. Oké, maar waarom migreren?

U wilt upgraden van een oudere Zigbee-coördinator naar een nieuwer, krachtiger model

U wilt een beter bereik, meer stabiliteit of een hogere apparaatlimiet

Uw huidige adapter heeft hardwareproblemen, interferentieproblemen of verouderde firmware

U bent uw Home Assistant-configuratie aan het herbouwen en wilt alle gekoppelde Zigbee-apparaten behouden

U wilt voorkomen dat u tientallen of zelfs honderden apparaten in uw huis opnieuw moet koppelen

Deze handleiding richt zich uitsluitend op het migreren naar een nieuwe coördinator zonder apparaten opnieuw te hoeven koppelen. Als opnieuw koppelen nodig is, is het proces eenvoudig en behoeft weinig uitleg: werk het coördinatorpad in uw configuratie bij en begin met het één voor één toevoegen van apparaten.

Ondersteunde coördinatoren en Zigbee-chips

Als zowel uw oude als nieuwe coördinatoren een chip gebruiken die back-up en herstel in Zigbee2MQTT ondersteunt, is de migratie vrij eenvoudig. Op dit moment wordt volledige back-up en herstel officieel alleen ondersteund voor coördinatoren gebaseerd op zstack (Texas Instruments) en ember (Silicon Labs). Dit omvat migratie tussen verschillende modellen binnen dezelfde familie, zoals EFR32MG21 naar EFR32MG24 of CC2538 naar CC2652P.

Bij migratie tussen verschillende chipfamilies, zoals zstack naar ember of ember naar zstack, wordt het proces niet officieel ondersteund, maar u kunt (en zult waarschijnlijk) toch succes hebben. In de meeste gevallen verbinden apparaten zich opnieuw met het nieuwe netwerk zonder opnieuw te koppelen en werken ze probleemloos. Zelfs als sommige apparaten opnieuw gekoppeld moeten worden, migreren de meeste apparaten succesvol.

Back-up en herstelmigratie wordt niet ondersteund voor andere adaptertypen in Zigbee2MQTT, waaronder conbee, ezsp, zboss en zigate. Deze adapters kunnen geen coördinatorback-upbestanden importeren of herstellen, waardoor Zigbee2MQTT geen echte migratie ermee kan uitvoeren. Het is mogelijk dat deze methode wel werkt, maar er zijn geen garanties.

Daarom richt deze handleiding voor Zigbee2MQTT zich uitsluitend op het migreren van ondersteunde adapters, waaronder ember > ember, ember > zstack, zstack > zstack en zstack > ember. ZHA ondersteunt migratie tussen alle officieel ondersteunde radiotypes, waardoor u uw bestaande netwerk van de ene adapter naar de andere kunt verplaatsen, zolang beide adapters compatibel zijn met ZHA.

Om het helemaal duidelijk te maken, volgt hier een tabel met een aantal Zigbee-coördinatoren en de chips die ze gebruiken:

Opmerking: ezsp is de verouderde driver voor Silicon Labs-adapters. Als u momenteel ezsp gebruikt, is het raadzaam om uw configuratie eerst te migreren naar de nieuwere Ember-driver. Beschouw dit als een Ember-naar-Ember-migratie, die werkt ondanks het officiële label “niet ondersteund”.

Zigbee2MQTT migreren naar een nieuwe coördinator

Bij het overschakelen naar een nieuwe coördinator met een back-upfunctie kan Zigbee2MQTT het volledige netwerk herstellen zonder opnieuw te hoeven koppelen. Sommige apparaten zoeken de coördinator op via het IEEE-adres, wat mislukt wanneer het adres van de coördinator verandert. Daarom moet uw bestaande IEEE-adres worden gekopieerd naar de nieuwe coördinator. Zowel zstack– als Ember-adapters ondersteunen volledige back-up en herstel, waardoor u het IEEE-adres, de netwerksleutel en de routeringstabel direct naar de nieuwe hardware kunt overzetten.

Volg deze procedure om Zigbee2MQTT naar een nieuwe coördinator te migreren:

1. Update Zigbee2MQTT naar de nieuwste versie
   Voor de migratie is een recente Z2M-versie vereist om volledige back-upcompatibiliteit te garanderen.
2. Maak voor de zekerheid een volledige back-up van Zigbee2MQTT
   Maak een back-up van de volgende bestanden uit uw Zigbee2MQTT-gegevensmap: coördinator_backup.json, database.db, configuration.yaml
3. Stop Zigbee2MQTT volledig
   Dit voorkomt schrijfbewerkingen tijdens het exporteren van de back-up of bij het kopiëren van het IEEE-adres.
4. Kopieer het IEEE-adres van de oude naar de nieuwe adapter (LEES HIERONDER)
   SLA DEZE STAP NIET OVER: Dit zorgt ervoor dat uw netwerk de nieuwe hardware als dezelfde coördinator herkent.
5. Verbind uw nieuwe coördinator met uw server
   Als het een USB-coördinator is, sluit deze dan weer aan op de server. Als het een netwerkcoördinator is, zorg er dan voor dat deze actief is op een statisch IP-adres. Als u Home Assistant of Zigbee2MQTT in een virtuele machine (Proxmox, ESXi) of Docker gebruikt, moet u uw USB-passthrough-instellingen of volumetoewijzing bijwerken.
6. Werk uw Zigbee2MQTT-configuratie bij
   Zorg ervoor dat de pan_id en ext_pan_id in uw configuratiebestand exact overeenkomen met uw vorige instellingen. Als u gegevens naar een nieuwe installatie kopieert, worden deze waarden soms teruggezet naar de standaardwaarden, waardoor apparaten geen verbinding kunnen maken. Werk tot slot het seriële gedeelte bij zodat het overeenkomt met uw nieuwe coördinator:serial:
port: /dev/ttyUSB_NEW_COORDINATOR #Pas het pad aan en stel het adaptertype in
7. Start Zigbee2MQTT
8. Klaar!

Met het nieuwe adres dat overeenkomt met uw oude adres, zal uw Zigbee-netwerk opnieuw opstarten met de nieuwe coördinator. Het duurt even voordat het stabiel is en u ontvangt mogelijk onnauwkeurige LQI-gegevens. Wees geduldig, geef het 24 uur de tijd om het pad opnieuw te bepalen en u bent klaar. Om het proces te versnellen, kunt u uw apparaten op batterijen handmatig activeren (druk één keer op de fysieke knop op de sensor). Hierdoor worden ze gedwongen om direct een ‘Data Request’ te verzenden, waardoor ze merken dat het netwerkpad is gewijzigd zonder te hoeven wachten op hun geplande check-in.

Het IEEE-adres kopiëren naar de nieuwe coördinator

Open Zigbee2MQTT en ga naar Instellingen > Over en kijk onder het gedeelte Coördinator en sla de waarde op, bijvoorbeeld 0xf074bffffe091703. U kunt ook naar de map zigbee2mqtt gaan en het bestand database.db openen. Het adres van de coördinator vindt u op de eerste regel, direct na “ieeeAddr“. Hier is een screenshot van de nieuwe Windfront-gebruikersinterface van Zigbee2MQTT:

De meeste netwerkcoördinatoren bieden tegenwoordig de mogelijkheid om het IEEE-adres rechtstreeks via het webdashboard te wijzigen. SMLight PoE-coördinatoren hebben bijvoorbeeld een instelling in het Z2M- en ZHA-menu, onder Geavanceerd: Adapter IEEE-instelling wijzigen. U hoeft alleen het nieuwe adres te plakken en op ‘IEEE-adres schrijven‘ te drukken. Zorg ervoor dat de coördinator niet in gebruik is tijdens deze procedure en dat Zigbee2MQTT/ZHA volledig is uitgeschakeld.

Als je een USB-only coordinator hebt, moet je een firmware-flashtool gebruiken. Afhankelijk van de chipfabrikant (Texas Instruments of Silicon Labs) heb je verschillende tools tot je beschikking om het IEEE-adres te wijzigen. Voor Silicon Labs-chips gebruik ik graag de Universal Silicon Labs Flasher. Voor Texas Instruments-chips raad ik de ZigStar Multi Tool aan. Hieronder lees je hoe je het IEEE-adres met elk van beide kunt wijzigen:

Universal Silicon Labs Flasher

1. Installeer de Universal Silicon Labs Flasher-tool
   Installeren via de terminal of PowerShell:$ pip install universal-silabs-flasher
2. Sluit uw nieuwe adapter aan op uw pc.
   Zoek de juiste seriële poort, bijvoorbeeld:
   • Linux: /dev/ttyACM0, /dev/ttyUSB0 enz.
   • macOS: /dev/tty.usbmodemXXXX of /dev/tty.usbserialXXXX
   • Windows: COM3, COM4 enz.
3. Voer de volgende opdracht uit en vervang de IEEE en de seriële poort:
   • • Vervang /dev/ttyACM0 door het pad naar uw nieuwe coördinator.
     • Vervang f074bffffe091703 door het IEEE-adres van uw coördinator.
       BELANGRIJK: Verwijder het hexadecimale voorvoegsel (0x) en de dubbele punten (:) uit uw IEEE-adres.

   universal-silabs-flasher --device /dev/ttyACM0 write-ieee --ieee f074bffffe091703
   Als het proces mislukt, probeer dan –force aan het einde van de opdracht toe te voegen. Controleer de logbestanden op een bevestiging van succes. Als het huidige IEEE-adres van het apparaat al overeenkomt met het nieuwe adres, zal de opdracht dit niet onnodig schrijven. Klaar!

Zigstar Multitool

1. Download en start ZigStar Multitool
   Installeer de applicatie voor uw besturingssysteem en open deze.
2. Sluit uw adapter aan en ga naar de Bootloader (BSL)-modus.
   Raadpleeg de handleiding van uw adapter, aangezien de methode per model verschilt.
3. Klik op het vernieuwingspictogram en selecteer uw adapter.
   De tool zou het seriële apparaat moeten detecteren zodra het in de BSL-modus staat.
4. Voer het oude IEEE-adres van de coördinator in.
   Vul het veld “IEEE” in met het IEEE-adres van uw oude coördinator.
   Het voorvoegsel 0x is optioneel en gebruik geen dubbele punten.
5. Schakel “Write IEEE” in en schrijf het adres.
   Vink het vakje “Write IEEE” aan en klik op “Write IEEE” om het adres te flashen.
6. Flash daarna de firmware opnieuw.
   Deze stap is vereist. De coördinator zal het nieuwe IEEE-adres pas gebruiken nadat de juiste firmware naar de adapter is teruggeschreven. Gebruik dezelfde tool om de firmware opnieuw te flashen of raadpleeg de flashtool van de fabrikant, bijvoorbeeld Sonoff.

Als de ZigStar Multitool uw adapter niet detecteert, controleer dan of deze correct in de BSL-modus staat en of er geen andere software (zoals Zigbee2MQTT of Home Assistant) dezelfde seriële poort gebruikt. Probeer de adapter los te koppelen en opnieuw aan te sluiten en klik vervolgens opnieuw op het vernieuwingspictogram. Als de IEEE-schrijfbewerking mislukt, start u de tool opnieuw en herhaalt u het proces, waarbij u ervoor zorgt dat het juiste COM- of USB-pad is geselecteerd.

ZHA migreren naar een nieuwe coördinator

ZHA bevat een ingebouwde migratiewizard waarmee u uw bestaande Zigbee-netwerk eenvoudig naar een nieuwe coördinator kunt overzetten. De wizard maakt automatisch een back-up van uw huidige netwerkgegevens, draagt ​​de Zigbee-netwerksleutel over, behoudt de apparaatkoppelingen en schrijft, indien nodig, het IEEE-adres van de oude coördinator naar de nieuwe adapter.

Tijdens dit proces worden ook essentiële netwerkmetadata hersteld, zodat uw apparaten zich opnieuw bij het netwerk kunnen aansluiten zonder opnieuw te hoeven koppelen. In ZHA werkt dit proces zowel voor migraties met dezelfde chip als, in de meeste gevallen, tussen verschillende chipfabrikanten, zolang de nieuwe adapter volledig door ZHA wordt ondersteund. Houd er rekening mee dat er bij het migreren van ZHA tussen verschillende chips geen absolute garanties zijn en dat u mogelijk sommige apparaten opnieuw moet koppelen.

Volg deze stappen om ZHA naar een nieuwe coördinator te migreren:

1. Controleer de vereisten en maak een back-up
   Maak een volledige back-up van Home Assistant voordat u migreert.
   Zorg ervoor dat de oude adapter momenteel alleen door ZHA wordt gebruikt.
2. Verbind de nieuwe coördinator met uw HA-server.
   Sluit de nieuwe Zigbee-adapter aan met een USB-verlengkabel om interferentie te verminderen. Als u een netwerkcoördinator gebruikt, stelt u een statisch IP-adres in op uw router.
3. Ga naar Instellingen > Apparaten en services, open ZHA en klik op Configureren (tandwielpictogram).
4. Selecteer onder Netwerkinstellingen de optie Adapter migreren.
   ZHA maakt automatisch een back-up van uw Zigbee-netwerk.
5. Selecteer Migreren naar een nieuwe adapter.
6. Selecteer de nieuwe Zigbee-adapter in de lijst met seriële poorten.
   Voor netwerkadapters selecteert u Handmatig invoeren en voert u het juiste TCP-adres en de juiste poort in.
7. Selecteer Automatisch migreren om uw back-up te herstellen.
   ZHA herstelt de back-up en schrijft het IEEE-adres van de oude coördinator naar de nieuwe adapter, indien ondersteund.
   In het zeldzame geval dat de nieuwe coördinator het IEEE-adres moet overschrijven, ziet u een melding om het IEEE-adres van de radio te overschrijven. Voer het nieuwe IEEE-adres in, vink het vakje ‘Het IEEE-adres van de radio permanent vervangen’ aan en klik op ‘Verzenden’.
8. Wacht tot de apparaten opnieuw verbinding maken.
   De apparaten zullen na verloop van tijd automatisch opnieuw verbinding maken met het netwerk. Dit kan tot een uur duren.
9. Verwijder de oude coördinator.
10. Klaar.

Zodra het netwerk weer online is, moet u het even de tijd geven om op te starten en te stabiliseren. De apparaten zullen na een tijdje automatisch opnieuw verbinding maken. U kunt dit proces forceren door uw Zigbee-routers die op netstroom zijn aangesloten, opnieuw op te starten.

Conclusie

Het migreren van een Zigbee-netwerk lijkt in eerste instantie misschien overweldigend, maar met de juiste voorbereiding en een goed begrip van de chipfamilie en mogelijkheden van je coordinator, is het proces veel eenvoudiger dan de meeste mensen denken. Of je nu Zigbee2MQTT of ZHA gebruikt, beide platforms bieden betrouwbare mechanismen om je bestaande netwerk naar een nieuwe adapter te verplaatsen zonder dat je elk apparaat in huis opnieuw hoeft te koppelen.

Voor Zigbee2MQTT hangt een succesvolle migratie volledig af van het gebruik van adapters die gebaseerd zijn op ondersteunde chipfamilies zoals Texas Instruments zstack of Silicon Labs ember. Wanneer aan deze voorwaarden is voldaan, is het kopiëren van het IEEE-adres en het herstellen van de netwerkback-up voldoende om naadloos verder te werken met hetzelfde Zigbee-meshnetwerk op nieuwe hardware. ZHA biedt nog meer flexibiliteit met een ingebouwde migratiewizard die automatisch back-ups maakt, herstelt, IEEE-adressen overdraagt ​​en het netwerk opnieuw opbouwt, zelfs bij het wisselen tussen verschillende chipfabrikanten, zolang beide adapters volledig worden ondersteund.

Dat gezegd hebbende, geen enkele migratiemethode is gegarandeerd perfect. Zigbee-netwerken variëren sterk in grootte, apparaattypen, routeringspatronen en firmwarekwaliteit. Zelfs met de juiste procedures kan het nodig zijn om een ​​aantal apparaten opnieuw te koppelen, met name batterijgevoede sensoren, oudere apparaten of apparaten die vóór de migratie al instabiel waren. Het is ook mogelijk dat bepaalde apparaten tijdelijk verdwijnen, niet probleemloos opnieuw verbinding maken of handmatig gereset moeten worden.

---

Ondersteun mijn website’s, kanaal en inhoud en mijn voortdurende inspanningen via Patreon:
https://patreon.com/Colani

Suc6
Terry van Erp