Get information about lights and control their brightness.
lights-cli print <id> lights-cli set <id> <value> lights-cli summary
lights-cli print <id>
View the brightness of a light. The reported brightness value is a floating point number between 0.0
(completely off) and 1.0
(completely on).
lights-cli set <id> <brightness>
Set the brightness of a light. For lights that support pulse-width modulation <brightness>
can be any number between 0.0
(completely off) and 1.0
(completely on). For lights that only support simple on and off states <brightness>
should only be 0.0
(off) or 1.0
(on).
lights-cli summary
View the total light count as well as the brightness and capabilities of each light. Currently supported capabilities are Brightness
, Rgb
, and Simple
. Brightness
is a value between 0.0
and 1.0
as explained in the set
command's description. Rgb
is the RGB value of the light. Simple
indicates whether the light supports pulse-width modulation or only simple on and off states.
$ lights-cli print AMBER_LED Value of AMBER_LED: 1.000000
$ lights-cli set AMBER_LED 0.5 # This command exits silently.
$ lights-cli summary Total 1 lights Value of AMBER_LED: 0.500000 Capabilities: Brightness
<<./_access.md>>
Source code for lights-cli
: //src/ui/light/bin/lights-cli/