Referenčný popis Zigbee
Táto stránka opisuje, ako ZiggyMeter vyzerá v sieti Zigbee: koncové body, clustre a atribúty. Ako sa pripojiť do siete, nájdete v Nastavení Zigbee.
O Zigbee
Zigbee je nízkoenergetický bezdrôtový mesh protokol pre zariadenia IoT, postavený na IEEE 802.15.4 v pásme 2,4 GHz. Správy sa preposielajú cez smerovače napájané zo siete — práve preto funguje v elektromerových skriniach a suterénoch, kde by priame spojenie Wi-Fi neprešlo.
ZiggyMeter sa pripája ako koncové zariadenie: nesmeruje prevádzku iných zariadení a medzi odpočtami spí.
Požiadavky
- Koordinátor Zigbee — USB adaptér alebo hub, ktorý sieť vytvára a spravuje
- Softvér, ktorý rozumie clustrom Zigbee Cluster Library v8
Všetky clustre, ktoré ZiggyMeter poskytuje, sú štandardné. Neexistujú žiadne clustre špecifické pre výrobcu, takže väčšina integrácií funguje bez vlastného ovládača zariadenia.
Koncové body
Koncový bod 1 — zariadenie
Identifikácia zariadenia a základný stav. Prepnutie vypínača On/Off zapne alebo vypne Wi-Fi.
Vstupné clustre
| ID clustra | Názov |
|---|---|
0x0000 | Basic |
0x0001 | Power Configuration |
0x0003 | Identify |
0x0006 | On/Off |
0x0402 | Temperature Measurement |
Výstupné clustre
| ID clustra | Názov |
|---|---|
0x0003 | Identify |
0x0019 | OTA Upgrade |
Koncový bod 2 — elektromer
Údaje elektromera. Prepnutie vypínača On/Off spustí odpočet.
Vstupné clustre
| ID clustra | Názov |
|---|---|
0x0006 | On/Off |
0x0702 | Simple Metering |
0x0B04 | Electrical Measurement |
Žiadne výstupné clustre.
Cluster Metering (0x0702)
Dva atribúty, oba štandardné. Nie sú potrebné žiadne vlastné príkazy.
| ID atribútu | Názov |
|---|---|
0x0000 | Current Summation Delivered |
0x0001 | Current Summation Received |
Current Summation Received sa aktualizuje len vtedy, ak elektromer túto hodnotu poskytuje.
Cluster Electrical Measurement (0x0B04)
Elektrické parametre. Cluster deklaruje celú množinu atribútov uvedenú nižšie, no iba tri z nich — Active power (0x050B), RMS current (0x0508) a RMS voltage (0x0505) — sa dajú naplniť hodnotou z elektromera a hlásiť koordinátoru. Pozrite si Dostupné cieľové atribúty.
Ktoré z nich sa naozaj aktualizujú, závisí od elektromera: jednofázový elektromer pochopiteľne nikdy nevyplní fázy B a C.
Niektoré integrácie Zigbee nezobrazujú každý atribút, ani keď ho zariadenie správne aktualizuje. Než usúdite, že zariadenie nehlási údaje, skontrolujte surové hodnoty clustra v nástrojoch svojho koordinátora.
| ID atribútu | Názov |
|---|---|
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) |
Ako sa z hodnôt elektromera stanú atribúty
Elektromer používa kódy OBIS, Zigbee atribúty clustrov. ZiggyMeter medzi nimi udržiava mapovaciu tabuľku.
Každý záznam mapovania je kód OBIS plus ID mapovania: štyri bajty v šestnástkovej podobe, kde prvé dva sú cluster a posledné dva atribút.
| OBIS | ID mapovania | Cluster / atribút | Význam |
|---|---|---|---|
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, fáza A |
1-0:11.7.0 | 0b040508 | 0x0B04 / 0x0508 | RMS current, fáza A |
1-0:12.7.0 | 0b040505 | 0x0B04 / 0x0505 | RMS voltage, fáza A |
Zmeňte ju, keď váš elektromer používa kód, ktorý predvolené nastavenie nepokrýva — napríklad elektromer, ktorý hlási napätie pod kódom špecifickým pre model, takže hodnotu vidíte v odpočte, ale ku koordinátoru sa nikdy nedostane.
Zmena mapovania
Robí sa vo webovom rozhraní. Otvorte Meter → Readings a dvakrát kliknite na pole Mapping v riadku, ktorý chcete zmeniť; pole sa premení na rozbaľovací zoznam dostupných cieľových atribútov Zigbee. Vyberte jeden a hneď sa uloží — samostatné potvrdenie nie je.
INFO
Namapovať sa dajú len kódy OBIS, ktoré sa objavia v odpočte, pretože tabuľka je odpočet. Ak požadovaný riadok chýba, najprv odpočítajte elektromer.
Dostupné cieľové atribúty
Rozbaľovací zoznam ponúka šesť možností, nič viac. Kódu OBIS sa dá priradiť len týchto päť párov cluster/atribút — ostatné atribúty uvedené vyššie na clustroch existujú, ale cieľmi mapovania nie sú.
| Položka zoznamu | ID mapovania | Cluster / atribút |
|---|---|---|
| Unassigned | 00000000 | — (hodnota sa odpočíta, ale nezverejní cez Zigbee) |
| 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
Každý cieľ môže naraz používať len jeden kód OBIS. Priradením cieľa, ktorý už drží iný riadok, ho presuniete: druhý riadok sa automaticky vráti na Unassigned. Ak prestavujete viac riadkov, po zmene si tabuľku skontrolujte.
Porovnáva sa celý kód OBIS vrátane tarify (1-0:15.8.0*101). API prijme aj porovnanie podľa krátkeho kódu (15.8.0).
Úprava cez API
/api/v1/zigbee/map číta a zapisuje tú istú tabuľku, čo je užitočné pri rovnakom nastavovaní viacerých zariadení. Je to alternatíva k webovému rozhraniu, nie bežná cesta — POST nahradí celú tabuľku a pravidlo „jeden cieľ, jeden kód“ za vás nevynucuje.
Firmvér bezdrôtovo
Koncový bod 1 poskytuje štandardný cluster OTA Upgrade (0x0019), takže zariadenie dokáže aktualizovať každý koordinátor s podporou Zigbee OTA. Hotové indexové súbory sú zverejnené pre Zigbee2MQTT aj pre zigpy/ZHA: