Colani's PI, Arduino & Home Domotica

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

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

Suc6
Terry van Erp

Gerelateerde berichten:

Sonoff Dongle Lite LMG21 (ZigBee) Alle Sonoff-dongles vergeleken: welke moet je kopen? HP T640 thin client