Mikä on Zigbee2MQTT (Z2M)? Näin se toimii Home Assistantissa

Zigbee2MQTT eli Z2M on ohjelmisto, jonka avulla eri valmistajien Zigbee-laitteita voidaan yhdistää samaan Zigbee-verkkoon ja käyttää esimerkiksi Home Assistantissa.

Kun kirjoitimme tämän oppaan ensimmäisen version, Zigbee2MQTT oli meille itsellemmekin vielä melko uusi tuttavuus. Nyt kun sitä on tullut käytettyä oikeassa älykodissa huomattavasti enemmän, suhtautuminen on aika selvä: me itse pidämme Zigbee2MQTT:stä todella paljon.

Ei siksi, että se olisi aina helpoin tapa aloittaa, vaan siksi, että kun älykoti alkaa kasvaa, Zigbee2MQTT antaa todella paljon vapautta nähdä mitä laitteet tekevät, säätää niiden asetuksia ja yhdistää saman Zigbee-verkon alle eri valmistajien tuotteita.

Meidänkin verkossamme koko ajatus on käytännössä se, ettei tarvitse miettiä kuuluuko laite Tuya-, Sonoff-, Philips Hue- tai johonkin muuhun ekosysteemiin. Paljon kiinnostavampi kysymys on:

“Löytyykö tälle laitteelle Zigbee2MQTT-tuki?”

Jos Zigbee itsessään ei ole vielä tuttu, kannattaa aloittaa ensin artikkelistamme Mikä on Zigbee ja miten Zigbee mesh -verkko toimii?

Mitä Zigbee2MQTT oikeastaan tekee?

Nimi kertoo yllättävän hyvin, mistä on kyse:

Zigbee → MQTT.

Zigbee2MQTT keskustelee Zigbee-laitteiden kanssa Zigbee-koordinaattorin kautta ja välittää niiden tiedot MQTT:n avulla eteenpäin esimerkiksi Home Assistantiin.

Jos esimerkiksi makuuhuoneessa oleva Zigbee-lämpötila-anturi ilmoittaa lämpötilaksi 21,4 °C, Zigbee2MQTT vastaanottaa tiedon Zigbee-verkosta ja välittää sen MQTT:n kautta Home Assistantille.

Home Assistantissa lämpötila näkyy normaalina sensorina, jota voidaan käyttää mittauksissa, käyttöliittymässä ja automaatioissa.

Sama idea toimii esimerkiksi:

• ovi- ja ikkuna-antureissa
• liike- ja läsnäolotunnistimissa
• älypistorasioissa
• releissä
• termostaateissa
• painikkeissa
• valaistuksessa
• vesivuotoantureissa
• palo- ja häkävaroittimissa
• ja monissa muissa Zigbee-laitteissa.

Miksi Zigbee2MQTT on meille niin mieluinen?

Ensimmäinen syy on laitetuki.

Zigbee2MQTT:n tuettujen laitteiden tietokanta on valtava, ja sieltä voi hakea laitteen valmistajalla tai tarkalla mallinumerolla. Tämä on meidän mielestämme yksi koko järjestelmän parhaista ominaisuuksista.

Kun harkitsemme uutta Zigbee-laitetta omaan käyttöön tai verkkokauppaan, yksi ensimmäisistä paikoista, joista katsomme, on Zigbee2MQTT:n laitetietokanta.

Zigbee2MQTT:n tuettujen laitteiden hakemisto löytyy täältä.

Sieltä ei näe pelkästään sitä, onko laite tuettu. Laitekohtaisella sivulla näkyvät yleensä myös laitteen tarjoamat ominaisuudet eli mitä tietoja siitä saadaan ulos ja mitä asetuksia voidaan ohjata.

Tämä on tärkeää, koska kaksi Zigbee-laitetta voi näyttää päällepäin hyvin samanlaisilta, mutta niiden Home Assistantille tarjoamissa ominaisuuksissa voi olla isoja eroja.

Eri valmistajien laitteet samaan Zigbee-verkkoon

Tämä on toinen iso syy siihen, miksi me päädyimme Zigbee2MQTT:hen.

Valmistajien omissa Zigbee-järjestelmissä törmää helposti ekosysteemien rajoihin. Tuya-laitteelle halutaan Tuya/Smart Life -gateway, Sonoff/eWeLink-laitteelle oma järjestelmänsä ja Philips Huella on Hue Bridge.

Zigbee2MQTT:n kanssa valmistajan oma gateway jää pois välistä.

Kun laite on Zigbee2MQTT:n tukema, samassa Zigbee-verkossa voi olla esimerkiksi Sonoffia, Tuyaa, Philips Huea, IKEAa, Aqaraa, Nousia, HeIMANia ja monia muita valmistajia.

Juuri tässä vaiheessa älykoti alkaa meidän mielestämme muuttua kiinnostavaksi.

Ovianturin valmistajalla ei ole enää kovin suurta merkitystä. Sen ilmoittamaa oven tilaa voidaan käyttää Home Assistantissa vaikka toisen valmistajan lämmityksen, valaistuksen tai hälytyksen ohjaamiseen.

Mitä Zigbee2MQTT:n käyttö vaatii?

Nimi saattaa kuulostaa aluksi paljon monimutkaisemmalta kuin itse kokonaisuus.

Ensimmäiseksi tarvitaan joku laite, jolla Home Assistant pyörii. Se voi olla esimerkiksi valmis Home Assistant Green, mini-PC, Raspberry Pi tai vaikka vanha läppäri.

Home Assistantia voi toki ajaa monella muullakin tavalla, mutta näillä pääsee hyvin hahmottamaan kokonaisuuden.

Sen lisäksi tarvitaan Zigbee-koordinaattori eli laite, joka muodostaa varsinaisen Zigbee-verkon ja keskustelee antureiden, pistorasioiden, releiden ja muiden Zigbee-laitteiden kanssa.

Käytännössä koordinaattori on usein Home Assistantiin liitettävä USB-dongle, mutta se voi olla myös Ethernet- tai PoE-verkkoliitännällä toimiva koordinaattori.

Eli yksinkertaistettuna esimerkiksi näin:

Home Assistant Green / mini-PC / Raspberry Pi / läppäri + Zigbee-koordinaattori + Zigbee2MQTT + Zigbee-laitteet.

Zigbee2MQTT:n käyttöön tarvitaan käytännössä:

• Home Assistant tai muu järjestelmä, jossa haluat käyttää laitteita
• Zigbee-koordinaattori, esimerkiksi USB-dongle tai Ethernet-/PoE-koordinaattori
• Zigbee2MQTT
• MQTT-brokeri, kuten Mosquitto
• ja tietenkin vähintään yksi Zigbee-laite.

Jos siis ostat esimerkiksi Home Assistant Greenin, se toimii Home Assistant -palvelimena, mutta Zigbee2MQTT-käyttöä varten tarvitset sen lisäksi Zigbee-koordinaattorin. Mini-PC:n, Raspberry Pi:n tai vanhan läppärin kanssa perusajatus on sama.

Meiltä löydät Zigbee2MQTT-yhteensopivia laitteita täältä ja laajemmin Home Assistant -tuotteet täältä.

Ja mikä ihme se MQTT sitten on?

MQTT saattaa olla juuri se kirjainyhdistelmä, jonka kohdalla aloittelija ensimmäisen kerran miettii, että nyt tästä tuli vaikeaa.

Ei siitä kuitenkaan tarvitse aluksi ymmärtää kovin syvällisesti.

MQTT on yksinkertaistettuna viestinvälitystapa, jolla eri järjestelmät voivat lähettää toisilleen tietoa. Zigbee2MQTT käyttää sitä Zigbee-laitteiden tietojen välittämiseen.

Home Assistant -ympäristössä MQTT-brokerina käytetään usein Mosquittoa. Kun MQTT on kerran laitettu kuntoon, sitä ei tavallisessa käytössä tarvitse jatkuvasti miettiä.

Esimerkiksi Zigbee-lämpötila-anturi voi lähettää Zigbee2MQTT:n kautta MQTT:hen tiedon lämpötilasta ja Home Assistant ottaa sen vastaan. Sama toimii myös toiseen suuntaan, kun esimerkiksi pistorasia halutaan kytkeä päälle.

Zigbee2MQTT:n käyttöliittymä on yksi sen parhaista puolista

Zigbee2MQTT ei ole meille pelkkä näkymätön palikka Home Assistantin taustalla.

Sillä on oma selainkäyttöliittymä, josta näkee Zigbee-laitteet ja pääsee tarkastelemaan niiden tietoja ja asetuksia.

Tämä on erityisen hyödyllistä silloin, kun jokin laite ei käyttäydy kuten pitäisi.

Home Assistantissa saattaa vain näkyä, ettei jokin arvo päivity. Zigbee2MQTT:n puolella pääsee usein paljon lähemmäksi itse Zigbee-laitetta: mitä se raportoi, millä nimellä ominaisuus tulee ja mitä asetuksia laite oikeasti tarjoaa.

Juuri tällaisissa tilanteissa olemme itse oppineet arvostamaan Zigbee2MQTT:tä enemmän sitä mukaa, mitä enemmän sitä on käyttänyt.

Laitteen lisääminen Zigbee2MQTT:hen

Perusidea on yksinkertainen.

Zigbee2MQTT:stä sallitaan hetkeksi uusien laitteiden liittyminen verkkoon ja Zigbee-laite laitetaan paritustilaan. Kun laite löytyy, Zigbee2MQTT tunnistaa sen ja se ilmestyy käyttöliittymään.

Käytännössä juuri laitteen saaminen paritustilaan on joskus se kohta, jossa saa kaivaa käyttöohjetta. 😄

Toisessa laitteessa nappia painetaan viisi sekuntia, toisessa kymmenen, kolmannessa virrat katkaistaan kolme kertaa ja neljännen kanssa täytyy ilmeisesti suorittaa pieni rituaali oikeassa kuun vaiheessa.

No, ei sentään ihan.

Mutta tämän takia tarkistamme itse yleensä ensin kyseisen laitteen käyttöohjeen tai Zigbee2MQTT-sivun. Siellä on usein myös laitekohtainen paritusohje.

Jos laite ei vieläkään paritu, kannattaa kokeilla uudelleen ja tarkistaa myös, onko Zigbee2MQTT ajan tasalla. Uusien laitteiden ja uusien laiteversioiden tuki tulee usein Zigbee2MQTT-päivitysten mukana, joten vanhalla versiolla aivan uusi laite ei välttämättä vielä tunnistu.

Zigbee2MQTT vai ZHA?

Tämä kysymys tulee Home Assistantin kanssa vastaan lähes väistämättä.

ZHA on Home Assistantin oma Zigbee-integraatio. Se toimii suoraan Home Assistantin sisällä ja on monelle todella hyvä sekä yksinkertaisempi tapa ottaa Zigbee käyttöön.

Zigbee2MQTT taas toimii erillisenä ohjelmistona ja käyttää MQTT:tä kommunikointiin Home Assistantin kanssa.

Molemmilla voi rakentaa oikein hyvän Zigbee-verkon.

Me itse käytämme ja suosimme Zigbee2MQTT:tä, koska olemme kokeneet sen laitetuen, laitekohtaiset asetukset ja näkyvyyden Zigbee-laitteiden toimintaan meille sopivammiksi.

Se ei kuitenkaan tarkoita, että ZHA olisi huono tai että kaikkien pitäisi valita Zigbee2MQTT.

Jos haluaa mahdollisimman yksinkertaisen Zigbee-ratkaisun suoraan Home Assistantin sisään, Home Assistantin oma Zigbee eli ZHA voi olla erittäin hyvä valinta. Jos taas tykkää meidän tavoin vähän tutkia, säätää ja nähdä tarkemmin mitä Zigbee-verkon sisällä tapahtuu, Zigbee2MQTT on vaikea ohittaa.

Meiltä löytyy myös erikseen ZHA-yhteensopivia tuotteita.

Zigbee2MQTT ei tarkoita, että kaikki Zigbee-laitteet toimivat

Tämä kannattaa sanoa ääneen.

Se, että laitteessa lukee Zigbee, ei automaattisesti tarkoita sitä, että Zigbee2MQTT tukee sitä.

Ennen ostamista kannattaa hakea laitteen tarkka mallinumero Zigbee2MQTT:n laitetietokannasta.

Ja nimenomaan mallinumero.

Saman tuotteen nimellä voidaan joskus myydä eri laiteversioita, joten pelkkä esimerkiksi “Tuya lämpötila-anturi” ei vielä kerro tarpeeksi.

Tämän vuoksi pyrimme myös omilla tuotesivuillamme kertomaan mahdollisimman selkeästi, kun tuotteelle löytyy dokumentoitu Zigbee2MQTT-tuki – usein myös kuvakaappauksin omasta Home Assistantistamme.

Kuinka paljon laitteita Zigbee2MQTT tukee?

Tässä kohtaa sana “satoja” ei enää oikein riitä.

Zigbee2MQTT:n virallisessa laitetietokannassa on nykyään tuhansia tuettuja laitteita sadoilta eri valmistajilta, ja lista muuttuu jatkuvasti uusien laitteiden ja tuen kehittymisen myötä.

Tämän artikkelin päivityshetkellä tuettuja laitteita on jo yli 5 500.

Siksi emme edes yritä ylläpitää omaa täydellistä listaa.

Ajantasaisin paikka tarkistaa tuki on aina Zigbee2MQTT:n oma Supported Devices -hakemisto.

Zigbee2MQTT elää yhteisön mukana

Yksi Zigbee2MQTT:n hienoimmista puolista on se, ettei valtava laitetuki synny vain yhden yrityksen tuotekehityksessä. Zigbee2MQTT on avoimen lähdekoodin projekti, jota kehitetään aktiivisesti yhteisön voimin.

Käyttäjät ja kehittäjät ympäri maailmaa lisäävät tukea uusille laitteille, korjaavat laitemäärityksiä ja tekevät muutoksia, kun valmistajat julkaisevat uusia laite- tai ohjelmistoversioita.

Jos aivan uusi Zigbee-laite ei vielä löydy Zigbee2MQTT:n tuettujen laitteiden listalta, se ei siis välttämättä tarkoita, ettei se sinne koskaan tulisi. Kokeneemmat käyttäjät ja kehittäjät voivat tehdä laitteille uusia määrityksiä ja osallistua niiden tuen lisäämiseen Zigbee2MQTT-projektiin.

Iso kiitos kuuluukin sille valtavalle joukolle harrastajia ja kehittäjiä, jotka tekevät tätä työtä muidenkin hyödyksi. Ilman heitä Zigbee2MQTT ei olisi lähellekään niin laaja kuin se nykyään on.

Samasta syystä Zigbee2MQTT myös elää jatkuvasti. Uusia laitteita tulee, vanhojen laitteiden tukea parannetaan ja välillä jokin päivitys voi myös rikkoa hetkellisesti jotain, mikä aikaisemmin toimi.

Usein tällaisiin ongelmiin tulee korjaus melko nopeasti seuraavissa päivityksissä, mutta sitä ei tietenkään voida luvata jokaisen laitteen kohdalla.

Tämän vuoksi emme itse pidä kovin hyvänä ajatuksena asentaa jokaista uutta Home Assistant- tai Zigbee2MQTT-päivitystä ensimmäisenä mahdollisena hetkenä, jos järjestelmän varassa on jotain oikeasti tärkeää.

Jos Home Assistant ohjaa esimerkiksi kodin lämmitystä, lämminvesivaraajaa tai muita kriittisempiä automaatioita, kannattaa ennen päivitystä vilkaista julkaisutiedot ja seurata hetki muiden käyttäjien kokemuksia.

Suomalaisissa Älykoti- ja Home Assistant Suomi -Facebook-ryhmissä tämän huomaa usein nopeasti: jos jokin tuore päivitys aiheuttaa ongelmia tietyn donglen, laitteen tai integraation kanssa, joku on yleensä ehtinyt törmätä siihen jo ennen sinua. 😄

Ja ennen päivityksiä tietenkin: varmuuskopio.

Entä jos jokin ei toimi?

Jos Zigbee2MQTT:n kanssa alkaa harrastaa enemmän, jossain vaiheessa jokin myös todennäköisesti temppuilee.

Se kuuluu vähän lajin luonteeseen.

Ensimmäisenä kannattaa katsoa laitteen oma Zigbee2MQTT-sivu ja virallinen dokumentaatio. Sen jälkeen laitemallilla ja ongelman kuvauksella löytyy usein keskusteluja muilta, jotka ovat törmänneet samaan asiaan.

Ja yksi asia, jonka merkityksen oppii yleensä viimeistään ensimmäisen isomman päivityksen yhteydessä: ota varmuuskopiot.

Ennen Home Assistantin, Zigbee2MQTT:n tai muiden järjestelmän tärkeiden osien päivittämistä kannattaa varmistaa, että toimivasta kokonaisuudesta on palautuskelpoinen varmuuskopio.

Jos päivityksen jälkeen jokin hajoaa, on huomattavasti mukavampi palata edelliseen toimivaan versioon kuin alkaa keskellä yötä selvittää, mikä muuttui. 😄

Home Assistantin varmuuskopioilla saa talteen Home Assistantin asetuksia, automaatioita ja muuta järjestelmän sisältöä. Myös Zigbee2MQTT:n omasta datasta kannattaa huolehtia käytetyn asennustavan mukaan.

Varsinkin pitkään rakennetussa älykodissa varmuuskopioiden arvo kasvaa nopeasti sitä mukaa, mitä enemmän järjestelmän varassa on.

Zigbee2MQTT:n virallinen Getting Started -opas löytyy täältä.

Apua löytyy myös Home Assistant -yhteisöstä, YouTubesta, Facebookin suomalaisista Älykoti- ja Home Assistant Suomi -ryhmistä sekä nykyään varsin hyvin myös tekoälyn avulla.

Meidän tehtävämme kauppana on pyrkiä kertomaan mahdollisimman selkeästi, mitä olemme itse tuotteista testanneet ja mihin järjestelmiin niille löytyy dokumentoitu tuki. Emme kuitenkaan pysty vianrajaamaan jokaisen asiakkaan yksilöllistä Home Assistant- tai Zigbee2MQTT-järjestelmää.

Home Assistant ja Zigbee2MQTT ovat parhaimmillaan juuri sellaiselle käyttäjälle, joka on valmis välillä itsekin käärimään hihat.

Kannattaako Zigbee2MQTT?

Meidän mielestämme kyllä – jos Home Assistant ja älykodin rakentelu ylipäätään kiinnostavat vähän harrastuksena.

Zigbee2MQTT ei ole kaikkein helpoin ensimmäinen askel älykotiin. Smart Life, Philips Hue tai muu valmis järjestelmä pääsee alkuun nopeammin ja vähemmällä perehtymisellä.

Mutta jos tavoitteena on rakentaa järjestelmä, jossa on paljon eri valmistajien Zigbee-laitteita ja jossa haluaa päästä myös niiden asetuksiin hieman pintaa syvemmälle, Zigbee2MQTT on meidän kokemuksemme perusteella erittäin hyvä ratkaisu.

Meille siitä on tullut sellainen osa Home Assistantia, jota ei oikeastaan enää edes ajattele erillisenä ohjelmistona. Se vain hoitaa Zigbee-verkon taustalla.

Ja kun seuraavan kerran löytää kiinnostavan Zigbee-anturin, kysymys kuuluu lähinnä:

“Mikäs tämän mallinumero olikaan – löytyykö se Z2M:stä?” 😄

→ Tutustu Zigbee2MQTT-yhteensopiviin tuotteisiimme

→ Lue myös: Mikä on Zigbee ja miten Zigbee mesh -verkko toimii?