Linux driver | Create sysfs interface in driver

Preface

In some Linux development boards, you can often see the echo method. Directly control the hardware or modify the driver, for example:

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

How to do this?

Actually, this is because the sysfs interface is provided in the driver for users to use, so that users can use the cat or echo command to View and modify the values ​​of certain variables in the driver.

The following describes how to create a sysfs interface in the driver.

sysfs interface creation

Basic steps:

1. UseDEVICE_ATTRDeclare a sys node

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

led_status: The node name displayed in the sys interface

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.