鴻蒙開發(fā)實(shí)戰(zhàn)：【Hdf Framework】

簡介

該倉主要存放OpenHarmony驅(qū)動子系統(tǒng)核心源碼信息（包括驅(qū)動框架、配置管理、配置解析、驅(qū)動通用框架模型、硬件通用平臺能力接口等），旨在為開發(fā)者提供更精準(zhǔn)、更高效的開發(fā)環(huán)境，力求做到一次開發(fā)，多系統(tǒng)部署。

圖 1 驅(qū)動框架架構(gòu)圖[]()

說明

驅(qū)動框架使用說明

基于HDF框架開發(fā)驅(qū)動，開發(fā)者只需注冊所需接口和配置，驅(qū)動框架就會解析配置內(nèi)容，完成驅(qū)動加載和初始化動作。

HDF驅(qū)動框架主要包含三部分：

1、驅(qū)動程序部分----完成驅(qū)動的功能邏輯。

2、驅(qū)動配置信息----指示驅(qū)動的加載信息內(nèi)容。

3、驅(qū)動資源配置----配置驅(qū)動的硬件配置信息。

驅(qū)動程序主要是完成驅(qū)動功能的邏輯代碼：

對于開發(fā)者首先看到的是驅(qū)動入口部分，驅(qū)動入口通過結(jié)構(gòu)體DriverEntry進(jìn)行描述。

其中主要包含Bind, Init 和Release三個接口。

struct HdfDriverEntry g_deviceSample = {
    .moduleVersion = 1,
    .moduleName = "sample_driver", 
    .Bind = SampleDriverBind,
    .Init = SampleDriverInit,
    .Release = SampleDriverRelease,
};

Bind接口描述：該接口的作用主要是完成驅(qū)動設(shè)備和設(shè)備服務(wù)接口的bind動作。

int32_t SampleDriverBind(struct HdfDeviceObject *deviceObject)
{
    return HDF_SUCCESS;
}

Init接口描述：當(dāng)框架完成設(shè)備綁定動作后，就開始調(diào)用驅(qū)動初始化接口，初始化成功后，驅(qū)動框架根據(jù)配置文件決定是對外創(chuàng)建設(shè)備服務(wù)接口，還是接口只對當(dāng)前服務(wù)可見。如果Init初始化失敗，驅(qū)動框架就會主動釋放創(chuàng)建的設(shè)備接口等信息。

int32_t SampleDriverInit(struct HdfDeviceObject *deviceObject)
{
    return HDF_SUCCESS;
}

Release接口描述：當(dāng)用戶需要卸載驅(qū)動時，驅(qū)動框架先通過該接口通知驅(qū)動程序釋放資源，然后再釋放其他內(nèi)部資源。

void SampleDriverRelease(struct HdfDeviceObject *deviceObject)
{
    // Release all resources.
    return;
}

Sensor框架模型說明

基于HDF（Hardware Driver Foundation）驅(qū)動框架的Sensor驅(qū)動模型，可實(shí)現(xiàn)跨操作系統(tǒng)遷移、器件差異配置等功能。

Sensor驅(qū)動模型主要由以下兩部分組成：

• 基礎(chǔ)能力部分：依賴HDF驅(qū)動框架實(shí)現(xiàn)Sensor器件驅(qū)動的注冊、加載、去注冊、器件探測等能力，提供同一類型Sensor器件的驅(qū)動歸一接口、寄存器配置解析操作接口、總線訪問抽象接口和平臺抽象接口。
• 開發(fā)者實(shí)現(xiàn)部分：依賴HDF驅(qū)動框架的HCS(HDF Configuration Source)配置管理，根據(jù)同類型Sensor差異化配置，實(shí)現(xiàn)Sensor器件參數(shù)序列化配置和器件部分操作接口。

Display框架模型說明

基于OpenHarmony驅(qū)動框架的Display驅(qū)動模型，對下屏蔽了芯片平臺差異，方便操作系統(tǒng)跨平臺遷移；向上抽象了外設(shè)驅(qū)動公共業(yè)務(wù)邏輯，通過配置或差異化適配接口，實(shí)現(xiàn)了一套驅(qū)動模型兼容不同的外設(shè)器件，使得三方廠商可以高效、便捷的切入鴻蒙驅(qū)動生態(tài)。

Display驅(qū)動模型主要由以下兩部分組成：

• 基礎(chǔ)能力部分：包括HDI（Hardware Driver Interfaces）接口的定義及實(shí)現(xiàn)框架，以及芯片平臺對HDI接口的適配實(shí)現(xiàn)；內(nèi)核驅(qū)動部分抽象了Panel驅(qū)動的公共業(yè)務(wù)，提供了Panel初始化、器件配置信息獲取、上下電、背光設(shè)置等公共流程。
• 開發(fā)者實(shí)現(xiàn)部分：需要完成板級HCS配置及Panel私有數(shù)據(jù)配置，實(shí)現(xiàn)部分器件差異化接口。

Input框架模型說明

基于OpenHarmony驅(qū)動框架的Input驅(qū)動模型，不依賴于芯片平臺，對上層輸入服務(wù)提供統(tǒng)一的驅(qū)動接口；在具體的驅(qū)動模型實(shí)現(xiàn)中，針對不同類別的輸入設(shè)備，抽象出幾類公共的平臺驅(qū)動，通過配置及差異化的適配接口，使得驅(qū)動模型可兼容不同的輸入設(shè)備。借由此驅(qū)動模型，可大幅縮減Input設(shè)備驅(qū)動的開發(fā)周期。

Input驅(qū)動模型主要有以下兩部分組成：

• 基礎(chǔ)能力部分：包括Input HDI層的接口定義及公共實(shí)現(xiàn)，對上層輸入服務(wù)提供設(shè)備管理、業(yè)務(wù)控制、數(shù)據(jù)上報等驅(qū)動能力接口；而Input驅(qū)動模型提供不同類型Input設(shè)備的歸一化驅(qū)動, 包括輸入設(shè)備的注冊和注銷、event數(shù)據(jù)的上報通道、配置信息的解析、公共驅(qū)動的加載等能力。
• 開發(fā)者實(shí)現(xiàn)部分：需根據(jù)驅(qū)動模型提供的平臺驅(qū)動，完成設(shè)備描述配置及器件私有配置，實(shí)現(xiàn)預(yù)留的器件差異化接口。

WLAN框架模型說明

基于OpenHarmony驅(qū)動框架的WLAN驅(qū)動模型，可實(shí)現(xiàn)跨操作系統(tǒng)遷移，自適應(yīng)器件差異，模塊化拼裝編譯等功能。各WLAN廠商驅(qū)動開發(fā)人員可根據(jù)WLAN模塊提供的向下統(tǒng)一接口適配各自的驅(qū)動代碼，HDI層開發(fā)人員可根據(jù)WLAN模塊提供的向上統(tǒng)一接口獲取如下能力：建立/關(guān)閉WLAN熱點(diǎn)、掃描、關(guān)聯(lián)WLAN熱點(diǎn)等。

WLAN驅(qū)動模型主要有以下兩部分組成：

• 基礎(chǔ)能力部分：包括WLAN HDI層的接口定義及公共實(shí)現(xiàn)，對上層輸入服務(wù)提供如設(shè)置MAC地址，獲取設(shè)備MAC地址，獲取特性類型，設(shè)置發(fā)射功率等能力；對驅(qū)動開發(fā)者提供創(chuàng)建/釋放WifiModule、關(guān)聯(lián)/取消關(guān)聯(lián)、申請/釋放NetBuf等能力。
• 開發(fā)者實(shí)現(xiàn)部分：需根據(jù)驅(qū)動模型提供的平臺驅(qū)動，完成板級的HCS配置及WLAN芯片的私有配置，實(shí)現(xiàn)預(yù)留的初始化/注銷網(wǎng)絡(luò)設(shè)備、打開/關(guān)閉網(wǎng)絡(luò)設(shè)備等相關(guān)接口。

審核編輯 黃宇