1# HID DDK开发指导
2
3## 场景介绍
4
5HID DDK（HID Driver Develop Kit）是为开发者提供的HID设备驱动程序开发套件，支持开发者基于用户态，在应用层开发HID设备驱动。提供了一系列主机侧访问设备的接口，包括创建设备、向设备发送事件、销毁设备。
6
7## 约束与限制
8
9* HID DDK开放API支持非标HID类外设扩展驱动开发场景。
10
11* HID DDK开放API使用范围内仅允许DriverExtensionAbilit生命周期内使用。
12
13* 使用HID DDK开放API需要在module.json5中声明匹配的ACL权限，例如ohos.permission.ACCESS_DDK_HID。
14
15## 接口说明
16
17| 名称 | 描述 |
18| -------- | -------- |
19| OH_Hid_CreateDevice(Hid_Device *hidDevice, Hid_EventProperties *hidEventProperties) | 创建HID设备。请在设备使用完后使用OH_Hid_DestroyDevice销毁设备 |
20| OH_Hid_EmitEvent(int32_t deviceId, const Hid_EmitItem items[], uint16_t length) | 向指定deviceId的HID设备发送事件。 |
21| OH_Hid_DestroyDevice(int32_t deviceId) | 销毁指定deviceId的HID设备。 |
22
23详细的接口说明请参考[HID DDK](../reference/apis-driverdevelopment-kit/_hid_ddk.md)。
24
25## 开发步骤
26
27以下步骤描述了如何使用 **HID DDK**开发HID设备驱动：
28
29**添加动态链接库**
30
31CMakeLists.txt中添加以下lib。
32```txt
33libhid.z.so
34```
35
36**头文件**
37```c++
38#include <hid/hid_ddk_api.h>
39#include <hid/hid_ddk_types.h>
40```
41
421. 创建设备。
43
44    使用 **hid_ddk_api.h** 的 **OH_Hid_CreateDevice** 接口创建HID设备，成功返回设备deviceId（**非负数**），失败返回错误码（**负数**）。
45
46    ```c++
47   // 构建HID设备属性
48   std::vector<Hid_DeviceProp> deviceProp = {HID_PROP_DIRECT};
49   std::string deviceName = "keyboard"
50   Hid_Device hidDevice = {
51       .deviceName = deviceName.c_str(),
52       .vendorId = 0x6006,
53       .productId = 0x6006,
54       .version = 1,
55       .bustype = 3,
56       .properties = deviceProp.data(),
57       .propLength = (uint16_t)deviceProp.size()
58   };
59   // 构建HID设备关注的事件属性
60   std::vector<Hid_EventType> eventType = {HID_EV_ABS, HID_EV_KEY, HID_EV_SYN, HID_EV_MSC};
61   Hid_EventTypeArray eventTypeArray = {.hidEventType = eventType.data(), .length = (uint16_t)eventType.size()};
62   std::vector<Hid_KeyCode> keyCode = {HID_BTN_TOOL_PEN, HID_BTN_TOOL_RUBBER, HID_BTN_TOUCH, HID_BTN_STYLUS, HID_BTN_RIGHT};
63   Hid_KeyCodeArray keyCodeArray = {.hidKeyCode = keyCode.data(), .length = (uint16_t)keyCode.size()};
64   std::vector<Hid_MscEvent> mscEvent = {HID_MSC_SCAN};
65   Hid_MscEventArray mscEventArray = {.hidMscEvent = mscEvent.data(), .length = (uint16_t)mscEvent.size()};
66   std::vector<Hid_AbsAxes> absAxes = {HID_ABS_X, HID_ABS_Y, HID_ABS_PRESSURE};
67   Hid_AbsAxesArray absAxesArray = {.hidAbsAxes = absAxes.data(), .length = (uint16_t)absAxes.size()};
68   Hid_EventProperties hidEventProp = {
69       .hidEventTypes = eventTypeArray,
70       .hidKeys = keyCodeArray,
71       .hidAbs = absAxesArray,
72       .hidMiscellaneous = mscEventArray
73    };
74    // 创建设备并获取到deviceId
75    int32_t deviceId = OH_Hid_CreateDevice(&hidDevice, &hidEventProp);
76    ```
77
782. 向指定deviceId的HID设备发送事件。
79
80    使用 **hid_ddk_api.h** 的 **OH_Hid_EmitEvent** 向指定的deviceId的设备发送事件。
81
82    ```c++
83    // 构建需要发送事件
84    Hid_EmitItem event = {.type = HID_EV_MSC, .code = HID_MSC_SCAN, .value = 0x000d0042};
85    std::vector<Hid_EmitItem> itemVec;
86    itemVec.push_back(event);
87    // 向指定deviceId的HID设备发送事件
88    int32_t ret = OH_Hid_EmitEvent(deviceId, itemVec.data(), (uint16_t)itemVec.size());
89    ```
90
913. 释放资源。
92
93    在所有请求处理完毕，程序退出前，使用 **hid_ddk_api.h** 的 **OH_Hid_DestroyDevice** 接口销毁HID设备。
94
95    ```c++
96    // 销毁HID设备
97    int32_t ret = OH_Hid_DestroyDevice(deviceId);
98    ```
99