Zigbee2MQTT

Zigbee2MQTT to otwartoźródłowy most Zigbee. Jak sama nazwa wskazuje, zamienia ruch Zigbee na wiadomości MQTT, dzięki czemu ZiggyMeter może zasilać wszystko, co korzysta z MQTT — Home Assistant, Node-RED albo Twoje własne oprogramowanie.

Wymagania

• Koordynator Zigbee obsługiwany przez Zigbee2MQTT
• Działający Zigbee2MQTT połączony z brokerem MQTT
• Włączony ZiggyMeter z aktywnym Zigbee

Sparuj urządzenie

1. Otwórz frontend Zigbee2MQTT i włącz Permit join (na dole menu po lewej).

   

2. Przełącz ZiggyMeter w tryb dołączania:

   • Przycisk — kliknij 3 razy albo 4 razy, jeśli urządzenie śpi.
   • Interfejs webowy — Zigbee → ZIGBEE RESET.

3. Poczekaj, aż urządzenie pojawi się na liście Devices.

   

4. Opcjonalnie nadaj mu przyjazną nazwę. Ta nazwa staje się częścią tematu MQTT, więc wybierz ją, zanim napiszesz na niej automatyzacje.

WARNING

„Not supported” to nie błąd. Oznacza, że ZiggyMeter nie ma go w bazie urządzeń Zigbee2MQTT, a nie że nie działa. Wszystkie klastry są standardowe i dane płyną normalnie. Komunikat możesz spokojnie zignorować.

Szczegóły urządzenia

Kliknięcie urządzenia pokazuje jego szczegóły, w tym temat MQTT.

Przydatne podzakładki:

Zakładka	Co daje
Exposes	Pomiary — moc, energia, temperatura, bateria
Clusters	Surowe klastry Zigbee udostępniane przez urządzenie
Dev console	Bezpośredni odczyt i zapis atrybutów — narzędzie pierwszego wyboru, gdy wartość wygląda źle

Odbieranie danych

Zigbee2MQTT publikuje pomiary jako wiadomości MQTT.

• Domyślny wzorzec tematu: zigbee2mqtt/<friendly_name>
• Temat bazowy (zigbee2mqtt) jest konfigurowalny w ustawieniach Zigbee2MQTT

Zasubskrybuj dowolnym klientem MQTT:

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

Wiadomość wygląda tak:

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}

Końcówki _1 i _2 to punkty końcowe Zigbee — _1 to urządzenie, _2 to licznik. Zobacz Dokumentacja Zigbee.

INFO

Pole o wartości null oznacza, że licznik nie podał tej wartości, a nie że łącze Zigbee zawiodło. To, które pola są wypełnione, zależy wyłącznie od Twojego licznika.

Aktualizacje oprogramowania

Zigbee2MQTT może aktualizować ZiggyMeter automatycznie. Postępuj zgodnie z przewodnikiem Zigbee2MQTT o aktualizacjach OTA i użyj tego zdalnego adresu indeksu OTA:

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

WARNING

Zigbee OTA jest wolne. Trzymaj urządzenie zasilane i w zasięgu przez cały transfer — licz się z godzinami, nie minutami. Zobacz Aktualizacja oprogramowania → Zigbee OTA.

Rozwiązywanie problemów

Objaw	Sprawdź
Urządzenie nie dołącza	Czy permit join jest otwarte; wykonaj reset Zigbee (3 kliknięcia, 4 gdy śpi); przysuń urządzenie bliżej koordynatora
Brak wiadomości MQTT	Czy Zigbee2MQTT jest połączony z brokerem; czy subskrybujesz właściwy temat bazowy i przyjazną nazwę
Pola mają wartość null	Licznik nie zgłasza tych wartości — sprawdź odczyt w interfejsie webowym ZiggyMeter
Wartości nigdy się nie zmieniają	Nic nie wyzwala odczytów. Sprawdź harmonogram