Referenční popis Zigbee
Tato stránka popisuje, jak ZiggyMeter vypadá v síti Zigbee: koncové body, clustery a atributy. Jak se připojit k síti, popisuje Nastavení Zigbee.
O Zigbee
Zigbee je úsporný bezdrátový protokol sítě typu mesh pro zařízení IoT, který běží na IEEE 802.15.4 v pásmu 2,4 GHz. Zprávy přeskakují přes směrovače napájené ze sítě, a právě díky tomu funguje ve skříních elektroměrů a sklepech, kde by přímé spojení Wi-Fi nestačilo.
ZiggyMeter se připojuje jako koncové zařízení (End Device): nepředává provoz ostatním a mezi odečty spí.
Požadavky
- Koordinátor Zigbee — adaptér USB nebo hub, který síť vytváří a spravuje
- Software, který rozumí clusterům Zigbee Cluster Library v8
Všechny clustery, které ZiggyMeter poskytuje, jsou standardní. Neobsahuje žádné clustery specifické pro výrobce, takže většina integrací funguje ihned bez zvláštního ovladače zařízení.
Koncové body
Koncový bod 1 — zařízení
Identifikace zařízení a základní stav. Přepnutí přepínače On/Off zapíná nebo vypíná Wi-Fi.
Vstupní clustery
| ID clusteru | Název |
|---|---|
0x0000 | Basic |
0x0001 | Power Configuration |
0x0003 | Identify |
0x0006 | On/Off |
0x0402 | Temperature Measurement |
Výstupní clustery
| ID clusteru | Název |
|---|---|
0x0003 | Identify |
0x0019 | OTA Upgrade |
Koncový bod 2 — elektroměr
Data elektroměru. Přepnutí přepínače On/Off spustí odečet elektroměru.
Vstupní clustery
| ID clusteru | Název |
|---|---|
0x0006 | On/Off |
0x0702 | Simple Metering |
0x0B04 | Electrical Measurement |
Žádné výstupní clustery.
Cluster Metering (0x0702)
Dva atributy, oba standardní. Žádné proprietární příkazy nejsou potřeba.
| ID atributu | Název |
|---|---|
0x0000 | Current Summation Delivered |
0x0001 | Current Summation Received |
Current Summation Received se aktualizuje jen tehdy, pokud tuto hodnotu elektroměr poskytuje.
Cluster Electrical Measurement (0x0B04)
Elektrické parametry. Cluster deklaruje úplnou sadu atributů níže, ale jen tři z nich — Active power (0x050B), RMS current (0x0508) a RMS voltage (0x0505) — lze naplnit hodnotou z elektroměru a hlásit koordinátoru. Viz Dostupné cíle.
Které z nich se skutečně aktualizují, pak závisí na elektroměru: jednofázový elektroměr pochopitelně nikdy nevyplní fáze B a C.
Některé integrace Zigbee nezobrazují každý atribut, ani když ho zařízení správně aktualizuje. Než usoudíte, že zařízení nic nehlásí, zkontrolujte surové hodnoty clusterů v nástrojích svého koordinátoru.
| ID atributu | Název |
|---|---|
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) |
Jak se z hodnot elektroměru stávají atributy
Elektroměr používá kódy OBIS, Zigbee používá atributy clusterů. ZiggyMeter mezi nimi udržuje mapovací tabulku.
Každá položka mapování se skládá z kódu OBIS a ID mapování: čtyř bajtů v šestnáctkové soustavě, kde první dva jsou cluster a poslední dva atribut.
| OBIS | ID mapování | Cluster / atribut | Význam |
|---|---|---|---|
1-0:1.8.0 | 07020000 | 0x0702 / 0x0000 | Celková energie odebraná ze sítě |
1-0:2.8.0 | 07020001 | 0x0702 / 0x0001 | Celková energie dodaná do sítě |
1-0:1.7.0 | 0b04050b | 0x0B04 / 0x050B | Činný výkon, fáze A |
1-0:11.7.0 | 0b040508 | 0x0B04 / 0x0508 | Efektivní proud, fáze A |
1-0:12.7.0 | 0b040505 | 0x0B04 / 0x0505 | Efektivní napětí, fáze A |
Změňte ho, když váš elektroměr používá kód, který výchozí nastavení nepokrývá — například elektroměr, který hlásí napětí pod kódem specifickým pro model, takže se hodnota v odečtu objeví, ale ke koordinátoru nikdy nedorazí.
Změna mapování
Dělá se to ve webovém rozhraní. Otevřete Meter → Readings a dvakrát klikněte na buňku Mapping v řádku, který chcete změnit; buňka se změní na rozbalovací seznam dostupných cílů Zigbee. Vyberte jeden a uloží se okamžitě — žádný samostatný krok uložení neexistuje.
INFO
Namapovat lze jen kódy OBIS, které se objeví v odečtu, protože tabulka je odečet. Pokud hledaný řádek chybí, nejdřív elektroměr odečtěte.
Dostupné cíle
Rozbalovací seznam nabízí šest možností a žádné další. Kód OBIS lze přiřadit jen těmto pěti dvojicím cluster/atribut — ostatní výše uvedené atributy v clusterech existují, ale cíli mapování nejsou.
| Položka seznamu | ID mapování | Cluster / atribut |
|---|---|---|
| Unassigned | 00000000 | — (hodnota se čte, ale přes Zigbee se nezveřejňuje) |
| 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ý cíl může v jednu chvíli používat jen jeden kód OBIS. Přiřazení cíle, který už drží jiný řádek, ho přesune: druhý řádek se automaticky vrátí na Unassigned. Pokud přeskupujete více řádků, po změně tabulku zkontrolujte.
Porovnává se úplný kód OBIS včetně tarifu (1-0:15.8.0*101). API navíc přijímá porovnání podle krátkého kódu (15.8.0).
Úpravy přes API
/api/v1/zigbee/map čte a zapisuje tutéž tabulku, což se hodí při stejném nastavování více zařízení. Je to alternativa k webovému rozhraní, ne běžná cesta — POST nahradí celou tabulku a pravidlo „jeden cíl, jeden kód“ za vás neuplatní.
Firmware bezdrátově
Koncový bod 1 nese standardní cluster OTA Upgrade (0x0019), takže zařízení může aktualizovat každý koordinátor s podporou Zigbee OTA. Hotové indexové soubory jsou zveřejněny pro Zigbee2MQTT a pro zigpy/ZHA: