Byta från ZHA till Zigbee2MQTT
ZHA är Home Assistants egen Zigbee. ZigDash fungerar med Zigbee2MQTT, så den kan inte visa enheter som ligger i ZHA. Att byta innebär att du parkopplar dina enheter igen med Zigbee2MQTT. Home Assistant fortsätter att använda dem efteråt, via sin MQTT-integration.
Innan du börjar
- Vilken installation? Om menyn Inställningar i Home Assistant visar Apps (Add-ons i äldre versioner) har du Home Assistant OS: se med appar. Om inte, körs Home Assistant i Docker (Container): se Docker.
- Vilken adapter? Öppna Inställningar › Enheter och tjänster › Zigbee Home Automation. Under Hubs står adaptern med sin modell, till exempel SONOFF ZBDongle-E. Kolla sedan din adapter.
- Säkerhetskopiera ZHA. På samma sida trycker du på ⚙ bredvid Zigbee Home Automation och sedan på Download backup. Spara filen. På samma sida visar Network information kanalen, radiotypen och serieporten.
- Vad som ändras i Home Assistant. Dina enheter kommer tillbaka som nya MQTT-enheter med nya entitets-ID:n. Automationer, skript och dashboards som använder dem måste pekas om till de nya, och deras historik börjar om. Grupper och bindningar som gjorts i ZHA görs om i Zigbee2MQTT.
- Tid. Varje enhet återställs och parkopplas igen, en i taget. Vi har inga ärliga tidsuppskattningar än; räkna med en kväll för ett litet hem och mer för ett stort.
Två sätt att byta
| Extra adapter | Samma adapter | |
|---|---|---|
| Kostnad | En ny adapter, cirka 30–60 euro (till exempel en Home Assistant Connect ZBT-2, eller en SMLIGHT SLZB-06M eller SLZB-07) | Gratis |
| Medan du byter | Allt fortsätter att fungera: ZHA behåller den gamla adaptern | Zigbee är avstängt tills varje enhet är parkopplad igen |
| Takt | Rum för rum, gärna under flera dagar | Allt på en gång |
| Gå tillbaka | Enkelt: dra ur den nya adaptern, ZHA stoppade aldrig | Återställ ZHA-säkerhetskopian (se Gå tillbaka) |
Extra adapter
- Sätt upp Zigbee2MQTT på den nya adaptern (med appar eller Docker) med ett eget nätverk. Välj allt detta innan Zigbee2MQTT startar första gången, eftersom ett kanalbyte senare kan innebära att du måste parkoppla igen:
- låt nätverksnyckeln och PAN ID stå på
GENERATE(standard); - välj en annan kanal än ZHA:s (ZHA:s ⚙ › Network information visar den); Home Assistant rekommenderar 15, 20 eller 25.
- låt nätverksnyckeln och PAN ID stå på
- Håll de två adaptrarna isär, var och en på sin USB-förlängningskabel.
- På Home Assistant OS kan Home Assistant erbjuda sig att sätta upp den nya adaptern för ZHA eller Thread när du kopplar in den. Strunta i det: adaptern är till för Zigbee2MQTT.
- Flytta ett rum i taget: parkoppla först rummets nätdrivna enheter (lampor, uttag, infällda strömbrytare: de är routrar), sedan de batteridrivna.
- När alla enheter är flyttade inaktiverar du ZHA (se nedan) och sparar den gamla adaptern som reserv.
Samma adapter
- Ladda ner ZHA-säkerhetskopian (se Innan du börjar) precis innan du börjar.
- Inaktivera ZHA: Inställningar › Enheter och tjänster › Zigbee Home Automation, ⋮ bredvid Zigbee Home Automation › Disable. Inte Delete.
- Sätt upp Zigbee2MQTT på samma adapter (med appar eller Docker) och låt nätverksnyckeln och PAN ID stå på
GENERATE. - Stäng av dina nätdrivna Zigbee-enheter med väggbrytaren eller i proppskåpet. Annars fortsätter de att leta efter det gamla nätverket.
- Slå på dem igen en i taget och parkoppla var och en när den startar. Parkoppla sedan de batteridrivna enheterna.
Din adapter
- Silicon Labs (Home Assistant Connect ZBT-1 och ZBT-2, Home Assistant Yellow, Sonoff ZBDongle-E, SMLIGHT SLZB-06M och SLZB-07):
adapter: ember. ZBT-2 behöver ocksåbaudrate: 460800; ZBDongle-E behöverrtscts: false; SLZB-06M behöver firmware 20240510 eller senare. - Texas Instruments (Sonoff ZBDongle-P, SMLIGHT SLZB-06 och SLZB-06P7):
adapter: zstack. - ConBee eller RaspBee:
adapter: deconz. - CC2531 eller ZiGate: för gamla eller inte längre underhållna för ett bra Zigbee2MQTT-nätverk. Använd sättet med extra adapter, med en ny adapter.
- En nätverksadapter (SMLIGHT SLZB-06, SLZB-06M, SLZB-07, MR series): ZHA visar den som
socket://IP:6638; i Zigbee2MQTT är dentcp://IP:6638, och Docker behöver ingen USB-rad. - Multiprotokoll (ZBT-1 eller Yellow som kör Zigbee och Thread samtidigt; hårdvarusidan i Home Assistant visar det): Zigbee2MQTT kan inte använda multiprotokoll-firmware. För sättet med samma adapter stänger du av multiprotokoll medan du fortfarande är på ZHA, med Home Assistants egen procedur (ZBT-1, Yellow). Thread-enheter som använde den slutar fungera tills en annan Thread-gränsrouter tar över dem. För sättet med extra adapter låter du den vara och köper den nya adaptern som ren Zigbee-adapter.
Zigbee2MQTT:s adaptersidor har detaljerna.
Home Assistant med appar (Home Assistant OS)
- Under Inställningar › Apps installerar och startar du Mosquitto broker. Home Assistant erbjuder sedan MQTT-integrationen under Inställningar › Enheter och tjänster: godkänn den.
- Lägg till Zigbee2MQTT-förrådet (i appbutiken, ⋮ › Repositories:
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt) och installera sedan Zigbee2MQTT. - På fliken Configuration anger du serieporten och adaptern utifrån din adapter, till exempel:
För sättet med extra adapter anger du också kanalen (se ovan) före första starten.port: /dev/serial/by-id/usb-... adapter: ember - Starta Zigbee2MQTT och öppna dess webbsida från appens sida. Sedan parkopplar du.
Home Assistant i Docker (utan appar)
Utan appar körs Mosquitto och Zigbee2MQTT som egna containrar bredvid Home Assistant. I en ny mapp:
1. compose.yaml (ange sökvägen till din adapter i devices; ls /dev/serial/by-id/ visar 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 nätverksadapter utelämnar du devices och udev-raden.
2. mosquitto/config/mosquitto.conf:
listener 1883
allow_anonymous false
password_file /mosquitto/config/passwd
persistence true
persistence_location /mosquitto/data/
Skapa MQTT-användaren (du får ange ett lösenord två gånger; filen måste ägas av Mosquittos egen användare, annars startar inte 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 (adapterraderna från din adapter):
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 samma adapter är ZHA nu inaktiverat (se ovan). Om Home Assistants egen container mappar adaptern tar du bort den raden från dess compose-fil eller docker run: bara en container i taget kan använda adaptern.
5. docker compose up -d, öppna sedan http://the-machine:8080: Zigbee2MQTT:s webbsida.
6. I Home Assistant: Inställningar › Enheter och tjänster › Add integration › MQTT. Broker: datorns IP-adress, port 1883, användare zigbee och lösenordet.
Parkoppla enheterna
- På Zigbee2MQTT:s webbsida trycker du på Permit join (öppet i ungefär fyra minuter). Vill du parkoppla via en router nära enheten väljer du den routern i permit join-menyn: praktiskt för Aqara och andra kräsna enheter.
- Sätt enheten i parkopplingsläge på det sätt tillverkaren anger: ett långt tryck för de flesta sensorer, några av/på-cykler för lampor, en serie brytarslag för vissa infällda strömbrytare.
- När den dyker upp ger du den namn och rum i Zigbee2MQTT. Sedan nästa.
Nätdrivna enheter först, batteridrivna efter, så att det nya nätverket har vägar att gå.
Efter bytet
- ZigDash: öppna appen och tryck på Hitta min installation. Den hittar Mosquitto i ditt nätverk; logga in med MQTT-användaren. Eller välj Home Assistant och logga in: det fungerar nu också, eftersom Home Assistant har MQTT-integrationen.
- Namn och rum: Inställningar › Importera från Home Assistant i ZigDash hämtar namnen och rummen du gav de nya enheterna i Home Assistant.
- Home Assistant: peka om automationer, skript och dashboards till de nya enheterna. När du är säker tar du bort ZHA-integrationen.
Gå tillbaka
- Extra adapter: stoppa Zigbee2MQTT och dra ur den nya adaptern. ZHA stoppade aldrig. Enheter som du redan har flyttat måste parkopplas med ZHA igen.
- Samma adapter: stoppa Zigbee2MQTT och tryck sedan på Enable på ZHA:s sida. ZHA säger "Network settings do not match most recent backup" (nätverksinställningarna stämmer inte med den senaste säkerhetskopian), eftersom adaptern nu har Zigbee2MQTT:s nätverk. Öppna Inställningar › Repairs › "Zigbee network settings have changed" (Zigbee-nätverksinställningarna har ändrats) och välj Restore backup (recommended). ZHA:s nätverk kommer tillbaka som det var. Enheter som du hade parkopplat med Zigbee2MQTT måste parkopplas med ZHA igen. Om ingen reparation dyker upp använder du ⚙ › Migrate adapter med säkerhetskopian du laddade ner.
Behålla nätverket utan att parkoppla igen
Det finns ett tredje sätt: att kopiera ZHA:s nätverk till Zigbee2MQTT så att enheterna inte behöver parkopplas igen. Zigbee2MQTT stöder det inte, ett felaktigt värde kan radera nätverket, och det är bara rimligt för stora hem (säg, över 60 enheter). Om du vill läsa om det: svaret från Zigbee2MQTT:s utvecklare, och erfarenheter från användare i diskussion 24478 och diskussion 26716.