Linux內核的LED設備驅動框架【轉】-有解無憂

/************************************************************************************

*本文為個人學習記錄，如有錯誤，歡迎指正，

*本文參考資料：

*　　　　　　　　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/linhaostudy/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/caozuo/13663.html

標籤：嵌入式

上一篇：電源管理-4種休眠方式狀態

下一篇：git基礎教程(三)