Przewodnik integracji urządzeń Shelly Zigbee

Wymagania systemowe

Upewnij się, że posiadasz następujące elementy i dostęp:

• 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, lub

  • Zigbee2MQTT z poprawnie skonfigurowanym brokerem MQTT

• Urządzenie Shelly z obsługą Zigbee oraz fizycznym dostępem do przycisku

• Komputer lub urządzenie mobilne podłączone do tej samej sieci lokalnej co platforma smart home

Konfiguracja krok po kroku

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

Niektóre urządzenia Shelly są domyślnie dostarczane z firmware Wi-Fi/Matter. Jeśli Twoje urządzenie obsługuje Zigbee, ale nie działa w trybie Zigbee, należy ręcznie zmienić tryb.

Dla wersji firmware poniżej 1.7.0:

1. Naciśnij szybko przycisk urządzenia 5 razy.

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

Uwaga: Ta operacja jest wymagana tylko raz, chyba że firmware zostanie później ręcznie przywrócone do trybu Wi-Fi.

Dla wersji firmware 1.7.0 i nowszych:

Zmiana firmware jest możliwa wyłącznie poprzez lokalny interfejs webowy:

Settings → Switch to Matter/Zigbee

Krok 2: Włączenie trybu parowania

Urządzenie Shelly musi znajdować się w trybie parowania, aby mogło połączyć się z siecią Zigbee.

• Automatyczny tryb parowania: uruchamiany po przywróceniu ustawień fabrycznych

• Ręczny tryb parowania: naciśnij szybko przycisk 3 razy

Krok 3: Parowanie urządzenia z siecią Zigbee

Dla Home Assistant (ZHA)

1. Przejdź do:
   Settings → Devices & Services → Add Integration → Add Zigbee Device

2. Kliknij Add Device.

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

4. Wybierz je i opcjonalnie przypisz nazwę oraz obszar.

Dla Zigbee2MQTT

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

2. Kliknij Permit Join.

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

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

Krok 4: Korzystanie z urządzenia

Po pomyślnym sparowaniu urządzenie udostępni dostępne encje Zigbee, takie jak:

• Przełączniki

• Czujniki

• Wskaźniki poziomu baterii (jeśli obsługiwane)

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

Krok 5 (Zalecane): Aktualizacja firmware Zigbee

Aby zapewnić optymalną wydajność i kompatybilność, zaktualizuj urządzenie Shelly do najnowszej wersji firmware Zigbee.

⚠️ Aktualizacje firmware muszą być obecnie wykonywane w trybie Wi-Fi/BLE. Aktualizacje OTA przez Zigbee nie są obecnie obsługiwane.

Procedura aktualizacji

1. Włącz tryb Wi-Fi/BLE
Naciśnij i przytrzymaj przycisk z tyłu przez 5 sekund, aby przełączyć tryb.

2. Połącz się z punktem dostępowym urządzenia

• Po resecie urządzenie nadaje lokalny punkt dostępowy Wi-Fi.

• Połącz się z nim i otwórz w przeglądarce http://192.168.33.1.

3. Zaktualizuj firmware przez interfejs webowy

• Przejdź do: Settings → Firmware

• Zainstaluj najnowszą dostępną wersję firmware zawierającą usprawnienia Zigbee.

4. Sprawdź status połączenia Zigbee

Jeśli status pokazuje „failed”, naciśnij szybko przycisk 3 razy, aby ponownie włączyć tryb parowania.

Rozwiązywanie problemów