Zigbee2MQTT

Zigbee2MQTT is een opensource Zigbee-brug. Zoals de naam zegt zet hij Zigbee-verkeer om in MQTT-berichten, waardoor ZiggyMeter elk systeem kan voeden dat MQTT ondersteunt — Home Assistant, Node-RED of uw eigen software.

Vereisten

• Een Zigbee-coördinator die door Zigbee2MQTT wordt ondersteund
• Een draaiende Zigbee2MQTT die met een MQTT-broker is verbonden
• Een ingeschakelde ZiggyMeter met Zigbee aan

Koppel het apparaat

1. Open de webinterface van Zigbee2MQTT en zet Permit join aan (onderaan het linkermenu).

   

2. Zet ZiggyMeter in de koppelmodus:

   • Knop — klik 3 keer, of 4 keer als het apparaat slaapt.
   • Webinterface — Zigbee → ZIGBEE RESET.

3. Wacht tot het apparaat in de lijst Devices verschijnt.

   

4. Geef het eventueel een eigen naam. Die naam wordt onderdeel van het MQTT-topic, dus kies hem voordat u er automatiseringen op baseert.

WARNING

“Not supported” is geen fout. Het betekent dat ZiggyMeter niet in de apparatendatabase van Zigbee2MQTT staat, niet dat het niet werkt. Alle clusters zijn standaard en de gegevens stromen gewoon. U kunt de melding gerust negeren.

Gegevens van het apparaat

Wanneer u het apparaat kiest, ziet u de details, waaronder het MQTT-topic.

Nuttige subtabbladen:

Tabblad	Wat het u geeft
Exposes	Metingen — vermogen, energie, temperatuur, batterij
Clusters	De ruwe Zigbee-clusters die het apparaat aanbiedt
Dev console	Attributen rechtstreeks lezen en schrijven — het gereedschap waar u naar grijpt als een waarde niet klopt

Gegevens ontvangen

Zigbee2MQTT publiceert metingen als MQTT-berichten.

• Standaardpatroon voor het topic: zigbee2mqtt/<friendly_name>
• Het basistopic (zigbee2mqtt) is in de instellingen van Zigbee2MQTT aan te passen

Abonneer u met een willekeurige MQTT-client:

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

Een bericht ziet er zo uit:

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}

De achtervoegsels _1 en _2 zijn de Zigbee-endpoints — _1 is het apparaat, _2 de meter. Zie Referentie Zigbee.

INFO

Een veld met null betekent dat de meter die waarde niet heeft geleverd, niet dat de Zigbee-verbinding is mislukt. Welke velden gevuld zijn, hangt volledig van uw meter af.

Firmware-updates

Zigbee2MQTT kan ZiggyMeter automatisch bijwerken. Volg de handleiding van Zigbee2MQTT voor OTA-updates en gebruik dit externe adres voor de OTA-index:

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

WARNING

Zigbee OTA is langzaam. Houd het apparaat de hele overdracht gevoed en binnen bereik — reken op uren, niet op minuten. Zie Firmware-update → Zigbee OTA.

Problemen oplossen

Verschijnsel	Controleer
Apparaat koppelt niet	Permit join staat open; voer een Zigbee-reset uit (3 klikken, 4 als het slaapt); zet het apparaat dichter bij de coördinator
Geen MQTT-berichten	Zigbee2MQTT is met de broker verbonden; u bent geabonneerd op het juiste basistopic en de juiste apparaatnaam
Velden zijn null	De meter meldt die waarden niet — controleer de uitlezing in de webinterface van ZiggyMeter
Waarden veranderen nooit	Er start niets een uitlezing. Controleer het schema