开源专题(3) - 使用GR533x BLE开发板刷抖音

前言:

• 使用汇顶(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设备

1. 针对应用功能，添加对应设备的hid map
2. 服务中添加对应设备的数据长度，报告类型
3. 按照需求发送对应的数据给主设备。不同应用模拟的动作不同，例如：

• 鼠标: 左中右按键，滚轮，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)