Skip to main content

iris light iris.2

Hue and brightness of the four RGB LEDs on the iris board. Brightness 0 means off.

← Device types

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​

KeyValuesMeaning
h0–359°Overall hue 0–359 (degrees on the color wheel: 0 red, 120 green, 240 blue)
b0–100%Overall brightness 0–100 (of the brightest LED)
h10–359°LED 1 hue 0–359
b10–100%LED 1 brightness 0–100, 0 is off
h20–359°LED 2 hue 0–359
b20–100%LED 2 brightness 0–100, 0 is off
h30–359°LED 3 hue 0–359
b30–100%LED 3 brightness 0–100, 0 is off
h40–359°LED 4 hue 0–359
b40–100%LED 4 brightness 0–100, 0 is off
on1 when any LED is on

Commands <cid>@​

CommandMeaning
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.