BTstack项目中HID报告消息格式解析与转换

概述

在使用BTstack项目实现蓝牙HID设备功能时，开发者经常需要处理HID报告消息的格式转换问题。本文将详细介绍蓝牙HID协议中消息格式的规范要求，以及如何正确地将USB HID报告转换为蓝牙HID协议消息。

蓝牙HID协议消息结构

蓝牙HID协议定义了特定的消息格式用于传输HID报告数据。与USB HID报告不同，蓝牙HID协议消息需要在报告数据前添加一个消息类型字节：

• 消息类型：0xA1表示这是一个输入报告(Input Report)
• 报告ID：标识报告类型的ID
• 报告数据：实际的HID报告内容

完整的蓝牙HID协议消息格式为：[0xA1, reportID, ...report_data]

USB HID到蓝牙HID的转换

当从USB HID设备(如使用tinyusb库实现的键盘)获取报告数据后，需要按照以下步骤转换为蓝牙HID协议消息：

1. 键盘报告转换：

   • USB格式：[reportID, modifier, keycode1, keycode2, keycode3, keycode4, keycode5, keycode6]
   • 蓝牙格式：[0xA1, reportID, modifier, oem, keycode1, keycode2, keycode3, keycode4, keycode5, keycode6]
   • 注意：需要添加OEM字节(通常为0)

2. 消费者控制报告转换：

   • USB格式：[reportID, CD, usage_code]
   • 蓝牙格式：[0xA1, reportID, CD, oem, usage_code, 0, 0, 0, 0, 0]
   • 注意：需要填充剩余字节为0以满足报告长度要求

实现建议

在实际开发中，建议封装一个专门的转换函数来处理这种格式转换。例如可以创建一个hid_device_send_input_report()函数，该函数内部自动添加0xA1消息类型前缀，然后调用底层的hid_device_send_interrupt_message()发送数据。

这种封装不仅使代码更清晰，还能确保所有HID报告都符合蓝牙协议规范，避免因忘记添加消息类型而导致通信问题。

协议规范背景

蓝牙HID协议的这种设计源于其需要兼容多种HID设备类型，同时保持与USB HID协议的互操作性。消息类型字节的使用使得接收设备能够快速识别数据包类型，提高处理效率。

对于开发者而言，理解并正确实现这种消息格式转换是确保蓝牙HID设备正常工作的关键步骤之一。