21 Linux 自带的LED驱动
一、Linux 自带 LED 驱动使能
其实 Linux 内核自带 LED 抢夺那个，但在此之前需要配置 Linux 驱动来使能 LED 驱动。
输入以下命令：
cd linux/atk-mpl/linux/my_linux/linux-5.4.31
make menuconfig根据以下路径找到 LED 驱动：
→ Device Drivers
→ LED Support (NEW_LEDS [=y])
→LED Support for GPIO connected LEDs
配置完成后，Save 保存退出，之后重新编译 Linux，并且把新编译的 uImage 镜像启动开发版。
二、Linux 自带 LED 驱动简介
1.1 LED 驱动框架分析
进入 /linux/atk-mpl/linux/my_linux/linux-5.4.31/drivers/leds 目录，打开 leds-gpio.c 文件：
/* 这里其实和上一章节类似，都是这种结构，除了325行是新的之外 */
......
203 static const struct of_device_id of_gpio_leds_match[] = {
204 { .compatible = "gpio-leds", }, // 这里得和设备树的LED节点一样才能匹配成功
205 {},
206 };
207
208 MODULE_DEVICE_TABLE(of, of_gpio_leds_match);
......
316 static struct platform_driver gpio_led_driver = {
317 .probe = gpio_led_probe,
318 .shutdown = gpio_led_shutdown,
319 .driver = {
320 .name = "leds-gpio", // 这里设置为leds-gpio，那么/sys/bus/platform/drivers目录下也会出现一个这个名字
321 .of_match_table = of_gpio_leds_match,
322 },
323 };
......
325 module_platform_driver(gpio_led_driver); // 向Linux内核注册platform
1.2 module_platform_driver 分析
上一节的 LED 驱动中的 325 行是向 Linux 内核注册 platform。module_platform_driver 其实是 platform 驱动的注册和删除，把之前的给省略了：
static int __init gpio_led_driver_init(void)
{
return platform_driver_register (&(gpio_led_driver));
}
module_init(gpio_led_driver_init);
static void __exit gpio_led_driver_exit(void)
{
platform_driver_unregister (&(gpio_led_driver) );
}
module_exit(gpio_led_driver_exit);
三、设备树节点编写
Documentation/devicetree/bindings/leds/leds-gpio.txt 这个文档就是讲解 Linux 自带驱动对应的设备的设备树如何编写。这个就是led gpio 的编写，还有其他的文档。我们从 leds-gpio.txt 文档中了解到需要注意以下几点：
① 创建一个节点表示 LED 灯设备，比如 dtsleds，如果板子上有多个 LED 灯的话每个 LED灯都作为 dtsleds 的子节点；
比如：
dtsleds{
compatible = 'gpio-leds'; // 这里必须跟leds-gpio.c中的compatible一样
led0:{
label = "red"; // 这里表示led0是红色灯
gpios = <&gpioi 0 GPIO_ACTIVE_LOW>;
linux,default-trigger = "heartbeat"; // 设置为心跳指示灯
default-state = "off"; // 默认关闭
...
};
led1:{
label = "bule"; // 这里同上
gpios = <&gpiof 3 GPIO_ACTIVE_LOW>; // 这里看的硬件原理图是PF3
default-state = "off";
...
};
// 以此往下
};② dtsleds 节点的 compatible 属性值一定要为“gpio-leds”，看上面的比如；
③ 设置 label 属性，此属性为可选，每个子节点都有一个 label 属性， label 属性一般表示LED 灯的名字，比如以颜色区分的话就是 red、 bule，如上；
④ 每个子节点必须要设置 gpios 属性值，表示此 LED 所使用的 GPIO 引脚，如上；
⑤ 可以设置“ linux,default-trigger”属性值，也就是设置 LED 灯的默认功能，查阅 Documentation/devicetree/bindings/leds/common.txt
这个文档来查看可选功能，如上，比如：
backlight： LED 灯作为背光。
default-on： LED 灯打开。
heartbeat： LED 灯作为心跳指示灯，可以作为系统运行提示灯。
disk-activity： LED 灯作为磁盘活动指示灯。
ide-disk： LED 灯作为硬盘活动指示灯。
timer： LED 灯周期性闪烁，由定时器驱动，闪烁频率可以修改
⑥ 设置“default-state”属性值，可以设置为 on、 off 或 keep，为 on 的时候 LED 灯默认打开，为 off 的话 LED 灯默认关闭，为 keep 的话 LED 灯保持当前模式，如上。
第一步首先就是改设备树，打开 linux/atk-mpl/linux/my_linux/linux-5.4.31/arch/arm/boot/dts/stm32mp15-pinctrl.dtsi 创建这两个 LED 的 pinctrl 节点：
打开 /home/alientek/linux/atk-mpl/linux/my_linux/linux-5.4.31/arch/arm/boot/dts/stm32mp157d-atk.dts ，在"/"跟节点下添加 LED 设备子节点：
修改完后，输入命令：
cd
cd linux/atk-mpl/linux/my_linux/linux-5.4.31
make dtbs
cd arch/arm/boot/dts/
sudo cp stm32mp157d-atk.dtb /home/alientek/linux/tftpboot/ -f
四、运行测试
开启开发板，进入 sys/devices/platform/dtsleds/leds/ 目录中，可以看见之前在设备树中设置的 label。
查看 sys/class/leds/red/brightness 和 sys/class/leds/green/brightness 这两个文件，分别对应 LED0 和 LED1，通过操作这两个文件来实现 LED 的打开和关闭。
输入以下命令来打开：
echo 1 > /sys/class/leds/red/brightness # 打开 LED0
echo 1 > /sys/class/leds/green/brightness # 打开 LED1
# echo 在终端输出指定的文本或变量，这里我们指定brightness文件为1关闭：
echo 0 > /sys/class/leds/red/brightness #关闭 LED0
echo 0 > /sys/class/leds/green/brightness #关闭 LED1这里我搞错了，是控制绿灯亮灭，之后我改回来。其实我们可以在系统正常运行的时候加入 LED 让它一闪一闪的，打开 stm32mp157d-atk.dts 如下：
还是以上操作，重启开发板，就可以看到红色的 LED 不断的闪烁了。
总结
这里使用 Linux 自带的驱动去玩 LED，这里我觉得只能单纯的使用一个灯，不能和其他设备相互联动。这里或许是我的知识的浅薄，不知道还能否联动，有大佬知道的话麻烦说一下，谢谢。但是对于使用自带的很方便，只需要修改树即可。
