Zigbee2Mqtt Assistant

Når du starter ud med Zigbee2mqtt, kan man som ny i MQTT-verdenen, godt føle det er et lidt stort bjerg at skulle bestige, da Zigbee2mqtt ikke kommer med et UI, men lægger op at man manuelt sender kommandoer igennem sin MQTT-broker, eller koder nogle knapper ind i sit Home Assistant UI – heldigvis er der nu en nemmere måde at komme i gang på – Zigbee2mqtt Assistant.

Zigbee2mqtt Assistant er kort fortalt et UI henover din Zigbee2mqtt, der gør det nemt at holde styr på din Zigbee enheder, omdøbe dem, parre dem og opdatere dem.

Assistenten laver også en “Map” så man visuelt kan følge routerne og signalet imellem alle ens Zigbee-enheder. Det er ret sjovt, at følge med i, hvor de alle snakker sammen i et stort MESH-netværk.

Nå, nok snak – lad os få installeret Zigbee2mqtt Assistant i vores Home Assistant 😎

Vi har gennemgået dette emne (Add-ons) mange gange tidligere her på Robotnet.dk, så jeg gennemgår det kun lige kort igen her i denne guide. Hvis du er kommet hertil, burde du have den nødvendige viden til at installere et add-on 😎 – Vi skal igennem følgende 3 steps i denne guide:

  1. Tilføj følgende Community add-on repos til vores Home Assistant:
    https://github.com/yllibed/hassio
  2. Installer Zigbee2Mq2ttAssistant fra Add-on Store
  3. Konfigurer vores MQTT server med brugernavn og kodeord

Step 1: Tilføj repos.

Start med at tilføj følgende add-on repos. til din Home Assistant installation.
https://github.com/yllibed/hassio

Step 2: Installer Assistenten

Installer den nye pakke zigbee2mqttassistant der dukker op i din Addon store:

Step 3: Konfigurer

Hop ind under “Configuration” for dit nye add-on og tilføj dit mqtt brugernavn og pasword- som vi lavede tidligere.

Sæt flueben i “Start on boot” og “Show in sidebar” og tryk på “Start” for at starte din nye Zigbee Assistant.

Boom! Du har nu fået et nyt menupunkt i din sidebar med adgang til din nye Zigbee2mqtt Assistant. Her kan du se din “Coordinator” som er din Zigbee Gateway, og alle de enheder som er tilknyttet dit Zigbee netværk ✅😎

Dan par med nye Zigbee-enheder

Lad os tilføje vores første Zigbee enhed, til vores nye Zigbee netværk. Det gør vi ved at starte “Parringstilstand” direkte fra din nye assistent.

Hop under “Status” i top-menuen og klik på knappen “Allow new devices to join network”- dette åbner op for at nye enheder automatisk kan parres med vores controller.

🚧 Bemærk: Der er opsat en timeout på 20 minutter, så funktionen slår selv fra igen efter 20 minutter.

For at parre en enhed med din nye gateway, skal du typisk nulstille den enhed du vil parre. Jeg har lavet en guide til hvordan du gør med tre populære enheder her:

IKEA produkter

IKEAs produkter herunder pærer er nemme at parre med en ny gateway, følg disse trin:

  1. Start “Allow Join” som vist herover
  2. Slet evt. din pære fra tidl. parring, f.eks Hue eller IKEA bridge
  3. Tænd din pære og lade være tændt 5 sekunder
  4. Sluk, og tænd med det samme igen.
  5. Sluk staks efter den tænder, og tænd med det samme igen.
  6. Sluk staks efter den tænder, og tænd med det samme igen.
  7. Sluk staks efter den tænder, og tænd med det samme igen.
  8. Sluk staks efter den tænder, og tænd med det samme igen.
  9. Sluk staks efter den tænder, og tænd med det samme igen.
  10. Lad den være tændt nu, indtil lyset efter et par sekunder giver et “Blink” der bekræfter den er parret. Vil den ikke parre, skal du rykke pæren tættere på din Zigbee bridge.
  11. Tryk på “Devices” igen, og din pære skulle gerne dukke op. Alle enheder bliver automatisk navngivet efter deres ID, dvs. noget lignende 0x000ffffe2d3456.
  12. Tryk ind på din pære og omdøb den.
  13. Bemærk der kan gå nogle minutter inden billede, producent mm. er opdateret.

Der findes efterhånden en hel del IKEA Zigbee produkter, her finder du en guide til dem alle.

HUEs produkter

Hue’s pære søger automatisk efter en ny gateway at snakke med, når du sletter dem fra din Hue-bridge, så start “Allow Join” og slet din pære fra din Hue bridge en ad gangen, så burde de automatisk poppe op på din nye Coordinator/Gateway.

  1. Start “Allow Join” som vist herover
  2. Slet din pære fra tidl. parring, f.eks Hue bridge. Din pære vil nu automatisk søge efter en ny Coordinator / Gateway
  3. Tryk på “Devices” igen for at opdatere listen, og din pære skulle gerne dukke op. Hvis den ikke dukker op, sluk din pære i 3-5 sekunder og tænd igen, så starter den søgningen på ny.
    Alle enheder bliver automatisk navngivet efter deres ID, dvs. noget lignende 0x000ffffe2d3456.
  4. Tryk ind på din pære og omdøb den.
  5. Bemærk der kan gå nogle minutter inden billede, producent mm. er opdateret.

Udover pære fra Hue, findes der mange andre produkter fra Hue Universet, du kan finde en guide til hvordan du parre dem alle her på Zigbee2mqtt’s hjemmeside under emnet #Philips.

Xiaomis Zigbee produkter

Xiaomi har en hel række Zigbee produkter som er blevet populære, fordi de kan købes billigt i Kina fra eBay eller AliExpress. Jeg bruger selv en række af deres vindue/dør sensors, knapper samt temperaturmålere. Alle deres enheder har en reset-knap som du blot holder inde i nogle sekunder, hvorefter enheden nulstilles og søger efter ny Coordinator. Husk at aktiver “Allow Join” inden du nulstiller, og så burde parring gerne ske på få sekunder.

Andre produkter

En af Zigbee2mqtt’s styrker, er deres store kompatibilitetsliste. Der findes næsten ikke nogle Zigbee enheder, som ikke er understøttet af Zigbee2mqtt. Dette skyldes at Zigbee2mqtt er open-source, så alle kan bidrage med viden – og derfor er udviklere fra hele verden med til at bygge databasen op af understøttede enheder. Du kan læse mere om alle de forskellige enheder som er understøttet og hvordan du nulstiller dem her: zigbee2mqtt.io/information/supported_devices.html 👩🏻‍💻

Map

En lille sidste ting, jeg gerne lige vil have med i denne artikel er Assistentens Map-funktion. Her i mit demo-setup ses en lille bold af 20 test-enheder der alle snakker sammen på kryds og tværs i et stort MESH-netværk. Det er fantastisk sjovt at se alle ens enheder på en visuel måde, og hvilke enheder de kobler sig op, og hvordan de router sig igennem lamper og andre strømfødte enheder, for at komme til vores moder i Zigbee-netværke; vores coordinator.

Zigbee2mqtt Assistant Map – En visualisering af hele vores Zigbee netværk.