Zigbee2MQTT

Zigbee2MQTT je open‑source Zigbee brána. Jak napovídá název, převádí data Zigbee na zprávy MQTT, což umožňuje integraci ZiggyMeter se systémy, které využívají MQTT. Při použití Zigbee můžete přijímat zprávy ze zařízení a měření prostřednictvím MQTT.

MQTT je lehký komunikační protokol typu publish‑subscribe (publikovat-odebírat). Běžně se používá v IoT pro efektivní komunikaci mezi zařízeními (senzory/aktuátory) a automatizačními systémy (například Home Assistant nebo Node‑RED).

Požadavky

• Koordinátor Zigbee podporovaný Zigbee2MQTT
• Spuštěné Zigbee2MQTT připojené k brokeru MQTT
• Zapnutý ZiggyMeter s povoleným Zigbee

Párování ZiggyMeter

1. Otevřete webové rozhraní Zigbee2MQTT a povolte Permit join (Povolit připojení) v levé dolní části menu.
2. Uveďte ZiggyMeter do režimu připojování k Zigbee:
   • Doporučeno: stiskněte tlačítko ZiggyMeter na 4 sekundy (reset Zigbee).
   • Alternativa: ve webovém rozhraní ZiggyMeter přejděte na stránku Zigbee a stiskněte ZIGBEE RESET.
3. Počkejte, až se ZiggyMeter objeví v seznamu Devices (Zařízení) v Zigbee2MQTT.
4. (Volitelné) Nastavte přátelský název (friendly name) v Zigbee2MQTT. Tento název se stane součástí tématu MQTT (topic).

WARNING

Může se zobrazit zpráva "Not supported" (Nepodporováno). To pouze znamená, že ZiggyMeter není v databázi zařízení Zigbee2MQTT. Můžete to bezpečně ignorovat.

Podrobnosti o zařízení

Pokud kliknete na odkaz zařízení, zobrazí se podrobnosti včetně tématu MQTT.

Příjem dat přes MQTT

Zigbee2MQTT publikuje měření ze ZiggyMeter jako zprávy MQTT, které může váš automatizační systém zpracovat.

• Výchozí vzor tématu: zigbee2mqtt/<friendly_name>
• Základní téma (zigbee2mqtt) lze změnit v nastavení Zigbee2MQTT.

Chcete-li vidět, co ZiggyMeter publikuje, přihlaste se k odběru tématu zařízení pomocí libovolného klienta MQTT.

Příklad (Mosquitto):

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

Výsledek:

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}

Pole null znamená, že elektroměr tuto hodnotu neposkytl.

Zobrazení dat

Ve webovém rozhraní Zigbee2MQTT otevřete stránku zařízení ZiggyMeter.

Užitečné jsou následující podstránky:

• Exposes — zobrazení měření, jako je výkon a teplota zařízení
• Clusters — procházení clusterů Zigbee vystavených zařízením
• Dev console — čtení a zápis atributů v clusterech koncových bodů

Aktualizace

Zigbee2MQTT můžete nakonfigurovat pro automatickou aktualizaci firmwaru ZiggyMeter. Viz příručka Zigbee2MQTT: Aktualizace Zigbee2MQTT OTA.

ZiggyMeter poskytuje soubory s OTA firmwarem a indexový soubor kompatibilní se Zigbee2MQTT. Během nastavení použijte tuto vzdálenou URL adresu indexu OTA: https://fw.ziggymeter.com/z2m_index.json

Řešení problémů

• Zařízení se nepřipojuje: povolte Permit join v Zigbee2MQTT, proveďte reset Zigbee (tlačítko na 4 s) a umístěte ZiggyMeter blízko koordinátoru.
• Žádné zprávy MQTT: potvrďte, že je Zigbee2MQTT připojeno k brokeru a že odebíráte správné základní téma a přátelský název.