Linux驱动 | 在驱动中创建sysfs接口

前言

在一些linux开发板中，经常可以看到通过echo的方式来直接控制硬件或者修改驱动，例如：

//灯灭
echo 0 >/sys/class/leds/firefly:blue:power/brightness
//灯亮
echo 1 >/sys/class/leds/firefly:blue:power/brightness

这是怎么做到呢？

实际上，这是因为在驱动中提供了sysfs接口给用户使用，使得用户可以通过cat或者echo命令来查看和修改驱动中某些变量的值。

下面介绍驱动中创建sysfs接口的方法。

sysfs接口创建

基本步骤：

1、使用DEVICE_ATTR声明一个sys节点

static DEVICE_ATTR(led_status, 0600, led_status_show, led_status_store);

led_status：在sys接口中显示的节点名字

0600：表示操作这个led_status节点的权限

led_status_show：使用cat命令查看sys接口时调用的函数

led_status_store：使用echo命令往sys接口写入内容时调用的函数

2、完成sys节点的读写函数

static unsigned int led = 0;
/*
*  sys节点的读函数
*  执行 cat /sys/devices/platform/leds/led_status时会调用
*/
static ssize_t led_status_show(struct device *dev, struct device_attribute *attr, char *buf)
{
//buf是通过cat命令显示到终端的内容，这里显示led变量
return sprintf(buf, "%s:%d.\n", "led", led);
}
/**
*  sys节点的写函数
*  用echo命令往sys节点写入内容时，会调用该函数
*/
static ssize_t led_status_store(struct device *dev, struct device_attribute *attr, const char *buf, size_t count)
{
//写入的内容会存放到buf中，这里将buf内容赋值给led变量
sscanf(buf, "%d", &led);
return count;
}

示例中，led_status_show()函数和led_status_store()函数的作用分为打印led变量的值和修改led变量的值.

3、定义struct attribute和struct attribute_group数组

static struct attribute *led_attributes[]={
/*上述使用了DEVICE_ATTR声明节点名字为led_status，
* 则struct attribute名字应为：
*  dev_attr_ + (节点名) + .attr
* 所以名字为dev_attr_led_status.attr
*/
&dev_attr_led_status.attr,
NULL,
};
static const struct attribute_group led_attrs={
.attrs = led_attributes,//引用上述struct attribute数组
};

上述使用了DEVICE_ATTR声明节点名字为led_status，
则struct attribute名字应为：dev_attr_ + (节点名) + .attr。所以名字为dev_attr_led_status.attr。

4、在probe函数中调用sysfs_create_group()函数注册sysfs接口

完整例子

设备树：

 leds:leds{
compatible = "xx,xx-led";
};

驱动：

static unsigned int led = 0;
static ssize_t led_status_show(struct device *dev, struct device_attribute *attr, char *buf)
{
return sprintf(buf, "%s:%d.\n", "led", led);
}
static ssize_t led_status_store(struct device *dev, struct device_attribute *attr, const char *buf, size_t count)
{
sscanf(buf, "%d", &led);
return count;
}
static DEVICE_ATTR(led_status, 0600, led_status_show, led_status_store);
static struct attribute *led_attributes[]={
&dev_attr_led_status.attr,
NULL,
};
static const struct attribute_group led_attrs={
.attrs = led_attributes,
};
static int xx_led_probe(struct platform_device *pdev)
{
sysfs_create_group(&pdev->dev.kobj, &led_attrs);
return 0;
}
static int xx_led_remove(struct platform_device *pdev)
{
sysfs_remove_group(&pdev->dev.kobj, &led_attrs);
return 0;
}
static const struct of_device_id xx_led_of_match[] = {
{.compatible = "xx,xx-led"},
};
static struct platform_driver xx_led_driver = {
.probe = xx_led_probe,
.remove = xx_led_remove,
.driver = {
.name = "xx-led",
.owner = THIS_MODULE,
.of_match_table = xx_led_of_match,
},
};
static int __init xx_led_init(void)
{
return platform_driver_register(&xx_led_driver );
}
static void __exit xx_led_exit(void)
{
platform_driver_unregister(&xx_led_driver);
}
module_init(xx_led_init);
module_exit(xx_led_exit);
MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("xx led driver");
MODULE_AUTHOR("Vincent");
MODULE_VERSION("V1.0.00");

驱动加载后，就可以在linux终端中，使用cat和echo命令来查看和修改驱动中led变量的值。例如：

//查看led变量的值
cat /sys/devices/platform/leds/led_status
led:0.
//修改led变量的值为9
echo 9 > /sys/devices/platform/leds/led_status
//查看
cat /sys/devices/platform/leds/led_status
led:9.