取得燈具資訊，並控制燈具的亮度和顏色。
用量
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/