燈具

取得燈光相關資訊，並控制亮度和色彩。

使用方法

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 (完全關閉) 之間的浮點數。

設定

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 表示光源支援脈衝寬度調變，還是簡單開啟和關閉狀態。

清單

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/