跟着小白一起学鸿蒙--写个简单的LED驱动(九)

系统 OpenHarmony
HDF(Hardware Driver Framework)是OpenHarmony的驱动子系统,包括驱动框架,配置管理,配置解析,驱动通用框架模型,硬件通用平台能力接口等。

​想了解更多关于开源的内容,请访问:​

​51CTO 开源基础软件社区​

​https://ost.51cto.com​

接下来我们需要学习下如何开发一个驱动应用。

HDF框架简介

HDF(Hardware Driver Framework)是OpenHarmony的驱动子系统,包括驱动框架,配置管理,配置解析,驱动通用框架模型,硬件通用平台能力接口等。下图是一副标准系统的框架模型,但是在小型或者轻量级系统使用的时候时候没有VFS也没有这么复杂的分层。

  • 标准系统

#冲刺创作新星# #跟着小白一起学鸿蒙# [九] 写个简单的LED驱动-开源基础软件社区

  • 小型、轻量系统

#冲刺创作新星# #跟着小白一起学鸿蒙# [九] 写个简单的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;
}
  • 驱动编译gn脚本
import("//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​​。

责任编辑:jianghua 来源: 51CTO开源基础软件社区
相关推荐

2022-10-09 15:05:50

NAPI框架鸿蒙

2022-10-20 16:40:16

JS应用控制LED鸿蒙

2022-11-29 16:35:02

Tetris鸿蒙

2022-12-02 14:20:09

Tetris鸿蒙

2023-03-30 09:32:27

2022-11-14 17:01:34

游戏开发画布功能

2023-02-27 16:30:32

鸿蒙开源协议分析

2023-03-30 09:19:54

SELinux安全子系统

2022-08-19 19:02:20

开源鸿蒙操作系统

2023-04-04 09:24:11

鸿蒙HiDumper

2022-10-10 14:47:04

蓝牙应用鸿蒙

2022-11-03 15:47:04

HTTP通信协议

2023-01-03 15:09:10

鸿蒙常用工具

2022-11-24 14:34:41

Hap程序鸿蒙

2023-03-15 16:19:03

BinderIPC工具

2022-12-06 15:39:16

鸿蒙主干代码

2023-02-24 16:02:45

WebSocket网络通讯协议

2022-11-22 15:15:46

Wi-Fi鸿蒙

2022-11-08 15:43:45

开源鸿蒙蓝牙协议栈

2022-10-31 15:35:02

Wi-Fi蓝牙子系统
点赞
收藏

51CTO技术栈公众号