HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践

开发 前端
OpenHarmony作为一个自主研发、全新技术生态的全领域下一代开源操作系统,提供了一套驱动框架来满足此诉求。

[[433907]]

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com

在IoT时代下,终端设备差异较大、形态各异、尺寸各异、交互方式各异,解决设备适配问题无疑是实现万物互联的一个关键。但是,在驱动框架的开发和部署过程中,由于终端设备对硬件的计算和存储能力的需求不同、设备厂商提供的设备软硬件操作接口不同、内核提供的操作接口不同,这就使得OEM厂商部署系统的时候需要投入大量的精力来适配和维护驱动代码。

能否提供了一个跨芯片平台、跨内核的驱动框架,使得设备驱动软件可以在不同的设备上运行?OpenHarmony作为一个自主研发、全新技术生态的全领域下一代开源操作系统,提供了一套驱动框架来满足此诉求。

下面我们将带着大家解读OpenHarmony驱动框架。

一、OpenHarmony驱动框架解读

1. 设计目标

为解决在开发和部署过程中遇到的困难,OpenHarmony驱动框架设计目标如下:

  • 支持百K级~G级容量的设备部署,如手机、手环等
  • 提供统一硬件IO抽象,屏蔽SoC芯片差异,兼容不同内核,如Linux、LiteOS等。
  • 屏蔽驱动和系统组件间交互。可动态拆解,满足不同容量设备的部署。
  • 面向不同容量的设备,提供统一的配置界面。

2. 设计思路

OpenHarmony驱动框架(下面简称为HDF)通过提供驱动与芯片平台、内核解耦的底座,规范硬件驱动接口,实现驱动软件在不同设备中部署。

HDF驱动框架架构如下图所示。

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图1 驱动架构

为了达成设计目标,OpenHarmony驱动框架采用如下核心设计思路:

(1)弹性化架构

  • 框架可动态伸缩: 通过对象管理器,多态加载不同容量设备实现方式,实现弹性伸缩部署。
  • 驱动可动态伸缩: 支持统一的设备驱动插件管理,实现设备驱动任意分层,积木式组合拼接

(2)组件化设备模型

  • 提供设备功能模型抽象,屏蔽设备驱动与系统交互的实现,为开发者提供统一的驱动开发接口
  • 提供主流IC的公版驱动能力,支持配置化部署

(3)归一化平台底座

  • 提供规范化的内核、SoC硬件IO适配接口,兼容不同内核、SoC芯片,对外开发规范化的平台驱动接口

(4)统一配置界面

  • 构建全新的配置语言,面向不同容量的设备,提供统一配置界面,支持硬件资源配置和设备信息配置

3. 构建策略

面向Liteos的轻量级设备,主要基于HDF构建主流IC驱动,形成公版驱动和通用设备功能模型,支撑不同硬件芯片、不同内核(LiteOS-M/LiteOS-A)部署。

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图2 轻量级设备部署模式

面向标准设备,除了支持内核态驱动,还支持用户态驱动。用户态驱动的重点在于构建设备抽象模型,为系统提供统一的设备接口,兼容Linux原生驱动和HDF驱动。内核态则使用Linux驱动与HDF驱动并存的策略,提供端到端的解决方案。

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图3 标准设备部署模式

4. 现状与演进

目前HDF驱动框架已经支持Liteos-m、Liteos-a、Linux内核,以及OpenHarmony轻量级、标准级上部署,并且在标准系统上同时支持内核态与用户态部署。

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图4 OpenHarmony驱动框架演进图

经过开发者的不断努力,OpenHarmony驱动框架正在不断完善和增强,在OpenHarmony LTS3.0中,基础框架新增了对热插拔设备的管理以及HDI编译工具hdi-gen,驱动模型部分新增了Audio、Camera、Senso、USB DDK等多个模块的支持。

二、OpenHarmony驱动开发

OpenHarmony驱动为了避免与具体内核产生依赖,实现可迁移目标,开发时需要遵循以下约定:

系统相关接口使用HDF OSAL接口;

总线和硬件资源相关接口使用平台驱动提供的相关接口。

基于HDF框架,驱动开发的通常流程包含驱动代码的实现、编译脚本、配置文件添加、以及用户态程序和驱动交互的流程。下面将详细介绍HDF驱动开发一般步骤。

1. 实现驱动代码

在HDF驱动框架中,HdfDriverEntry对象被用来描述一个驱动实现。

  1. struct HdfDriverEntry { 
  2.     int32_t moduleVersion; 
  3.     const char *moduleName; 
  4.     int32_t (*Bind)(struct HdfDeviceObject *deviceObject); 
  5.     int32_t (*Init)(struct HdfDeviceObject *deviceObject); 
  6.     void (*Release)(struct HdfDeviceObject *deviceObject); 
  7. }; 

编写一个简单的驱动,首先需要实现驱动程序(Driver Entry)入口中的三个主要接口:

  • Bind接口: 实现驱动接口实例化绑定,如果需要发布驱动接口,会在驱动加载过程中被调用,实例化该接口的驱动服务并和DeviceObject绑定。当用户态发起调用时,Bind中绑定的服务对象的Dispatch方法将被回调,在该方法中处理用户态调用的消息。
  • Init接口: 实现驱动或者硬件的初始化,返回错误将中止驱动加载流程。
  • Release接口: 实现驱动的卸载,在该接口中释放驱动实例的软硬件资源。

一个基于HDF框架编写的简单驱动代码如下,其功能是用户态消息回环,即驱动收到用户态发送的消息后将相同内容的消息再发送给用户态:

  1. #include "hdf_base.h" 
  2. #include "hdf_device_desc.h" 
  3. #include "hdf_log.h" 
  4. #define HDF_LOG_TAG "sample_driver" 
  5. #define SAMPLE_WRITE_READ 0xFF00 
  6. static int EchoString(struct HdfDeviceObject *deviceObject, struct HdfSBuf *data, struct HdfSBuf *reply) 
  7.     const char *readData = HdfSbufReadString(data); 
  8.     if (readData == NULL) { 
  9.         HDF_LOGE("%s: failed to read data", __func__); 
  10.         return HDF_ERR_INVALID_PARAM; 
  11.     } 
  12.     if (!HdfSbufWriteInt32(reply, INT32_MAX)) { 
  13.         HDF_LOGE("%s: failed to reply int32", __func__); 
  14.         return HDF_FAILURE; 
  15.     } 
  16.     return HdfDeviceSendEvent(deviceObject, id, data); // 发送事件到用户态 
  17. int32_t HdfSampleDriverDispatch(struct HdfDeviceObject *deviceObject, int id, struct HdfSBuf *data, struct HdfSBuf *reply) 
  18.     const char *readData = NULL
  19.     int ret = HDF_SUCCESS; 
  20.     switch (id) { 
  21.         switch SAMPLE_WRITE_READ: 
  22.             ret = EchoString(deviceObject, data, reply); 
  23.             break; 
  24.         default
  25.             HDF_LOGE("%s: unsupported command"); 
  26.             ret = HDF_ERR_INVALID_PARAM; 
  27.     } 
  28.     return ret; 
  29. void HdfSampleDriverRelease(struct HdfDeviceObject *deviceObject) 
  30.     // 在这里释放驱动申请的软硬件资源 
  31.     return
  32. int HdfSampleDriverBind(struct HdfDeviceObject *deviceObject) 
  33.     if (deviceObject == NULL) { 
  34.         return HDF_FAILURE 
  35.     } 
  36.     static struct IDeviceIoService testService = { 
  37.         .Dispatch = HdfSampleDriverDispatch, 
  38.     }; 
  39.     deviceObject->service = &testService; 
  40.     return HDF_SUCCESS; 
  41. int HdfSampleDriverInit(struct HdfDeviceObject *deviceObject) 
  42.     if (deviceObject == NULL) { 
  43.         HDF_LOGE("%s::ptr is null!", __func__); 
  44.         return HDF_FAILURE; 
  45.     } 
  46.     HDF_LOGE("Sample driver Init success"); 
  47.     return HDF_SUCCESS; 
  48. struct HdfDriverEntry g_sampleDriverEntry = { 
  49.     .moduleVersion = 1, 
  50.     .moduleName = "sample_driver"
  51.     .Bind = HdfSampleDriverBind, 
  52.     .Init = HdfSampleDriverInit, 
  53.     .Release = HdfSampleDriverRelease, 
  54. }; 
  55. HDF_INIT(g_sampleDriverEntry); 

2. 配置设备信息

在HDF框架的配置文件(例如vendor/hisilicon/xxx/config/device_info.hcs)中添加该驱动的配置信息,配置目录与具体开发板关联,如下所示:

  1. root { 
  2.     device_info { 
  3.         match_attr = "hdf_manager"
  4.         template host { 
  5.             hostName = ""
  6.             priority = 100; 
  7.             template device { 
  8.                 template deviceNode { 
  9.                     policy = 0; 
  10.                     priority = 100; 
  11.                     preload = 0; 
  12.                     permission = 0664; 
  13.                     moduleName = ""
  14.                     serviceName = ""
  15.                     deviceMatchAttr = ""
  16.                 } 
  17.             } 
  18.         } 
  19.        sample_host :: host{ 
  20.             hostName = "host0";    // host名称,host节点是用来存放某一类驱动的容器 
  21.             priority = 100;        // host启动优先级(0-200),值越大优先级越低,建议默认配100,优先级相同则不保证host的加载顺序 
  22.             device_sample :: device {        // sample设备节点 
  23.                 device0 :: deviceNode {      // sample驱动的DeviceNode节点 
  24.                     policy = 1;              // policy字段是驱动服务发布的策略,在驱动服务管理章节有详细介绍 
  25.                     priority = 100;          // 驱动启动优先级(0-200),值越大优先级越低,建议默认配100,优先级相同则不保证device的加载顺序 
  26.                     preload = 0;             // 驱动加载策略,参考《5.2 HDF驱动框架章节》 
  27.                     permission = 0664;       // 驱动创建设备节点权限 
  28.                     moduleName = "sample_driver";   // 驱动名称,该字段的值必须和驱动入口结构体的moduleName值一致 
  29.                     serviceName = "sample_service";    // 驱动对外发布服务的名称,必须唯一 
  30.                     deviceMatchAttr = "sample_config"; // 驱动私有数据匹配的关键字,必须和驱动私有数据配置表中的match_attr值相等 
  31.                 } 
  32.             } 
  33.         } 
  34.     } 

定义设备列表时使用了HCS的模板语法,template host节点下的内容由HDF框架定义,新增host以及host中的device只需要继承该模板并填充具体内容即可。

在配置中定义的device将在加载过程中产生一个设备实例,配置中通过moduleName字段指定设备对应的驱动名称,从而将设备与驱动关联起来。其中,设备与驱动可以是一对多的关系,即可以实现一个驱动支持多个同类型设备。

3. 用户态程序与驱动交互

用户态程序和驱动交互基于HDF IoService模型实现,该设计屏蔽了具体内核的差异,将驱动接口抽象为IoService对象,调用者基于名称获取该对象,并可以使用IoService系列接口进行接口调用和事件监听。值得一提的是消息传递时使用了HDF Sbuf对象进行参数的序列化和反序列化,这样可以避免不受控的内存访问,也简化了消息传递和分发过程中的内存所有权问题,有利于提升用户态和内核态数据传递的安全性和便利性。HDF Sbuf相关接口可以参考HarmonyOS设备开发官网API Reference中头文件hdf_sbuf.h部分。

基于HDF框架编写的用户态程序和驱动交互的代码如下:

  1. #include "hdf_log.h" 
  2. #include "hdf_sbuf.h" 
  3. #include "hdf_io_service_if.h" 
  4. #define HDF_LOG_TAG "sample_test" 
  5. #define SAMPLE_SERVICE_NAME "sample_service" 
  6. #define SAMPLE_WRITE_READ 0xFF00 
  7. int g_replyFlag = 0; 
  8. static int OnDevEventReceived(void *priv, uint32_t id, struct HdfSBuf *data) 
  9.     const char *string = HdfSbufReadString(data); 
  10.     int ret = HDF_SUCCESS; 
  11.     if (string == NULL) { 
  12.         HDF_LOGE("failed to read string in event data"); 
  13.         ret = HDF_FAILURE; 
  14.     } else { 
  15.         HDF_LOGE("%s", string); 
  16.     } 
  17.     g_replyFlag = 1; 
  18.     return ret; 
  19. static int SendEvent(struct HdfIoService *serv, char *eventData) 
  20.     int ret = 0; 
  21.     struct HdfSBuf *data = HdfSBufObtainDefaultSize(); // 申请需要发送的序列化对象 
  22.     if (data == NULL) { 
  23.         HDF_LOGE("failed to obtain sbuf data"); 
  24.         return 1; 
  25.     } 
  26.     struct HdfSBuf *reply = HdfSBufObtainDefaultSize(); // 申请返回数据的序列化对象 
  27.     if (reply == NULL) { 
  28.         HDF_LOGE("failed to obtain sbuf reply"); 
  29.         ret = HDF_DEV_ERR_NO_MEMORY; 
  30.         goto out
  31.     } 
  32.     if (!HdfSbufWriteString(data, eventData)) { // 准备消息内容 
  33.         HDF_LOGE("failed to write sbuf"); 
  34.         ret = HDF_FAILURE; 
  35.         goto out
  36.     } 
  37.     ret = serv->dispatcher->Dispatch(&serv->object, SAMPLE_WRITE_READ, data, reply); // 发起接口调用 
  38.     if (ret != HDF_SUCCESS) { 
  39.         HDF_LOGE("failed to send service call"); 
  40.         goto out
  41.     } 
  42.     int replyData = 0; 
  43.     if (!HdfSbufReadInt32(reply, &replyData)) { // 反序列化返回数据 
  44.         HDF_LOGE("failed to get service call reply"); 
  45.         ret = HDF_ERR_INVALID_OBJECT; 
  46.         goto out
  47.     } 
  48.     HDF_LOGE("Get reply is: %d", replyData); 
  49. out
  50.     HdfSBufRecycle(data); 
  51.     HdfSBufRecycle(reply); 
  52.     return ret; 
  53. int main() 
  54.     struct HdfIoService *serv = HdfIoServiceBind(SAMPLE_SERVICE_NAME); // 通过名称获取IoService对象,与驱动配置中的名称一致 
  55.     if (serv == NULL) { 
  56.         HDF_LOGE("failed to get service %s", SAMPLE_SERVICE_NAME); 
  57.         return HDF_FAILURE; 
  58.     } 
  59.     static struct HdfDevEventlistener listener = { // 构造驱动事件监听器对象 
  60.         .callBack = OnDevEventReceived, // 填充事件处理方法 
  61.         .priv = NULL
  62.     }; 
  63.     if (HdfDeviceRegisterEventListener(serv, &listener) != HDF_SUCCESS) {  // 注册事件监听 
  64.         HDF_LOGE("failed to register event listener"); 
  65.         return HDF_FAILURE; 
  66.     } 
  67.     if (SendEvent(serv, "Hello World, HDF Driver!")) { // 调用驱动接口,样例驱动收到事件 
  68.         HDF_LOGE("failed to send event"); 
  69.         return HDF_FAILURE; 
  70.     } 
  71.     while (g_replyFlag == 0) { // 等待驱动上报事件 
  72.         sleep(1); 
  73.     } 
  74.     HdfDeviceUnregisterEventListener(serv, &listener)); // 去注册事件监听器 
  75.     HdfIoServiceRecycle(serv); // 回收IoService对象 
  76.     return 0; 

该示例执行后会在终端中打印出"Hello World, HDF Driver!"字符串,表明我们的用户态测试程序和驱动成功地进行了一次交互。

三、使用DevEco Device Tool进行驱动开发

上一小节介绍了OpenHarmony驱动的一般开发方法,那么有没有更简单的方法添加一款驱动呢?答案就是华为南向开发IDE——DevEco Device Tool。DevEco Device Tool最新版本已经集成了HDF驱动开发功能,下面介绍如何使用DevEco Device Tool进行驱动开发。

DevEco Device Tool下载链接:

https://device.harmonyos.com/cn/develop/ide#download_release。

1. 创建驱动

(1)导入工程

参考DevEco Device Tool手册,通过npm或网络下载的方式导入OHOS工程。

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图5 DevEco Device Tool启动界面

(2)使用HDF页面工具创建新驱动,按照需求填写Module名称,工具将根据Module名称创建对应驱动代码与。

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图6 Device Eco Tool HDF插件界面

DevEco Device Tool将自动生成驱动实现代码:

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图7 Device Eco Tool 生成驱动代码

为源码文件自动生成编译脚本:

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图8 Device Eco Tool 生成驱动编译脚本

DevEco Device Tool还会在对应单板的驱动配置中生成驱动设备配置信息:

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图9 Device Eco Tool 生成驱动配置信息

2. 修改驱动

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图10 Device Eco Tool驱动快速编辑界面

DevEco Device Tool提供了快捷方式直达源码、编译脚本、配置文件,点击链接修改相关文件,实现驱动功能。DevEco Device Tool自动生成代码已经提供了DriverEntry的基础实现,只需填充对应函数的实际功能即可。

3. 编译版本

使用DevEco Device Tool build功能一键编译版本,编译输出显示在终端窗口:

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图11 Device Eco Tool编译界面

4. 烧录验证

DevEco Device Tool提供了一站式的烧录、调试环境。使用upload功能将编译好的镜像烧录进开发板。

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图12 Device Eco Tool烧写功能界面

烧录过程和进度显示在终端窗口。

HDC2021技术分论坛:OpenHarmony驱动框架解读和开发实践-鸿蒙HarmonyOS技术社区

图13 Device Eco Tool烧写输出

四、总结

除了在此次HDC大会与大家分享驱动框架的设计和最新进展,开放原子基金会还在OpenHarmony公众号、gitee社区等渠道发布了一系列技术分享、指导文档等资料,欢迎大家关注并一起建设OpenHarmony驱动生态。

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com

 

责任编辑:jianghua 来源: 鸿蒙社区
相关推荐

2021-11-03 17:08:22

鸿蒙HarmonyOS应用

2021-11-26 10:05:06

鸿蒙HarmonyOS应用

2021-10-28 14:53:27

鸿蒙HarmonyOS应用

2021-10-29 10:14:42

鸿蒙HarmonyOS应用

2021-11-02 14:52:17

鸿蒙HarmonyOS应用

2021-10-29 15:34:45

鸿蒙HarmonyOS应用

2021-11-08 10:20:48

鸿蒙HarmonyOS应用

2022-04-01 15:18:04

HarmonyHDF 驱动鸿蒙

2021-11-03 17:03:31

鸿蒙HarmonyOS应用

2021-10-28 10:11:17

鸿蒙HarmonyOS应用

2021-09-07 15:48:28

鸿蒙HarmonyOS应用

2021-11-15 10:15:37

鸿蒙HarmonyOS应用

2022-04-21 11:26:31

鸿蒙操作系统

2023-03-08 15:55:53

Linux驱动鸿蒙

2021-03-24 09:56:34

开发

2023-05-31 15:45:49

HCS鸿蒙
点赞
收藏

51CTO技术栈公众号