Rozdział 9.7. – Integracje (u::Lux)

Mnogość sterowanych urządzeń, sceny świetlne, sterowanie ogrzewaniem, wentylacją, klimatyzacją, to
tylko część możliwości inteligentnego domu. Zastosowanie w tym celu tradycyjnych włączników bardzo
komplikuje realizację części funkcjonalności lub zupełnie ją uniemożliwia. Wychodząc naprzeciw tym wymaganiom oferujemy włączniki u::Lux. W niewielkim rozmiarze tradycyjnego włącznika zamknięta została
wielka funkcjonalność, dzięki której zrealizujesz nawet bardzo złożone funkcje, a także z łatwością dopasujesz je do swoich potrzeb. Jeżeli w przyszłości Twoje preferencje się zmienią, wówczas bez problemu
zmienisz konfigurację włącznika u::Lux, aby stale spełniała Twoje oczekiwania.
Oczywiście należy pamiętać, że DOMIQ pozwala na integrację z wieloma innymi włącznikami, np.: z rodziny KNX czy LCN.

Włączniki u::Lux wyposażone są w cztery klawisze mechaniczne oraz kolorowy wyświetlacz. Każdy włącznik u::Lux może mieć zaprogramowanych do 128 klawiszy wirtualnych (32 strony po 4 klawisze). Natomiast każdy klawisz może sterować dowolnym urządzeniem/zmienną dostępną z poziomu modułu
DOMIQ Base 2.0. Klawisze wyposażone są w diody RGB LED, które mogą sygnalizować stan klawisza przez
świecenie lub miganie. Klawisze rozróżniają krótkie i długie naciśnięcie, a także moment puszczenia klawisza. Dzięki temu w łatwy sposób można zrealizować np. funkcję ściemniania oświetlenia w sposób znany z
aplikacji DOMIQ Remote lub z włączników ściennych LCN. Na ekranie wyświetlane są ikony oraz informacje o sterowanych urządzeniach/zmiennych. Treści wyświetlane na ekranie są w pełni programowalne,
dlatego w każdej chwili możesz zmienić wygląd i sposób działania włącznika, aby spełniał Twoje oczekiwania. Do dyspozycji jest domyślny zestaw ikon, jednakże istnieje możliwość użycia własnych grafik, aby
jeszcze lepiej dopasować włączniki do Twoich potrzeb i upodobań. Włączniki u::Lux pasują do ramek tradycyjnych włączników oświetlenia, dzięki czemu z większą łatwością dopasujesz ich wygląd do wnętrza
budynku.

Włącznik u::Lux wyposażony jest w czujnik jasności oświetlenia, który może posłużyć do realizacji algorytmu sterowania oświetleniem w oparciu o jasność w pomieszczeniu.

W celu oszczędzania energii, ekran włącznika może zostać wygaszony. Jego ponowne załączenie nastąpi
automatycznie, gdy włącznik wykryje zbliżającego się użytkownika (włącznik posiada wbudowany czujnik
zbliżeniowy).

Włącznik wyposażony jest w głośnik, dzięki czemu użytkownicy inteligentnego budynku mogą być informowani o zdarzeniach w systemie za pomocą dźwięków i komunikatów głosowych np. ostrzeżenie o pozostawionych otwartych oknach w momencie wychodzenia z domu. Włącznik u::Lux obsługuje pliki
dźwiękowe w formacie MP3 oraz WAV (tylko mono, 16-bit, próbkowanie 22050Hz, nieskompresowany
PCM).

Ponadto do włącznika u::Lux można podłączyć moduły rozszerzeń:

1. czujnik temperatury,
2. czujnik temperatury i wilgotności,
3. czujnik temperatury, wilgotności i dwutlenku węgla,
4. czujnik temperatury, wilgotności i detektor ruchu (wykrywa ruch w promieniu około 5m),
5. moduł dwóch wejść cyfrowych.

1. Komunikacja #

Włączniki u::Lux komunikują się poprzez protokół UDP przy użyciu sieci LAN. Sieć LAN służy także do ich
zasilania, zatem wymagany jest switch PoE lub dedykowany zasilacz marki u::Lux.

Włączniki po podłączeniu do sieci LAN i otrzymaniu adresu IP są automatycznie wykrywane przez moduł
DOMIQ Base 2.0. Ewentualna późniejsza zmiana adresu IP zostanie także automatycznie wykryta przez moduł Base. Każdy włącznik u::Lux ma swój unikalny identyfikator w obrębie instalacji, co bardzo upraszcza
rozróżnianie naciśnięć klawiszy, a także sterowanie funkcjami poszczególnych włączników.

2. Konfiguracja #

Do konfiguracji włączników służy dedykowane oprogramowanie u::Lux Config. Z wykorzystaniem u::Lux
Config m.in. utworzysz strukturę klawiszy (strony) i zaprogramujesz sposób ich działania, wybierzesz ikony,
przypiszesz adresy IP włącznikom itd. Opis konfiguracji włączników przy użyciu u::Lux Config nie jest częścią tego dokumentu. Wideo samouczki przedstawiające oprogramowanie u::Lux Config znajdziesz tutaj:
Samouczki u::Lux Config

Podstawowym elementem sterującym we włącznikach u::Lux jest aktor. Przez pojęcie aktora należy rozumieć zmienną o numerze unikalnym w całej instalacji, do której odnosić się może dowolna liczba klawiszy
w dowolnej liczbie włączników – numer aktora jest globalny w całym projekcie (instalacji). O aktorze można też myśleć jako o unikalnym identyfikatorze urządzenia lub zmiennej, którą dany klawisz lub grupa klawiszy ma sterować. W obrębie projektu może być 65535 aktorów (od 1 do 65535). Pojedynczy włącznik
u::Lux może wykorzystać do 128 aktorów.

Integracja pomiędzy DOMIQ Base 2.0 a włącznikami u::Lux polega na tym, że moduł Base potrafi odbierać komendy wysyłane do aktorów, a także sam zmieniać ich stan. W tym celu należy utworzyć mapowanie,
gdzie numer aktora jest przypisany do danego identyfikatora w obrębie modułu Base. Z tak utworzonymi
powiązaniami możliwe jest sterowanie urządzeniami i zmiennymi dostępnymi w module Base z poziomu
włączników u::Lux. Dzięki globalności aktorów, raz utworzone powiązanie pozwala na sterowanie z dowolnej liczby włączników, które mają odwołanie do danego aktora. Mapowanie jest niezbędne, aby włączniki u::Lux prezentowały bieżący stan urządzeń i zmiennych dostępnych w module Base, którymi sterują.

W dalszej części tego podrozdziału omówiony zostanie interfejs konfiguracyjny, który umożliwia tworzenie mapowania w module DOMIQ Base 2.0.

Zakładka ULUX podzielona jest na dwie części. Lewa część interfejsu to Lista aktorów. Zawiera ona wszystkie numery aktorów, dla których utworzone zostało mapowanie. Nad tabelą są dwa przyciski: Dodaj, który umożliwia dodanie nowego aktora do listy oraz Usuń, który służy do usuwania aktorów z listy. Prawa strona interfejsu zawiera tabelę Szczegóły, która pokaże się po wybraniu aktora i służy do konfigurowania parametrów mapowania dla wybranego aktora. Dostępne są następujące pola:

1. ID aktora (pole wymagane) – Unikalny numer aktora, który został nadany w oprogramowaniu
   uLux::Config.
2. Kanał (pole wymagane) – Identyfikator w obrębie modułu Base, z którym dany aktor ma być powiązany. Wpisany identyfikator musi odpowiadać zasobowi, którym chcemy sterować.
3. Opis – Pomocniczy opis, do łatwiejszej identyfikacji aktora.
4. Pole wyboru Wartość rzeczywista/Wartość edytowalna (pole wymagane).

Aktory mogą pracować w dwóch trybach, jako wartość edytowalna lub jako wartość rzeczywista. Bardzo istotne dla poznania sposobu działania włączników u::Lux jest zrozumienie różnicy między oboma trybami, która dotyczy sposobu prezentowania stanu aktora (sterowanego urządzenia/zmiennej).

Wartość edytowalna
Poniższy diagram ilustruje aktualizację stanu w trybie pracy aktora jako wartość edytowalna:

W trybie wartości edytowalnej modyfikacji podlega zmienna lokalna w oprogramowaniu włącznika u::Lux. Następnie jej wartość przesyłana jest do modułu Base wraz z numerem aktora. Moduł Base na podstawie utworzonego mapowania, przekazuje otrzymaną wartość jako komendę do przypisanego w konfiguracji identyfikatora i w ten sposób realizowane jest sterowanie. Po wykonaniu się komendy aktualizowany jest stan identyfikatora w Base, a następnie jego nowa wartość jest wysyłana z powrotem do włącznika u::Lux, w celu zapewnienia synchronizacji stanu sterowanego urządzenia/zmiennej. Zapewnia to również prawidłowość wyświetlania aktualnego stanu na ekranie włącznika w przypadku sterowania danym urządzeniem/zmienną przy pomocy innych dostępnych w DOMIQ sposobów, np. przy użyciu aplikacji Remote.

Wartość rzeczywista
Poniższy diagram ilustruje aktualizację stanu w trybie pracy aktora jako wartość rzeczywista:

Aktor pracujący w trybie wartości rzeczywistej wysyła jedynie informację o naciśnięciu lub zwolnieniu klawisza. Moduł Base przetwarza tę informację wg zaprogramowanych reguł i steruje przypisanym identyfikatorem. Następnie stan sterowanego identyfikatora (urządzenia/zmiennej) jest wysyłany z modułu Base
do włącznika/włączników u::Lux w celu aktualizacji stanu na wyświetlaczu.

W module Base dodaliśmy także funkcjonalność umożliwiającą rozróżnianie długości naciśnięcia klawisza.
W ten sposób rozróżniane jest krótkie naciśnięcie, długie naciśnięcie (powyżej 1 sekundy) oraz zwolnienie
klawisza. Informacja o naciśnięciu klawisza jest odbierana przez moduł Base jako zdarzenie, na które można zareagować dowolną akcją.

Opis zdarzeń generowanych przez interakcję z klawiszami znajduje się w rozdziale 12. Identyfikatory.
W przypadku, gdy mapowanie dotyczy identyfikatora, który posiada implementację funkcji ściemniania,
wówczas długie naciśnięcie rozpoczyna płynną zmianę wartości (rozjaśnianie/ściemnianie), a kolejne długie naciśnięcie zmienia kierunek zmian wartości na przeciwny. Puszczenie klawisza zatrzymuje zmianę
wartości.

Opcjonalnie istnieje możliwość przypisania komend, które będą wykonywane przy określonym rodzaju
interakcji z klawiszem. Wypełnienie poniżej opisanych pól jest opcjonalne (można wypełnić tylko jedno z
nich, dwa, wszystkie lub wcale). W przypadku, gdy pola zostaną puste, wówczas naciśnięcie klawisza zostanie obsłużone w sposób domyślny, opisany powyżej.

1. Krótko – Komenda, która zostanie wykonana przy krótkim (poniżej sekundy) naciśnięciu klawisza.
   Poniższy przykład ma zastosowanie również do pozostałych rodzajów akcji:
   • C.LCN.output.0.12.2=100
     Wysterowanie wyjścia nr 2 na 100% w module LCN o adresie 12.
2. Długo – Komenda, która zostanie wykonana przy długim (powyżej sekundy) naciśnięciu klawisza.
3. Puść – Komenda, która zostanie wykonana, gdy klawisz zostanie puszczony.

W górnej części interfejsu znajdują się trzy przyciski:

1. Zapisz – Zapisuje konfigurację zakładki ULUX.
   WAŻNE: utworzone powiązania nie będą aktywne dopóki nie zostanie zapisana konfiguracja.
   Wszystkie zmiany wprowadzone w konfiguracji są pamiętane lokalnie w przeglądarce do czasu zapisania konfiguracji.
2. Przywróć– Odtwarza ostatnią zapisaną konfigurację zakładki ULUX.
3. Skanuj – rozpoczyna skanowanie w poszukiwaniu włączników u::Lux obecnych w sieci LAN. Skanowanie należy wykonać po ręcznej zmianie adresów IP podłączonych włączników lub po ręcznej zmianie
   ich identyfikatorów w oprogramowaniu u::Lux Config. Jeżeli nie były wprowadzone żadne zmiany w
   tym zakresie, wówczas skanowanie nie jest potrzebne. Włączniki nowo podłączone do instalacji zostaną wykryte automatycznie.

Przykład 1:
W tym przykładzie zaprezentujemy tworzenie mapowania, które umożliwi sterowanie wyjściem ściemnianym LCN w sposób skokowy.

1. Kliknij przycisk Dodaj, aby dodać aktor.
2. ID aktora – wpisz numer aktora zgodnie z konfiguracją z oprogramowania u::Lux
   Config.
3. Kanał – wpisz identyfikator wyjścia ściemnianego w module LCN, np. LCN.output.0.10.1.
4. Wybierz pole Wartość edytowalna.
5. Kliknij przycisk Zapisz, aby potwierdzić konfigurację.

Mając wybrany tryb aktora jako Wartość edytowalna (taki sam tryb musi być wybrany w
oprogramowaniu uLux::Config). Następnie w oprogramowaniu uLux::Config należy zdefiniować parę klawiszy, w której jeden będzie zwiększał wartość, a drugi ją zmniejszał o określony skok.

Przykład 2:
W tym przykładzie zaprezentujemy natomiast płynne sterowanie wyjściem ściemnianym
LCN.

1. Kliknij przycisk Dodaj, aby dodać aktor.
2. ID aktora – wpisz numer aktora zgodnie z konfiguracją z oprogramowania u::Lux
   Config.
3. Kanał – wpisz identyfikator wyjścia ściemnianego w module LCN, np. LCN.output.0.10.1.
4. Wybierz pole Wartość rzeczywista.
5. Pola opcjonalne (Krótko, Długo, Puść) zostaw puste.
6. Kliknij przycisk Zapisz, aby potwierdzić konfigurację.

Mając wybrany tryb aktora jako Wartość rzeczywista (taki sam tryb musi być wybrany
w oprogramowaniu uLux::Config). Krótkie naciśnięcie spowoduje wysterowanie wyjścia na 100% lub 0% (w zależności od obecnego stanu), natomiast przy długim naciśnięciu wartość będzie zmieniała się płynnie. Zwolnienie klawisza zatrzyma zmianę.
Ten rodzaj sterowania można zrealizować z wykorzystaniem jednego klawisza.