承接上文一个例子了解通过Openharmony的HDF框架实现简易驱动的流程,实现到了test_hdf_newdevice1设备的驱动。应用或服务如何与此设备通过HDF的框架的驱动消息机制,进行通信?
依旧以Openharmony中的V3.1 版本为基座,编写测试代码来进行分析说明。
HDF框架提供统一的驱动消息机制,支持用户应用向内核态驱动发送消息,也支持内核态驱动向用户态应用发送消息。
一、用户态应用测试程序
可以通过创建一个应用程序或动态库.so或静态库.a来与内核的驱动程序进行通信。这里简单以一个应用程序为例进行演示。
创建用户态应用测试程序步骤如下:
创建项目:
新建源文件:
添加编译配置:
编译烧录:
1.1 新建源文件test.c
通过驱动对外发布服务的名称(test_hdf_newdevice1)获取驱动的服务对象。
// test.c
#include <stdio.h>
#include <stdlib.h>
#include <sys/time.h>
#include <unistd.h>
#include <string.h>
#include <core/hdf_io_service_if.h>
#include "hdf_sbuf.h"
#include "osal_time.h"
#include "hilog/log.h"
...
int main(int arg, char **argv)
{struct HdfIoService *serv = HdfIoServiceBind("test_hdf_newdevice1");if (serv == NULL) {printf("get service fail!\n");return -1;}return 0;
}
注册事件监听对象HdfDevEventlistener
// test.c
...
#define TEST_WRITE_DATA 1234
static int OnDevEventReceive(struct HdfDevEventlistener *listener,struct HdfIoService *service, uint32_t id, struct HdfSBuf *data)
{printf("enter %d, service address is %p, event cmdId is %d\n",__func__, service, id);return 0;
}static struct HdfDevEventlistener listener = {.onReceive = OnDevEventReceive
}int main(int arg, char **argv)
{
...if (HdfDeviceRegisterEventListener(serv, &listener) != 0) {printf("register event listener fail!\n");}
...
}
准备写入的数据与读出数据
// test.c
...
int main(int arg, char **argv)
{
...struct HdfSBuf *data = HdfSbufObtainDefaultSize();if (data == NULL) {printf("fail to obtain sbuf data!\n");return -1;}struct HdfSBuf *reply = HdfSbufObtainDefaultSize();if (reply == NULL) {printf("fail to obtain sbuf reply!\n");HdfSbufRecycle(data);return -1;}// 写入传入的数据if (!HdfSbufWriteString(data, "Send Msg to Driver Message!")) {printf("fail to write sbuf!\n");HdfSbufRecycle(data);HdfSbufRecycle(reply);HdfDeviceUnregisterEventListener(serv, &listener);HdfIoServiceRecycle(serv);return -1;}
...
}
分发消息
...
int main(int arg, char **argv)
{
...if (serv->dispatcher->Dispatch(&service->object, TEST_WRITE_DATA, data, reply) != 0) {printf("fail to send service call!\n");HdfSbufRecycle(data);HdfSbufRecycle(reply);HdfDeviceUnregisterEventListener(serv, &listener);HdfIoServiceRecycle(serv);return -1;}
...
}
读取驱动返回数据
...
int main(int arg, char **argv)
{const char *result = HdfSbufReadString(reply);if (result == NULL) {printf("fail to read result from reply!\n");HdfSbufRecycle(data);HdfSbufRecycle(reply);HdfDeviceUnregisterEventListener(serv, &listener);HdfIoServiceRecycle(serv); return -1;}printf("read result from driver: %s\n", result);HdfSbufRecycle(data);HdfSbufRecycle(reply);HdfDeviceUnregisterEventListener(serv, &listener);HdfIoServiceRecycle(serv);return 0;
}
...
1.2 添加编译配置BUILD.gn
import("//build/ohos.gni")
import("//drivers/adapter/uhdf2/uhdf.gni")ohos_executable("test_hdf_msg") {sources = ["test.c"]include_dirs = ["//drivers/framework/include","//drivers/framework/include/utils","//drivers/adapter/uhdf2/osal/include","//drivers/framework/include/osal"]deps = ["$hdf_uhdf_path/utils:libhdf_utils",]external_deps = ["device_driver_framework:libhdf_utils","hiviewdfx_hilog_native:libhilog","utils_base:utils"]
}
1.3 编译烧录
./build.sh --product-name rk3568
# 将生成的执行文件test_hdf_msg通过hdc发送开发板执行
# 上一篇中HdfNewdeviceIoServiceDispatch中接收到信息打印如下
# HdfNewdeviceIoServiceDispatch read data is: Send Msg to Driver Message!
# 返回如下信息
# read result from driver: I am driver's reply string!
二、HDF特性
HDF驱动加载包括按需加载和按序加载。
按需加载:HDF框架支持驱动在系统启动过程中默认加载,或者在系统启动之后动态加载。
按序加载:HDF框架支持驱动在系统启动的过程中按照驱动的优先级进行加载。
HDF框架可以集中管理驱动服务,开发者可直接通过HDF框架对外提供的能力接口获取驱动相关的服务。
DF框架提供统一的驱动消息机制,支持用户态应用向内核态驱动发送消息,也支持内核态驱动向用户态应用发送消息。
HCS(HDF Configuration Source)是HDF驱动框架的配置描述源码,内容以Key-Value为主要形式。它实现了配置代码与驱动代码解耦,便于开发者进行配置管理。
参考资料
https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/driver/Readme-CN.md