一、簡介

相關(guān)文件；

• /include/linux/platform_device.h
• /drivers/base/platform.c

在linux設(shè)備驅(qū)動中，有許多沒有特定總線的外設(shè)驅(qū)動，在實際開發(fā)中，又需要使用到總線、驅(qū)動和設(shè)備模型這三個概念，故而linux提供了platform這個虛擬總線，掛接在platform總線上的驅(qū)動稱為platform驅(qū)動，由struct platform_driver描述，掛接在platorm總線上的設(shè)備稱為platform設(shè)備，由struct platform_device描述。

在linux內(nèi)核的驅(qū)動源碼中，可以看見很多基于platform驅(qū)動框架的驅(qū)動案例實現(xiàn)。

二、platform總線

在linux內(nèi)核中，使用struct bus_type描述一個總線，為了抽象出platform這個虛擬總線，其定義如下（/drivers/base/platform.c）：

structbus_typeplatform_bus_type={
.name="platform",
.dev_groups=platform_dev_groups,
.match=platform_match,
.uevent=platform_uevent,
.pm=&platform_dev_pm_ops,
};

platform總線的注冊由platform_bus_init()完成：

int__initplatform_bus_init(void)
{
interror;

early_platform_cleanup();

error=device_register(&platform_bus);
if(error)
returnerror;
error=bus_register(&platform_bus_type);
if(error)
device_unregister(&platform_bus);
of_platform_register_reconfig_notifier();
returnerror;
}

該函數(shù)在linux內(nèi)核啟動過程中，在driver_init()中被調(diào)用，從而向linux內(nèi)核注冊了platform總線。

三、platform設(shè)備和驅(qū)動的匹配過程

在定義platform總線的時候就定了該總線下設(shè)備和驅(qū)動的具體匹配過程，由platform_match()實現(xiàn)：

staticintplatform_match(structdevice*dev,structdevice_driver*drv)
{
structplatform_device*pdev=to_platform_device(dev);
structplatform_driver*pdrv=to_platform_driver(drv);

/*Whendriver_overrideisset,onlybindtothematchingdriver*/
if(pdev->driver_override)
return!strcmp(pdev->driver_override,drv->name);

/*AttemptanOFstylematchfirst*/
if(of_driver_match_device(dev,drv))
return1;

/*ThentryACPIstylematch*/
if(acpi_driver_match_device(dev,drv))
return1;

/*Thentrytomatchagainsttheidtable*/
if(pdrv->id_table)
returnplatform_match_id(pdrv->id_table,pdev)!=NULL;

/*fall-backtodrivernamematch*/
return(strcmp(pdev->name,drv->name)==0);
}

從上述代碼可知，platform設(shè)備和驅(qū)動的匹配分為了四種方式處理：

• 1、基于設(shè)備樹的匹配方式。

struct device_driver結(jié)構(gòu)中有個名為of_match_table的成員變量，此成員變量保存著驅(qū)動的compatible匹配表，在設(shè)備樹中的每個設(shè)備節(jié)點的compatible屬性會和of_match_table表中的所有成員比較，查看是否存在相同的條目，如果存在則表示設(shè)備和此驅(qū)動匹配，設(shè)備和驅(qū)動匹配成功以后probe函數(shù)就會執(zhí)行（這個過程是由linux設(shè)備驅(qū)動模型中的總線去完成）。

• 2、ACPI的匹配方式。

• 3、id_table 匹配。

每個struct platform_driver有一個id_table成員變量，用于保存很多id信息，這些id信息存放著這個platform驅(qū)動所支持的驅(qū)動類型。

• 4、比較name字段

如果第三種匹配方式的id_table不存在，就直接比較驅(qū)動和設(shè)備的name字段是否相等，如果相等則匹配成功；反之匹配不成功。

一般設(shè)備驅(qū)動為了兼容性都支持設(shè)備樹和無設(shè)備樹兩種匹配方式。也就是第一種匹配方式一般都會存在，第三種和第四種只要存在一種就可以，一般用的最多的還是第四種，也就是直接比較驅(qū)動和設(shè)備的name字段，因為這種方式最簡單了。

四、platrom驅(qū)動和platform設(shè)備

前文已經(jīng)提到：掛接在platform總線上的驅(qū)動稱為platform驅(qū)動，由struct platform_driver描述，掛接在platorm總線上的設(shè)備稱為platform設(shè)備，由struct platform_device描述。要想開發(fā)基于platform設(shè)備驅(qū)動驅(qū)動框架的驅(qū)動程序，一定離不開這兩個數(shù)據(jù)結(jié)構(gòu)。首先來看看platform驅(qū)動的描述者struct platform_driver，該結(jié)構(gòu)定義如下（/include/linux/platform_device.h）：

structplatform_driver{
int(*probe)(structplatform_device*);
int(*remove)(structplatform_device*);
void(*shutdown)(structplatform_device*);
int(*suspend)(structplatform_device*,pm_message_tstate);
int(*resume)(structplatform_device*);
structdevice_driverdriver;
conststructplatform_device_id*id_table;
boolprevent_deferred_probe;
};

• probe：當驅(qū)動與設(shè)備匹配成功以后.probe函數(shù)就會執(zhí)行，這是一個非常重要的函數(shù)，一般驅(qū)動的提供者都會設(shè)計該函數(shù)。
• remove：當platform驅(qū)動移除的時候，.remove指向的函數(shù)將執(zhí)行。
• shutdown、suspend和resume：與電源管理相關(guān)的函數(shù)。
• driver：為device_driver結(jié)構(gòu)體變量，相當于C++中的基類，提供了最基礎(chǔ)的驅(qū)動框架。plaform_driver繼承了這個基類，然后在此基礎(chǔ)上又添加了一些特有的成員變量。
• id_table：描述platform設(shè)備的id_table表，platform總線匹配驅(qū)動和設(shè)備的時候會使用。
• prevent_deferred_probe：布爾類型變量（內(nèi)部參數(shù)），用于防止驅(qū)動程序請求延遲probe，以避免進一步的徒勞的探測嘗試。

再看看platform設(shè)備的描述者struct platform_device，定義如下（/include/linux/platform_device.h）：

structplatform_device{
constchar*name;
intid;
boolid_auto;
structdevicedev;
u32num_resources;
structresource*resource;

conststructplatform_device_id*id_entry;
char*driver_override;/*Drivernametoforceamatch*/

/*MFDcellpointer*/
structmfd_cell*mfd_cell;

/*archspecificadditions*/
structpdev_archdataarchdata;
};

• name ：name表示設(shè)備名字，該參數(shù)要和所使用的platform驅(qū)動的name字段相同，否則設(shè)備就無法匹配到對應(yīng)的驅(qū)動。
• id：設(shè)備id。
• dev：linux內(nèi)核面向?qū)ο蟮木唧w體現(xiàn)，用于描述platform_device的基類。
• num_resources：表示資源的數(shù)量。
• resource：表示資源，也就是設(shè)備的信息，比如外設(shè)寄存器等。Linux內(nèi)核使用struct resource結(jié)構(gòu)體表示資源。
• id_entry：platform設(shè)備對應(yīng)的id匹配表實例，在platform總線匹配驅(qū)動和設(shè)備的時候會使用到。

五、platform驅(qū)動設(shè)計

platform驅(qū)動設(shè)計的總體思路分為兩種：

• （1）使用【struct platform_device + struct platform_driver】的方式實現(xiàn)。

在這種實現(xiàn)方式中，需要實現(xiàn)描述設(shè)備信息的struct platform_device結(jié)構(gòu)，并需要使用platform_device來描述具體的設(shè)備信息，然后使用platform_device_register()函數(shù)將設(shè)備信息注冊到 Linux 內(nèi)核中；如果不再使用platform了，可以通過platform_device_unregister()函數(shù)注銷相應(yīng)的platform設(shè)備。

這種方式在不支持設(shè)備樹的linux內(nèi)核中使用！

• （2）使用【struct platform_driver + 設(shè)備樹】的方式來實現(xiàn)。

在編寫 platform 驅(qū)動的時候，首先定義一個struct platform_driver結(jié)構(gòu)體變量，然后實現(xiàn)結(jié)構(gòu)體中的各個成員變量，重點是實現(xiàn)匹配方法以及probe 函數(shù)。當驅(qū)動和設(shè)備匹配成功以后.probe函數(shù)就會執(zhí)行，具體的驅(qū)動程序在 probe 函數(shù)里面編寫。當定義并初始化好 platform_driver 結(jié)構(gòu)體變量以后，需要在驅(qū)動入口函數(shù)里面調(diào)用platform_driver_register()函數(shù)向Linux內(nèi)核注冊一個platform驅(qū)動。

注意，如果linux內(nèi)核支持設(shè)備樹，就可以不需要再使用struct platform_device來描述設(shè)備，直接使用設(shè)備樹去描述設(shè)備的信息。當然，如果一定要用struct platform_device來描述設(shè)備信息也是可以的。基于新版的linux內(nèi)核的platform驅(qū)動的開發(fā)，通常是通過設(shè)備樹來描述設(shè)備信息，我們只需要實現(xiàn)對應(yīng)的platform驅(qū)動即可。

六、代碼示例

本小節(jié)基于【struct platform_driver + 設(shè)備樹】給出一個基本的platform驅(qū)動的設(shè)計結(jié)構(gòu)。

首先使用設(shè)備樹描述設(shè)備的信息：

debug_device_node{
compatible="iriczhao_debug";
pinctrl-0=<&pinctrl_usdhc2_8bit>;
pinctrl-1=<&pinctrl_usdhc2_8bit_100mhz>;
pinctrl-2=<&pinctrl_usdhc2_8bit_200mhz>;
bus-width=<8>;
non-removable;
status="okay";
};

上述代碼描述了一個名為debug_device_node的設(shè)備節(jié)點，給出了compatible屬性值。

platform驅(qū)動設(shè)計：

#include
#include
#include
#include

#include

#include

#include

staticintplatform_demo_probe(structplatform_device*dev)
{printk("
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
");
printk("doplatform_demo_probe
");
printk("
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
");

return0;
}

staticintplatform_demo_remove(structplatform_device*dev)
{
printk("doplatform_demo_remove
");
return0;
}

staticconststructof_device_idplatform_demo_id[]={
{.compatible="iriczhao_debug"},
{/*Sentinel*/}
};

MODULE_DEVICE_TABLE(of,platform_demo_id);

staticstructplatform_driverplatform_demo_driver={
.probe=platform_demo_probe,
.remove=platform_demo_remove,
.driver={
.name="dd",
.of_match_table=platform_demo_id,
}
};


staticint__initplatform_demo_init(void)
{
printk("doplatform_demo_init
");

returnplatform_driver_register(&platform_demo_driver);
}

staticvoid__exitplatform_demo_exit(void)
{
printk("doplatform_demo_exit
");

platform_driver_unregister(&platform_demo_driver);
}

module_init(platform_demo_init);
module_exit(platform_demo_exit);

MODULE_AUTHOR("IRIC");
MODULE_LICENSE("GPL");

以模塊方式構(gòu)建上述代碼，運行后結(jié)果如下：

從上述結(jié)果可知：platform驅(qū)動和對應(yīng)的設(shè)備匹配成功，且.probe指向的函數(shù)得以執(zhí)行，當模塊退出時，platform驅(qū)動將被移除，這時候.remove指向的函數(shù)得以執(zhí)行。結(jié)果符合程序預(yù)期效果！