Skip to content

RGBW (PL)

fandf92 edited this page Oct 19, 2021 · 1 revision

RGBW - sterownik kolorowego oświetlenia LED

RGBW to sterownik oświetlenia RGBW LED. Moduł możemy zasilić napięciem 9-30V DC, natomiast wyjścia mogą sterować taśmami led 12/24 V o obciążalności do 4A na kanał. Więcej informacji znajdziesz tutaj.

Wspierane metody RestAPI

Urządzenie RGBW może pracować w oparciu o zdarzenia zdefiniowane w kalendarzu iCal. Więcej informacji o konfiguracji kalendarzy w urządzeniach F&F Fox można znaleźć tutaj.

Poniżej opisano metody wspierane przez urządzenie. Należy zwrócić uwagę na parametr blocking_time, pozwala on zawiesić działanie operacji zdefiniowanych w kalendarzu na czas jaki ustawimy (w milisekundach). Wywołanie metod obsługujących parametr blocking_time z wartością równą 0 lub pominięcie tego parametru spowoduje ustawienie stanu urządzenia i jego utrzymanie do najlbliżej zmiany wynikającej z harmonogramu (kalendarza).

Włączenie / wyłączenie urządzenia:

Włączenie urządzenia realizujemy poprzez poniższe wywołanie mtody, parametr state przyjmuje wartość on lub off.

Włączenie urządzenia state = on

/set_state/?state=on&blocking_time=0

Wyłącznie wyłączenie state = off.

/set_state/?state=off&blocking_time=0

Urządzenie po wywołaniu metody powinno zwrócić poniższą odpowiedź:

{
	"status":"ok"
}

Jeśli status jest różny od "ok" należy sprawdzić czy wartości przekazane do metody są poprawne. Więcej informacji o możliwych odpowiedziach znajdziesz tutaj.

Pobieranie stanu urządzenia:

Pobranie stanu urządzenia tj. sprawdzenie czy urządzenie jest włączone czy nie realizujemy za pomocą poniżej metody.

/get_state/

Urządzenie powino zwrócić poniższą odpowiedź. Jeśli odpowiedź jest inna należy sprawdzić czy poprawnie wywołaliśmy metodę. Więcej informacji o możliwych odpowiedziach znajdziesz tutaj.

{
	"state": "off",
	"status": "ok"
}
Ustawienie kolorów paleta RGB

Urządzenie pozwala ustawiać kolor taśmy LED w palecie kolorów RGB. Realizujemy to poprzez poniższą metodę z wykorzystaniem parametrów: kolor czerwony r=[0-255], kolor zielony g=[0-255], kolor niebieski b=[0-255]

/set_color_rgb/?r=0&g=255&b=0
Pobranie aktualnie ustawionego koloru paleta RGB

Pobieranie aktualnie ustawionego koloru w palecie RGB realizujemy poprzez poniższą metodę:

/set_color_rgb/?r=0&g=255&b=0

Przykładowa odpowiedź

{
	"r": "128",
	"g": "0",
	"b": "100",
	"status":"ok"
}
Ustawienie kolorów paleta HSV

Urządzenie pozwala ustawiać kolor taśmy LED w palecie kolorów HSV. Realizujemy to poprzez poniższą metodę z wykorzystaniem parametrów: hue h=[0-359], saturation s=[0-100], value v=[0-100]

/set_color_hsv/?h=120&s=100&v=100

Przykładowe wartości zwrócone z urządzenia:

{
	"h":"120",
	"s":"100",
	"v":"100",
	"status":"ok"
}
Ustawienie czasu przejścia:

Urządzenie RGBW pozwala zdefiniować czas przejścia pomiędzy zadanymi wartościami jasności, kolorów. Dzięki metodzie set_transition_time możemy zdefiniować czas w milisekundach poprzez parametr time oznaczający długość przejścia pomiędzy aktualną a zadaną wartością janości, koloru uzykując płynny efekt rozjaśniania, przejścia lub ściemniania. Poniżej przykład użycia:

/set_transition_time/?time=300/
Pobieranie czasu przejścia:

Pobranie aktualnego czasu przejścia:

/get_transition_time/

Przykładowe wartości zwrócone z urządzenia:

{
	"transition_time": "300",
	"status":"ok"
}
Ustawienie temperatury barwowej

Urządzenie pozwala ustawiać temperaturę barwową oraz jasność dla kanału białego. Poniżej przykład ustawienia temperatury (parametr balance) oraz jasności (parametr brightness):

set_color_temperature/?balance=50&brightness=50