前言
在一些linux開發(fā)板中,經(jīng)常可以看到通過echo的方式來直接控制硬件或者修改驅(qū)動,例如:
//燈滅
echo 0 >/sys/class/leds/firefly:blue:power/brightness
//燈亮
echo 1 >/sys/class/leds/firefly:blue:power/brightness
這是怎么做到呢?
實際上,這是因為在驅(qū)動中提供了sysfs
接口給用戶使用,使得用戶可以通過cat
或者echo
命令來查看和修改驅(qū)動中某些變量的值。
下面介紹驅(qū)動中創(chuàng)建sysfs接口的方法。
sysfs接口創(chuàng)建
基本步驟:
1、使用DEVICE_ATTR
聲明一個sys
節(jié)點
static DEVICE_ATTR(led_status, 0600, led_status_show, led_status_store);
led_status
:在sys接口中顯示的節(jié)點名字
0600
:表示操作這個led_status節(jié)點的權(quán)限
led_status_show
:使用cat
命令查看sys接口時調(diào)用的函數(shù)
led_status_store
:使用echo
命令往sys接口寫入內(nèi)容時調(diào)用的函數(shù)
2、完成sys節(jié)點的讀寫函數(shù)
static unsigned int led = 0;
/*
* sys節(jié)點的讀函數(shù)
* 執(zhí)行 cat /sys/devices/platform/leds/led_status時會調(diào)用
*/
static ssize_t led_status_show(struct device *dev, struct device_attribute *attr, char *buf)
{
//buf是通過cat命令顯示到終端的內(nèi)容,這里顯示led變量
return sprintf(buf, "%s:%d.\\n", "led", led);
}
/**
* sys節(jié)點的寫函數(shù)
* 用echo命令往sys節(jié)點寫入內(nèi)容時,會調(diào)用該函數(shù)
*/
static ssize_t led_status_store(struct device *dev, struct device_attribute *attr, const char *buf, size_t count)
{
//寫入的內(nèi)容會存放到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é)點名字為led_status,
* 則struct attribute名字應(yīng)為:
* dev_attr_ + (節(jié)點名) + .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é)點名字為led_status
, 則struct attribute
名字應(yīng)為:dev_attr_ + (節(jié)點名) + .attr
。所以名字為dev_attr_led_status.attr
。
4、在probe函數(shù)中調(diào)用sysfs_create_group()
函數(shù)注冊sysfs
接口
完整例子
設(shè)備樹:
leds:leds{
compatible = "xx,xx-led";
};
驅(qū)動:
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");