OpenHarmony-4.HDI 框架

news/2024/12/22 2:25:21/
  • HDI 框架

1.HDI介绍

  HDI（Hardware Device Interface，硬件设备接口）是HDF驱动框架为开发者提供的硬件规范化描述性接口，位于基础系统服务层和设备驱动层之间，是连通驱动程序和系统服务进行数据流通的桥梁，是提供给硬件系统服务开发者使用的、统一的硬件设备功能抽象接口，其目的是为系统服务屏蔽南向设备差异。

  在OpenHarmony 分层结构中，HDI位于 “基础系统服务层”和“设备抽象层（DAL）”之间。硬件设备通过DAL抽象化，并基于IDL（Interface Description Language）接口描述语言描述后，为上层应用或服务提供了规范的硬件设备接口。
在这里插入图片描述

2.HDI实现

2.1.IDL接口描述语言

  IDL（Interface Description Language）是一类用来描述接口的语言，通过一种中立的方式来定义客户端与服务端均认可的编程接口，可以实现在二者间的跨进程通信（IPC）。跨进程通信意味着可以在一个进程访问另一个进程的数据，或调用另一个进程的方法。通常把应用接口提供方（供调用）称为服务端，调用方称为客户端。

  IDL先把需要传递的对象分解成操作系统能够理解的基本类型，然后根据接口声明编译，生成IPC/RPC代理（Proxy）和桩（Stub）的C/C++代码，从而为调用者提供一致的接口和调用方式。

  使用IDL语法描述HDI接口并保存为.idl文件，.idl文件在编译过程中转换为C/C++语言的函数接口声明、客户端与服务端IPC相关过程代码，开发时只需要基于生成的头文件中函数接口实现具体服务功能即可。代码生成与编译功能已经集成在hdi.gni编译模板，基于该编译模板编写idl文件的BUILD.gn就可以简单的生成客户端、服务端代码并编译为共享库。如下图所示：
在这里插入图片描述

drivers_interface 仓库：

├── README.en.md
├── README.md
├── sensor                          #sensor HDI 接口定义
│   └── v1_0                        #sensor HDI 接口 v1.0版本定义
│       ├── BUILD.gn                #sensor idl文件编译脚本
│       ├── ISensorCallback.idl     #sensor callback 接口定义idl文件
│       ├── ISensorInterface.idl    #sensor interface 接口定义idl文件
│       └── SensorTypes.idl         #sensor 数据类型定义idl文件
├── audio                           #audio HDI 接口定义
│   └── ...
├── camera                          #camera HDI接口定义
├── codec                           #codec HDI接口定义
├── display                         #display HDI接口定义
├── face_auth                       #faceauth HDI接口定义
├── format                          #format HDI接口定义
├── input                           #input HDI接口定义
├── misc                            #misc HDI接口定义
├── pinauth                         #pinauth HDI接口定义
├── usb                             #usb HDI接口定义
├── fingerprint_auth                #fingerprintauth HDI接口定义
└── wlan                            #wlan HDI接口定义

2.2.使用IDL语法编写 .idl 文件

  创建对应模块/版本接口目录，初始版本定义为v1_0，如 drivers/interface/input/v1.0/目录：

-rw-r--r--. 1 iscas iscas 1.1K Dec 17 11:28 BUILD.gn
-rw-r--r--. 1 iscas iscas 2.4K Dec 17 11:28 IInputCallback.idl
-rw-r--r--. 1 iscas iscas  14K Dec 17 11:28 IInputInterfaces.idl
-rw-r--r--. 1 iscas iscas 5.4K Dec 17 11:28 InputTypes.idl
  • 定义接口IInputInterfaces.idl
 46 package ohos.hdi.input.v1_0;4748 import ohos.hdi.input.v1_0.IInputCallback;49 import ohos.hdi.input.v1_0.InputTypes;61 interface IInputInterfaces {75     ScanInputDevice([out] struct DevDesc[] staArr);89     OpenInputDevice([in] unsigned int devIndex);103    CloseInputDevice([in] unsigned int devIndex);118    GetInputDevice([in] unsigned int devIndex, [out] struct DeviceInfo devInfo);119    ...120 }
  • 如果接口中用到了自定义数据类型，将自定义类型定义到一个单独的.idl文件，如InputTypes.idl
 53 struct DevDesc {54     unsigned int devIndex;        /**< Device index */55     unsigned int devType;         /**< Device type */56 };5761 struct DevIdentify {62     unsigned short busType;       /**< Bus type */63     unsigned short vendor;        /**< Vendor ID */64     unsigned short product;       /**< Product ID */65     unsigned short version;       /**< Version */66 };
  • 如果需要从服务端回调，可以定义callback接口类，如IInputCallback.idl
 45 package ohos.hdi.input.v1_0;47 import ohos.hdi.input.v1_0.InputTypes;58 [callback] interface IInputCallback {69     EventPkgCallback([in] struct EventPackage[] pkgs, [in] unsigned int devIndex);79     HotPlugCallback([in] struct HotPlugEvent event);80 }

2.3.编写 idl文件的BUILD.gn

  drivers_interface/input/v1_0目录中添加BUILD.gn文件，内容如下：

 14 import("//build/config/components/hdi/hdi.gni")1516 if (defined(ohos_lite)) {17   group("libinput_proxy_1.0") {18     deps = []19     public_configs = []20   }21 } else {22   hdi("input") {23     module_name = "input_service"2425     sources = [26       "IInputCallback.idl",27       "IInputInterfaces.idl",28       "InputTypes.idl",29     ]30     mode = "passthrough"31     language = "cpp"32     subsystem_name = "hdf"33     part_name = "drivers_interface_input"34   }35 }

2.4.实现 HDI 服务

   .idl文件在编译过程中除了生成C/C++语言的函数接口声明、客户端与服务端IPC相关过程代码，还会生成驱动入口文件和驱动服务实现文件的模板（如图中间部分所示），实际开发中需要做的就是参照这两个模板根据实际业务需求将文件重新实现即可（如图右侧目录结构所示）。参考Battery IDL 接口如下图所示：
在这里插入图片描述

  在上述步骤中idl编译后将在out目录out/rk3568/gen/drivers/interfaces/input/v1_0生成中间代码。基于工具自动生成的input_interface_service.h，实现其中的服务接口。

oh41/out/rk3568/gen/drivers/interface/input/v1_0$ ls -lh
total 56K
-rw-rw-r-- 1 iscas iscas 1.7K 12月 17 16:16 iinput_callback.h
-rw-rw-r-- 1 iscas iscas 3.4K 12月 17 16:16 iinput_interfaces.h
-rw-rw-r-- 1 iscas iscas 1.1K 12月 17 16:16 input_callback_service.cpp
-rw-rw-r-- 1 iscas iscas 1.3K 12月 17 16:16 input_callback_service.h
-rw-rw-r-- 1 iscas iscas 1.7K 12月 17 16:16 input_interfaces_proxy.cpp
-rw-rw-r-- 1 iscas iscas 3.2K 12月 17 16:16 input_interfaces_service.cpp
-rw-rw-r-- 1 iscas iscas 2.7K 12月 17 16:16 input_interfaces_service.h
-rw-rw-r-- 1 iscas iscas 2.6K 12月 17 16:16 input_types.h

2.4.1.实现HDI服务接口

  基于工具自动生成的input_interface_service.h，实现其中的服务接口，并将相关源码编译为 libinput_interfaces_service_1.0.z.so。

  • drivers_peripheral\input\hdi_service\input_interfaces_impl.h：
#ifndef OHOS_HDI_INPUT_V1_0_INPUTINTERFACEIMPL_H
#define OHOS_HDI_INPUT_V1_0_INPUTINTERFACEIMPL_H#include "input_manager.h"
#include "v1_0/iinput_interfaces.h"namespace OHOS {
namespace HDI {
namespace Input {
namespace V1_0 {
class InputInterfacesImpl : public IInputInterfaces {
public:InputInterfacesImpl(): inputInterface_(NULL) {}virtual ~InputInterfacesImpl(){ReleaseInputInterface(&inputInterface_);}void Init();int32_t ScanInputDevice(std::vector<DevDesc> &staArr) override;int32_t OpenInputDevice(uint32_t devIndex) override;int32_t CloseInputDevice(uint32_t devIndex) override;int32_t GetInputDevice(uint32_t devIndex, DeviceInfo &devInfo) override;int32_t GetInputDeviceList(uint32_t &devNum, std::vector<DeviceInfo> &devList, uint32_t size) override;int32_t SetPowerStatus(uint32_t devIndex, uint32_t status) override;int32_t GetPowerStatus(uint32_t devIndex, uint32_t &status) override;int32_t GetDeviceType(uint32_t devIndex, uint32_t &deviceType) override;int32_t GetChipInfo(uint32_t devIndex, std::string &chipInfo) override;int32_t GetVendorName(uint32_t devIndex, std::string &vendorName) override;int32_t GetChipName(uint32_t devIndex, std::string &chipName) override;int32_t SetGestureMode(uint32_t devIndex, uint32_t gestureMode) override;int32_t RunCapacitanceTest(uint32_t devIndex, uint32_t testType, std::string &result,uint32_t length) override;int32_t RunExtraCommand(uint32_t devIndex, const ExtraCmd &cmd) override;int32_t RegisterReportCallback(uint32_t devIndex, const sptr<IInputCallback> &eventPkgCallback) override;int32_t UnregisterReportCallback(uint32_t devIndex) override;int32_t RegisterHotPlugCallback(const sptr<IInputCallback> &hotPlugCallback) override;int32_t UnregisterHotPlugCallback() override;
private:IInputInterface *inputInterface_;
};
} // V1_0
} // Input
} // HDI
} // OHOS#endif // OHOS_HDI_INPUT_V1_0_INPUTINTERFACEIMPL_H
  • drivers_peripheral\input\hdi_service\input_interfaces_impl.cpp:
int32_t InputInterfacesImpl::ScanInputDevice(std::vector<DevDesc> &staArr)
{if (inputInterface_ == nullptr || inputInterface_->iInputManager == nullptr ||inputInterface_->iInputManager->ScanInputDevice == nullptr) {HDF_LOGE("%{public}s: get input device Module instance failed", __func__);return HDF_FAILURE;}InputDevDesc staArrHdf[MAX_DEVICES];int32_t ret = memset_s(staArrHdf, MAX_DEVICES * sizeof(InputDevDesc), 0, MAX_DEVICES * sizeof(InputDevDesc));ret = inputInterface_->iInputManager->ScanInputDevice(staArrHdf, MAX_DEVICES);for (uint32_t i = 0; i < MAX_DEVICES; i++) {DevDesc StaArr;StaArr.devIndex = staArrHdf[i].devIndex;StaArr.devType = staArrHdf[i].devType;staArr.push_back(StaArr);}return ret;
}int32_t InputInterfacesImpl::OpenInputDevice(uint32_t devIndex)
{if (inputInterface_ == nullptr || inputInterface_->iInputManager == nullptr ||inputInterface_->iInputManager->OpenInputDevice == nullptr) {HDF_LOGE("%{public}s: get input device Module instance failed", __func__);return HDF_FAILURE;}int32_t ret = inputInterface_->iInputManager->OpenInputDevice(devIndex);return ret;
}
...

2.4.2.实现驱动入口

  HDI服务发布是基于用户态HDF驱动框架，所以需要实现一个驱动入口。驱动实现代码参考已经在out目录中生成，可以根据业务需要直接使用该文件或参考该文件按业务需要重新实现， 然后将驱动入口源码编译为libinput_driver.z.so（该名称无强制规定，与hcs配置中配套即可）。

  • drivers_peripheral\input\hdi_service\input_interfaces_driver.cpp:
static void HdfInputInterfacesDriverRelease(struct HdfDeviceObject *deviceObject)
{HDF_LOGI("HdfInputInterfacesDriverRelease enter");if (deviceObject->service == nullptr) {HDF_LOGE("HdfInputInterfacesDriverRelease not initted");return;}auto *hdfInputInterfacesHost = CONTAINER_OF(deviceObject->service, struct HdfInputInterfacesHost, ioService);delete hdfInputInterfacesHost;
}struct HdfDriverEntry g_inputinterfacesDriverEntry = {.moduleVersion = 1,.moduleName = "input_service",.Bind = HdfInputInterfacesDriverBind,.Init = HdfInputInterfacesDriverInit,.Release = HdfInputInterfacesDriverRelease,
};

vendor/hihope/rk3568/hdf_config/uhdf/device_info.hcs

2.4.3.发布服务

  在产品hcs配置中声明HDI服务，以标准系统rk3568为例，HDF设备配置路径为vendor/hihope/rk3568/hdf_config/uhdf/device_info.hcs，在其中新增以下配置：

310             input_hdi_device :: device {
311                 device0 :: deviceNode {
312                     policy = 2;
313                     priority = 100;
314                     moduleName = "libinput_driver.z.so";
315                     serviceName = "input_interfaces_service";
316                 }
317             }

2.4.6.HDI使用

  • 在需要使用HDI服务的客户端BUILD.gn中增加依赖： “drivers_interface_input:libinput_proxy_1.0”
 powermgr/battery_manager/charger/BUILD.gn:60   external_deps = [61     "c_utils:utils",62     "config_policy:configpolicy_util",63     "drivers_interface_battery:libbattery_proxy_2.0",64     "drivers_interface_input:libinput_proxy_1.0",65     "init:libbegetutil",66     "ipc:ipc_core",67   ]
  • 在代码中调用HDI接口
base/powermgr/battery_manager/charger/src/charger_thread.cpp:
339 void ChargerThread::InitInput()
340 {
341     inputInterface = nullptr;
342     inputInterface = HDI::Input::V1_0::IInputInterfaces::Get(true);
347
348     const uint32_t POWERKEY_INPUT_DEVICE = 2;
349     int32_t ret = inputInterface->OpenInputDevice(POWERKEY_INPUT_DEVICE);
355
356     uint32_t devType = INDEV_TYPE_UNKNOWN;
357     ret = inputInterface->GetDeviceType(POWERKEY_INPUT_DEVICE, devType);
363
364     /* first param is powerkey input device, refer to device node '/dev/hdf_input_event2', so pass 2 */
365     if (g_callback == nullptr) {
366         g_callback = new (std::nothrow) HdfInputEventCallback();
367     }
372     ret = inputInterface->RegisterReportCallback(POWERKEY_INPUT_DEVICE, g_callback);
378 }

3.HDI 部署

  在不同量级的 OpenHarmony 系统上，HDI 存在两种部署形态，IPC 模式和直通模式。

在这里插入图片描述

  • 轻量级 OpenHarmony 系统，出于减小系统性能负载考虑，HDI 实现为用户态共享库，由系统服务直接加载 HDI 实现到自己进程中函数调用使用。HDI 实现封装具体的用户态-内核态交互过程，当需要访问驱动程序时使用 IO Service 请求将消息通过 system call 方式调用到内核驱动实现。

  • 标准 OpenHarmony 系统，HDI 以独立服务进程方式部署，系统服务只加载 HDI 客户端实现到自己进程中，实际业务运行在独立进程中，客户端通过 IPC 与服务端交互，便于架构解耦、权限管理。

3.1.HDI接口实现

  直通模式为函数实现方式，无论调用还是实现都不需要其他组件支持即可实现。

  IPC 模式基于 OpenHarmony 系统通信框架的通用模型，但是因为驱动很多时候涉及到底层操作和多系统迁移的场景而使用C语言编写，所以驱动框架还提供了 HDI 服务的 C 语言实现的基础组件，C++实现则主要使用系统通信框架组件。

3.2.IPC模式下的调用原理

  在IPC模式下，当系统服务调用HDI接口时，通过proxy库将函数调用转换为IPC请求，将接口调用的参数进行序列化；IPC请求通过IPC框架发送到服务端，请求将被stub库先处理，然后对接口调用的参数进行反序列化，再转换成对服务实现的函数调用，从而实现接口调用过程。

refer to

  • https://gitee.com/openharmony/drivers_interface
  • https://laval.csdn.net/67341a85cd8b2677c3df7942.html
  • https://baijiahao.baidu.com/s?id=1731328576146856524&wfr=spider&for=pc
  • https://developer.huawei.com/consumer/cn/forum/topic/0204858485287900172
  • https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/IDL/idl-guidelines.md#%E5%88%9B%E5%BB%BAidl%E6%96%87%E4%BB%B6

http://www.ppmy.cn/news/1557081.html

相关文章

Go框架比较：goframe、beego、iris和gin

Go框架比较：goframe、beego、iris和gin

由于工作需要&#xff0c;这些年来也接触了不少的开发框架&#xff0c;Golang的开发框架比较多&#xff0c;不过基本都是Web"框架"为主。这里稍微打了个引号&#xff0c;因为大部分"框架"从设计和功能定位上来讲&#xff0c;充其量都只能算是一个组件&…
阅读更多...
Rust中＜‘_＞是什么意思

Rust中＜‘_＞是什么意思

在 Rust 中&#xff0c;<_> 是一种匿名生命周期的语法&#xff0c;用来简化代码中对生命周期的显式标注。 背景 在 Rust 的类型系统中&#xff0c;生命周期用于表示引用的有效范围&#xff0c;以确保引用不会超过其原始数据的生命周期。通常我们会使用显式的生命周期标…
阅读更多...
3D工具显微镜的测量范围

3D工具显微镜的测量范围

一、测量尺寸范围 样品尺寸&#xff1a; 3D工具显微镜通常能够测量各种尺寸和形状的样品&#xff0c;从小至微米级别的微小结构到大至几厘米甚至更大的物体。具体的测量尺寸范围取决于显微镜的载物台大小、镜头焦距以及软件处理能力。测量精度&#xff1a; 3D工具显微镜的测量…
阅读更多...
Guava 库中的 `Multimap` 是一个允许一个键对应多个值的集合 Guava `Multimap` 的基本代码示例：

Guava 库中的 `Multimap` 是一个允许一个键对应多个值的集合 Guava `Multimap` 的基本代码示例：

Guava 库中的 Multimap 是一个允许一个键对应多个值的集合。以下是一些使用 Guava Multimap 的基本代码示例&#xff1a; 引入 Guava 库 确保你的项目中已经添加了 Guava 库的依赖。如果你使用 Maven&#xff0c;可以在 pom.xml 文件中添加以下依赖&#xff1a; <depende…
阅读更多...
极狐GitLab 正式发布安全补丁版本 17.6.2、17.5.4、 17.4.6

极狐GitLab 正式发布安全补丁版本 17.6.2、17.5.4、 17.4.6

本分分享极狐GitLab 补丁版本 17.6.2, 17.5.4, 17.4.6 的详细内容。这几个版本包含重要的缺陷和安全修复代码&#xff0c;我们强烈建议所有私有化部署用户应该立即升级到上述的某一个版本。对于极狐GitLab SaaS&#xff0c;技术团队已经进行了升级&#xff0c;无需用户采取任何…
阅读更多...
R-CNN算法详解及代码复现

R-CNN算法详解及代码复现

算法背景 在目标检测领域的发展历程中，RCNN算法的出现标志着一个重要里程碑。在RCNN问世之前，研究人员已经探索了多种目标检测方法，为后续突破奠定了基础: 滑动窗口 ：一种早期常用的技术，通过在图像上移动不同大小的窗口来检测潜在目标。 选择性搜索 ：一种更先进的候选区…
阅读更多...
Magento2项目部署笔记

Magento2项目部署笔记

一.去获取Adobe Commerce的个人秘钥 Adobe Commerce Extensions & Themes for Your Online Store | Marketplace 这个个人秘钥不收费&#xff0c;用于作为下载Magento2源代码的凭证 二. 检查Magento2最新版本 以及最新版本对应的环境要求 System requirements | Adobe Comm…
阅读更多...
基于Spring Boot的水果蔬菜商城系统

基于Spring Boot的水果蔬菜商城系统

一、系统概述 该系统主要适用于实体店的线上销售&#xff0c;旨在打造线上线下一体化的销售模式&#xff0c;带动水果蔬菜的销售量&#xff0c;提高店铺的销售额。系统前台主要面向用户&#xff0c;提供登录注册、首页展示、分类搜索、购物车、地址信息、个人信息、订单信息等…
阅读更多...
最新文章

Copyright @ 2022~2023