Linux 驱动开发 五十九：《common.txt》翻译

文档：linux-imx-4.1.15\Documentation\devicetree\bindings\leds\common.txt。

常见 LED 灯属性。

LED和 flash LED设备提供与电流调节器相同的基本功能，但扩展了 LED 和 flash LED 的特定功能，如闪烁模式，flash 超时，flash 故障和外部 flash 闪光灯模式。

许多 LED 设备公开多个电流输出，可以连接到一个或多个分立的 LED 组件。由于连接的排列会影响 LED 设备初始化的方式，所以 LED 组件必须与 LED 设备绑定紧密耦合。它们由父 LED 设备绑定的子节点表示。

子节点的可选属性：

• led-sources：LED 所连接的设备电流输出列表。输出由必须在 LED 设备绑定文档中定义的数字标识。
• label：这个 LED 的标签。如果省略，则标签取自节点名(不包括单元地址)。它必须唯一标识一个设备，即不能给其他 LED 类设备分配相同的标签。
• linux,default-trigger：这个参数，如果存在，是一个字符串，定义分配给 LED 的触发器。目前的触发器：
  • backlight：LED 将充当背光，由 framebuffer 系统控制。
  • default-on：LED 将打开(但是对于 LED -gpio 请参见 Documentation/devicetree/bindings/gpio/led.txt 中的 default-state 属性)。
  • heartbeat：LED 双闪烁以负载平均速率为基础。
  • ide-disk：LED 指示磁盘活动。
  • timer：LED 以固定的、可配置的速率闪烁。
• max-microamp：以微安为单位的 flash LED 设备用 LED)最大强度。
• flash-max-microamp：flash LED 的最大微安强度；如果 LED应该支持闪光模式，这是强制性的。
• flash-timeout-us：超时时间(以微秒为单位)，超过此时间，flash LED 将被关闭。

例如：

system-status {
	label = "Status";
	linux,default-trigger = "heartbeat";
	...
};

camera-flash {
	label = "Flash";
	led-sources = <0>, <1>;
	max-microamp = <50000>;
	flash-max-microamp = <320000>;
	flash-timeout-us = <500000>;
};