Linux驅(qū)動(dòng)中創(chuàng)建sysfs接口的方法

前言

在一些linux開(kāi)發(fā)板中，經(jīng)?？梢钥吹酵ㄟ^(guò)echo的方式來(lái)直接控制硬件或者修改驅(qū)動(dòng)，例如：

//燈滅
echo 0 >/sys/class/leds/firefly:blue:power/brightness 
//燈亮
echo 1 >/sys/class/leds/firefly:blue:power/brightness 

這是怎么做到呢？

實(shí)際上，這是因?yàn)樵隍?qū)動(dòng)中提供了sysfs接口給用戶(hù)使用，使得用戶(hù)可以通過(guò)cat或者echo命令來(lái)查看和修改驅(qū)動(dòng)中某些變量的值。

下面介紹驅(qū)動(dòng)中創(chuàng)建sysfs接口的方法。

sysfs接口創(chuàng)建

基本步驟：

1、使用DEVICE_ATTR聲明一個(gè)sys節(jié)點(diǎn)

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

led_status：在sys接口中顯示的節(jié)點(diǎn)名字

0600：表示操作這個(gè)led_status節(jié)點(diǎn)的權(quán)限

led_status_show：使用cat命令查看sys接口時(shí)調(diào)用的函數(shù)

led_status_store：使用echo命令往sys接口寫(xiě)入內(nèi)容時(shí)調(diào)用的函數(shù)

2、完成sys節(jié)點(diǎn)的讀寫(xiě)函數(shù)

static unsigned int led = 0;
/*
*  sys節(jié)點(diǎn)的讀函數(shù)
*  執(zhí)行 cat /sys/devices/platform/leds/led_status時(shí)會(huì)調(diào)用
*/
static ssize_t led_status_show(struct device *dev, struct device_attribute *attr, char *buf)
{
  //buf是通過(guò)cat命令顯示到終端的內(nèi)容，這里顯示led變量
 return sprintf(buf, "%s:%d.\\n", "led", led);
}

/**
*  sys節(jié)點(diǎn)的寫(xiě)函數(shù)
*  用echo命令往sys節(jié)點(diǎn)寫(xiě)入內(nèi)容時(shí)，會(huì)調(diào)用該函數(shù)
*/
static ssize_t led_status_store(struct device *dev, struct device_attribute *attr, const char *buf, size_t count)
{
  //寫(xiě)入的內(nèi)容會(huì)存放到buf中，這里將buf內(nèi)容賦值給led變量
 sscanf(buf, "%d", &led);

 return count;
}

示例中，led_status_show()函數(shù)和led_status_store()函數(shù)的作用分為打印led變量的值和 修改led變量的值 .

3、定義struct attribute和struct attribute_group數(shù)組

static struct attribute *led_attributes[]={
 
  /*上述使用了DEVICE_ATTR聲明節(jié)點(diǎn)名字為led_status，
  * 則struct attribute名字應(yīng)為：
  *  dev_attr_ + (節(jié)點(diǎn)名) + .attr
  * 所以名字為dev_attr_led_status.attr
  */
  &dev_attr_led_status.attr,
 NULL,
};


static const struct attribute_group led_attrs={
 .attrs = led_attributes,//引用上述struct attribute數(shù)組
};

上述使用了DEVICE_ATTR聲明節(jié)點(diǎn)名字為led_status， 則struct attribute名字應(yīng)為：dev_attr_ + (節(jié)點(diǎn)名) + .attr。所以名字為dev_attr_led_status.attr。

4、在probe函數(shù)中調(diào)用sysfs_create_group()函數(shù)注冊(cè)sysfs接口

完整例子

設(shè)備樹(shù)：

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

驅(qū)動(dòng)：

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");

驅(qū)動(dòng)加載后，就可以在linux終端中，使用cat和echo命令來(lái)查看和修改驅(qū)動(dòng)中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.