很多朋友在调试驱动的时候,都会遇到这样一个场景:
修改一个参数,然后调用某个内核中的函数。
比如将某个gpio的值拉高/拉低,修改某个寄存器的值等等。
如果每一个参数都通过字符设备的ioctl接口,增加对应的cmd,会比较麻烦,
研究内核的计算机大牛门怎么会容忍这种事发生,
于是设计出了DRIVER_ATTR
这个宏,完美解决这个需求。
下面一口君通过一个简单的实例,给大家讲解如何使用DRIVER_ATTR
。
该宏定义的文件如下:
include/linux/device.h
struct driver_attribute { struct attribute attr; ssize_t (*show)(struct device_driver *driver, char *buf); ssize_t (*store)(struct device_driver *driver, const char *buf, size_t count); }; #define DRIVER_ATTR(_name, _mode, _show, _store) \ struct driver_attribute driver_attr_##_name = __ATTR(_name, _mode, _show, _store)
__ATTR
定义于文件
include/linux/sysfs.h
#define __ATTR(_name, _mode, _show, _store) { \ .attr = {.name = __stringify(_name), .mode = _mode }, \ .show = _show, \ .store = _store, \ }
说明
_name:名称,也就是将在sys fs中生成的文件名称。 _mode:上述文件的访问权限,与普通文件相同,UGO的格式,最高权限0644,否则会报错。 _show:显示函数,cat该文件时,此函数被调用。 _store:写函数,echo内容到该文件时,此函数被调用。
定义一个写操作的回调函数:
static ssize_t peng_test_store(struct device_driver *driver, const char *buf, size_t count) { //对参数进行检查 if(NULL == buf || count >255 || count == 0 || strnchr(buf, count, 0x20)) return -1; printk("buf:%s count:%d\n",buf,count); return count; }
声明该函数与文件节点关系
static DRIVER_ATTR(peng, 0644, NULL, peng_test_store);
创建文件节点:
ret = driver_create_file(&(hello_driver.driver), &driver_attr_peng); if (ret < 0){ dev_err(&pdev->dev, "could not create sysfs files\n"); ret = -ENOENT; }
这几个名字之间关系如下:
本实验代码分为两个模块
device、driver,
分别定义结构体platform_device、platform_driver并注册到platform总线。
完整源码如下:
device.c
#include <linux/init.h> #include <linux/module.h> #include <linux/platform_device.h> #include <linux/ioport.h> static void hello_release(struct device *dev) { return; } static struct platform_device hello_device = { .name = "duang", .id = -1, .dev.release = hello_release, }; static int hello_init(void) { printk("hello_init \n"); return platform_device_register(&hello_device); } static void hello_exit(void) { printk("hello_exit \n"); platform_device_unregister(&hello_device); return; } MODULE_LICENSE("GPL"); module_init(hello_init); module_exit(hello_exit);
driver.c
#include <linux/init.h> #include <linux/module.h> #include <linux/kdev_t.h> #include <linux/fs.h> #include <linux/cdev.h> #include <linux/device.h> #include <asm/io.h> #include <linux/platform_device.h> #include <linux/ioport.h> static int hello_probe(struct platform_device *pdev); static int hello_remove(struct platform_device *pdev); static ssize_t peng_test_store(struct device_driver *driver, const char *buf, size_t count) { if(NULL == buf || count >255 || count == 0 || strnchr(buf, count, 0x20)) return -1; printk("buf:%s count:%d\n",buf,count); return count; } static DRIVER_ATTR(peng, 0644, NULL, peng_test_store); static struct platform_driver hello_driver = { .probe = hello_probe, .driver.name = "duang", .remove = hello_remove, }; struct resource *res; static int hello_probe(struct platform_device *pdev) { int ret; printk("match ok \n"); ret = driver_create_file(&(hello_driver.driver), &driver_attr_peng); if (ret < 0){ dev_err(&pdev->dev, "could not create sysfs files\n"); ret = -ENOENT; } return 0; } static int hello_remove(struct platform_device *pdev) { printk("hello_remove \n"); return 0; } static int hello_init(void) { printk("hello_init \n"); return platform_driver_register(&hello_driver); } static void hello_exit(void) { printk("hello_exit \n"); platform_driver_unregister(&hello_driver); return; } MODULE_LICENSE("GPL"); module_init(hello_init); module_exit(hello_exit);
Makefile
ifneq ($(KERNELRELEASE),) obj-m:=device.o driver.o else KDIR :=/lib/modules/$(shell uname -r)/build #KDIR :=/home/peng/linux-3.14 PWD :=$(shell pwd) all: make -C $(KDIR) M=$(PWD) modules clean: rm -f *.ko *.o *.mod.o *.symvers *.cmd *.mod.c *.order endif
第一步:编译
第二步:加载模块驱动
第三步:查看生成的文件节点:
第四步:
通过下面命令向节点输入一个数字(要管理员权限):
echo 1 > peng
由结果可知,我们通过向文件peng
写入一个字符,实现了调用函数peng_test_store()
,并且字符1
传递给了参数buf
,字符个数传递给了count
。
其中目录duang
是由结构体变量hello_driver
给出:
static struct platform_driver hello_driver = { .driver.name = "duang", };
需要借助结构体
struct attribute
以及函数
/** * sysfs_create_group - given a directory kobject, create an attribute group * @kobj: The kobject to create the group on * @grp: The attribute group to create * * This function creates a group for the first time. It will explicitly * warn and error if any of the attribute files being created already exist. * * Returns 0 on success or error. */ int sysfs_create_group(struct kobject *kobj, const struct attribute_group *grp)
此处就不验证了,直接从内核找个例子给大家学习下吧
drivers\input\touchscreen\ads7846.c
static ssize_t ads7846_pen_down_show(struct device *dev, struct device_attribute *attr, char *buf) { struct ads7846 *ts = dev_get_drvdata(dev); return sprintf(buf, "%u\n", ts->pendown); } static DEVICE_ATTR(pen_down, S_IRUGO, ads7846_pen_down_show, NULL); static ssize_t ads7846_disable_show(struct device *dev, struct device_attribute *attr, char *buf) { struct ads7846 *ts = dev_get_drvdata(dev); return sprintf(buf, "%u\n", ts->disabled); } static ssize_t ads7846_disable_store(struct device *dev, struct device_attribute *attr, const char *buf, size_t count) { struct ads7846 *ts = dev_get_drvdata(dev); unsigned int i; int err; err = kstrtouint(buf, 10, &i); if (err) return err; if (i) ads7846_disable(ts); else ads7846_enable(ts); return count; } static DEVICE_ATTR(disable, 0664, ads7846_disable_show, ads7846_disable_store); static struct attribute *ads784x_attributes[] = { &dev_attr_pen_down.attr, &dev_attr_disable.attr, NULL, }; static struct attribute_group ads784x_attr_group = { .attrs = ads784x_attributes, };
err = sysfs_create_group(&mydevice->dev.kobj, &ads784x_attr_group);
当然_ATTR不是独生子女,他还有一系列的姊妹__ATTR_RO宏只有读方法,__ATTR_NULL等等
如对设备的使用 DEVICE_ATTR 对驱动使用 DRIVER_ATTR 对总线使用 BUS_ATTR 对类别 (class) 使用 CLASS_ATTR
好了,大家后面在调试驱动的时候别忘了有这些宏可以使用。