HDF（Hardware Driver Framework）是OpenHarmony的驅動子系統，包括驅動框架，配置管理，配置解析，驅動通用框架模型，硬件通用平臺能力接口等。
??想了解更多關于開源的內容，請訪問：??
??51CTO 開源基礎軟件社區??
??https://ost.51cto.com??
接下來我們需要學習下如何開發一個驅動應用。
HDF框架簡介
HDF(Hardware Driver
Framework)是OpenHarmony的驅動子系統，包括驅動框架，配置管理，配置解析，驅動通用框架模型，硬件通用平臺能力接口等。下圖是一副標準系統的框架模型，但是在小型或者輕量級系統使用的時候時候沒有VFS也沒有這么復雜的分層。
![#沖刺創作新星# #跟著小白一起學鴻蒙# [九] 寫個簡單的LED驅動-開源基礎軟件社區](https://dl-harmonyos.51cto.com/images/202210/075887107015ec99029435721c30ce49ca77a0.png?x-oss-process=image/resize,w_820,h_691 "#沖刺創作新星# #跟著小白一起學鴻蒙# [九] 寫個簡單的LED驅動-開源基礎軟件社區")
![#沖刺創作新星# #跟著小白一起學鴻蒙# [九] 寫個簡單的LED驅動-開源基礎軟件社區](https://dl-harmonyos.51cto.com/images/202210/097a43f84535a5764f44548f581df74d1f2361.png?x-oss-process=image/resize,w_654,h_456 "#沖刺創作新星# #跟著小白一起學鴻蒙# [九] 寫個簡單的LED驅動-開源基礎軟件社區")
詳細的內容介紹在一下鏈接內可以看到官方的說明：
參考鏈接：https://gitee.com/openharmony/drivers_hdf_core
此樣例參考小熊派設計，使用小熊派HM_Micro開發板進行驗證
Driver開發流程
graph LR
編寫driver --> 編寫驅動配置 --> 編寫私有配置 --> 添加驅動應用 --> 編譯生成
- 編寫driver: led.c, BUILD.gn
//實現Hdf結構體，HdfDriverEntry(在hdf_device_desc.h中定義)類型的全局變量
struct HdfDriverEntry g_ledDriverEntry = {
.moduleVersion = 1,
.moduleName = "HDF_LED",
.Bind = HdfLedDriverBind,
.Init = HdfLedDriverInit,
.Release = HdfLedDriverRelease,
};
// 調用HDF_INIT將驅動入口注冊到HDF框架中
HDF_INIT(g_ledDriverEntry);
//Led設備結構體
struct TestLed {
uint32_t gpioNum;
};
static struct TestLed g_testLed;
// 讀取驅動私有配置
static int32_t LedReadDrs(struct TestLed *led, const struct
DeviceResourceNode *node)
{
int32_t ret;
struct DeviceResourceIface *drsOps = NULL;
drsOps = DeviceResourceGetIfaceInstance(HDF_CONFIG_SOURCE);
if (drsOps == NULL || drsOps->GetUint32 == NULL) {
HDF_LOGE("%s: invalid drs ops!", __func__);
return HDF_FAILURE;
}
/* 讀取led.hcs里面led_gpio_num的值 */
ret = drsOps->GetUint32(node, "led_gpio_num", &led->gpioNum,
0);
if (ret != HDF_SUCCESS) {
HDF_LOGE("%s: read led gpio num fail!", __func__);
return ret;
}
return HDF_SUCCESS;
}
// HDF框架：驅動初始化
int32_t HdfLedDriverInit(struct HdfDeviceObject *device)
{
struct TestLed *led = &g_testLed;
int32_t ret;
if (device == NULL || device->property == NULL) {
HDF_LOGE("%s: device or property NULL!", __func__);
return HDF_ERR_INVALID_OBJECT;
}
/* 讀取hcs私有屬性值 */
ret = LedReadDrs(led, device->property);
if (ret != HDF_SUCCESS) {
HDF_LOGE("%s: get led device resource fail:%d", __func__, ret);
return ret;
}
/* 將GPIO管腳配置為輸出 */
ret = GpioSetDir(led->gpioNum, GPIO_DIR_OUT);
if (ret != 0)
{
HDF_LOGE("GpioSerDir: failed, ret %d\n", ret);
return ret;
}
HDF_LOGD("Led driver Init success");
return HDF_SUCCESS;
}
//HDF框架：驅動綁定
int32_t HdfLedDriverBind(struct HdfDeviceObject *deviceObject)
{
if (deviceObject == NULL)
{
HDF_LOGE("Led driver bind failed!");
return HDF_ERR_INVALID_OBJECT;
}
static struct IDeviceIoService ledDriver = {
.Dispatch = LedDriverDispatch,
};
deviceObject->service = (struct IDeviceIoService *)(&ledDriver);
HDF_LOGD("Led driver bind success");
return HDF_SUCCESS;
}
// HDF框架：驅動資源釋放
void HdfLedDriverRelease(struct HdfDeviceObject *deviceObject)
{
if (deviceObject == NULL)
{
HDF_LOGE("Led driver release failed!");
return;
}
HDF_LOGD("Led driver release success");
return;
}
import("http://drivers/adapter/khdf/liteos/hdf.gni")
hdf_driver("hdf_led") {
sources = [
"led.c",
]
}驅動配置。
在鴻蒙源碼目錄下vendor目錄里是不同廠家的開發板，之下有hdf_config目錄，里面有對應的device_info.hcs設備硬件配置文件，在此文件里增加以下內容。
device_led :: device { // led設備節點
device0 :: deviceNode { // led驅動的DeviceNode節點
policy = 2; // policy字段是驅動服務發布的策略，在驅動服務管理章節有詳細介紹
priority = 10; // 驅動啟動優先級(0-200)，值越大優先級越低，建議默認配100，優先級相同則不保證device的加載順序
preload = 1; // 驅動按需加載字段
permission = 0777; // 驅動創建設備節點權限
moduleName = "HDF_LED"; // 驅動名稱，該字段的值必須和驅動入口結構的moduleName值一致
serviceName = "hdf_led"; // 驅動對外發布服務的名稱，必須唯一
deviceMatchAttr = "st_stm32mp157_led"; //
驅動私有數據匹配的關鍵字，必須和驅動私有數據配置表中的match_attr值相等
}
}同時在同級目錄里也需要增加led_config.hcs文件。
root {
LedDriverConfig {
led_gpio_num = 13;
match_attr = "st_stm32mp157_led";
//該字段的值必須和device_info.hcs中的deviceMatchAttr值一致
}
}同時在同級目錄里也需要修改hdf.hcs文件，增加以下代碼：
#include "led/led_config.hcs"
編譯生成。
./build.sh --product-name PRODUCT_NAME
//看到success則為編譯成功，可以通過find out/[PRODUCT_NAME] -name "my_led"看到對應的應用
總結
device_info.hcs文件中的moduleName必須要和驅動文件中的moduleName字段匹配，這樣驅動才會加載起來。
device_info.hcs文件中的deviceMatchAttr的字段必須和私有配置文件中led_config.hcs的match_attr的字段匹配，這樣私有配置才能生效。
??想了解更多關于開源的內容，請訪問：??
??51CTO 開源基礎軟件社區??
??https://ost.51cto.com??。
