Zigbee referencia
Ez az oldal azt írja le, hogyan jelenik meg a ZiggyMeter egy Zigbee hálózatban: végpontok, klaszterek és attribútumok. A hálózatba való belépésről lásd: Zigbee beállítása.
A Zigbee-ről
A Zigbee alacsony fogyasztású, vezeték nélküli mesh protokoll IoT-eszközökhöz, amely az IEEE 802.15.4 szabványra épül 2,4 GHz-en. Az üzenetek hálózatról táplált routereken haladnak tovább, és épp ezért működik mérőszekrényekben és alagsorokban, ahol a közvetlen Wi-Fi kapcsolat nem boldogulna.
A ZiggyMeter végponti eszközként lép be: nem továbbít mások forgalmát, és a leolvasások között alszik.
Követelmények
- Egy Zigbee koordinátor — USB adapter vagy hub, amely létrehozza és kezeli a hálózatot
- Olyan szoftver, amely érti a Zigbee Cluster Library v8 klasztereket
A ZiggyMeter által kínált minden klaszter szabványos. Gyártóspecifikus klaszter nincs, így a legtöbb integráció saját eszközillesztő nélkül, azonnal működik.
Végpontok
1. végpont — készülék
A készülék azonosítói és alapállapota. Az On/Off kapcsoló átváltása be- vagy kikapcsolja a Wi-Fit.
Bemeneti klaszterek
| Klaszter azonosítója | Neve |
|---|---|
0x0000 | Basic |
0x0001 | Power Configuration |
0x0003 | Identify |
0x0006 | On/Off |
0x0402 | Temperature Measurement |
Kimeneti klaszterek
| Klaszter azonosítója | Neve |
|---|---|
0x0003 | Identify |
0x0019 | OTA Upgrade |
2. végpont — mérőóra
Mérési adatok. Az On/Off kapcsoló átváltása leolvasást indít a mérőórán.
Bemeneti klaszterek
| Klaszter azonosítója | Neve |
|---|---|
0x0006 | On/Off |
0x0702 | Simple Metering |
0x0B04 | Electrical Measurement |
Kimeneti klaszter nincs.
Metering klaszter (0x0702)
Két attribútum, mindkettő szabványos. Saját parancsokra nincs szükség.
| Attribútum azonosítója | Neve |
|---|---|
0x0000 | Current Summation Delivered |
0x0001 | Current Summation Received |
A Current Summation Received csak akkor frissül, ha a mérőóra megadja azt az értéket.
Electrical Measurement klaszter (0x0B04)
Elektromos jellemzők. A klaszter a lenti teljes attribútumkészletet bejelenti, de közülük csak három — az Active power (0x050B), az RMS current (0x0508) és az RMS voltage (0x0505) — tölthető fel mérőóra-értékkel és jelezhető a koordinátornak. Lásd: Választható célok.
Hogy ezek közül melyek frissülnek valóban, a mérőórától függ: egy egyfázisú mérőóra természetesen soha nem tölti ki a B és C fázist.
Néhány Zigbee-integráció nem jelenít meg minden attribútumot akkor sem, ha a készülék helyesen frissíti őket. Mielőtt arra jutna, hogy a készülék nem jelez, ellenőrizze a nyers klaszterértékeket a koordinátor saját eszközeivel.
| Attribútum azonosítója | Neve |
|---|---|
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) |
Hogyan lesznek a mérőóra-értékekből attribútumok
A mérőóra OBIS-kódokat használ, a Zigbee klaszterattribútumokat. A ZiggyMeter hozzárendelési táblát tart fenn a kettő között.
Minden hozzárendelés egy OBIS-kódból és egy hozzárendelési azonosítóból áll: négy bájt hexadecimálisan, ahol az első kettő a klaszter, az utolsó kettő az attribútum.
| OBIS | Hozzárendelési azonosító | Klaszter / attribútum | Jelentés |
|---|---|---|---|
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, A fázis |
1-0:11.7.0 | 0b040508 | 0x0B04 / 0x0508 | RMS current, A fázis |
1-0:12.7.0 | 0b040505 | 0x0B04 / 0x0505 | RMS voltage, A fázis |
Akkor módosítsa, ha a mérőórája olyan kódot használ, amelyet az alapértékek nem fednek — például olyan mérőóránál, amely a feszültséget típusspecifikus kóddal jelzi, így az érték megjelenik a leolvasásban, de soha nem jut el a koordinátorhoz.
Hozzárendelés módosítása
Ezt a webes felületen végezze. Nyissa meg a Meter → Readings oldalt, és kattintson duplán a módosítani kívánt sor Mapping mezőjére; a mező legördülő listává változik, amelyben a választható Zigbee-célok szerepelnek. Válasszon egyet, és azonnal mentődik — nincs külön mentési lépés.
INFO
Csak olyan OBIS-kódok rendelhetők hozzá, amelyek megjelennek egy leolvasásban, mert a tábla maga a leolvasás. Ha a kívánt sor nincs ott, először olvassa le a mérőórát.
Választható célok
A legördülő lista hat lehetőséget kínál, többet nem. Csak ez az öt klaszter-attribútum páros kaphat OBIS-kódot — a fentebb felsorolt többi attribútum létezik a klasztereken, de nem hozzárendelési cél.
| Választás a listából | Hozzárendelési azonosító | Klaszter / attribútum |
|---|---|---|
| Unassigned | 00000000 | — (az értéket a készülék kiolvassa, de nem teszi közzé Zigbee-n) |
| 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
Egy célt egyszerre csak egy OBIS-kód használhat. Ha olyan célt ad meg, amelyet már egy másik sor birtokol, a cél átkerül: a másik sor automatikusan Unassigned állapotba áll. Ha több sort rendez át, a módosítás után ellenőrizze a táblát.
Az egyeztetés a teljes OBIS-kód alapján történik, a tarifával együtt (1-0:15.8.0*101). Az API a rövid kód (15.8.0) szerinti egyeztetést is elfogadja.
Szerkesztés az API-n keresztül
A /api/v1/zigbee/map végpont ugyanezt a táblát olvassa és írja, ami több készülék egyforma beállításánál hasznos. Ez a webes felület alternatívája, nem a szokásos út — a POST a teljes táblát felülírja, és nem érvényesíti Ön helyett az „egy cél, egy kód” szabályt.
Firmware vezeték nélkül
Az 1. végpont a szabványos OTA Upgrade klasztert (0x0019) kínálja, így minden Zigbee OTA-t támogató koordinátor frissíteni tudja a készüléket. Kész indexfájlok érhetők el a Zigbee2MQTT-hez és a zigpyhez/ZHA-hoz: