燈具

取得燈具的相關資訊，並控制燈具亮度和顏色。

用量

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 版本。

此為裝置端指令，而非 fx 或 ffx 等主機端指令。換句話說，您必須先存取 Fuchsia 裝置的殼層，才能呼叫這項指令。

如何以互動方式存取 Fuchsia 裝置的殼層：

ffx component explore <component>

將 <component> 替換為可存取本頁所述指令的元件名稱。

如何呼叫單一指令，並將輸出內容傳回主機：

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

將 <command> 替換為本頁列出的其中一項指令。

原始碼

lights-cli 的原始碼：//src/ui/light/bin/lights-cli/