Driver Development Kit简介
========================

Driver Development Kit（驱动开发套件）为外设驱动开发者提供高效、安全、丰富的扩展外设驱动开发解决方案ArkTS-API和C-API，支持外设驱动开发者为消费者带来外设即插即用的极致体验。

#### 使用场景

支持开发者高效、安全开发专业外设或扩展外设增强能力：

1.  面向专业专用办公外设驱动开发场景。
    
    例如：银行柜台、企业办公、医疗检测等领域专业专用外设，如：高拍仪、身份证扫描仪、指纹识别仪、血氧血糖监测设备。
    
2.  面向非标外设扩展增强能力开放场景。
    
    例如：厂商私有非标HID外设增强能力开放场景，如：手写板快捷键定制、压感/绘图区域设置、扩展增强能力设置、鼠标灯光效果设置、鼠标扩展按键定制、DPI及X/Y轴等高阶能力设置。
    

#### 亮点特征

*   支持开发者开发外设配件的高阶功能，满足消费者高阶使用场景诉求。
    
*   扩展驱动框架支持扩展外设驱动生命周期管理，面向扩展设备应用提供扩展外设查询绑定能力接口。
    

#### 基本概念

*   扩展外设驱动客户端：查询驱动并绑定驱动，自定义驱动与设备之间的通信方式以及数据处理方式等，即[带UI界面基础驱动](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/externaldevice-guidelines)。
*   扩展外设驱动：基于DDK能力开发的专业专用扩展外设驱动或扩展外设增强驱动，即[无UI界面基础驱动](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/driverextensionability)。
*   扩展外设管理服务（External Device Manager）：扩展设备管理，驱动包全生命周期管理等。
*   BMS（Bundle Manager Service）：包管理服务，在HarmonyOS上主要负责应用的安装、卸载和数据管理。
*   AMS（Ability Manager Service）：元能力管理服务，用于拉起和关闭扩展驱动能力DriverExtensionAbility。
*   SA（SystemAbility）：系统元能力，是一种系统服务，对外提供能力。如：外设扩展服务SA就是对外提供非标外设驱动能力的系统服务。
*   非标外设：指的是采用了非标准的协议通信（也称为厂商自定义协议）的一类外设。

#### 实现原理

HDF扩展驱动框架为扩展外设驱动开发，提供稳定统一的外设驱动开发接口，支撑用户态扩展外设驱动开发者基于DDK能力开发用户态扩展外设驱动。

扩展外设管理服务作为用户态扩展外设管理的核心服务，实现对扩展外部设备和扩展外设驱动的生命周期管理，同时面向扩展设备应用开发提供标准ArkTS API接口，支持扩展外设查询、绑定及解绑能力接口。

#### \[h2\]扩展外设驱动架构

**图1** 扩展外设驱动原理图

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3f/v3/z5VimNlERJqIFPP_6BYGmA/zh-cn_image_0000002594828648.png?HW-CC-KV=V1&HW-CC-Date=20260612T073446Z&HW-CC-Expire=86400&HW-CC-Sign=3722C786C9A43987FAF45372A27389E45ED33E59E6653946304340B57364B0ED)

#### \[h2\]运作流程

用户插入外设时，外设与驱动的匹配流程如图2所示。

**图2** 非标外设与对应扩展外设驱动应用匹配的时序图

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9b/v3/iC4UgbqISCOgzyXerTyWXQ/zh-cn_image_0000002625188095.png?HW-CC-KV=V1&HW-CC-Date=20260612T073446Z&HW-CC-Expire=86400&HW-CC-Sign=509BF72A1C4C2BF80993ED7402C92FA6D6D4CEA1A41E812225B0DA28B4B580F5)

用户使用扩展外设驱动客户端时，扩展外设驱动客户端与扩展外设驱动的绑定流程如图3所示。

**图3** 扩展外设驱动客户端与扩展外设驱动绑定的时序图

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3d/v3/GZyN0-ZeRkmmCYKsiUWGwQ/zh-cn_image_0000002625108239.png?HW-CC-KV=V1&HW-CC-Date=20260612T073446Z&HW-CC-Expire=86400&HW-CC-Sign=D07166C726D7D9D957834937BC835D52204D684D32170C537C88C45B426B17A0)

#### 约束与限制

调用Driver Development Kit提供的ArkTS-API或者C-API，开发者需要申请特定权限，才能使用相关接口。

所需权限如下：

| API 类型 | DDK类型 | 权限名称 |
| :-- | :-- | :-- |
| ArkTS-API | 不涉及 | ohos.permission.ACCESS\_EXTENSIONAL\_DEVICE\_DRIVER |
| C-API | UsbDdk | ohos.permission.ACCESS\_DDK\_USB |
| C-API | HidDdk | ohos.permission.ACCESS\_DDK\_HID |
| C-API | USBSerialDDK | ohos.permission.ACCESS\_DDK\_USB\_SERIAL |
| C-API | ScsiPeripheralDDK | ohos.permission.ACCESS\_DDK\_SCSI\_PERIPHERAL |

#### 模拟器支持情况

本Kit不支持模拟器。

#### 关联模块

在扩展外设驱动开发过程中，需要使用到其他关联模块的部分能力，来协助驱动开发。

| 名称 | 作用 |
| :-- | :-- |
| PerformanceAnalysisKit | 引入[hilog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-hilog)用于日志打印。 |
| BasicServicesKit | 引入[BusinessError](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-base#businesserror)用于捕获错误信息。 |
| IPCKit | 引入[rpc](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-rpc)用于驱动与客户端IPC（Inter-Process Communication）通信。 |
| AbilityKit | 引入[@ohos.application.Want (Want)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-application-want)用于生命周期管理。 |

#### 驱动应用规格说明

1.驱动应用定义

*   驱动应用是基于Driver Development Kit开发的、面向非标外设的用户态驱动。
*   驱动应用基于DriverExtensionAbility，开发者需要重写该Ability的生命周期回调接口。

2.驱动应用安装卸载规格

*   安装策略
    *   当用户安装某一驱动应用时，系统会将应用安装到当前已有的所有用户环境下。
    *   当创建新用户时，系统会将已安装的驱动应用在该用户环境下进行安装。
*   卸载策略：当用户在任意用户环境下发起卸载某一驱动应用，系统会将所有用户环境下的该驱动应用卸载。

3.基于DriverExtensionAbility生命周期管理说明

*   ExtensionAbility是基于场景服务的扩展能力的统称，简称为扩展能力（例如用户态扩展驱动、卡片、输入法等）以便满足不同的使用场景。
*   各类Extension的生命周期由各个SA管理，通过connectAbility启动Extension，并驱动定义的业务接口；业务结束，SA调用disconnectAbility接口断开Extension连接，AMS会根据该Extension是否有SA连接来决定是否销毁该Extension及进程。在用户态扩展驱动开发场景下，管理DriverExtensionAbility生命周期的系统SA为外设扩展服务SA。

4.在DriverExtensionAbility中API访问安全管控说明

*   系统支持基于ExtensionAbility构建场景化扩展Ability，DriverExtensionAbility为支持开发用户态扩展驱动的一类Ability。
*   在DriverExtensionAbility中仅支持访问DDK（[docs/zh-cn/application-dev/reference/apis-driverdevelopment-kit · HarmonyOS/docs - AtomGit | GitCode](https://gitcode.com/openharmony/docs/tree/master/zh-cn/application-dev/reference/apis-driverdevelopment-kit)）API，实现对非标外设进行访问控制和数据通信。
*   基于驱动开发安全约束及驱动开发业务场景，在DriverExtensionAbility中不支持访问其它ArkTS API，以防止恶意行为和数据泄漏。
*   DriverExtensionAbility受限访问ArkTS API方案说明：
    *   ArkTS API受限原理：在初始化和创建Extension进程时，会根据Extension配置的受限访问ArkTS API名单加载系统模块。在运行时，如果在DriverExtensionAbility中调用受限ArkTS API，由于初始化和创建阶段未加载相应系统模块，API会调用失败。
*   DriverExtensionAbility具体受限ArkTS API名单，请参考[frameworks/native/ability/native/etc/extension\_blocklist\_config.json · HarmonyOS/ability\_ability\_runtime - AtomGit | GitCode](https://gitcode.com/openharmony/ability_ability_runtime/blob/master/frameworks/native/ability/native/etc/extension_blocklist_config.json)中DriverExtension配置。