fan-controller

Opis

Bloczek fan-controller służy do sterowania wentylatorem łazienkowym na podstawie stanu światła, komend z bloczka command oraz opcjonalnego pomiaru wilgotności.

Wentylator jest włączony wtedy, gdy aktywne jest przynajmniej jedno z poniższych źródeł:

światło świeci wystarczająco długo i upłynął czas opóźnienia startu,
po zgaszeniu światła trwa jeszcze czas opóźnienia wyłączenia,
aktywna jest komenda set z bloczka command, uruchomiona przy zgaszonym świetle,
wilgotność osiągnęła albo przekroczyła skonfigurowany próg.

Komenda reset z bloczka command natychmiast wyłącza wentylator. Dodatkowo może czasowo zablokować ponowną aktywację od światła i wilgotności zgodnie z opisem wejść.

Parametry konfiguracyjne

Nazwa parametru	Wartość
`light_on_delay_time`	Parametr obowiązkowy określający opóźnienie startu wentylatora po zapaleniu światła. Wartość podawana jest w sekundach. Dozwolony zakres to od 0 do 64800 sekund, czyli od 0 s do 18 godzin, z krokiem 0.1 s. Przykłady: `2` oznacza 2 s, a `10.5` oznacza 10.5 s.
`light_off_delay_time`	Parametr obowiązkowy określający opóźnienie wyłączenia wentylatora po zgaszeniu światła. Wartość podawana jest w sekundach. Dozwolony zakres to od 0 do 64800 sekund, czyli od 0 s do 18 godzin, z krokiem 0.1 s. Przykłady: `2` oznacza 2 s, a `10.5` oznacza 10.5 s.
`humidity_enabled`	Parametr obowiązkowy typu logicznego określający czy bloczek ma reagować na pomiar wilgotności.
`humidity_threshold`	Parametr obowiązkowy tylko wtedy, gdy `humidity_enabled` ma wartość true. Określa próg włączenia wentylatora przy wilgotności. Dozwolone są wartości od 1 do 99 procent. Gdy `humidity_enabled` ma wartość false, parametr ten jest ignorowany.

Obsługa wejścia

Bloczek posiada jedno wejście i rozpoznaje kilka rodzajów danych:

Wartość logiczna true oznacza zapalenie światła.
Wartość logiczna false oznacza zgaszenie światła.
Wartość liczbowa z zakresu 0..100 oznacza aktualny poziom wilgotności w procentach. Jeśli na wejście trafi wartość z częścią ułamkową, jej część ułamkowa zostaje obcięta przed dalszą analizą.
Komenda set z bloczka command oznacza natychmiastowe włączenie wentylatora.
Komenda reset z bloczka command oznacza natychmiastowe wyłączenie wentylatora.

Szczegóły działania:

Po zapaleniu światła bloczek rozpoczyna odliczanie light_on_delay_time. Jeśli światło zgaśnie przed końcem tego czasu, oczekujący start jest anulowany.
Po zgaszeniu światła bloczek rozpoczyna odliczanie light_off_delay_time, ale tylko wtedy, gdy źródło światła wcześniej rzeczywiście aktywowało wentylator albo wentylator został wymuszony komendą set z bloczka command przy zapalonym świetle.
Jeśli światło zostanie ponownie zapalone podczas aktywnego light_off_delay_time, wentylator nie wyłącza się i nie rozpoczyna ponownie odliczania light_on_delay_time. Bloczek traktuje taką sytuację tak, jakby światło nie zgasło, a aktywne off-delay zostaje natychmiast zastąpione aktywnym źródłem światła.
Komenda set z bloczka command przy zapalonym świetle natychmiast aktywuje wentylator bez uruchamiania opóźnienia wyłączenia. Jeśli światło było już aktywnym źródłem pracy wentylatora, komenda jest ignorowana.
Komenda set z bloczka command przy zgaszonym świetle uruchamia wentylator na czas light_off_delay_time. Jeśli taki czas już był odmierzany, zostaje zresetowany i rozpoczyna się od nowa. Późniejsze zapalenie światła podczas tego czasu powoduje natychmiastowe przejęcie pracy wentylatora przez źródło światła bez czekania na light_on_delay_time.
Jeśli humidity_enabled ma wartość true, wilgotność większa lub równa humidity_threshold aktywuje wentylator natychmiast, bez opóźnienia startu.
Komenda reset z bloczka command wyłącza wentylator i anuluje aktywne timery. Jeśli w chwili resetu światło jest zapalone, logika światła pozostaje zablokowana aż do zgaszenia światła i jego kolejnego zapalenia.
Komenda reset z bloczka command podczas aktywnej wilgotności blokuje też ponowną aktywację od wilgotności aż do chwili, gdy odczyt spadnie poniżej humidity_threshold.

Bloczek nie wymaga stosowania wejść oznaczanych za pomocą bloczka tag.

Wyjścia bloczka

Numer i nazwa wyjścia	Opis wyjścia
1. Status pracy wentylatora.	Zwraca wartość true, gdy wentylator jest aktywny, albo false, gdy wentylator jest wyłączony.

Błędy zwracane przez bloczek

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

Kod błędu	Opis błędu
`Invalid light_on_delay_time configuration.`	Parametr `light_on_delay_time` ma niepoprawną wartość albo nie został podany.
`Invalid light_off_delay_time configuration.`	Parametr `light_off_delay_time` ma niepoprawną wartość albo nie został podany.
`Invalid humidity_enabled configuration.`	Parametr `humidity_enabled` ma niepoprawną wartość albo nie został podany.
`Invalid humidity_threshold configuration.`	Parametr `humidity_threshold` ma niepoprawną wartość, gdy sterowanie wilgotnością jest włączone.