Przewodnik integracji urządzeń Shelly Zigbee

Zmodyfikowano dnia czw, 31 Lip o 3:53 PO POŁUDNIU

Wymagania systemowe

Przed rozpoczęciem upewnij się, że posiadasz:

  • Koordynator Zigbee (np. Sonoff ZBDongle, ConBee II, SkyConnect) podłączony do systemu smart home

  • Zainstalowane i działające oprogramowanie do obsługi Zigbee, takie jak:

    • Home Assistant z integracją ZHA

    • Zigbee2MQTT wraz z brokerem MQTT

  • Urządzenie Shelly obsługujące Zigbee z fizycznym dostępem do jego przycisku

  • Komputer lub urządzenie mobilne podłączone do tej samej sieci co system automatyki domowej


Instrukcja krok po kroku

Krok 1: Przełączenie na firmware Zigbee (jeśli wymagane)

Niektóre urządzenia Shelly są domyślnie dostarczane z firmware Wi-Fi/Matter. Jeśli Twoje urządzenie obsługuje Zigbee, ale nie jest jeszcze w tym trybie:

  1. Szybko naciśnij przycisk 5 razy

  2. Odczekaj 5–10 sekund, aż urządzenie przełączy się w tryb Zigbee

Uwaga: Ten krok wykonujesz tylko raz – chyba że ponownie przełączysz się na tryb Wi-Fi.


Krok 2: Wejście w tryb parowania

Aby urządzenie mogło połączyć się z siecią Zigbee, musi być w trybie parowania:

  • Automatyczny tryb parowania – aktywowany po przywróceniu ustawień fabrycznych

  • Ręczne włączenie trybu parowaniaszybko naciśnij przycisk 3 razy


Krok 3: Parowanie urządzenia z siecią Zigbee

W Home Assistant (ZHA)

  1. Przejdź do:
    Ustawienia → Urządzenia i usługi → Dodaj integrację → Dodaj urządzenie Zigbee

  2. Kliknij „Dodaj urządzenie”

  3. Poczekaj, aż urządzenie Shelly zostanie wykryte

  4. Wybierz je i przypisz nazwę oraz lokalizację (jeśli chcesz)

W Zigbee2MQTT

  1. Otwórz interfejs internetowy Zigbee2MQTT (zwykle pod adresem http://<twoje-ip>:8080)

  2. Kliknij „Permit Join”

  3. Poczekaj na wykrycie urządzenia

  4. Zmień jego nazwę i skonfiguruj według potrzeb


Krok 4: Użycie urządzenia

Po poprawnym sparowaniu urządzenie udostępni odpowiednie encje, takie jak:

  • Przełączniki

  • Czujniki

  • Poziom baterii (jeśli obsługiwany)

Możesz teraz używać urządzenia w automatyzacjach, scenach lub sterować nim ręcznie z poziomu platformy Zigbee.


Krok 5 (zalecany): Aktualizacja firmware Zigbee

Dla zapewnienia stabilności i kompatybilności zaleca się zaktualizowanie urządzenia Shelly do najnowszej wersji firmware Zigbee.

⚠️ Uwaga: Aktualizacje OTA przez Zigbee nie są obecnie obsługiwane. Należy tymczasowo przełączyć urządzenie w tryb Wi-Fi/BLE.

Procedura aktualizacji

  1. Włącz tryb Wi-Fi/BLE
    Przytrzymaj tylny przycisk przez 5 sekund

  2. Połącz się z siecią Wi-Fi urządzenia

    • Po resecie urządzenie uruchomi własny punkt dostępowy

    • Połącz się z nim i otwórz przeglądarkę na http://192.168.33.1

  3. Zaktualizuj firmware z poziomu interfejsu www

    • Przejdź do Ustawienia → Firmware

    • Zainstaluj najnowszą dostępną wersję

  4. Sprawdź status Zigbee

Status ZigbeeZnaczenie
joinedUrządzenie połączone z siecią Zigbee
steeringUrządzenie w trybie parowania, szuka sieci
failedNie udało się połączyć – spróbuj ponownie sparować

Jeśli status to „failed”, naciśnij przycisk 3 razy szybko, by ponownie wejść w tryb parowania.


Rozwiązywanie problemów

ProblemRozwiązanie
Brak reakcji po 5 naciśnięciachUpewnij się, że naciśnięcia są szybkie i wyraźne; odczekaj 5–10 sekund
Urządzenie się nie pojawiaSprawdź, czy jest w trybie Zigbee; spróbuj ponownie naciskając 3 razy
Urządzenie widoczne jako „unknown”Odczekaj kilka minut; zaktualizuj oprogramowanie lub definicje urządzeń
Słaba jakość połączenia ZigbeeZbliż urządzenie do koordynatora lub dodaj inne urządzenia pełniące rolę routera Zigbee