获取有关灯具的信息,并控制其亮度和颜色。
用法
lights-cli <device_path> print <id>
lights-cli <device_path> set <id> <brightness>
lights-cli <device_path> set <id> <red> <green> <blue>
lights-cli <device_path> summary
lights-cli list
命令
打印
lights-cli <device_path> print <id>
查看灯的亮度和颜色(如果适用)。报告的值是介于 0.0
(完全关闭)和 1.0
(完全开启)之间的浮点数。
set
lights-cli <device_path> set <id> <brightness>
设置灯的亮度。对于支持脉冲宽度调制的灯具,<brightness>
可以是 0.0
(完全关闭)到 1.0
(完全开启)之间的任何数字。对于仅支持开启和关闭状态的灯具,<brightness>
应仅为 0.0
(关闭)或 1.0
(开启)。
lights-cli <device_path> set <id> <red> <green> <blue>
设置灯的颜色。<red>
<green>
和 <blue>
可以是 0.0
和 1.0
之间的任意数字,用于控制每个颜色分量的强度。
汇总
lights-cli <device_path> summary
查看灯具总数,以及每个灯具的亮度和功能。目前支持的 capability 包括 Brightness
、Rgb
和 Simple
。Brightness
是一个介于 0.0
和 1.0
之间的值,如 set
命令的说明中所述。Rgb
是灯的 RGB 值。Simple
表示灯具是否支持脉冲宽度调制,还是仅支持简单的开启和关闭状态。
list
lights-cli list
列出所有灯的设备路径。
示例
节点“123”的所有示例(用于检查可用节点类型 ls /dev/class/light
)。
查看灯具的亮度
$ lights-cli /dev/class/light/123 print AMBER_LED
Value of AMBER_LED: Brightness 1.000000
查看灯的亮度和颜色
$ lights-cli /dev/class/light/123 print 1
Value of lp50xx-led-1: Brightness 0.745098 RGB 0.235294 0.176471 0.164706
设置灯的亮度
$ lights-cli /dev/class/light/123 set AMBER_LED 0.5
# This command exits silently.
设置一盏灯,使其显示紫色
$ lights-cli /dev/class/light/123 set 5 0.5 0 0.5
# This command exits silently.
查看灯具总数以及每个灯具的亮度和功能
$ lights-cli /dev/class/light/123 summary
Total 1 lights
Value of AMBER_LED: Brightness 0.500000
Capabilities: Brightness
列出所有灯的设备路径
$ lights-cli list
/dev/class/light/123
备注
访问此命令
此命令仅适用于某些诊断和测试 Fuchsia build。
这是设备端命令,而非 fx
或 ffx
等主机端命令。换句话说,在调用此命令之前,您必须先访问 Fuchsia 设备的 shell。
如需交互式访问 Fuchsia 设备的 shell,请执行以下操作:
ffx component explore <component>
将 <component>
替换为有权访问本页中记录的命令的组件的名称。
如需调用单个命令并将输出返回给主机,请执行以下操作:
ffx component explore <component> -c "<command>"
将 <command>
替换为本页面上记录的某个命令。
源代码
lights-cli
的源代码://src/ui/light/bin/lights-cli/