Przewodowe instalacje automatyki budynkowej cechują się najwyższą niezawodnością transmisji danych i stanowią standard w systemie DOMIQ. Istnieją jednak sytuacje, w których ułożenie nowej instalacji kablowej jest niemożliwe (np. w wykończonych już wnętrzach). Wychodząc naprzeciw tym wymaganiom, system DOMIQ oferuje zaawansowaną integrację z bezprzewodowymi urządzeniami marki Shelly.
Oprócz standardowych przekaźników i ściemniaczy pierwszej oraz drugiej generacji, system wspiera także nowoczesne komponenty bezprzewodowe, takie jak profesjonalne trójfazowe liczniki energii Shelly 3EM Pro czy głowice termostatyczne Shelly BLU TRV.
1. Komunikacja #
Urządzenia Shelly umożliwiają integrację z użyciem API HTTP oraz MQTT. W związku z tym, że API HTTP wymaga stałego odpytywania o bieżący stan urządzeń, wybraliśmy standard MQTT, który zapewnia w pełni dwukierunkową komunikację.
Wbudowany broker MQTT w module Base 2.0 obsługuje standard transmisji z poziomem dostarczania QoS 0 oraz wymaga aktywnej opcji Clean Session dla każdego podłączonego urządzenia. Ponadto nowa generacja modułu Base 2.0 wprowadza natywne wsparcie dla szyfrowania TLS w komunikacji sieciowej, co pozwala na bezpieczną, szyfrowaną integrację z zewnętrznymi usługami i gwarantuje najwyższy poziom bezpieczeństwa danych w sieci lokalnej.
Więcej informacji na temat standardu MQTT znaleźć można na oficjalnej stronie.
2. Konfiguracja #
Proces integracji składa się z dwóch etapów: skierowania strumienia danych w panelu Shelly oraz aktywacji nasłuchu w module DOMIQ Base 2.0.
Pierwszym etapem integracji jest prawidłowa konfiguracja modułów Shelly
2.1. Ustawienia sieci – przygotowanie modułu Shelly #
Wszystkie moduły Shelly fabrycznie startują w trybie Access Point – zatem każdy moduł tworzy swoją lokalną sieć WiFi. Piewszym krokiem jest zmiana ustawień sieciowych modułu, aby łączył się on z Twoją lokalną siecią WiFi.
- Podłącz się do sieci utworzonej przez moduł Shelly.
- Otwórz interfejs konfiguracyjny modułu – wpisz jego domyślny adres IP (patrz instrukcja obsługi Shelly) w polu adresu przeglądarki.
- W sekcji Networks lub Internet & Security wprowadź ustawienia umożliwiające podłączenie modułu
do twojej lokalnej sieci WiFi. Zalecamy ustawienie statycznego adresu IP lub utworzenie przypisania
adresu IP do adresu MAC karty sieciowej (należy to wykonać w ustawieniach routera). - Po zapisaniu ustawień otwórz ponownie interfejs konfiguracyjny Shelly, ale z wykorzystaniem
już przypisanego adresu IP w Twojej sieci lokalnej.
Stały adres powinien mieć również moduł Base, ponieważ urządzenia Shelly korzystają z niego podczas łączenia z brokerem MQTT.
Nazwy i rozmieszczenie opcji mogą różnić się zależnie od modelu Shelly i wersji jego oprogramowania.
2.2. Konfiguracja ręczna MQTT #
Konfigurację ręczną można wykorzystać, gdy panel automatycznej konfiguracji nie jest dostępny lub urządzenie wymaga ręcznego ustawienia połączenia.
W konfiguratorze Base włącz obsługę MQTT oraz integrację Shelly. W nowszych wersjach konfiguratora ustawienia integracji znajdują się w zakładce Integracje. W starszych wersjach opisanych w poprzedniej instrukcji opcje te były dostępne w zakładce Ustawienia; po ich włączeniu należało zapisać ustawienia i zrestartować Base.
Urządzenia generacji 1
- Zakładka Internet & Security -> Advanced – Developer Settings
- Zaznacz opcję Enable MQTT.
- Uzupełnij następujące pola formularza:
- Server – Wpisz adres IP modułu Base oraz domyślny nr portu dla komunikacji MQTT, czyli 1883. Przykład: 192.168.1.100:1883
- Zaznacz opcję Use custom MQTT prefix i w polu poniżej wpisz nazwę modułu Shelly. Nazwa musi być unikalna dla całej instalacji!
- Zaznacz opcję Clean Session.
- Upewnij się, że opcja Max QoS ma wartość 0.
- Następnie kliknij przycisk Save, aby zapisać konfigurację. Do zatwierdzenia ustawień wymagany jest
restart urządzenia, o czym poinformuje Cię interfejs Shelly. - Konfiguracja modułu zakończona.
Urządzenia generacji 2
- Zakładka Networks -> Mqtt
- Włącz opcję Enable.
- Uzupełnij następnie pola formularza:
- Connection type: MQTT
- W następnym polu wpisz nazwę modułu Shelly. Nazwa musi być unikalna dla całej instalacji!
- Włącz opcję RPC status notifications over MQTT.
- W polu tekstowym poniżej wpisz adres IP modułu Base oraz domyślny nr portu dla komunikacji MQTT, czyli 1883. Przykład: 192.168.1.100:1883
- Kliknij Apply aby zatwierdzić ustawienia.
- Konfiguracja modułu zakończona
2.3. Pozostałe ustawienia #
Na tym etapie moduł Shelly jest gotowy do integracji z DOMIQ/Base 2.0. Pozostałe ustawienia modułu np. rodzaj używanych wejść, harmonogramy i inne skonfiguruj wg potrzeb.
3. Aktywacja integracji w DOMIQ/Base 2.0 #
W najnowszych wersjach systemu dla modułu Base 2.0 zarządzanie usługą Shelly zostało w pełni zmodernizowane i uproszczone. Nie ma już potrzeby aktywowania protokołów w starej zakładce Ustawienia ani restartowania całego modułu.
- W panelu konfiguracyjnym modułu Base przejdź do centralnej zakładki Integracje.
- W sekcji poświęconej strukturze Shelly należy przestawić dedykowany przełącznik (suwak) z pozycji OFF na ON.
- Kliknij przycisk Konfiguruj znajdujący się obok suwaka, aby otworzyć okno zarządzania.
- System powinien automatycznie wykryć i wyświetlić moduły Shelly działające w sieci lokalnej. Jeśli na liście nie widzisz swojego urządzenia, użyj przycisku Odśwież lub Skanuj, aby wymusić ponowne przeszukanie sieci.
- Kliknij ikonę połączenia przy wybranym urządzeniu na liście, aby sparować je i połączyć z serwerem MQTT w module Base. Szczegółowe wskazówki dotyczące parowania oraz zmiany nazw urządzeń znajdziesz bezpośrednio w tym samym oknie pod nagłówkiem „Jak używać?”.
3.1. Sterowanie i odczyt stanu #
Jak już wspomnieliśmy wczesniej, moduły Shelly dzielą się na moduły pierwszej i drugiej generacji. Oprócz róznic sprzętowych, różnią się także protokołem integracyjnym. Protokół modułów generacji 2 został ujednolicony dla wszystkich urządzeń, podczas gdy urządzenia pierwszej generacji dość mocno różnią się między sobą pod względem parametrów, które można odczytać, a także komend, które można wysyłać do modułów. Opis obsługi modułów obu generacji podzieliliśmy na opis poszczególnych urządzeń i przedstawiliśmy w rozdziale 12.8 SHELLY.
4. Inne #
W kolejnych aktualizacjach dodano m.in.:
- Shelly Pro 3EM — System 3.0.3.0: obsługę trójfazowych liczników energii, w tym parametrów poszczególnych faz i wartości sumarycznych.
- Shelly BLU TRV — System 3.0.4.1: obsługę głowic termostatycznych, obejmującą temperaturę zadaną i aktualną, stan baterii, pozycję zaworu oraz polecenia kalibracji i trybu Boost.
- Ściemniacze Shelly Gen2+ — System 3.0.6.0 dla Base 2.0: poprawki ich obsługi.
Głowice Shelly BLU TRV komunikują się przez Bluetooth z bramką Shelly BLU Gateway Gen3. Połączenie z siecią lokalną i konfigurację MQTT realizuje się po stronie bramki.