Bytte fra ZHA til Zigbee2MQTT
ZHA er Home Assistants egen Zigbee. ZigDash fungerer med Zigbee2MQTT, så den kan ikke vise enheter som ligger i ZHA. Å bytte betyr å pare enhetene på nytt med Zigbee2MQTT. Home Assistant fortsetter å bruke dem etterpå, via MQTT-integrasjonen.
Før du begynner
- Hvilken installasjon? Hvis Innstillinger-menyen i Home Assistant viser Apps (Add-ons i eldre versjoner), har du Home Assistant OS: se med apper. Hvis ikke, kjører Home Assistant i Docker (Container): se Docker.
- Hvilken adapter? Åpne Innstillinger › Enheter og tjenester › Zigbee Home Automation. Under Hubs står adapteren oppført med modellnavnet, for eksempel SONOFF ZBDongle-E. Sjekk deretter adapteren din.
- Ta sikkerhetskopi av ZHA. På den samme siden trykker du på ⚙ ved siden av Zigbee Home Automation og deretter Download backup. Ta vare på filen. På samme side viser Network information kanalen, radiotypen og den serielle porten.
- Hva som endres i Home Assistant. Enhetene kommer tilbake som nye MQTT-enheter med nye entitets-ID-er. Automasjoner, skript og dashbord som bruker dem, må pekes mot de nye, og historikken deres starter på nytt. Grupper og bindinger som ble laget i ZHA, lages på nytt i Zigbee2MQTT.
- Tid. Hver enhet tilbakestilles og pares på nytt, én etter én. Vi har ikke pålitelige tider ennå; sett av en kveld for et lite hjem og mer for et stort.
To måter å bytte på
| Ekstra adapter | Samme adapter | |
|---|---|---|
| Kostnad | En ny adapter, ca. 30–60 euro (for eksempel en Home Assistant Connect ZBT-2, eller en SMLIGHT SLZB-06M eller SLZB-07) | Gratis |
| Mens du bytter | Alt fortsetter å virke: ZHA beholder den gamle adapteren | Zigbee er av til hver enhet er paret på nytt |
| Tempo | Rom for rom, gjerne over flere dager | Alt på én gang |
| Gå tilbake | Enkelt: trekk ut den nye adapteren, ZHA stoppet aldri | Gjenopprett ZHA-sikkerhetskopien (se Gå tilbake) |
Ekstra adapter
- Sett opp Zigbee2MQTT på den nye adapteren (med apper eller Docker) med sitt eget nettverk. Velg alt dette før Zigbee2MQTT starter for første gang, for å bytte kanal senere kan bety at du må pare på nytt:
- la nettverksnøkkelen og PAN ID stå på
GENERATE(standard); - velg en annen kanal enn ZHA sin (ZHA sitt ⚙ › Network information viser den); Home Assistant anbefaler 15, 20 eller 25.
- la nettverksnøkkelen og PAN ID stå på
- Hold de to adapterne et stykke fra hverandre, hver på sin USB-skjøteledning.
- På Home Assistant OS kan Home Assistant tilby å sette opp den nye adapteren for ZHA eller Thread når du kobler den til. Ignorer det: adapteren er for Zigbee2MQTT.
- Flytt ett rom om gangen: par først enhetene med strøm fra stikkontakten (pærer, støpsler, innbygde brytere: de er rutere), deretter batterienhetene.
- Når alle enhetene er flyttet, deaktiverer du ZHA (se under) og beholder den gamle adapteren som reserve.
Samme adapter
- Last ned ZHA-sikkerhetskopien (se Før du begynner) rett før du starter.
- Deaktiver ZHA: Innstillinger › Enheter og tjenester › Zigbee Home Automation, ⋮ ved siden av Zigbee Home Automation › Disable. Ikke Delete.
- Sett opp Zigbee2MQTT på samme adapter (med apper eller Docker), og la nettverksnøkkelen og PAN ID stå på
GENERATE. - Slå av Zigbee-enhetene med strøm fra nettet, på veggen eller i sikringsskapet. Ellers fortsetter de å lete etter det gamle nettverket.
- Slå dem på igjen én etter én, og par hver enhet når den kommer på. Par deretter batterienhetene.
Adapteren din
- Silicon Labs (Home Assistant Connect ZBT-1 og ZBT-2, Home Assistant Yellow, Sonoff ZBDongle-E, SMLIGHT SLZB-06M og SLZB-07):
adapter: ember. ZBT-2 trenger ogsåbaudrate: 460800; ZBDongle-E trengerrtscts: false; SLZB-06M trenger fastvare 20240510 eller nyere. - Texas Instruments (Sonoff ZBDongle-P, SMLIGHT SLZB-06 og SLZB-06P7):
adapter: zstack. - ConBee eller RaspBee:
adapter: deconz. - CC2531 eller ZiGate: for gamle eller ikke lenger vedlikeholdt for et godt Zigbee2MQTT-nettverk. Bruk måten med ekstra adapter, med en ny adapter.
- En nettverksadapter (SMLIGHT SLZB-06, SLZB-06M, SLZB-07, MR series): ZHA viser den som
socket://IP:6638; i Zigbee2MQTT er dentcp://IP:6638, og Docker trenger ingen USB-linje. - Multiprotokoll (ZBT-1 eller Yellow som kjører Zigbee og Thread samtidig; maskinvaresiden i Home Assistant sier det): Zigbee2MQTT kan ikke bruke multiprotokoll-fastvare. For måten med samme adapter slår du av multiprotokoll mens du fortsatt er på ZHA, med Home Assistants egen fremgangsmåte (ZBT-1, Yellow). Thread-enheter som brukte den, slutter å virke til en annen Thread-grenseruter tar over. For måten med ekstra adapter lar du den være, og kjøper den nye adapteren som ren Zigbee-adapter.
Zigbee2MQTT sine adaptersider har detaljene.
Home Assistant med apper (Home Assistant OS)
- I Innstillinger › Apps installerer og starter du Mosquitto broker. Home Assistant tilbyr deretter MQTT-integrasjonen under Innstillinger › Enheter og tjenester: godta den.
- Legg til Zigbee2MQTT-repositoriet (i appbutikken, ⋮ › Repositories:
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt), og installer deretter Zigbee2MQTT. - I fanen Configuration setter du serieporten og adapteren ut fra adapteren din, for eksempel:
For måten med ekstra adapter setter du også kanalen (se over) før første start.port: /dev/serial/by-id/usb-... adapter: ember - Start Zigbee2MQTT og åpne nettsiden fra appens side. Deretter parer du.
Home Assistant i Docker (uten apper)
Uten apper kjører Mosquitto og Zigbee2MQTT som egne containere ved siden av Home Assistant. I en ny mappe:
1. compose.yaml (sett stien til adapteren i devices; ls /dev/serial/by-id/ viser den):
services:
mosquitto:
image: eclipse-mosquitto:2
restart: unless-stopped
ports:
- 1883:1883
volumes:
- ./mosquitto/config:/mosquitto/config
- ./mosquitto/data:/mosquitto/data
zigbee2mqtt:
image: ghcr.io/koenkk/zigbee2mqtt
restart: unless-stopped
depends_on:
- mosquitto
ports:
- 8080:8080
volumes:
- ./zigbee2mqtt:/app/data
- /run/udev:/run/udev:ro
environment:
- TZ=Europe/Berlin
devices:
- /dev/serial/by-id/usb-...:/dev/ttyACM0
Med en nettverksadapter utelater du devices og udev-linjen.
2. mosquitto/config/mosquitto.conf:
listener 1883
allow_anonymous false
password_file /mosquitto/config/passwd
persistence true
persistence_location /mosquitto/data/
Opprett MQTT-brukeren (du blir bedt om passordet to ganger; filen må eies av Mosquittos egen bruker, ellers starter ikke Mosquitto):
docker run -it --rm -v "$PWD/mosquitto/config:/mosquitto/config" eclipse-mosquitto:2 \
sh -c "mosquitto_passwd -c /mosquitto/config/passwd zigbee && chown mosquitto:mosquitto /mosquitto/config/passwd"
3. zigbee2mqtt/configuration.yaml (adapterlinjene fra adapteren din):
homeassistant:
enabled: true
frontend:
enabled: true
port: 8080
mqtt:
server: mqtt://mosquitto:1883
user: zigbee
password: your-password
serial:
port: /dev/ttyACM0 # a network adapter: tcp://IP:6638
adapter: ember
advanced:
network_key: GENERATE
pan_id: GENERATE
ext_pan_id: GENERATE
channel: 20 # second adapter: not ZHA's channel
4. Med samme adapter er ZHA nå deaktivert (se over). Hvis Home Assistants egen container har adapteren koblet inn, fjerner du den linjen fra compose-filen eller docker run: bare én container kan bruke adapteren.
5. docker compose up -d, og åpne deretter http://the-machine:8080: nettsiden til Zigbee2MQTT.
6. I Home Assistant: Innstillinger › Enheter og tjenester › Add integration › MQTT. Broker: maskinens IP-adresse, port 1883, bruker zigbee og passordet.
Pare enhetene
- På nettsiden til Zigbee2MQTT trykker du på Permit join (åpent i omtrent fire minutter). For å pare via en ruter nær enheten velger du den ruteren i permit join-menyen: nyttig for Aqara og andre kresne enheter.
- Sett enheten i paremodus slik produsenten beskriver: et langt trykk for de fleste sensorer, noen av/på-runder for pærer, en serie bryterklikk for enkelte innbygde brytere.
- Når den dukker opp, gir du den navn og rom i Zigbee2MQTT. Så den neste.
Enheter med strøm fra nettet først, batterienheter etterpå, slik at det nye nettverket har veier å sende signalene gjennom.
Etter byttet
- ZigDash: åpne appen og trykk på Finn oppsettet mitt. Den finner Mosquitto på nettverket ditt; logg inn med MQTT-brukeren. Eller velg Home Assistant og logg inn: det fungerer nå også, siden Home Assistant har MQTT-integrasjonen.
- Navn og rom: Innstillinger › Importer fra Home Assistant i ZigDash henter navnene og rommene du ga de nye enhetene i Home Assistant.
- Home Assistant: pek automasjoner, skript og dashbord mot de nye enhetene. Når du er sikker, sletter du ZHA-integrasjonen.
Gå tilbake
- Ekstra adapter: stopp Zigbee2MQTT og trekk ut den nye adapteren. ZHA stoppet aldri. Enheter du allerede har flyttet, må pares med ZHA på nytt.
- Samme adapter: stopp Zigbee2MQTT, og trykk deretter på Enable på ZHA-siden. ZHA sier "Network settings do not match most recent backup" (nettverksinnstillingene samsvarer ikke med siste sikkerhetskopi), fordi adapteren nå har Zigbee2MQTT sitt nettverk. Åpne Innstillinger › Repairs › "Zigbee network settings have changed" (Zigbee-nettverksinnstillingene er endret) og velg Restore backup (recommended). ZHA-nettverket kommer tilbake slik det var. Enheter du hadde paret med Zigbee2MQTT, må pares med ZHA på nytt. Hvis ingen reparasjon dukker opp, bruker du ⚙ › Migrate adapter med sikkerhetskopien du lastet ned.
Beholde nettverket uten å pare på nytt
Det finnes en tredje måte: å kopiere ZHA-nettverket inn i Zigbee2MQTT, slik at enhetene ikke må pares på nytt. Zigbee2MQTT støtter det ikke, en feil verdi kan slette nettverket, og det gir bare mening for store hjem (for eksempel over 60 enheter). Vil du lese om det: svaret fra vedlikeholderen av Zigbee2MQTT, og erfaringer fra brukere i diskusjon 24478 og diskusjon 26716.