文章目录
前言:
- 使用汇顶(Goodix)科技的 GR533x SK 蓝牙开发板, 开发了一个基于HID玩抖音App的创意小程序. 可以轻松移植到Goodix 的所有蓝牙SK板. 程序通过 GR533x SK板使用抖音app, 模拟了上划、下划、点赞等功能. 简单演示了空中手势功能。大家可以基于参考程序, 扩展更多趣味实现, 找到BLE更多的创意场景.
1. BLE HID简介
- BLE HID协议规范是以USB HID协议规范为蓝本的,可以认为是USB HID的无线方式
- BLE HID 设备支持三种报告(Report):报告(Input),输出(Output), 特征(Feature)
- 输入报告:BLE HID 从机设备发数据给 BLE HID主机设备.
- 输出报告:BLE HID 主机设备发数据给 BLE HID从机设备.
- 特征报告:双向数据通道
- UUID为0x1812(标准规范),数据存放在报告中,通过下面的各个特征 characteristic 来收发 HID 的报告数据.
- 我们常见产品有:蓝牙鼠标,蓝牙键盘,蓝牙游戏手柄,蓝牙自拍杆等。
2. 如何开发 HID设备
- 针对应用功能,添加对应设备的hid map
- 服务中添加对应设备的数据长度,报告类型
- 按照需求发送对应的数据给主设备。不同应用模拟的动作不同,例如:
- 鼠标: 左中右按键,滚轮,X,Y坐标
- 键盘:全键盘,小键盘
- 自拍杆:手机音量键
- 触控板:触摸事件,X,Y坐标
注: Goodix 芯片实现了鼠标,键盘,触控板,自拍杆等常用功能的HID模拟,可提供示例工程。
下面以 HID 鼠标举例说明实现 HID 设备的一般过程.
2.1 获取HID Map生成工具
-
前往 usb.org/document-library/hid-descriptor-tool 获取HID Map生成工具(dt2_t)
-
从工具获取 HID Map, 也可以从Goodix SoC提供的示例工程中获取。
2.2 进行数据结构填充
-
根据HID Map解析出上报数据的结构体
-
填充数据结构, 下述代码参考自 Goodix SDK示例工程. 填充值为: 鼠标左中右键,鼠标滚轮值,鼠标X,Y绝对坐标
-
将HID数据结构,数据ID放入HID 报告中,鼠标HID 服务初始化即完成
2.3 将HID数据发送给master
- 按照60Hz频率给手机/电脑发送HID数据即可完成完成的鼠标功能
- 以下代码实现一个滚轮滑动功能。
3. HID程序说明
3.1 开源仓库
- 工程的开源托管仓库为: BLE.HID.Ref.DouYin
- 工程依赖 GR533x SDK, 仓库托管地址为: GR533x.SDK
3.2 构建程序
- 将工程目录ble_app_hids_douyin拷贝到 ${GR533x.SDK}\projects\ble\ble_peripheral 目录下. 完整路径为: ${GR533x.SDK}\projects\ble\ble_peripheral\ble_app_hids_douyin
- 使用 keil环境构建编译
- 下载到 GR533x SK开发板体验即可. (如果有Goodix其他的SK板, 可以轻松移植到对应的SDK下.)
3.3 关键点说明
- HID map:该项目中HID Map rep_map_data 包含鼠标,手指,音量键三种功能的描述。
- Android和iOS对HID的适配不一致。该项目中Android的滑动和点击使用手指模拟,iOS的滑动和点击使用鼠标模拟,因此需要在BLE连接上后发现一次Ancs服务,如果服务存在则是iOS系统,否则是Android系统。
- 模拟滑动时,在每个动作之间必须要有延时。一般手机的刷新率为60HZ,因此该项目中每个动作之间的延时控制在15ms,来匹配手机的刷新率。确保动作可以被识别。
3.3 玩法
- 编译ble_app_hids_douyin工程,并下载代码到GR533x SK板中
- 打开手机系统蓝牙,可发现Goodix_DY设备。连接配对
- 打开抖音,单击Key1可上滑,单击Key2可下滑,双击Key1/Key2可点赞
4. HID Profile刷抖音注意事项
4.1 iOS平台
- 在iOS系统蓝牙中需要显示出设备名称,需添加描述符BLE_ATT_SVC_HID 字段
- 与iOS连接刷抖音, touch无效,实测使用鼠标滚轮效果最佳
- 不同版本iOS可能存在坐标或滚轮不兼容
- 根据测试情况, 参考图中调整 iOS 触控板灵敏度
4.2 Android 平台
- 在Android 系统蓝牙中需要显示键盘/鼠标的图标,需添加描述符BLE_APPEARANCE_HID_KEYBOARD 字段
- 与Android连接刷抖音,实测使用Finger Touch效果最佳
- 在60HZ interval下,保证每个interval发送一个数据包
5. 视频演示
- 点击在线观看程序的视频演示效果 : 通过GR533x SK刷抖音
6. 附录
- 对 汇顶蓝牙芯片、BLE技术、穿戴及Iot产品感兴趣的同学, 欢迎加入 QQ技术社群: (群号 - 168552615)