qwe 发表于 2025-2-12 14:26:13

Linux驱动---/sys接口

目录

[*]一、伪文件 sys
[*]二、led_classdev结构体
[*]三、注册/注销LED

[*]3.1、led_classdev_register 函数
[*]3.2、led_classdev_unregister 函数

[*]四、/sys接口实现

[*]4.1、编写驱动程序
[*]4.2、驱动安装测试



一、伪文件 sys

伪文件(Pseudo File) 是 Linux 系统中一种特殊的文件,它不占用物理存储空间,而是由内核或系统动态生成,用于提供某种特定的功能或信息。我们本篇文章所整理的 /sys 便是伪文件,它提供了内核对象(如设备、驱动、总线)的属性和状态信息。

在上篇LED驱动文章中,我们通过在 /dev 下创建设备节点,提供了用户空间访问硬件设备的入口。不过这种情况下,用户只能通过open()、read()、write()等函数编程来操作设备。而 /sys 下的文件是内核为用户空间提供的高级抽象接口,直接读写文件(如cat、echo等)会触发内核中对应的回调函数,完成配置或信息获取。

这样,当我们回顾以前的知识就会发现,在学习Linux下的GPIO操作时为什么有 libgpiod 和 sysfs 两种操作方式,其实就是一直是通过编程操作 /dev 的设备,另一种是直接通过命令行操作 /sys 的设备。
二、led_classdev结构体

每个 LED 设备在内核中通过一个 led_classdev 结构体来表示。这个结构体包含了 LED 设备的各种属性和控制函数,例如亮度设置函数、最大亮度等,定义如下(只整理了常见部分):
struct led_classdev{        const char                *name;                     // 设备名字        enum led_brightness       brightness;             // LED 默认亮度        enum led_brightness       max_brightness;         // LED 的最大亮度    // 用于设置 LED 亮度的函数指针,不可休眠    void    (*brightness_set)(struct led_classdev *led_cdev, enum led_brightness brightness);    //用于设置 LED 亮度的函数指针,可以休眠    int   (*brightness_set_blocking)(struct led_classdev *led_cdev, enum led_brightness brightness);      struct device          *dev;    const char                  *default_trigger;}
(1)name:表示设备名字;

(2)brightness和max_brightness:这两个成员都是枚举类型 enum led_brightness 的变量,一个表示 LED 的初始化亮度,一个表示 LED 的最大亮度,这个枚举 类型定义了 LED 的亮度等级,来看看这个枚举类型:
enum led_brightness {        LED_OFF                = 0,        LED_ON                = 1,        LED_HALF        = 127,        LED_FULL        = 255,};
(3)default_trigger:该属性设置LED灯的默认动作,比如:
backlight:LED灯作为背光。default-on:LED灯打开heartbeat:LED灯作为心跳指示灯,可以作为系统运行提示灯。ide-disk:LED灯作为硬盘活动指示灯。timer:LED灯周期性闪烁,由定时器驱动,闪烁频率可以修改
(4)brightness_set:绑定 LED 亮度设置函数(不可休眠);

(5)brightness_set_blocking:绑定 LED 亮度设置函数(可以休眠);
三、注册/注销LED

3.1、led_classdev_register 函数

该函数将一个 LED 设备注册到 LED 子系统中,使其可以通过内核提供的统一接口进行操作。为 LED 设备初始化一些默认的属性,如亮度(brightness)、最大亮度(max_brightness)、触发器(trigger)等。同时在 /sys/class/leds/ 目录下为注册的 LED 设备创建一个对应的设备文件,用户可以通过该文件对 LED 进行操作。
int led_classdev_register(struct device *parent, struct led_classdev *led_cdev);//parent:指向父设备的指针。通常为 NULL,表示该 LED 设备没有父设备。如果提供了父设备,则 LED 设备会与父设备关联。//led_cdev:指向 led_classdev 结构体的指针,该结构体包含了 LED 设备的相关信息,如名称、亮度设置函数、最大亮度等。//成功时返回 0。失败时返回负的错误码.3.2、led_classdev_unregister 函数

该函数用于从 LED 子系统中注销一个之前注册的 LED 设备。删除 /sys/class/leds/ 目录下对应的设备文件。释放与该 LED 设备相关的内核资源。
void led_classdev_unregister(struct led_classdev *led_cdev);//led_cdev:指向之前通过 led_classdev_register 注册的 led_classdev 结构体的指针。功能四、/sys接口实现

4.1、编写驱动程序

在上一篇文章中,我们通过注册字符设备,在/dev下创建设备节点,从而实现了用户空间通过编程对硬件进行操作。接下来在这里将通过/sys接口实现用户通过命令行直接操作硬件设备。代码如下(设备树文件参考上篇文章,这里没有做修改):
//vim ldv2.c#include <linux/module.h>#include <linux/init.h>#include <linux/kernel.h>   #include <linux/fs.h>       #include <linux/errno.h>    #include <linux/types.h>   #include <linux/cdev.h>   #include <linux/slab.h>   #include <linux/version.h>#include <linux/uaccess.h>#include <linux/device.h>#include <linux/of.h>#include <linux/platform_device.h>#include <linux/gpio/consumer.h>#include <linux/leds.h>struct leds_desc{    struct led_classdev dev;   /* dev for led_classdev_register() */    struct gpio_desc   *gpio;    /* gpio instance for this led */    char                name; /* led name in /sys/class/leds */};struct led_priv{    int               nleds; /* number of leds */    struct leds_desc   *leds;/* leds array */};struct led_priv *priv;static void led_brightness_set(struct led_classdev *dev, enum led_brightness brightness){    struct leds_desc *led = container_of(dev, struct leds_desc, dev);    gpiod_set_value_cansleep(led->gpio, brightness?1:0 );}static int led_probe(struct platform_device *pdev){    struct device *dev = &pdev->dev;    struct leds_desc *led;    int ret, i;    /* allocate memory for private data structure */    priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);    if (!priv)      return -ENOMEM;    /* parser the number of LEDs from the device tree */    priv->nleds = gpiod_count(dev, NULL);    if ( priv->nleds < 1) {      dev_err(dev, "Failed to read leds gpio from device tree\n");      return -EINVAL;    }    dev_info(dev, "led driver probe for %d leds from device tree\n", priv->nleds);    /* allocate memory for all the leds */    priv->leds = devm_kzalloc(dev, priv->nleds*sizeof(*priv->leds), GFP_KERNEL);    if( !priv->leds )      return -ENOMEM;    /* parser and request GPIO pins from the device tree */    for (i = 0; i < priv->nleds; i++) {      priv->leds.gpio = devm_gpiod_get_index(dev, NULL, i, GPIOD_ASIS);      if (IS_ERR(priv->leds.gpio))            return PTR_ERR(priv->leds.gpio);      /* set GPIO as output mode and default off */      gpiod_direction_output(priv->leds.gpio, 0);    }    /* create sysfs file for each led */    for (i = 0; i < priv->nleds; i++) {      led = priv->leds+i;      snprintf(led->name, sizeof(led->name), "led%d", i);      led->dev.name = led->name;      led->dev.brightness_set = led_brightness_set;      ret = led_classdev_register(dev, &led->dev);      if (ret) {            dev_err(dev, "Failed to register LED[%d]\n", i);            goto failed_destroy;      }    }    platform_set_drvdata(pdev, priv);    return 0;failed_destroy:    for (--i; i >= 0; i--)      led_classdev_unregister(&priv->leds.dev);    return ret;}static int led_remove(struct platform_device *pdev){    struct led_priv *priv = platform_get_drvdata(pdev);    int i;    for (i = 0; i < priv->nleds; i++) {      led_classdev_unregister(&priv->leds.dev);    }    dev_info(&pdev->dev, "led driver removed.\n");    return 0;}static const struct of_device_id led_of_match[] = {    { .compatible = "rgb,leds", },    { /* sentinel */ },};MODULE_DEVICE_TABLE(of, led_of_match);static struct platform_driver led_driver = {    .probe = led_probe,    .remove = led_remove,    .driver = {      .name = "leds",      .of_match_table = led_of_match,    },};module_platform_driver(led_driver);MODULE_LICENSE("GPL");
Makefile文件如下:
ARCH ?= armCROSS_COMPILE ?= /opt/gcc-aarch32-10.3-2021.07/bin/arm-none-linux-gnueabihf-KERNAL_DIR ?= ~/igkboard-imx6ull/bsp/kernel/linux-imx/PWD :=$(shell pwd)obj-m += ledv2.omodules:    $(MAKE) ARCH=${ARCH} CROSS_COMPILE=${CROSS_COMPILE} -C $(KERNAL_DIR) M=$(PWD) modules    @make clearclear:    @rm -f *.o *.cmd *.mod *.mod.c    @rm -rf *~ core .depend .tmp_versions Module.symvers modules.order -f    @rm -f .*ko.cmd .*.o.cmd .*.o.d    @rm -f *.unsignedclean:    @rm -f *.komake4.2、驱动安装测试

将编译后的ledv2.ko下载到开发板上,并进行安装:
insmod ledv2.ko
在新的驱动中,我们并没有注册字符设备,所以 /dev/ 下并不会产生新的设备文件,而在 /sys/class/leds 路径下出现了我们的三个 Led 设备文件。
ls /dev/led*ls: cannot access '/dev/led*': No such file or directoryls /sys/class/leds/led0led1led2mmc0::mmc1::ls /sys/class/leds/led1/brightnessdevicemax_brightnesspowersubsystemtriggeruevent
接下来我们使用 echo 命令就可以控制相应 Led 亮灭了。
echo 1 > /sys/class/leds/led1/brightness//效果:绿灯亮echo 0 > /sys/class/leds/led1/brightness//效果:绿灯灭
从上面 Led 驱动程序编写过程中我们了解到,要实现一个设备的驱动供应用程序空间使用,可以有多种不同的实现方式。如果我们想要容易编程控制,则可以使用常规的字符设备驱动通过调用 ioctl() 系统调用实现;而如果想要在命令行或Shell脚本中直接实现,则我们可以使用 /sys/class 伪文件系统来实现。
页: [1]
查看完整版本: Linux驱动---/sys接口