Zigbee-referens
Den här sidan beskriver hur ZiggyMeter ser ut i ett Zigbee-nätverk: endpoints, kluster och attribut. Hur du ansluter till ett nätverk beskrivs under Konfigurera Zigbee.
Om Zigbee
Zigbee är ett strömsnålt trådlöst meshprotokoll för IoT-enheter som körs på IEEE 802.15.4 vid 2,4 GHz. Meddelanden hoppar via nätdrivna routrar, och det är därför det fungerar i mätarskåp och källare där en direkt Wi-Fi-länk inte skulle räcka.
ZiggyMeter ansluter som slutenhet (End Device): den vidarebefordrar ingen trafik åt andra och sover mellan avläsningarna.
Krav
- En Zigbee-koordinator — en USB-adapter eller hub som skapar och hanterar nätverket
- Programvara som förstår kluster enligt Zigbee Cluster Library v8
Alla kluster som ZiggyMeter exponerar är standardiserade. Det finns inga tillverkarspecifika kluster, så de flesta integrationer fungerar direkt utan någon särskild drivrutin.
Endpoints
Endpoint 1 — enheten
Enhetsidentifiering och grundläggande status. Att växla brytaren On/Off slår på eller av Wi-Fi.
Inkommande kluster
| Kluster-ID | Namn |
|---|---|
0x0000 | Basic |
0x0001 | Power Configuration |
0x0003 | Identify |
0x0006 | On/Off |
0x0402 | Temperature Measurement |
Utgående kluster
| Kluster-ID | Namn |
|---|---|
0x0003 | Identify |
0x0019 | OTA Upgrade |
Endpoint 2 — mätaren
Mätardata. Att växla brytaren On/Off startar en mätaravläsning.
Inkommande kluster
| Kluster-ID | Namn |
|---|---|
0x0006 | On/Off |
0x0702 | Simple Metering |
0x0B04 | Electrical Measurement |
Inga utgående kluster.
Klustret Metering (0x0702)
Två attribut, båda standardiserade. Inga egna kommandon behövs.
| Attribut-ID | Namn |
|---|---|
0x0000 | Current Summation Delivered |
0x0001 | Current Summation Received |
Current Summation Received uppdateras bara om mätaren tillhandahåller det värdet.
Klustret Electrical Measurement (0x0B04)
Elektriska parametrar. Klustret deklarerar hela uppsättningen attribut nedan, men bara tre av dem — Active power (0x050B), RMS current (0x0508) och RMS voltage (0x0505) — kan matas med ett mätarvärde och rapporteras till en koordinator. Se Tillgängliga mål.
Vilka av dem som faktiskt uppdateras beror sedan på mätaren: en enfasmätare fyller förstås aldrig i fas B och C.
Vissa Zigbee-integrationer visar inte alla attribut, även när enheten uppdaterar dem korrekt. Kontrollera klustrens råvärden i koordinatorns egna verktyg innan du drar slutsatsen att enheten inte rapporterar.
| Attribut-ID | Namn |
|---|---|
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) |
Hur mätarvärden blir attribut
Mätaren använder OBIS-koder, Zigbee klusterattribut. ZiggyMeter har en mappningstabell mellan de två.
Varje mappningspost är en OBIS-kod plus ett mappnings-ID: fyra byte hexadecimalt, där de två första är klustret och de två sista attributet.
| OBIS | Mappnings-ID | Kluster / attribut | Betydelse |
|---|---|---|---|
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 | Aktiv effekt, fas A |
1-0:11.7.0 | 0b040508 | 0x0B04 / 0x0508 | Effektivvärde ström, fas A |
1-0:12.7.0 | 0b040505 | 0x0B04 / 0x0505 | Effektivvärde spänning, fas A |
Ändra den när din mätare använder en kod som standardinställningen inte täcker — till exempel en mätare som rapporterar spänningen under en modellspecifik kod, så att värdet syns i avläsningen men aldrig når fram till koordinatorn.
Ändra en mappning
Det gör du i webbgränssnittet. Öppna Meter → Readings och dubbelklicka på cellen Mapping på raden du vill ändra; cellen blir en rullgardinslista med tillgängliga Zigbee-mål. Välj ett så sparas det direkt — det finns inget separat sparsteg.
INFO
Bara OBIS-koder som finns i en avläsning kan mappas, eftersom tabellen är avläsningen. Om raden du letar efter saknas, läs av mätaren först.
Tillgängliga mål
Rullgardinslistan har sex alternativ, och inga fler. Bara de här fem kombinationerna av kluster och attribut kan tilldelas en OBIS-kod — övriga attribut ovan finns i klustren men är inga mappningsmål.
| Alternativ i listan | Mappnings-ID | Kluster / attribut |
|---|---|---|
| Unassigned | 00000000 | — (värdet läses men publiceras inte via 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
Varje mål kan bara användas av en OBIS-kod i taget. Om du tilldelar ett mål som en annan rad redan har flyttas det: den andra raden sätts automatiskt tillbaka till Unassigned. Kontrollera tabellen efter en ändring om du flyttar om flera rader.
Matchningen görs på den fullständiga OBIS-koden inklusive tariff (1-0:15.8.0*101). API:t tar också emot matchning på den korta koden (15.8.0).
Redigera via API:t
/api/v1/zigbee/map läser och skriver samma tabell, vilket är praktiskt när flera enheter ska konfigureras likadant. Det är ett alternativ till webbgränssnittet, inte den vanliga vägen — en POST ersätter hela tabellen och tillämpar inte regeln ”ett mål, en kod” åt dig.
Firmware trådlöst
Endpoint 1 har standardklustret OTA Upgrade (0x0019), så alla koordinatorer som stöder Zigbee OTA kan uppdatera enheten. Färdiga indexfiler publiceras för Zigbee2MQTT och för zigpy/ZHA: