Openharmony - HDF驱动小示例和测试程序-编程知识

Openharmony - HDF驱动小示例和测试程序

By: fulinux
E-mail: fulinux@sina.com
Blog: https://blog.csdn.net/fulinus
喜欢的盆友欢迎点赞和订阅！
你的喜欢就是我写作的动力！

在这里插入图片描述

1. 创建KHDF示例驱动
- 1.1. 创建KHDF项目
- 1.2. HDF驱动程序实现
- - 1.2.1. 驱动入口
  - 1.2.2. 实现Dispatch方法
  - 1.2.3. 硬件业务初始化与释放
  - 1.2.4. 驱动完整展示
- 1.3. Makefile文件
- 1.4. 修改上一级Makefile文件
- 1.5. 驱动配置
- - 1.5.1. 驱动设备描述
  - 1.5.2. 驱动私有配置
- 1.6. 编译烧录效果
2. HDF应用测试程序
- 2.1. 用户态应用测试程序
- 2.3. 新建源文件myhdftest.c
- 2.3.1. 测试程序完整代码
- 2.4. 添加编译配置BUILD.gn
- 2.5. 添加编译配置bundle.json
- 2.6. 修改编译配置config.json
- 2.7. 编译烧录
3. HDF特性

最近在学习鸿蒙系统，首当其冲是学习HDF，这里有很多文章可以阅读：
https://docs.openharmony.cn/pages/v4.0/zh-cn/device-dev/driver/driver-overview-foundation.md/
但是千言万语，不如一个好示例。下面就是一个示例，不过适配的是3.1，在我的3.2上有比较多的问题，于是将修改后的内容提出来供大家一起学习。
https://blog.csdn.net/procedurecode/article/details/128906246

1. 创建KHDF示例驱动

本例中基于Openharmony的V3.2版本，创建KHDF驱动程序。

1.1. 创建KHDF项目

创建KHDF驱动程序步骤如下：

添加目录: drivers/hdf_core/adapter/khdf/linux/中创建目录myhdfsample；
添加文件: drivers/hdf_core/adapter/khdf/linux/myhdfsample添加文件myhdfsample.c与Makefile；
添加配置: vendor/hihope/rk3568/hdf_config/khdf/device_info/device_info.hcs；
编译烧录运行；

1.2. HDF驱动程序实现

通过HDF_INIT将驱动入口注册到HDF框架中，在加载驱动时HDF框架会先调用Bind函数,再调用Init函数加载该驱动，当Init调用异常时，HDF框架会调用Release释放驱动资源并退出:

//myhdfsample.c
#include <linux/rtc.h>
#include "device_resource_if.h"
#include "hdf_device_desc.h"
#include "hdf_log.h"
......
struct HdfDriverEntry g_MyHDFSampleEntry = {.moduleVersion = 1,.Bind = MyHDFSampleBind,.Init = MyHDFSampleInit,.Release = MyHDFSampleRelease,.moduleName = "myhdfsample",
};HDF_INIT(g_MyHDFSampleEntry);

1.2.1. 驱动入口

通过指定Bind，MyHDFSampleBind将相关的服务接口绑定到HDF框架，通过Dispatch对用户态应用的消息进行处理：

//myhdfsample.c
......
#define TEST_WRITE_DATA 1234
static int32_t MyHDFSampleIoServiceDispatch(struct HdfDeviceIoClient *client, int cmdId, struct HdfSBuf *data, struct HdfSBuf *reply)
{
......
}static struct IDeviceIoService MyHDFSampleService = {.Open = NULL,.Dispatch = MyHDFSampleIoServiceDispatch,.Release = NULL,
};static int32_t MyHDFSampleBind(struct HdfDeviceObject *deviceObject)
{HDF_LOGD("enter %s", __func__);deviceObject->service = &MyHDFSampleService;return HDF_SUCCESS;
}
......

1.2.2. 实现Dispatch方法

定义TEST_WRITE_DATA的cmdId号，对写入的数据进行打印，并返回应答数据。HdfDeviceSendEvent对应用端通过HdfDeviceRegisterEventListener方法注册的监听器HdfDevEventlistener对象均可以接受到cmdId消息。HdfDevEventlistener将会应用端进行说明：

#define TEST_WRITE_DATA 1234
static int32_t MyHDFSampleIoServiceDispatch(struct HdfDeviceIoClient *client, int cmdId, struct HdfSBuf *data, struct HdfSBuf *reply)
{HDF_LOGD("enter %s: received cmd %d", __func__, cmdId);if (cmdId == TEST_WRITE_DATA) {const char *readData = HdfSbufReadString(data);if (readData != NULL) {HDF_LOGD("%s: read data is:%s", __func__, readData);}if (HdfSbufWriteString(reply, "I am driver's reply string!")) {return HdfDeviceSendEvent(client->device, cmdId, data);}}HDF_LOGE("%s: return fail", __func__);return HDF_FAILURE;
}

1.2.3. 硬件业务初始化与释放

HdfNewdeviceInit实现驱动自身业务初始的接口，HdfNewdeviceRelease实现驱动资源释放的接口：

static int32_t MyHDFSampleInit(struct HdfDeviceObject *device)
{HDF_LOGD("%s: Hdf dev service:%s init success", __func__, HdfDeviceGetServiceName(device));return HDF_SUCCESS;
}static void MyHDFSampleRelease(struct HdfDeviceObject *device)
{HDF_LOGD("%s: Hdf dev service:%s release success", __func__, HdfDeviceGetServiceName(device));
}