iris light iris.2
Hue and brightness of the four RGB LEDs on the iris board. Brightness 0 means off.
Use
For the RGB light firmware of the iris board (ESP32-C3).
On the device
On connecting, the device announces this type with t= in @$ui and sends @$state whenever its state changes. Apps send commands to <cid>@.
@$name My iris light:Living room
@$ui t=iris.2
@$state h=0;b=0;h1=0;b1=0;h2=0;b2=0;h3=0;b3=0;h4=0;b4=0
State keys @$state
| Key | Values | Meaning |
|---|---|---|
h | 0–359° | Overall hue 0–359 (degrees on the color wheel: 0 red, 120 green, 240 blue) |
b | 0–100% | Overall brightness 0–100 (of the brightest LED) |
h1 | 0–359° | LED 1 hue 0–359 |
b1 | 0–100% | LED 1 brightness 0–100, 0 is off |
h2 | 0–359° | LED 2 hue 0–359 |
b2 | 0–100% | LED 2 brightness 0–100, 0 is off |
h3 | 0–359° | LED 3 hue 0–359 |
b3 | 0–100% | LED 3 brightness 0–100, 0 is off |
h4 | 0–359° | LED 4 hue 0–359 |
b4 | 0–100% | LED 4 brightness 0–100, 0 is off |
on | 1 when any LED is on |
Commands <cid>@
| Command | Meaning |
|---|---|
h={v} | Set every LED to hue {v} |
b={v} | Set every LED to {v}% brightness |
h1={v} | LED 1 hue |
b1={v} | LED 1 brightness, 0 turns it off |
h2={v} | LED 2 hue |
b2={v} | LED 2 brightness, 0 turns it off |
h3={v} | LED 3 hue |
b3={v} | LED 3 brightness, 0 turns it off |
h4={v} | LED 4 hue |
b4={v} | LED 4 brightness, 0 turns it off |
{v} is the slider or color value. Even for an unknown command the device should send its current state, so the app does not wait.
Implementation notes
- There is no separate power switch; brightness 0 is off. Devices should also accept on/off (turn on at the last brightness).
- Saturation is always full. A device that needs white adds its own command.
Default picture
This type has no default picture.
Examples
- iris-rgb — example page on arduino.iosignal.net
Type file
iosignal/devices/types/iris.2.json (rev 3) · CDN
The screen labels in the type file are in Korean; apps show them as written.