/************************************************************************************
*本文為個人學習記錄，如有錯誤，歡迎指正，
*本文參考資料：
* https://blog.csdn.net/qq_28992301/article/details/52410587
* https://blog.csdn.net/hanp_linux/article/details/79037610
************************************************************************************/
1. 驅動框架的概念
內核中驅動部分維護者針對每個種類的驅動設計一套成熟的、標準的、典型的驅動實作，并把不同廠家的同類硬體驅動中相同的部分抽出來自己實作好，再把不同部分留出介面給具體的驅動開發工程師來實作，這就叫驅動框架，即標準化的驅動實作,統一管理系統資源，維護系統穩定，
2. LED設備驅動框架概述
（1）LED設備的共性：
1）LED的亮與滅；
2）具有相應的設備節點（設備檔案），
（2）LED設備的不同點：
1）LED的硬體連接方式不同（GPIO不同）；
2）LED的控制方式不同（低或高電平觸發）；
3）等其他不同點，
因此，Linux中LED的驅動框架把所有LED設備的共性給實作了，把不同的地方留給驅動工程師去做，
（3）核心檔案：
/kernel/driver/leds/led-class.c
/kernel/driver/leds/led-core.c
/kernel/driver/leds/led-triggers.c
/kernel/include/linux/leds.h
（4）輔助檔案(根據需求來決定這部分代碼是否需要)：
/kernel/driver/leds/led-triggers.c
/kernel/driver/leds/trigger/led-triggers.c
/kernel/driver/leds/trigger/ledtrig-oneshot.c
/kernel/driver/leds/trigger/ledtrig-timer.c
/kernel/driver/leds/trigger/ledtrig-heartbeat.c
3. LED設備驅動框架分析
3.1 創建leds類
subsys_initcall是一個宏，它的功能是將其宣告的函式放到一個特定的段：.initcall4.init，
內核在啟動程序中，內核需要按照先后順序去進行初始化操作，因此，內核給是給啟動時要呼叫的所有初始化函式歸類，然后每個類按照一定的次序去呼叫執行，這些分類名就叫.initcalln.init，n的值從1到8，內核開發者在撰寫內核代碼時只要將函式設定合適的級別，這些函式就會被鏈接的時候放入特定的段，內核啟動時再按照段順序去依次執行各個段即可，module_init()、module_exit()也是一個宏，其功能與subsys_initcall相同，只是指定的段不同，
//所在檔案/kernel/include/linux/init.h
#define subsys_initcall(fn) __define_initcall("4",fn,4)
#define __define_initcall(level,fn,id) \
static initcall_t __initcall_##fn##id __used \
__attribute__((__section__(".initcall" level ".init"))) = fn
LED驅動框架使用subsys_initcall宏修飾leds_init()函式，因此leds_init()函式在內核啟動階段被呼叫，leds_init()函式的主要作業是：呼叫class_create()函式在/sys/class目錄下創建一個leds類目錄，
//所在檔案/kernel/driver/leds/led-class.c
static int __init leds_init(void)
{
leds_class = class_create(THIS_MODULE, "leds"); //在/sys/class目錄下創建一個leds類目錄
if (IS_ERR(leds_class))
return PTR_ERR(leds_class);
/*填充leds_class*/
leds_class->suspend = led_suspend;
leds_class->resume = led_resume;
leds_class->dev_attrs = led_class_attrs; //類屬性
return 0;
}
subsys_initcall(leds_init);
3.2 leds類屬性的定義與初始化
leds_class->dev_attrs規定了leds設備類的類屬性，其中的類屬性將被sysfs以檔案的形式匯出至/sys/class/leds目錄下，用戶空間通過對這些檔案的訪問來操作硬體設備，詳見Linux設備管理：sysfs檔案系統的功能及其應用，
led_class_attrs結構體陣列設定了leds設備類的屬性，即led硬體操作的物件和方法，分析可知，leds類設備的操作物件一共由3個brightness（LED的亮滅狀態）、max_brightness（LED最高亮度值）、trigger（LED閃爍狀態），對應的操作規則有讀寫，即show和store，這些操作規則內部其實呼叫了設備體led_classdev內的具體操作函式，譬如：當用戶層試圖寫brightness這個物件時，會觸發操作規則led_brightness_store，
//所在檔案/kernel/driver/leds/led-class.c
static struct device_attribute led_class_attrs[] =
{
__ATTR(brightness, 0644, led_brightness_show, led_brightness_store),
__ATTR(max_brightness, 0444, led_max_brightness_show, NULL),
#ifdef CONFIG_LEDS_TRIGGERS
__ATTR(trigger, 0644, led_trigger_show, led_trigger_store),
#endif
__ATTR_NULL,
};
/*
*所在檔案/kernel/include/linux/sysfs.h
*_name表示屬性的名字,即在sys中呈現的檔案，
*_mode表示這個屬性的讀寫權限,如0666, 分別表示user/group/other的權限都是可讀可寫，
*_show表示的是對此屬性的讀函式,當cat這個屬性的時候被呼叫，_stroe表示的是對此屬性的寫函式,當echo內容到這個屬性的時候被呼叫，
*/
#define __ATTR(_name,_mode,_show,_store) { \
.attr = {.name = __stringify(_name), .mode = _mode }, \
.show = _show, \
.store = _store, \
}
3.3 LED設備資訊初始化
在registerLED設備之前，需要先定義并初始化一個struct led_classdev結構體變數，該結構體包含了該LED設備的所有資訊，
初始化struct led_classdev結構體變數時，只需填充如下值即可，其余的在register程序中自動完成填充，
--name：LED設備目錄名稱；
--brightness：LED設備初始亮度；
--max_brightness：LED設備的最大亮度；
--void (*brightness_set)(struct led_classdev *led_cdev, enum led_brightness brightness)：該函式為實際操作LED硬體的函式，由驅動工程師根據具體的LED設備來實作；
--enum led_brightness (*brightness_get)(struct led_classdev *led_cdev)：該函式用于獲取LED設備的當前亮度值，LED驅動框架已實作led_get_brightness()函式（/kernel/drivers/leds/leds.h），將該函式的函式名賦予這個指標變數即可，
struct led_classdev {
const char *name; //LED設備名
int brightness; //LED設備的初始亮度
int max_brightness; //LED設備的最大亮度
int flags;
/* Lower 16 bits reflect status */
#define LED_SUSPENDED (1 << 0)
/* Upper 16 bits reflect control information */
#define LED_CORE_SUSPENDRESUME (1 << 16)
void (*brightness_set)(struct led_classdev *led_cdev, enum led_brightness brightness); //設定LED設備的亮度
enum led_brightness (*brightness_get)(struct led_classdev *led_cdev); //獲取LED設備的當前亮度
/* Activate hardware accelerated blink, delays are in
* miliseconds and if none is provided then a sensible default
* should be chosen. The call can adjust the timings if it can't
* match the values specified exactly. */
int (*blink_set)(struct led_classdev *led_cdev, unsigned long *delay_on, unsigned long *delay_off);
struct device *dev;
struct list_head node; /* LED Device list */
const char *default_trigger; /* Trigger to use */
#ifdef CONFIG_LEDS_TRIGGERS
/* Protects the trigger data below */
struct rw_semaphore trigger_lock;
struct led_trigger *trigger;
struct list_head trig_list;
void *trigger_data;
#endif
};
3.4 LED設備的register介面
LED設備驅動框架為驅動開發者提供在/sys/class/leds這個類下創建LED設備的介面，
當驅動呼叫led_classdev_register注冊了一個LED設備，那么就會在/sys/class/leds目錄下創建xxx設備，由sysfs創建該設備的一系列attr屬性檔案（brightness、max_brightness等）將被保存至該目錄下供用戶空間訪問，
//所在檔案/kernel/driver/leds/led-class.c
int led_classdev_register(struct device *parent, struct led_classdev *led_cdev)
{
//在/sys/class/leds設備類目錄下創建具體的設備目錄，目錄名由led_cdev->name指定
led_cdev->dev = device_create(leds_class, parent, 0, led_cdev, "%s", led_cdev->name);
if (IS_ERR(led_cdev->dev))
return PTR_ERR(led_cdev->dev);
#ifdef CONFIG_LEDS_TRIGGERS
init_rwsem(&led_cdev->trigger_lock);
#endif
/* add to the list of leds */
down_write(&leds_list_lock);
list_add_tail(&led_cdev->node, &leds_list);
up_write(&leds_list_lock);
//如果設備驅動在注冊時沒有設定max_brightness,則將max_brightness設定為滿即255
if (!led_cdev->max_brightness)
led_cdev->max_brightness = LED_FULL;
//如果在初始化struct_classdev *led_cdev時,設定了get_brightness方法,則讀出當前的brightness并更新
led_update_brightness(led_cdev);
#ifdef CONFIG_LEDS_TRIGGERS
led_trigger_set_default(led_cdev);
#endif
printk(KERN_DEBUG "Registered led device: %s\n", led_cdev->name); //在內核啟動程序中列印所注冊設備類的名稱
return 0;
}
3.5 leds類屬性的操作方法實作
當用戶在檔案系統下讀寫LED設備的屬性檔案時,就會呼叫這些屬性檔案的show和store方法，從而操作硬體，
（1）brightness屬性操作
1）當用戶cat /sys/class/leds/xxx/brightness時會呼叫led-class.c中的brightness_show函式，
//所在檔案/kernel/driver/leds/led-class.c
static ssize_t led_brightness_show(struct device *dev, struct device_attribute *attr, char *buf)
{
//根據device結構體獲取led_classdev結構體，其中包含了該LED設備的所有資訊
struct led_classdev *led_cdev = dev_get_drvdata(dev);
//如果在初始化struct_classdev *led_cdev時,設定了get_brightness方法,則讀出當前的brightness并更新
led_update_brightness(led_cdev);
return sprintf(buf, "%u\n", led_cdev->brightness); //將LED當前亮度值存入buf中
}
static void led_update_brightness(struct led_classdev *led_cdev)
{
if (led_cdev->brightness_get)
led_cdev->brightness = led_cdev->brightness_get(led_cdev);
}
static inline int led_get_brightness(struct led_classdev *led_cdev)
{
return led_cdev->brightness;
}
2）當用戶 echo 100 > /sys/class/leds/xxx/brightness時會呼叫led-class.c中的brightness_store函式，
//所在檔案/kernel/driver/leds/led-class.c
static ssize_t led_brightness_store(struct device *dev, struct device_attribute *attr, const char *buf, size_t size)
{
//根據device結構體獲取led_classdev結構體，其中包含了該LED設備的所有資訊
struct led_classdev *led_cdev = dev_get_drvdata(dev);
ssize_t ret = -EINVAL;
char *after;
unsigned long state = simple_strtoul(buf, &after, 10);
size_t count = after - buf;
if (isspace(*after))
count++;
if (count == size) {
ret = count;
if (state == LED_OFF)
led_trigger_remove(led_cdev);
led_set_brightness(led_cdev, state);//設定LED亮度
}
return ret;
}
//所在檔案/kernel/driver/leds/leds.h
static inline void led_set_brightness(struct led_classdev *led_cdev, enum led_brightness value)
{
if (value > led_cdev->max_brightness)
value = https://www.cnblogs.com/dongmll/p/led_cdev->max_brightness;
led_cdev->brightness = value;
if (!(led_cdev->flags & LED_SUSPENDED))
led_cdev->brightness_set(led_cdev, value); //呼叫led_classdev下的LED硬體操作函式brightness_set，該函式由驅動工程師完成撰寫，
}
（2）max_brightness屬性操作
當用戶當用戶cat /sys/class/leds/xxx/max_brightness時會呼叫led-class.c中的led_max_brightness_show函式，
//所在檔案/kernel/driver/leds/led-class.c
static ssize_t led_max_brightness_show(struct device *dev, struct device_attribute *attr, char *buf)
{
struct led_classdev *led_cdev = dev_get_drvdata(dev);
return sprintf(buf, "%u\n", led_cdev->max_brightness);//將最大亮度值保存至buf中
}
3.6 LED設備的unregister介面
LED設備驅動框架為驅動開發者LED設備驅動的卸載介面，呼叫led_classdev_unregister()函式卸載LED設備驅動，
//所在檔案/kernel/driver/leds/led-class.c
void led_classdev_unregister(struct led_classdev *led_cdev)
{
#ifdef CONFIG_LEDS_TRIGGERS
down_write(&led_cdev->trigger_lock);
if (led_cdev->trigger)
led_trigger_set(led_cdev, NULL);
up_write(&led_cdev->trigger_lock);
#endif
device_unregister(led_cdev->dev); //注銷設備類下的設備
down_write(&leds_list_lock);
list_del(&led_cdev->node);
up_write(&leds_list_lock);
}
//注銷設備類
static void __exit leds_exit(void)
{
class_destroy(leds_class);
}
module_exit(leds_exit);
轉載請註明出處，本文鏈接：https://www.uj5u.com/qita/238404.html
標籤：其他