NXP i.MX8系列平台开发讲解 - 3.1 Linux 之LED子系统(一)

专栏文章目录传送门：返回专栏目录

---

文章目录

Linux 之LED子系统(一)

1. Linux 子系统框架图

2. LED子系统使用的场景

3. LED子系统使用

4. LED的trigger

---

        Linux内核的LED子系统是一种重要的框架，用于管理和控制设备上的LED指示灯。在嵌入式系统和物联网设备中，LED子系统发挥着关键作用，为开发者提供了一种统一的方式来控制和定制LED的行为和效果。

1. Linux 子系统框架图

内核空间：内核配置LED相关的GPIO，初始化，提供各种控制LED的接口，并且在Linux 系统需要通过设备节点形式呈现，可通过读写设备节点去控制。

用户空间：LED子系统还提供了一组用户空间API，供应用程序使用。这些API可以在应用程序中调用，以实现对LED的控制和操作。API通常包括打开和关闭LED、设置LED亮度和颜色、闪烁和动画效果等。

led子系统主要核心文件：

driver/leds/led-class.c
driver/leds/led-core.c
driver/leds/led-triggers.c
include/linux/leds.h

还有一些其他文件，按照自己配置情况是否选用

ls ./drivers/leds/
Kconfig ﾠ ﾠ ﾠ ﾠ ﾠ ﾠ ﾠ ﾠ leds-as3645a.c ﾠ ﾠ  leds-da903x.c ﾠ ﾠ ﾠ ﾠ leds-is31fl32xx.c  leds-lp3944.c ﾠ ﾠ ﾠ ﾠ leds-max77650.c ﾠ leds-ot200.c ﾠ ﾠ ﾠ  leds-spi-byte.c ﾠ ﾠ ﾠ led-triggers.c
led-class.c ﾠ ﾠ ﾠ ﾠ ﾠ ﾠ leds-asic3.c ﾠ ﾠ ﾠ  leds-da9052.c ﾠ ﾠ ﾠ ﾠ leds-ktd2692.c ﾠ ﾠ leds-lp3952.c ﾠ ﾠ ﾠ ﾠ leds-max77693.c ﾠ leds-pca9532.c ﾠ ﾠ  leds-ss4200.c ﾠ ﾠ ﾠ ﾠ Makefile
led-class-flash.c ﾠ ﾠ ﾠ leds-aw2013.c ﾠ ﾠ ﾠ leds-dac124s085.c ﾠ ﾠ leds-lm3530.c ﾠ ﾠ  leds-lp50xx.c ﾠ ﾠ ﾠ ﾠ leds-max8997.c ﾠ  leds-pca955x.c ﾠ ﾠ  leds-sunfire.c ﾠ ﾠ ﾠ  TODO
led-class-multicolor.c  leds-bcm6328.c ﾠ ﾠ  leds-el15203000.c ﾠ ﾠ leds-lm3532.c ﾠ ﾠ  leds-lp5521.c ﾠ ﾠ ﾠ ﾠ leds-mc13783.c ﾠ  leds-pca963x.c ﾠ ﾠ  leds-syscon.c ﾠ ﾠ ﾠ ﾠ trigger
led-core.c ﾠ ﾠ ﾠ ﾠ ﾠ ﾠ  leds-bcm6358.c ﾠ ﾠ  leds-fsg.c ﾠ ﾠ ﾠ ﾠ ﾠ  leds-lm3533.c ﾠ ﾠ  leds-lp5523.c ﾠ ﾠ ﾠ ﾠ leds-menf21bmc.c  leds-pm8058.c ﾠ ﾠ ﾠ leds-tca6507.c ﾠ ﾠ ﾠ  uleds.c
leds-88pm860x.c ﾠ ﾠ ﾠ ﾠ leds-bd2802.c ﾠ ﾠ ﾠ leds-gpio.c ﾠ ﾠ ﾠ ﾠ ﾠ leds-lm355x.c ﾠ ﾠ  leds-lp5562.c ﾠ ﾠ ﾠ ﾠ leds-mlxcpld.c ﾠ  leds-powernv.c ﾠ ﾠ  leds-ti-lmu-common.c
leds-aat1290.c ﾠ ﾠ ﾠ ﾠ  leds-blinkm.c ﾠ ﾠ ﾠ leds-gpio-register.c  leds-lm3601x.c ﾠ ﾠ leds-lp55xx-common.c  leds-mlxreg.c ﾠ ﾠ leds-pwm.c ﾠ ﾠ ﾠ ﾠ  leds-tlc591xx.c
leds-acer-a500.c ﾠ ﾠ ﾠ  leds-clevo-mail.c ﾠ leds.h ﾠ ﾠ ﾠ ﾠ ﾠ ﾠ ﾠ  leds-lm36274.c ﾠ ﾠ leds-lp55xx-common.h  leds-mt6323.c ﾠ ﾠ leds-rb532.c ﾠ ﾠ ﾠ  leds-tps6105x.c
leds-adp5520.c ﾠ ﾠ ﾠ ﾠ  leds-cobalt-qube.c  leds-hp6xx.c ﾠ ﾠ ﾠ ﾠ  leds-lm3642.c ﾠ ﾠ  leds-lp8501.c ﾠ ﾠ ﾠ ﾠ leds-net48xx.c ﾠ  leds-regulator.c ﾠ  leds-turris-omnia.c
leds-an30259a.c ﾠ ﾠ ﾠ ﾠ leds-cobalt-raq.c ﾠ leds-ip30.c ﾠ ﾠ ﾠ ﾠ ﾠ leds-lm3692x.c ﾠ ﾠ leds-lp8788.c ﾠ ﾠ ﾠ ﾠ leds-netxbig.c ﾠ  leds-s3c24xx.c ﾠ ﾠ  leds-wm831x-status.c
leds-apu.c ﾠ ﾠ ﾠ ﾠ ﾠ ﾠ  leds-cpcap.c ﾠ ﾠ ﾠ  leds-ipaq-micro.c ﾠ ﾠ leds-lm3697.c ﾠ ﾠ  leds-lp8860.c ﾠ ﾠ ﾠ ﾠ leds-nic78bx.c ﾠ  leds-sc27xx-bltc.c  leds-wm8350.c
leds-ariel.c ﾠ ﾠ ﾠ ﾠ ﾠ  leds-cr0014114.c ﾠ  leds-is31fl319x.c ﾠ ﾠ leds-locomo.c ﾠ ﾠ  leds-lt3593.c ﾠ ﾠ ﾠ ﾠ leds-ns2.c ﾠ ﾠ ﾠ  leds-sgm3140.c ﾠ ﾠ  leds-wrap.c

2. LED子系统使用的场景

1. 可以控制LED的亮灭，闪烁模式，可以灵活改变相关触发方式；

2. 方便控制LED的亮度相关

3. 其他控制GPIO同样适用

3. LED子系统使用

以：imx8mq 为例子

设备树添加：

    leds {
        compatible = "gpio-leds";
        pinctrl-names = "default";
        pinctrl-0 = <&pinctrl_leds>;
​
        vibrator {
            label = "vibrator";
            gpios = <&gpio5 2 GPIO_ACTIVE_HIGH>;
            default-state = "off";
        };
​
        led0 {
            label = "heartbeat";
            gpios = <&gpio4 10 GPIO_ACTIVE_LOW>;
            default-state = "on";
            /*linux,default-trigger = "heartbeat";*/
        };
​
        led1 {
            label = "led1";
            gpios = <&gpio3 20 GPIO_ACTIVE_HIGH>;
            default-state = "on";
        };
​
        led2 {
            label = "led2";
            gpios = <&gpio1 15 GPIO_ACTIVE_HIGH>;
            default-state = "off";
        };
    };

内核打开配置文件：

开启CONFIG_LEDS_TRIGGERS 和 CONFIG_LEDS_TRIGGER_TIMER

编译完毕后，加载是开发板可以看到：

evk_8mq:/ # ls /sys/class/leds
heartbeat led1 led2 mmc0:: mmc1:: vibrator
evk_8mq:/sys/class/leds/led1 # ls
brightness device max_brightness power subsystem trigger uevent

控制LED的亮灭

evk_8mq:/sys/class/leds/led1 # echo 0 > brightness
evk_8mq:/sys/class/leds/led1 # echo 1 > brightness

控制LED亮灭的等级

evk_8mq:/sys/class/leds/heartbeat # cat max_brightness
255

查看触发方式

evk_8mq:/sys/class/leds/led1 # cat trigger
[none] rc-feedback rfkill-any rfkill-none timer transient mmc1 mmc0 tcpm-source-psy-0-0022-online bq25700-charger-online cw2015-battery-charging-or-full cw2015-battery-charging cw2015-battery-full cw2015-battery-charging-blink-full-solid rfkill0

修改触发方式，改为时间，可以实现使得灯亮多久

evk_8mq:/sys/class/leds/heartbeat # echo timer > trigger
evk_8mq:/sys/class/leds/heartbeat # ls
brightness delay_on max_brightness subsystem uevent
delay_off  device  power      trigger
\#设置灯亮1秒钟
evk_8mq:/sys/class/leds/heartbeat # echo 1000 > delay_on
\#灭1秒钟
evk_8mq:/sys/class/leds/heartbeat # echo 1000 > delay_off

还有一种方式可以实现

evk_8mq:/sys/class/leds/led1 # echo transient > trigger
evk_8mq:/sys/class/leds/led1 # ls
activate  device  max_brightness state   trigger
brightness duration power      subsystem uevent

#控制LED1 亮一秒熄灭：

echo 1 > state

echo 1000 > duration

echo 1 > activate

在设备树中，可以看到里面有一个

/linux,default-trigger = "heartbeat";/

这个可以选定它做为什么触发，心跳方式

4. LED的trigger

LED的trigger （部分）种类和作用

触发器名称	作用
transient	在特定事件发生时暂时改变LED的状态
timer	基于时间的LED控制，周期性地改变LED的状态
oneshot	在接收到触发事件时触发一次状态改变，并持续一段时间
heartbeat	模拟心跳效果，使LED呼吸或闪烁
cpu	根据CPU使用情况控制LED的状态
timerange	在特定的时间范围内控制LED的状态
gpio	通过与GPIO引脚的状态变化关联，控制LED的状态改变
pattern	允许定义自定义的LED模式，创造各种自定义的视觉效果
audio	将LED与音频输入关联，实现音频可视化效果
backlight	控制背光LED的状态，根据环境亮度或显示状态调整亮度
heartbeat-morse	结合了心跳效果和摩尔斯电码，创造有趣的视觉效果

下一遍将会解析LED主要核心实现相关功能。