Zigbee-viitetiedot
Tämä sivu kuvaa, miltä ZiggyMeter näyttää Zigbee-verkossa: päätepisteet, klusterit ja määritteet. Verkkoon liittyminen on kuvattu sivulla Zigbee-asetukset.
Tietoa Zigbeestä
Zigbee on vähävirtainen langaton mesh-protokolla IoT-laitteille, ja se toimii IEEE 802.15.4:n päällä taajuudella 2,4 GHz. Viestit hyppäävät verkkovirralla toimivien reitittimien kautta, minkä ansiosta se toimii mittarikaapeissa ja kellareissa, joissa suora Wi-Fi-yhteys ei toimisi.
ZiggyMeter liittyy verkkoon päätelaitteena: se ei reititä muiden liikennettä ja se nukkuu lukemien välillä.
Vaatimukset
- Zigbee-koordinaattori — USB-sovitin tai keskitin, joka luo ja hallitsee verkkoa
- Ohjelmisto, joka ymmärtää Zigbee Cluster Library v8 -klustereita
Kaikki ZiggyMeterin tarjoamat klusterit ovat vakioklustereita. Valmistajakohtaisia klustereita ei ole, joten useimmat integraatiot toimivat suoraan ilman erillistä laiteajuria.
Päätepisteet
Päätepiste 1 — laite
Laitteen tunnistetiedot ja perustila. On/Off-kytkimen kääntäminen ottaa Wi-Fin käyttöön tai poistaa sen käytöstä.
Tuloklusterit
| Klusterin tunnus | Nimi |
|---|---|
0x0000 | Basic |
0x0001 | Power Configuration |
0x0003 | Identify |
0x0006 | On/Off |
0x0402 | Temperature Measurement |
Lähtöklusterit
| Klusterin tunnus | Nimi |
|---|---|
0x0003 | Identify |
0x0019 | OTA Upgrade |
Päätepiste 2 — mittari
Mittaustiedot. On/Off-kytkimen kääntäminen käynnistää mittarin lukemisen.
Tuloklusterit
| Klusterin tunnus | Nimi |
|---|---|
0x0006 | On/Off |
0x0702 | Simple Metering |
0x0B04 | Electrical Measurement |
Ei lähtöklustereita.
Metering-klusteri (0x0702)
Kaksi määritettä, molemmat vakioita. Omia komentoja ei tarvita.
| Määritteen tunnus | Nimi |
|---|---|
0x0000 | Current Summation Delivered |
0x0001 | Current Summation Received |
Current Summation Received päivittyy vain, jos mittari tarjoaa kyseisen arvon.
Electrical Measurement -klusteri (0x0B04)
Sähköiset suureet. Klusteri esittelee alla olevan täyden määritejoukon, mutta vain kolme niistä — Active power (0x050B), RMS current (0x0508) ja RMS voltage (0x0505) — voidaan täyttää mittarin arvolla ja raportoida koordinaattorille. Katso Käytettävissä olevat kohteet.
Se, mitkä niistä todella päivittyvät, riippuu mittarista: yksivaiheinen mittari ei tietenkään täytä koskaan vaiheita B ja C.
Jotkin Zigbee-integraatiot eivät näytä kaikkia määritteitä, vaikka laite päivittäisi ne oikein. Tarkista raa'at klusteriarvot koordinaattorisi omilla työkaluilla, ennen kuin päättelet ettei laite raportoi.
| Määritteen tunnus | Nimi |
|---|---|
0x0300 | AC frequency |
0x0304 | Total active power |
0x0305 | Total reactive power |
0x0306 | Total apparent power |
0x0501 | Line current (phase A) |
0x0502 | Active current (phase A) |
0x0503 | Reactive current (phase A) |
0x0505 | RMS voltage (phase A) |
0x0508 | RMS current (phase A) |
0x050B | Active power (phase A) |
0x050E | Reactive power (phase A) |
0x050F | Apparent power (phase A) |
0x0901 | Line current (phase B) |
0x0902 | Active current (phase B) |
0x0903 | Reactive current (phase B) |
0x0905 | RMS voltage (phase B) |
0x0908 | RMS current (phase B) |
0x090B | Active power (phase B) |
0x090E | Reactive power (phase B) |
0x090F | Apparent power (phase B) |
0x0A01 | Line current (phase C) |
0x0A02 | Active current (phase C) |
0x0A03 | Reactive current (phase C) |
0x0A05 | RMS voltage (phase C) |
0x0A08 | RMS current (phase C) |
0x0A0B | Active power (phase C) |
0x0A0E | Reactive power (phase C) |
0x0A0F | Apparent power (phase C) |
Miten mittarin arvoista tulee määritteitä
Mittari käyttää OBIS-koodeja, Zigbee klusterimääritteitä. ZiggyMeter ylläpitää näiden välillä kytkentätaulukkoa.
Jokainen kytkentä on OBIS-koodi ja kytkentätunnus: neljä tavua heksadesimaalilukuina, joista kaksi ensimmäistä ovat klusteri ja kaksi viimeistä määrite.
| OBIS | Kytkentätunnus | Klusteri / määrite | Merkitys |
|---|---|---|---|
1-0:1.8.0 | 07020000 | 0x0702 / 0x0000 | Current summation delivered |
1-0:2.8.0 | 07020001 | 0x0702 / 0x0001 | Current summation received |
1-0:1.7.0 | 0b04050b | 0x0B04 / 0x050B | Active power, vaihe A |
1-0:11.7.0 | 0b040508 | 0x0B04 / 0x0508 | RMS current, vaihe A |
1-0:12.7.0 | 0b040505 | 0x0B04 / 0x0505 | RMS voltage, vaihe A |
Muuta taulukkoa, kun mittarisi käyttää koodia, jota oletukset eivät kata — esimerkiksi mittaria, joka raportoi jännitteensä mallikohtaisella koodilla, jolloin arvo näkyy lukemassa mutta ei koskaan päädy koordinaattorillesi.
Kytkennän muuttaminen
Tee se verkkokäyttöliittymässä. Avaa Meter → Readings ja kaksoisnapsauta muutettavan rivin Mapping-solua; solusta tulee valintaluettelo käytettävissä olevista Zigbee-kohteista. Valitse yksi, ja se tallentuu heti — erillistä tallennusvaihetta ei ole.
INFO
Kytkeä voi vain sellaisia OBIS-koodeja, jotka esiintyvät lukemassa, koska taulukko on lukema. Jos haluamaasi riviä ei ole, lue mittari ensin.
Käytettävissä olevat kohteet
Valintaluettelo tarjoaa kuusi vaihtoehtoa, ei enempää. Vain näille viidelle klusteri–määrite-parille voi määrittää OBIS-koodin — muut yllä luetellut määritteet ovat klustereissa olemassa, mutta ne eivät ole kytkennän kohteita.
| Valinta luettelossa | Kytkentätunnus | Klusteri / määrite |
|---|---|---|
| Unassigned | 00000000 | — (arvo luetaan, mutta sitä ei julkaista Zigbeen yli) |
| Summation Delivered [kWh] | 07020000 | 0x0702 / 0x0000 |
| Summation Received [kWh] | 07020001 | 0x0702 / 0x0001 |
| Active Power [kW] | 0b04050b | 0x0B04 / 0x050B |
| Current RMS [A] | 0b040508 | 0x0B04 / 0x0508 |
| Voltage RMS [V] | 0b040505 | 0x0B04 / 0x0505 |
WARNING
Kutakin kohdetta voi käyttää kerrallaan vain yksi OBIS-koodi. Jos määrität kohteen, joka on jo toisella rivillä, se siirtyy: toinen rivi palautuu automaattisesti tilaan Unassigned. Tarkista taulukko muutoksen jälkeen, jos järjestelet useita rivejä.
Vertailu tehdään täydellä OBIS-koodilla tariffi mukaan lukien (1-0:15.8.0*101). Rajapinta hyväksyy myös vertailun lyhyellä koodilla (15.8.0).
Muokkaus rajapinnan kautta
/api/v1/zigbee/map lukee ja kirjoittaa samaa taulukkoa, mikä on kätevää useiden laitteiden määrittämiseen samalla tavalla. Se on vaihtoehto verkkokäyttöliittymälle, ei tavanomainen reitti — POST korvaa koko taulukon eikä valvo puolestasi sääntöä ”yksi kohde, yksi koodi”.
Laiteohjelmisto langattomasti
Päätepiste 1 tarjoaa vakioklusterin OTA Upgrade (0x0019), joten mikä tahansa Zigbee OTA:ta tukeva koordinaattori voi päivittää laitteen. Valmiit hakemistotiedostot on julkaistu sekä Zigbee2MQTT:lle että zigpylle/ZHA:lle: