浅色 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（完全关闭）之间的浮点数 on）。

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 构建。

这是设备端命令，而不是 fx 或 ffx 等主机端命令。 换言之，在调用此命令之前，您必须先访问 Fuchsia 设备的外壳。

如需以交互方式访问 Fuchsia 设备的 shell，请执行以下操作：

ffx component explore <component>

将 <component> 替换为有权访问的组件的名称 请参阅本页中记录的命令。

要调用单个命令并将输出返回到主机，请执行以下操作：

ffx component explore <component> -c "<command>"

将 <command> 替换为本页记录的其中一个命令。

源代码

lights-cli 的源代码：//src/ui/light/bin/lights-cli/