Zigbee2MQTT

Zigbee2MQTT är en Zigbee-brygga med öppen källkod. Som namnet säger omvandlar den Zigbee-trafik till MQTT-meddelanden, vilket gör att ZiggyMeter kan mata allt som stöder MQTT — Home Assistant, Node-RED eller din egen programvara.

Krav

• En Zigbee-koordinator som stöds av Zigbee2MQTT
• Zigbee2MQTT igång och ansluten till en MQTT-broker
• ZiggyMeter påslagen med Zigbee aktiverat

Parkoppla enheten

1. Öppna Zigbee2MQTT:s gränssnitt och aktivera Permit join (längst ned i vänstermenyn).

   

2. Sätt ZiggyMeter i anslutningsläge:

   • Knapp — tryck 3 gånger, eller 4 gånger om enheten sover.
   • Webbgränssnitt — Zigbee → ZIGBEE RESET.

3. Vänta tills enheten dyker upp i listan Devices.

   

4. Ge den gärna ett beskrivande namn. Namnet blir en del av MQTT-ämnet, så välj det innan du skriver automationer som använder det.

WARNING

”Not supported” är inget fel. Det betyder att ZiggyMeter inte finns i Zigbee2MQTT:s enhetsdatabas, inte att den inte fungerar. Alla kluster är standardiserade och data flödar som vanligt. Du kan lugnt ignorera meddelandet.

Enhetens detaljer

När du väljer enheten visas dess detaljer, inklusive MQTT-ämnet.

Användbara underflikar:

Flik	Vad den ger dig
Exposes	Mätvärden — effekt, energi, temperatur, batteri
Clusters	De råa Zigbee-kluster som enheten exponerar
Dev console	Läs och skriv attribut direkt — verktyget att ta till när ett värde ser fel ut

Ta emot data

Zigbee2MQTT publicerar mätvärden som MQTT-meddelanden.

• Standardmönster för ämne: zigbee2mqtt/<friendly_name>
• Basämnet (zigbee2mqtt) kan ändras i Zigbee2MQTT:s inställningar

Prenumerera med valfri MQTT-klient:

mosquitto_sub -t 'zigbee2mqtt/<friendly_name>' -v

Ett meddelande ser ut så här:

zigbee2mqtt/0x404ccafffe478674 {"current_2":null,"energy_2":129496,"linkquality":204,"power_2":null,"produced_energy_2":67296,"state_1":"OFF","state_2":"OFF","temperature":36.59,"voltage_2":null}

Suffixen _1 och _2 är Zigbee-endpoints — _1 är enheten, _2 är mätaren. Se Zigbee-referens.

INFO

Ett fält med null betyder att mätaren inte tillhandahöll värdet, inte att Zigbee-länken fallerade. Vilka fält som fylls i beror helt på din mätare.

Firmwareuppdateringar

Zigbee2MQTT kan uppdatera ZiggyMeter automatiskt. Följ Zigbee2MQTT:s guide för OTA-uppdateringar och använd den här URL:en till fjärr-OTA-indexet:

https://fw.ziggymeter.com/z2m_index.json

WARNING

Zigbee OTA är långsamt. Håll enheten strömförsörjd och inom räckhåll under hela överföringen — räkna med timmar, inte minuter. Se Firmwareuppdatering → Zigbee OTA.

Felsökning

Symptom	Kontrollera
Enheten ansluter inte	Permit join är öppet; gör en Zigbee-återställning (3 tryck, 4 om den sover); flytta enheten närmare koordinatorn
Inga MQTT-meddelanden	Zigbee2MQTT är ansluten till brokern; du prenumererar på rätt basämne och namn
Fälten är null	Mätaren rapporterar inte de värdena — kontrollera avläsningen i ZiggyMeters webbgränssnitt
Värdena ändras aldrig	Inget startar avläsningar. Kontrollera schemat