OpenHarmony 3.1 Release版本关键特性解析——HDI硬件设备接口介绍

HDF 驱动框架是 OpenAtom OpenHarmony（简称“OpenHarmony”）系统硬件生态开放的基础，为驱动开发者提供了驱动加载、驱动服务管理和驱动消息机制等驱动框架能力，同时还为开发者提供了规范的HDI硬件设备接口，让开发者能屏蔽南向设备差异，提供更好的硬件。本文将为大家带来 HDI 硬件设备接口的介绍。

图1 HDF驱动框架

一、HDI介绍

HDI（Hardware Device Interface，硬件设备接口）是 HDF 驱动框架为开发者提供的硬件规范化描述性接口。在 OpenHarmony 分层结构中，HDI 位于 “基础系统服务层”和“设备抽象层（DAL）”之间。硬件设备通过 DAL 抽象化，并基于 IDL（Interface Description Language）接口描述语言描述后，为上层应用或服务提供了规范的硬件设备接口。

图2 OpenHarmony 分层结构

HDI 支持“IPC 模式”及“直通模式”两种调用方式。其中，IPC 模式即跨进程通信模式，基于 binder 机制实现，调用端通过 Proxy 代理库调用 HDI 接口，具备良好的解耦性和安全性，是标准系统的默认部署方式。直通模式，将 HDI 实现为共享库，调用端使用 dlopen 加载 HDI 实现库并直接调用 HDI 接口，是小型系统的默认部署方式，同时还适用于对性能有特殊需求的标准系统模块。

图3 两种调用方式

HDI 硬件设备接口的优点用一句话总结就是：为硬件的接入提供了统一的实现通路。屏蔽了硬件接口的具体实现，实现系统软件与硬件的架构解耦。让开发者专注于硬件接口的使用，从而简化开发过程，提升开发效率。

二、HDI实现

通过上文的介绍，相信很多小伙伴会有疑问，HDI 接口是怎么实现的呢？下面我们将为你介绍 IPC 模式下基于 C/S（Client-Server 客户端与服务端）结构的 HDI 接口实现。

2.1 IDL接口描述语言

为方便后文的理解，我们先简单了解一下 IDL 接口描述语言。

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

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

图4 IDL IPC模式通信模型

2.2 基于IDL语言实现HDI接口

首先，使用 IDL 语法描述 HDI 接口并保存为.idl文件，然后编写 .idl 文件的编译脚本 BUILD.gn 文件，最后编译 .idl 文件即可。下面我们将为大家演示电源子系统的 HDI 接口的实现过程。

（1）使用IDL语法编写 .idl 文件

● 定义电源接口 IPowerInterface.idl

package ohos.hdi.power.v1_0;
import ohos.hdi.power.v1_0.IPowerHdiCallback;
impor