dimmer

Bloczek ściemniacza (dimmer) dostarcza dodatkowych funkcji do zarządzania oświetleniem w pomieszczeniach. Umożliwia płynne ściemnianie i rozjaśnianie światła z poziomu przycisku lokalnego, czujnika ruchu lub z poziomu innych części projektu.

Parametry konfiguracyjne

Nazwa parametru	Wartość
Przycisk czas wł. [s] / Button time ON [s] (btn_time)	Pole numeryczne określające czas w sekundach, przez jaki światło będzie zapalone po krótkim naciśnięciu przycisku lokalnego (wejście tag1). Wartość minimalna to 1 sekunda, wartość maksymalna to 43200 sekund (czyli 12 godzin). Ustawienie wartości zera spowoduje, że światło będzie włączane na stałe.
Przycisk wartość [%] / Button value [%] (btn_value)	Pole numeryczne określające wartość jasności w procentach, na jaką zostanie ustawione światło po krótkim naciśnięciu przycisku lokalnego (wejście tag1).
Przycisk czas przejścia [s] / Button transition time [s] (btn_transition_time)	Pole numeryczne określające czas w sekundach, przez jaki będzie następowało przejście do wartości jasności ustawionej przez przycisk lokalny (wejście tag1). Wartość minimalna to 0 sekund, wartość maksymalna to 600 sekund (czyli 10 minut). Ustawienie wartości zera spowoduje natychmiastową zmianę jasności.
Czujnik ruchu czas wł. [s] / Motion time ON [s] (motion_time)	Pole numeryczne określające czas w sekundach, przez jaki będzie świeciło światło po wykryciu ruchu od momentu zaniknięcia ruchu (wejście tag2). Wartość minimalna to 1 sekunda, wartość maksymalna to 43200 sekund (czyli 12 godzin). Ustawienie wartości zera spowoduje, że światło będzie włączane na stałe.
Czujnik ruchu wartość [%] / Motion value [%] (motion_value)	Pole numeryczne określające wartość jasności w procentach, na jaką zostanie ustawione światło po wykryciu ruchu (wejście tag2).
Czujnik ruchu czas przejścia [s] / Motion transition time [s] (motion_transition_time)	Pole numeryczne określające czas w sekundach, przez jaki będzie następowało przejście do wartości jasności ustawionej przez czujnik ruchu (wejście tag2). Wartość minimalna to 0 sekund, wartość maksymalna to 600 sekund (czyli 10 minut). Ustawienie wartości zera spowoduje natychmiastową zmianę jasności.
Pamiętaj ostatnią wartość / Remember last value (remember_last_value)	Włączenie tej funkcji sprawia, że ściemniacz zachowa ostatnią ustawioną wartość jasności dla przycisku - na przykład po dłuższym przytrzymaniu przycisku lokalnego (wejście tag1). Po ponownym włączeniu światła (np. poprzez krótkie naciśnięcie przycisku lokalnego lub podanie wartości liczbowej na wejście bloczka) światło zostanie ustawione na tę ostatnią zapamiętaną wartość. Jeśli opcja jest wyłączona, światło będzie zawsze ustawiane na wartość określoną w parametrze Przycisk wartość [%].
Wartość domyślna [%] / Default value [%] (default_value)	Pole numeryczne określające wartość jasności w procentach, na jaką zostanie ustawione światło ściemniacza po uruchomieniu projektu o ile bloczek nie zapamięta innej wartości.
Powtarzaj cyklicznie wysyłanie żądania do urządzenia / Repeat command periodically (repeat_command)	Włączenie tej opcji spowoduje, że bloczek ściemniacza będzie cyklicznie wysyłał żądania ustawienia jasności do podłączonego urządzenia (np. modułu ściemniacza). Częstotliwość wysyłania żądań wynosi 5 minut. Opcja ta jest przydatna w sytuacjach, gdy urządzenie może utracić ustawioną wartość jasności (np. po zaniku zasilania) i wymaga okresowego przypominania o żądanej wartości.
Przywróć stan po zaniku zasilania / Restore state after power loss (persistent_state)	Włączenie tej opcji powoduje, że po ponownym uruchomieniu systemu bloczek próbuje przywrócić ostatni utrwalony stan ściemniacza. Zapis trwały nie następuje od razu, tylko około 10 minut po ostatniej zmianie. Jeśli restart lub zanik zasilania nastąpi wcześniej, może zostać przywrócony wcześniejszy stan.

Obsługa wejścia

Bloczek ściemniacza przyjmuje liczby całkowite z zakresu od 0 do 100, które nie są przekazane za pomocą bloczka „tag”, ale bezpośrednio na wejście bloczka. Wartość ta określa żądaną jasność światła w procentach, która ma zostać ustawiona przez ściemniacz. Jeśli przekazana wartość jest spoza tego zakresu lub nie jest wartością całkowitą, to zostanie zignorowana. Jeśli ta wartość jest dodatnia (od 1 do 100), to światło zostanie włączone na tę wartość jasności na czas określony w parametrze konfiguracyjnym Przycisk czas wł. [s] / Button time ON [s]. Dodatkowo jeśli włączona jest opcja Pamiętaj ostatnią wartość / Remember last value, to ta wartość zostanie zapamiętana jako ostatnia ustawiona wartość jasności. W przypadku gdy przekazana wartość to 0, to światło zostanie wyłączone.

Wysłanie z bloczka command komendy set na wejście bloczka spowoduje ustawienie światła na wartość jasności dla przycisku lokalnego określoną w parametrze konfiguracyjnym Przycisk wartość [%] / Button value [%] na czas nieokreślony.

Wysłanie z bloczka command komendy reset na wejście bloczka spowoduje wyłączenie światła.

Dodatkowo bloczek ściemniacza obsługuje następujące wejścia oznaczone za pomocą bloczka „tag”:

Numer i nazwa wejścia	Opis działania
tag1: Przycisk lokalny / Local button	Wysłanie wartości true na wejście na linii tag1 informuje bloczek o naciśnięciu przycisku lokalnego, natomiast wysłanie wartości false informuje o jego zwolnieniu. Krótkie naciśnięcie (na mniej niż 3 sekundy) spowoduje wyłączenie światła lub jego włączenie na czas określony w parametrze konfiguracyjnym Przycisk czas wł. [s] / Button time ON [s] na wartość jasności określoną w parametrze Przycisk wartość [%] / Button value [%]. Długie naciśnięcie (na 3 sekundy lub dłużej) spowoduje rozpoczęcie rozjaśniania lub ściemniania światła z krokiem +/-5% w zakresie od 5% do 100% i odwrotnie, aż do zwolnienia przycisku lub osiągnięcia wartości granicznej. UWAGA: W momencie gdy przycisk jest wciśnięty, to wejście reaguje jedynie na jego puszczenie. Wszystkie pozostałe wartości przesyłane w tym czasie na wejście bloczka są ignorowane.
tag2: Czujnik ruchu / Motion sensor	Wysłanie wartości true na wejście na linii tag2 informuje bloczek o wykryciu ruchu przez czujnik ruchu, natomiast wysłanie wartości false informuje o zaniku ruchu. Po wykryciu ruchu światło zostanie włączone na wartość jasności określoną w parametrze konfiguracyjnym Czujnik ruchu wartość [%] / Motion value [%]. Po zaniku ruchu światło pozostanie włączone przez czas określony w parametrze Czujnik ruchu czas wł. [s] / Motion time ON [s], a następnie zostanie wyłączone.
tag3: Zmiana parametru Przycisk wartość [%] / Button value [%]	Wysłanie liczby całkowitej na wejście na linii tag3 spowoduje tymczasową zmianę wartości zdefiniowanej w parametrze konfiguracyjnym Przycisk wartość [%] / Button value [%] na wartość przesłaną na to wejście. Wartość ta będzie obowiązywać do momentu ponownego uruchomienia projektu, wysłania innej wartości na to wejście lub zmiany jasności dla przycisku lokalnego gdy opcja Pamiętaj ostatnią wartość / Remember last value jest włączona.
tag4: Zmiana parametru Czujnik ruchu wartość [%] / Motion value [%]	Wysłanie liczby całkowitej na wejście na linii tag4 spowoduje tymczasową zmianę wartości zdefiniowanej w parametrze konfiguracyjnym Czujnik ruchu wartość [%] / Motion value [%] na wartość przesłaną na to wejście. Wartość ta będzie obowiązywać do momentu ponownego uruchomienia projektu lub wysłania innej wartości na to wejście.
tag5: Zmiana parametru Przycisk czas wł. [s] / Button time ON [s]	Wysłanie liczby całkowitej z zakresu od 0 do 43200 na wejście na linii tag5 spowoduje tymczasową zmianę wartości zdefiniowanej w parametrze konfiguracyjnym Przycisk czas wł. [s] / Button time ON [s] na wartość przesłaną na to wejście. Wartość ta będzie obowiązywać do momentu ponownego uruchomienia projektu lub wysłania innej wartości na to wejście.
tag6: Zmiana parametru Czujnik ruchu czas wł. [s] / Motion time ON [s]	Wysłanie liczby całkowitej z zakresu od 0 do 43200 na wejście na linii tag6 spowoduje tymczasową zmianę wartości zdefiniowanej w parametrze konfiguracyjnym Czujnik ruchu czas wł. [s] / Motion time ON [s] na wartość przesłaną na to wejście. Wartość ta będzie obowiązywać do momentu ponownego uruchomienia projektu lub wysłania innej wartości na to wejście.
tag7: Zmiana parametru Przycisk czas przejścia [s] / Button transition time [s]	Wysłanie liczby całkowitej z zakresu od 0 do 600 na wejście na linii tag7 spowoduje tymczasową zmianę wartości zdefiniowanej w parametrze konfiguracyjnym Przycisk czas przejścia [s] / Button transition time [s] na wartość przesłaną na to wejście. Wartość ta będzie obowiązywać do momentu ponownego uruchomienia projektu lub wysłania innej wartości na to wejście.
tag8: Zmiana parametru Czujnik ruchu czas przejścia [s] / Motion transition time [s]	Wysłanie liczby całkowitej z zakresu od 0 do 600 na wejście na linii tag8 spowoduje tymczasową zmianę wartości zdefiniowanej w parametrze konfiguracyjnym Czujnik ruchu czas przejścia [s] / Motion transition time [s] na wartość przesłaną na to wejście. Wartość ta będzie obowiązywać do momentu ponownego uruchomienia projektu lub wysłania innej wartości na to wejście.

Wyjścia bloczka

Bloczek ściemniacza posiada jedno wyjście, które zwraca aktualną wartość jasności światła w procentach (od 0 do 100). Wartość ta jest aktualizowana za każdym razem, gdy następuje zmiana jasności światła. Dodatkowo wartość ta jest również zwracana po ponownym uruchomieniu projektu, odzwierciedlając ostatnio ustawioną jasność światła (jeśli opcja Przywróć stan po zaniku zasilania / Restore state after power loss jest włączona). Jeśli zaznaczona została opcja Powtarzaj cyklicznie wysyłanie żądania do urządzenia / Repeat command periodically, to wartość ta będzie również zwracana co 5 minut, nawet jeśli jasność światła nie uległa zmianie.

Błędy zwracane przez bloczek

Bloczek ściemniacza może zwracać następujące błędy:

Kod błędu	Opis błędu
Invalid motion_time.	W konfiguracji bloczka błędnie skonfigurowano parametr Czujnik ruchu czas wł. [s] / Motion time ON [s]. Należy ustawić wartość z zakresu od 0 do 43200 sekund.
Invalid motion_value.	W konfiguracji bloczka błędnie skonfigurowano parametr Czujnik ruchu wartość [%] / Motion value [%]. Należy ustawić wartość z zakresu od 0 do 100 procent.
Invalid motion_transition_time.	W konfiguracji bloczka błędnie skonfigurowano parametr Czujnik ruchu czas przejścia [s] / Motion transition time [s]. Należy ustawić wartość z zakresu od 0 do 600 sekund.
Invalid btn_time.	W konfiguracji bloczka błędnie skonfigurowano parametr Przycisk czas wł. [s] / Button time ON [s]. Należy ustawić wartość z zakresu od 0 do 43200 sekund.
Invalid btn_value.	W konfiguracji bloczka błędnie skonfigurowano parametr Przycisk wartość [%] / Button value [%]. Należy ustawić wartość z zakresu od 0 do 100 procent.
Invalid btn_transition_time.	W konfiguracji bloczka błędnie skonfigurowano parametr Przycisk czas przejścia [s] / Button transition time [s]. Należy ustawić wartość z zakresu od 0 do 600 sekund.
Invalid remember_last_value.	W konfiguracji bloczka błędnie skonfigurowano parametr Pamiętaj ostatnią wartość / Remember last value. Należy ustawić wartość logiczną (true/false).
Invalid default_value.	W konfiguracji bloczka błędnie skonfigurowano parametr Wartość domyślna [%] / Default value [%]. Należy ustawić wartość z zakresu od 0 do 100 procent.
Input disconnected.	Wejście bloczka jest odłączone. Należy podłączyć wejście do odpowiedniego źródła danych.
Too many tagX connections.	Wejście bloczka ma zbyt wiele połączeń na linii tagX, gdzie X to numer linii od 1 do 8. Należy ograniczyć liczbę połączeń do jednej na każdej linii tagX.
Timer error	Wystąpił błąd wewnętrznego timera bloczka. Należy ponownie uruchomić projekt.