我們闡述了在啟動(dòng)DeviceManager這個(gè)核心服務(wù)時(shí)，是如何生成所有的host配套設(shè)施的，下面我們來進(jìn)一步剖析細(xì)節(jié)。

我們已經(jīng)知道，一個(gè)Host對(duì)應(yīng)一個(gè)DevHostServiceClnt和一個(gè)DevHostService，很明顯主要行為都包含在后者內(nèi)部。當(dāng)后者啟動(dòng)時(shí)，會(huì)執(zhí)行到DriverInstallerStartDeviceHost（），該函數(shù)又會(huì)調(diào)用DevHostServiceStartServie（），這些內(nèi)容在前一篇文章里都說過。

我們不用去想太多調(diào)用細(xì)節(jié)，反正說起來就是要讓一個(gè)DevHostServiceClnt和一個(gè)DevHostService“掛接”（attach）起來，掛接的動(dòng)作里會(huì)進(jìn)一步在DevHostService里安裝設(shè)備驅(qū)動(dòng)。這個(gè)掛接動(dòng)作具體對(duì)應(yīng)的函數(shù)就是DevmgrServiceClntAttachDeviceHost（）。在上一篇文章里，我們沒有展開講這個(gè)函數(shù)，現(xiàn)在就從它說起。為了便于閱讀，我將掛接動(dòng)作的調(diào)用順序先繪制出來，如下圖所示：

1.掛接device Host

我用黃色框表達(dá)了DevmgrServiceClntAttachDeviceHost（）一步，該函數(shù)代碼截選如下：

【drivers/hdf/frameworks/core/host/src/Devmgr_service_clnt.c】

int DevmgrServiceClntAttachDeviceHost（uint16_t hostId， struct IDevHostService *hostService）

{

struct IDevmgrService *devMgrSvcIf = NULL;

。 . 。 . 。 .

devMgrSvcIf = inst-》devMgrSvcIf;

。 . 。 . 。 .

// 實(shí)際調(diào)用的是DevmgrServiceAttachDeviceHost（）

return devMgrSvcIf-》AttachDeviceHost（devMgrSvcIf， hostId， hostService）;

}

最后一句實(shí)際調(diào)用的是DevmgrServiceAttachDeviceHost（），代碼截選如下：

【drivers/hdf/frameworks/core/manager/src/Devmgr_service.c】

static int DevmgrServiceAttachDeviceHost（

struct IDevmgrService *inst， uint16_t hostId， struct IDevHostService *hostService）

{

struct DevHostServiceClnt *hostClnt = DevmgrServiceFindDeviceHost（inst， hostId）;

。 . 。 . 。 .

hostClnt-》deviceInfos = HdfAttributeManagerGetDeviceList（hostClnt-》hostId， hostClnt-》hostName）;

。 . 。 . 。 .

hostClnt-》hostService = hostService;

return DevHostServiceClntInstallDriver（hostClnt）;

}

首先，遍歷DevmgrService的hosts列表，根據(jù)hostId找到對(duì)應(yīng)的DevHostServiceClnt對(duì)象，并給該DevHostServiceClnt對(duì)象的deviceInfos域和hostService域賦值，然后調(diào)用重頭戲DevHostServiceClntInstallDriver（）。

在獲取這個(gè)host范疇的所有device信息時(shí)，也是去查詢上一篇文章提到的配置樹，樹節(jié)點(diǎn)的類型為DeviceResourceNode，只不過上一次系統(tǒng)是去查找具有“hdf_manager”屬性的節(jié)點(diǎn)，而此次是查找名字為hostName的節(jié)點(diǎn)，這個(gè)節(jié)點(diǎn)里包含著若干設(shè)備的信息，現(xiàn)在這些設(shè)備信息會(huì)被組織成一個(gè)HdfDeviceInfo鏈表。最終形成下面圖中的結(jié)構(gòu)：

1.1安裝host范疇內(nèi)的設(shè)備驅(qū)動(dòng)

1.1.1在每個(gè)host的DevHostService里添加設(shè)備

Attach動(dòng)作的最后一步就是安裝驅(qū)動(dòng)啦，我們看一下這個(gè)DevHostServiceClntInstallDriver（）函數(shù)：

【drivers/hdf/frameworks/core/manager/src/Devhost_service_clnt.c】

int DevHostServiceClntInstallDriver（struct DevHostServiceClnt *hostClnt）

{

。 . 。 . 。 .

struct HdfSListIterator it;

struct HdfDeviceInfo *deviceInfo = NULL;

struct IDevHostService *devHostSvcIf = NULL;

。 . 。 . 。 .

devHostSvcIf = （struct IDevHostService *）hostClnt-》hostService;

。 . 。 . 。 .

HdfSListIteratorInit（&it， hostClnt-》deviceInfos）;

while （HdfSListIteratorHasNext（&it）） {

deviceInfo = （struct HdfDeviceInfo *）HdfSListIteratorNext（&it）;

if （（deviceInfo == NULL） || （deviceInfo-》preload ！= DEVICE_PRELOAD_ENABLE）） {

continue;

}

// 實(shí)際調(diào)用的是 DevHostServiceAddDevice（）

ret = devHostSvcIf-》AddDevice（devHostSvcIf， deviceInfo）;

。 . 。 . 。 .

}

return HDF_SUCCESS;

}

其實(shí)就是遍歷一下該host范疇內(nèi)的所有HdfDeviceInfo節(jié)點(diǎn)，如果節(jié)點(diǎn)的preload是“使能”的，就執(zhí)行對(duì)應(yīng)的AddDevice操作，即DevHostServiceAddDevice（）函數(shù)，其代碼截選如下：

【drivers/hdf/frameworks/core/host/src/Devhost_service.c】

static int DevHostServiceAddDevice（struct IDevHostService *inst，

const struct HdfDeviceInfo *deviceInfo）

{

int ret = HDF_FAILURE;

struct HdfDevice *device = NULL;

struct HdfDeviceNode *devNode = NULL;

struct DevHostService *hostService = （struct DevHostService *）inst;

struct IDriverLoader *driverLoader = HdfDriverLoaderGetInstance（）;

。 . 。 . 。 .

device = DevHostServiceGetDevice（hostService， deviceInfo-》deviceId）;

。 . 。 . 。 .

// 實(shí)際調(diào)用的是 HdfDriverLoaderLoadNode（）

devNode = driverLoader-》LoadNode（driverLoader， deviceInfo）;

。 . 。 . 。 .

devNode-》hostService = hostService;

// 實(shí)際調(diào)用的是 HdfDeviceAttach（）

ret = device-》super.Attach（&device-》super， devNode）;

。 . 。 . 。 .

return HDF_SUCCESS;

。 . 。 . 。 .

}

在這個(gè)函數(shù)里，先調(diào)用DevHostServiceGetDevice（）嘗試從DevHostService的devices列表里查找與deviceId匹配的節(jié)點(diǎn)，如果找不到就創(chuàng)建一個(gè)新HdfDevice節(jié)點(diǎn)，并插入該列表。

當(dāng)然，一開始devices列表是個(gè)空列表，此時(shí)只會(huì)創(chuàng)建新節(jié)點(diǎn)。反正經(jīng)此一步，我們一般可以拿到一個(gè)可用的HdfDevice對(duì)象。接著利用驅(qū)動(dòng)加載器加載一個(gè)和deviceInfo匹配的HdfDeviceNode節(jié)點(diǎn)。最后還需把得到的HdfDevice和HdfDeviceNode掛接起來。

1.1.1.1加載HdfDeviceNode

加載HdfDeviceNode的動(dòng)作實(shí)際上是HdfDriverLoaderLoadNode（），代碼截選如下：

【drivers/hdf/frameworks/core/host/src/Hdf_driver_loader.c】

static struct HdfDeviceNode *HdfDriverLoaderLoadNode（

struct IDriverLoader *loader， const struct HdfDeviceInfo *deviceInfo）

{

struct HdfDriverEntry *driverEntry = NULL;

struct HdfDeviceNode *devNode = NULL;

。 . 。 . 。 .

// 實(shí)際調(diào)用的是 HdfDriverLoaderGetDriverEntry（）

driverEntry = loader-》GetDriverEntry（deviceInfo）;

。 . 。 . 。 .

devNode = HdfDeviceNodeNewInstance（）;

。 . 。 . 。 .

devNode-》driverEntry = driverEntry;

devNode-》deviceInfo = deviceInfo;

devNode-》deviceObject.property = HcsGetNodeByMatchAttr（HcsGetRootNode（），

deviceInfo-》deviceMatchAttr）;

。 . 。 . 。 .

if （（deviceInfo-》policy == SERVICE_POLICY_PUBLIC） || （deviceInfo-》policy == SERVICE_POLICY_CAPACITY）） {

。 . 。 . 。 .

if （driverEntry-》Bind（&devNode-》deviceObject） ！= 0） {

HDF_LOGE（“bind driver failed”）;

HdfDeviceNodeFreeInstance（devNode）;

return NULL;

}

}

return devNode;

}

HdfDeviceNode的定義如下：

【drivers/hdf/frameworks/core/host/include/Hdf_device_node.h】

struct HdfDeviceNode {

struct IDeviceNode super;

struct HdfSListNode entry;

struct PowerStateToken *powerToken;

struct DevHostService *hostService;

struct HdfDeviceObject deviceObject;

struct IHdfDeviceToken *token;

struct HdfDriverEntry *driverEntry;

const struct HdfDeviceInfo *deviceInfo;

};

可以看到，驅(qū)動(dòng)加載器在創(chuàng)建HdfDeviceNode節(jié)點(diǎn)時(shí)，還是有一些工作要做的：

1）得加載相應(yīng)設(shè)備的驅(qū)動(dòng)程序入口，最終體現(xiàn)為HdfDriverEntry；

2）創(chuàng)建一個(gè)HdfDeviceNode對(duì)象，經(jīng)過研究，我們可以看到最終創(chuàng)建的其實(shí)是HdfDeviceNode的派生類（DeviceNodeExt）對(duì)象；

3）把HdfDeviceNode節(jié)點(diǎn)和設(shè)備驅(qū)動(dòng)程序綁定起來；

1.1.1.1.1獲取驅(qū)動(dòng)入口

驅(qū)動(dòng)加載器獲取HdfDriverEntry的實(shí)際動(dòng)作是HdfDriverLoaderGetDriverEntry（）：

【drivers/hdf/lite/manager/src/Lite_driver_loader.c】

struct HdfDriverEntry *HdfDriverLoaderGetDriverEntry（

const struct HdfDeviceInfo *deviceInfo）

{

int count = （int） （（（uint8_t *）（HDF_DRIVER_END（）） - （uint8_t *）（HDF_DRIVER_BEGIN（））） / sizeof（size_t））;

size_t *addrBegin = （size_t*）（HDF_DRIVER_BEGIN（））;

if （（deviceInfo == NULL） || （deviceInfo-》moduleName == NULL） || （deviceInfo-》svcName == NULL）） {

HDF_LOGE（“Hdf get device entry failed， input deviceInfo is NULL！”）;

return NULL;

}

for （int i = 0; i 《 count; i++） {

struct HdfDriverEntry *driverEntry = （struct HdfDriverEntry *）（*addrBegin）;

if （strcmp（deviceInfo-》moduleName， driverEntry-》moduleName） == 0） {

return driverEntry;

}

addrBegin++;

}

HDF_LOGE（“Hdf get %s device entry failed！”， deviceInfo-》svcName）;

return NULL;

}

其中，HdfDriverEntry的定義如下：

【drivers/hdf/frameworks/include/core/Hdf_device_desc.h】

struct HdfDriverEntry {

int32_t moduleVersion;

const char *moduleName;

int32_t （*Bind）（struct HdfDeviceObject *deviceObject）;

int32_t （*Init）（struct HdfDeviceObject *deviceObject）;

void （*Release）（struct HdfDeviceObject *deviceObject）;

};

現(xiàn)在我們來解釋一下，HdfDriverLoaderGetDriverEntry（）到底在干什么。我們?cè)O(shè)想，HDF會(huì)先加載需要的所有驅(qū)動(dòng)程序，每個(gè)驅(qū)動(dòng)程序內(nèi)部都會(huì)構(gòu)造一個(gè)HdfDriverEntry對(duì)象，而且會(huì)填好那個(gè)Bind域，這其實(shí)就是在填寫一個(gè)回調(diào)函數(shù)指針，當(dāng)然，也只有驅(qū)動(dòng)程序自己知道該填寫哪個(gè)函數(shù)指針。

HDF會(huì)把加載的所有驅(qū)動(dòng)的HdfDriverEntry對(duì)象的起始地址匯總起來，形成一個(gè)類似地址數(shù)組的東西，這個(gè)數(shù)組的第一項(xiàng)的地址對(duì)應(yīng)上面代碼中的HDF_DRIVER_BEGIN（），最后一項(xiàng)的地址對(duì)應(yīng)HDF_DRIVER_END（）（最后一項(xiàng)不填內(nèi)容）。示意圖如下：

獲取驅(qū)動(dòng)入口時(shí)，就是在遍歷這個(gè)指針數(shù)組，查詢與moduleName匹配的節(jié)點(diǎn)。

1.1.1.1.2 創(chuàng)建HdfDeviceNode對(duì)象

接著嘗試創(chuàng)建HdfDeviceNode對(duì)象，此時(shí)調(diào)用的HdfDeviceNodeNewInstance（）函數(shù)如下：

【drivers/hdf/frameworks/core/host/src/Hdf_device_node.c】

struct HdfDeviceNode *HdfDeviceNodeNewInstance（）

{

return （struct HdfDeviceNode *）HdfObjectManagerGetObject（HDF_OBJECT_ID_DEVICE_SERVICE）;

}

又需要去查我們熟悉的對(duì)象創(chuàng)建表（g_liteObjectCreators），最終查到會(huì)調(diào)用DeviceNodeExtCreate（）：

【drivers/hdf/lite/manager/src/Hdf_device_node_ext.c】

struct HdfObject *DeviceNodeExtCreate（）

{

struct DeviceNodeExt *instance =

（struct DeviceNodeExt *）OsalMemCalloc（sizeof（struct DeviceNodeExt））;

if （instance ！= NULL） {

DeviceNodeExtConstruct（instance）;

instance-》ioService = NULL;

}

return （struct HdfObject *）instance;

}

可以看到，實(shí)際創(chuàng)建的是一個(gè)DeviceNodeExt對(duì)象。DeviceNodeExt繼承于HdfDeviceNode，定義如下：

【drivers/hdf/lite/include/manager/Hdf_device_node_ext.h】

struct DeviceNodeExt {

struct HdfDeviceNode super;

struct HdfIoService *ioService;

};

其構(gòu)造函數(shù)如下：

【drivers/hdf/lite/manager/src/Hdf_device_node_ext.c】

static void DeviceNodeExtConstruct（struct DeviceNodeExt *inst）

{

struct IDeviceNode *nodeIf = （struct IDeviceNode *）inst;

if （nodeIf ！= NULL） {

HdfDeviceNodeConstruct（&inst-》super）;

nodeIf-》PublishService = DeviceNodeExtPublishService;

}

}

注意，它修改了繼承來的PublishService域，將函數(shù)指針設(shè)為DeviceNodeExtPublishService了。

HdfDriverLoaderLoadNode（）會(huì)給DeviceNodeExt的driverEntry域、deviceInfo域、deviceObject.property賦值，那么在進(jìn)行綁定之前，DeviceNodeExt的示意圖大概是這樣的：

1.1.1.1.3 綁定驅(qū)動(dòng)入口

接下來要將剛剛創(chuàng)建的DeviceNodeExt節(jié)點(diǎn)和驅(qū)動(dòng)入口綁定起來：

driverEntry-》Bind（&devNode-》deviceObject）

前文我們已經(jīng)說了，每個(gè)程序會(huì)實(shí)現(xiàn)自己的Bind動(dòng)作，而HDF只負(fù)責(zé)回調(diào)Bind。注意，回調(diào)時(shí)HDF需要傳入DeviceNodeExt節(jié)點(diǎn)的deviceObject部分的指針，因?yàn)樾枰?qū)動(dòng)程序填寫其中的域。當(dāng)然，我們從上圖中可以看到，deviceObject部分只剩下service域（IDeviceIoService*）需要填寫。那么很明顯，一個(gè)驅(qū)動(dòng)程序要能被HDF使用，那么它就得包含一個(gè)IDeviceIoService對(duì)象。IDeviceIoService的定義如下：

【drivers/hdf/frameworks/include/core/Hdf_device_desc.h】

struct IDeviceIoService {

struct HdfObject object;

int32_t （*Open）（struct HdfDeviceIoClient *client）;

int32_t （*Dispatch）（struct HdfDeviceIoClient *client， int cmdId， struct HdfSBuf *data，

struct HdfSBuf *reply）;

void （*Release）（struct HdfDeviceIoClient *client）;

};

現(xiàn)在我們可以基于前文示意圖，繪制一張DeviceNodeExt和驅(qū)動(dòng)程序綁定后的示意圖了，如下圖：

1.1.1.2 掛接HdfDeviceNode

DevHostServiceAddDevice（）在加載好DeviceNodeExt之后，調(diào)用了一句Attach：

ret = device-》super.Attach（&device-》super， devNode）;

嘗試把HdfDevice節(jié)點(diǎn)和DeviceNodeExt聯(lián)系起來，這一句其實(shí)是調(diào)用HdfDeviceAttach（），相關(guān)代碼如下：

【drivers/hdf/frameworks/core/host/include/Hdf_device.h】

struct IHdfDevice {

struct HdfObject object;

int （*Attach）（struct IHdfDevice *， struct HdfDeviceNode *）;

};

struct HdfDevice {

struct IHdfDevice super;

struct HdfSListNode node;

struct HdfSList services;

uint16_t deviceId;

uint16_t hostId;

};

【drivers/hdf/frameworks/core/host/src/Hdf_device.c】

static int HdfDeviceAttach（struct IHdfDevice *devInst， struct HdfDeviceNode *devNode）

{

struct HdfDevice *device = （struct HdfDevice *）devInst;

struct IDeviceNode *nodeIf = （struct IDeviceNode *）devNode;

。 . 。 . 。 .

HdfSListAdd（&device-》services， &devNode-》entry）;

// 實(shí)際調(diào)用的是 HdfDeviceLaunchNode（）

return nodeIf-》LaunchNode（devNode， devInst）;

}

代碼里先將DeviceNodeExt添加進(jìn)HdfDevice的services列表里，然后調(diào)用了HdfDeviceLaunchNode（）。

我們前文已經(jīng)說過，HdfDevice節(jié)點(diǎn)在之前已經(jīng)添加進(jìn)DevHostService的devices列表了，現(xiàn)在它又和DeviceNodeExt聯(lián)系起來了，再結(jié)合前文中的知識(shí)，我們可以畫一張大一點(diǎn)兒的關(guān)系示意圖了，如下：

至此，相信大家已經(jīng)基本了解掛接設(shè)備host所形成的數(shù)據(jù)結(jié)構(gòu)了，正如上圖所示，每個(gè)host都會(huì)對(duì)應(yīng)上圖中紅、綠、藍(lán)三個(gè)范疇。大家不妨自己試著畫畫這張圖，看看還會(huì)發(fā)現(xiàn)什么。至于HDF的其他方面，我們可以在其他文章里再探討。
編輯：hfy