[原创] 当BLE遇上MEMS——HID报告描述符介绍

lb8820265 2020-9-13 19:13 楼主

HID（human interface device）也就是人机接口设备，我们常见的鼠标键盘游戏手柄等都是HID，操作系统自带HID驱动的，有USB接口的，也有蓝牙接口的，都是相似的通信协议。因此这里参考USB接口的HID协议进行介绍。主要参考https://www.usb.org/hid网站中的两篇文档《Device Class Definition for HID 1.11 》《HID Usage Tables 1.2 》，可以直接在官网下载，也可以从本文附件中下载。

HID有自己协议，叫做报告描述符，用来描述发送的数据代表的含义（并不是发送的数据），包括是什么设备：鼠标、键盘、手柄等，和每一字节的含义。下面以键盘的报告描述符为例具体介绍。

参考例程：

nRF5_SDK_15.3.0_59ac345\examples\ble_peripheral\ble_app_hids_keyboard

main.c函数中的报告描述符如下表。

报告描述符	简介
0x05, 0x01, // Usage Pg (Generic Desktop)	这是一个global类Usage Page作用数据
0x09, 0x06, // Usage (Keyboard)	表示这是一个键盘
0xA1, 0x01, // Collection: (Application)	表示下面所包含的是对键盘的解释
0x05, 0x07, // Usage Pg (Key Codes)	定义的是按键码
0x19, 0xE0, // Usage Min (224) 0x29, 0xE7, // Usage Max (231)	按键码分别是 224~231，共总有 8 个按键码
0x15, 0x00, // Log Min (0) 0x25, 0x01, // Log Max (1)	按键码的值是 0 和 1，分别代表放开和按下
0x75, 0x01, // Report Size (1) 0x95, 0x08, // Report Count (8)	用 8 个 bit 分别表示 8 个按键的状态
0x81, 0x02, // Input: (Data, Variable,Absolute)	将这 8 个 bit 添加到本报告中
0x95, 0x01, // Report Count (1) 0x75, 0x08, // Report Size (8) 0x81, 0x01, // Input: (Constant)	另外再预留 8 个 bit 备用，暂时没用
0x95, 0x05, // Report Count (5) 0x75, 0x01, // Report Size (1)	定义 5 个 1bit
0x05, 0x08, // Usage Pg (LEDs)	这是 LED
0x19, 0x01, // Usage Min (1) 0x29, 0x05, // Usage Max (5)	5 个 bit 分别对应 LED1~LED5
0x91, 0x02, // Output: (Data, Variable,Absolute)	将这 5 个 bit 添加到本报告中，LED 需要作为 OUT
0x95, 0x01, // Report Count (1) 0x75, 0x03, // Report Size (3) 0x91, 0x01, // Output: (Constant)	再增加 3 个 bit，与上面 5 个 bit 组成一个字节
0x95, 0x06, // Report Count (6) 0x75, 0x08, // Report Size (8)	定义 6 个字节
0x15, 0x00, // Log Min (0) 0x25, 0x65, // Log Max (101)	每个字节的取值范围是 0~101
0x05, 0x07, // Usage Pg (Key Codes)	这个也是键盘码
0x19, 0x00, // Usage Min (0) 0x29, 0x65, // Usage Max (101)	分别是键盘码 0~键盘码 101
0x81, 0x00, // Input: (Data, Array)	将这 6 个字节添加到本报告中,表示同时可产生 6 个键值。
0xC0, // End Collection	结束