浅色 CLI

获取灯具的相关信息并控制其亮度和颜色。

用法

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

查看灯的总数量以及每个灯的亮度和功能。目前支持的功能包括 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/