Podstawowa konfiguracja modułu RELAY
Moduły wykonawcze nippy™ wyposażone w wyjścia przekaźnikowe (RELAY, SSR) mogą być sterowane:
ZDALNIE: po dodaniu bramki nippy™ DIN Gateway (od gen.2), wykorzystując konfiguracyjny interfejs webowy bramki (wirtualne przyciski ON/OFF), webhooki (http) oraz z poziomu Home Assistant po skonfigurowaniu integracji MySensors (Ustawienia/Urządzenia oraz usługi/Dodaj integrację).
MAGISTRALNIE: korzystając z komunikacji P2P, wykorzystując urządzenia wejściowe np. nippy™ DIN Input 6 lub nippy™ BOX Input 2, podpięte do magistrali nippyBUS™.
LOKALNIE (AUTONOMICZNIE): wykorzystując wbudowane w modułach wejścia cyfrowe, jeśli są obecne. Moduły mogące pracować lokalnie w sposób autonomiczny zostały oznaczone jako SIMPLE np. nippy™ SIMPLE DIN Input/Relay 6/6, nippy™ SIMPLE DIN Roller Shutter 1 itp.
Zmiana stanu wyjścia sterownika nippy™ może być wyzwalana przez akcję zdefiniowaną przez użytkownika po odpowiedniej konfiguracji modułu wejściowego (lub kanału wejściowego modułu z serii Simple) wykorzystując do tego dowolny wyzwalacz (przycisk, czujnik ruchu, sondę zalania itp.).
Podstawowa konfiguracja wyjścia w module RELAY
Każdy moduł nippy™ wyposażony w wejścia przekaźnikowe posiada zdefiniowane 2 podstawowe typy działania: ON/OFF oraz TOGGLE. Użytkownik ma możliwość zdefiniowania typu wyjścia (Type) i innych parametrów dla każdego wyjścia (przekaźnika, SSR) osobno.
ON / OFF
Po zdefiniowaniu typu jako ON/OFF , wybrany kanał w przypadku komunikacji P2P reaguje na instrukcje w następujący sposób: włącz (PAYLOAD=1), wyłącz (PAYLOAD=0), przełącz (PAYLOAD=2).
TOGGLE
Po zdefiniowaniu typu jako TOGGLE , wybrany kanał w przypadku komunikacji P2P reaguje na instrukcje w następujący sposób: przełącz (PAYLOAD=1).
Timer – Czas w sekundach, po którym dany przekaźnik samoczynnie rozłączyć obwód (wyłączy się), niezależnie od zdefiniowanego typu wyjścia. Opcja ta jest sugerowana w przypadku wymogu sterowania impulsowego (ustawiając Timer na 1s) docelowego urządzenia (np. bramy wjazdowej, garażowej) oraz w innych przypadkach wymagających rozłączenia obwodu po czasie (np. sterowania oświetleniem klatki schodowej budynku).
Pola Master ID, Master ID CHILD oraz Count nie są obecnie wykorzystywane i nie należy ich uzupełniać.
Sterowanie wykorzystując webhooki (http)
W przypadku braku innych możliwości sterowania i integracji, użytkownik może skorzystywać z wbudowanej funkcjonalności webAPI wykorzystując podaną niżej składnię:
http://IP_BRAMKI/api?&id=x&type=2&child=y&command=1&key=&payload=n
id=x child=y
gdzie x to numer ID modułu wykonawczego, który ma odebrać instrukcję, a y to numer konkretnego kanału (przekaźnika, SSR) w wybranym module.
payload=n
gdzie n to instrukcja działania zgodna z zdefiniowanym w module typem wejścia np. włącz (PAYLOAD=1), wyłącz (PAYLOAD=2), przełącz (PAYLOAD=2).
W przypadku ustawienia hasła interfejsu webowego bramki (pole API Key), należy dodatkowo użyć go w każdej wysyłanej za pośrednictwem webAPI komendzie uzupełniając key=haslo_api_key.
UWAGA
Należy pamiętać, że przy restarcie zasilania wszystkie wyjścia modułów nippy™ SIMPLE DIN oraz kanały 4-9 modułu nippy™ DIN Relay 9, przez krótki moment (~1s) nie mają określonego stanu. Dlatego w przypadku użycia przekaźników w trybie impulsowym (np. do otwierania bramy garażowej, wjazdowej) zalecanym jest wykorzystanie kanałów 1-3 modułu nippy™ DIN Relay 9 lub dowolnego modułu BOX (np. nippy™ SIMPLE BOX Input/Relay 2/2), gdzie takie zjawisko nie występuje.
Widok ściemniacza nippy™ LED PWM w Home Assistant
Każdy kanał wyjścia przekaźnikowego nippy™ pojawia się w panelu Home Assistant w gotowej do działania formie (rys.2), od razu po sparowaniu modułu. Jeśli poprawnie podłączyliśmy urządzenie do bramki oraz wykonaliśmy parowanie modułu (krótki reset >1s) RELAY jest gotowy do działania.
Zalecanym jest dokonywanie zmian w konfiguracji modułu z poziomu interfejsu webowego bramki, gdyż jest to metoda prostsza, czytelniejsza i odporna na ewentualne pomyłki (listy rozwijane, pola wyboru, opis ustawień itp.). Jeśli użytkownik chciałby dokonać podstawowych zmian konfiguracyjnych modułu bezpośrednio z poziomu Home Assistant, udostępniamy taką możliwość (należy zachować szczególną ostrożność). W tym celu należy użyć tekstowego pola konfiguracyjnego, przypisanego do wybranego kanału (rys.3).
Format zapisu to a,b,c,d,e, gdzie:
a odpowiada polu konfiguracyjnemu Type (1 dla ON/OFF, 0 dla TOGGLE).
d odpowiada polu konfiguracyjnemu Timer i definiuje czas w sekundach (255 max), po którym dany przekaźnik ma samoczynnie rozłączyć obwód (wyłączyć się).
Pozostałe pola nie są obecnie wykorzystywane i należy je uzupełnić wpisując 0.