Zigbee2MQTT

Zigbee2MQTT to otwartoźródłowy most (bridge) Zigbee. Jak sama nazwa wskazuje, konwertuje on dane Zigbee na wiadomości MQTT, umożliwiając integrację ZiggyMeter z systemami opartymi na MQTT. Korzystając z Zigbee, możesz odbierać wiadomości i pomiary z urządzenia przez MQTT.

MQTT to lekki protokół przesyłania wiadomości typu publikuj-subskrybuj. Jest powszechnie stosowany w IoT do wydajnej komunikacji między urządzeniami (czujnikami/aktuatorami) a systemami automatyki (na przykład Home Assistant lub Node‑RED).

Wymagania

• Koordynator Zigbee wspierany przez Zigbee2MQTT
• Uruchomione Zigbee2MQTT połączone z brokerem MQTT
• Włączony ZiggyMeter z aktywnym modułem Zigbee

Parowanie ZiggyMeter

1. Otwórz panel WWW Zigbee2MQTT i włącz Zezwalaj na dołączanie (Permit join) (lewy dolny róg menu).
   
2. Przełącz ZiggyMeter w tryb dołączania Zigbee:
   • Zalecane: przytrzymaj przycisk ZiggyMeter przez 4 sekundy (reset Zigbee).
   • Alternatywnie: w interfejsie WWW ZiggyMeter przejdź na stronę Zigbee i naciśnij ZIGBEE RESET.
3. Poczekaj, aż ZiggyMeter pojawi się na liście Urządzeń (Devices) w Zigbee2MQTT.
4. (Opcjonalnie) Ustaw przyjazną nazwę (Friendly name) w Zigbee2MQTT. Nazwa ta stanie się częścią tematu MQTT.

WARNING

Możesz zobaczyć komunikat "Not supported" (Nieobsługiwane). Oznacza to tylko, że ZiggyMeter nie znajduje się w bazie danych urządzeń Zigbee2MQTT. Możesz to bezpiecznie zignorować.

Szczegóły urządzenia

Kliknięcie w link urządzenia pokaże jego szczegóły, w tym temat (topic) MQTT.

Odbieranie danych przez MQTT

Zigbee2MQTT publikuje pomiary z ZiggyMeter jako wiadomości MQTT, które Twój system automatyki może konsumować.

• Domyślny wzorzec tematu: zigbee2mqtt/<przyjazna_nazwa>
• Podstawowy temat (zigbee2mqtt) można zmienić w ustawieniach Zigbee2MQTT.

Aby zobaczyć, co publikuje ZiggyMeter, zasubskrybuj temat urządzenia dowolnym klientem MQTT.

Przykład (Mosquitto):

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

Wynik:

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 oznacza, że licznik nie dostarczył danej wartości.

Przeglądanie danych

W panelu Zigbee2MQTT otwórz stronę urządzenia ZiggyMeter.

Przydatne są następujące zakładki:

• Exposes — podgląd pomiarów, takich jak moc i temperatura urządzenia.
• Clusters — przeglądanie klastrów Zigbee udostępnianych przez urządzenie.
• Dev console — odczyt i zapis atrybutów w klastrach punktów końcowych.

Aktualizacje

Możesz skonfigurować Zigbee2MQTT tak, aby automatycznie aktualizował oprogramowanie ZiggyMeter. Zobacz przewodnik Zigbee2MQTT: Zigbee2MQTT OTA updates.

ZiggyMeter dostarcza pliki oprogramowania OTA oraz plik indeksu zgodny z Zigbee2MQTT. Podczas konfiguracji użyj tego adresu URL zdalnego indeksu OTA: https://fw.ziggymeter.com/z2m_index.json

Rozwiązywanie problemów

• Urządzenie nie dołącza: włącz Permit join w Zigbee2MQTT, wykonaj reset Zigbee (przycisk przez 4s) i umieść ZiggyMeter blisko koordynatora.
• Brak wiadomości MQTT: upewnij się, że Zigbee2MQTT jest połączone z brokerem i zasubskrybuj poprawny temat podstawowy oraz przyjazną nazwę.