做蓝牙键盘、鼠标、游戏手柄、遥控器这类BLE人机交互设备的开发者大概率都有过这样的经历硬件和固件都调通了广播正常发送串口看数据也正常上报可Windows、macOS主机就是搜不到、连不上要么连上了没反应要么BQB认证的时候一堆合规性报错。目录一、先搞懂HID Device的服务基线必选、可选、条件必选分清楚二、核心服务的强制实现细节每一条都是合规底线2.1 HID Service整个设备的核心心脏没有任何妥协空间三、Battery Service必选的基础服务别再只做报告里的电量了四、Device Information Service必选的身份标识PnP ID是重中之重五、Scan Parameters Service与HID ISO Service六、安全要求合规认证的核心红线七、开发实战高频踩坑点避坑总结八、检验很多人第一反应是去改上报逻辑、调连接参数甚至换芯片可折腾了半天问题依旧。其实这类问题90%都不是代码逻辑的问题而是没吃透HOGP规范里对HID Device端的强制要求。HID Device作为整个HOGP体系的服务提供方它的每一个服务、每一个特征值、每一条广播参数甚至安全级别都有严格的规范约束差一点都不行。这篇文章就把HID Device端的所有强制要求、边界规则、隐藏坑点全部拆解清楚从必选服务基线、核心服务实现细节到安全合规要求、重连行为配置再到高频踩坑点的避坑方案全部讲透看完就能直接落地到开发和调试中少走半年弯路。一、先搞懂HID Device的服务基线必选、可选、条件必选分清楚就像开一家合规的餐厅必须有营业执照、固定经营场所、后厨、前台这些基础配置少一样都没法开门营业。HID Device要想被主机正常识别、稳定工作首先要搭好合规的服务框架规范对服务的必选性做了铁一般的定义没有任何妥协空间。HID Device的服务分为三类强制必选、可选支持、条件必选核心架构如下这里的每一项要求都没有模糊空间。强制必选的三项服务不管你做的是最简单的单按键遥控器还是复杂的带触摸板、手写笔的复合键盘都必须完整实现少一个都不符合规范主机有权直接拒绝识别你的设备。可选的扫描参数服务你可以根据设备的使用场景按需实现它的核心作用是配合Report Host优化扫描和重连逻辑降低设备功耗提升重连速度。如果你的设备只需要支持BIOS下的Boot模式完全可以不用实现这个服务因为规范明确要求Boot Host不能支持对应的Scan Client角色加了反而没用。条件必选的HID ISO服务是v1.1版本新增的低延迟能力的核心如果你要做1ms高刷的游戏手柄、低延迟手写笔需要用到LE等时通道传输HID报告那这个服务就变成强制必选必须完整实现如果你的设备只是普通的办公键盘、遥控器不需要高刷低延迟那这个服务就可以直接排除不用实现。二、核心服务的强制实现细节每一条都是合规底线2.1 HID Service整个设备的核心心脏没有任何妥协空间HID Service是整个HOGP体系的核心所有的HID报告交互、模式控制、状态同步都要通过这个服务完成它的实现规则直接决定了设备能不能被主机正常驱动。首先是最基础的服务类型要求规范明确要求All services with the «HID Service» UUID shall be instantiated as a «Primary Service»。这句话看起来简单却是新手开发者最高频的踩坑点。很多人刚接触BLE开发分不清Primary Service和Secondary Service的区别随手把HID Service做成了Secondary Service次服务结果就是主机在做服务发现的时候根本找不到你的HID Service自然也就无法识别设备。记住所有HID Service实例必须是Primary Service主服务没有任何例外。然后是最容易出错的外部服务依赖规则这是复合设备开发的重灾区。规范明确要求Any non-HID Service that has a characteristic whose value is described within the Report Map characteristic value shall be referenced as an «Include» within the HID Service definition containing that Report Map characteristic.这句话怎么理解举个例子你做了一个带电量显示的蓝牙键盘想把电池电量的状态做到HID报告里在Report Map描述符里定义了电池电量对应的Usage Page和Usage。这时候你存放电池电量的Battery Service就必须用Include声明包含到对应的HID Service定义里同时Battery Level特征值必须添加Report Reference特征描述符告诉主机这个特征值对应的Report ID和Report Type。很多人这里只改了Report Map没加Include声明也没加Report Reference描述符结果就是主机解析Report Map的时候找不到对应的特征值直接解析失败设备就算连上了也完全没有反应。更严重的是如果你有多个HID Service实例绝对不能让两个HID Service同时Include同一个外部服务否则会出现特征值引用冲突主机直接拒绝通信。接下来是广播数据的优化要求虽然这部分是推荐实现但直接决定了用户的第一体验。规范建议设备在可发现模式下广播数据里应该包含三个关键内容HID Service的UUID、设备的Local Name本地名称、Appearance外观值。HID Service UUID放在广播里主机可以在扫描阶段就直接识别出这是一个HID设备不用等连接后做服务发现大大加快连接速度Local Name能让用户在蓝牙列表里一眼认出自己的设备Appearance值更是关键它能告诉主机这个设备是键盘、鼠标、游戏手柄还是遥控器主机会根据这个值显示对应的图标而不是千篇一律的未知蓝牙设备。很多人做的设备蓝牙列表里只显示一串MAC地址就是没加Local Name主机显示未知设备图标就是没加Appearance值。然后是HID Information特征值的行为要求这里面有两个关键标志位直接决定了设备的重连和唤醒体验规范还专门用了独立附录详细定义了对应的行为我们必须重点拆解。第一个是NormallyConnectable标志位这个标志位的配置直接决定了设备在空闲状态下的广播行为是影响重连体验的核心。规范专门在附录A里详细定义了这个标志位两种配置对应的设备和主机行为我们直接拆解成实战场景当NormallyConnectable设置为FALSE时设备的行为是只有当有按键按下、有数据需要上报的时候才会开启高占空比广播持续5秒如果设备处于空闲状态没有任何操作会直接关闭射频停止广播。对应的主机行为是一直保持低占空比扫描尽可能降低自身功耗。这种配置最适合台式机配套的固定使用的键鼠几乎不会和主机断开连接空闲时关闭射频能最大化设备的续航是最常用的省电配置。当NormallyConnectable设置为TRUE时设备的行为是有数据需要上报时开启高占空比广播5秒就算设备处于完全空闲的状态也会一直保持低占空比广播随时等待主机的连接请求。对应的主机行为是当主机从睡眠中唤醒、有数据需要发送时会立刻开启高占空比扫描5秒快速找到设备完成重连。这种配置最适合笔记本、平板配套的移动使用的键鼠笔记本睡眠时会断开蓝牙连接唤醒后需要快速重连这个配置能让设备在几百毫秒内完成重连用户完全感知不到延迟体验拉满。很多人做的笔记本配套蓝牙键盘唤醒后要等好几秒才能连上甚至连不上就是因为把NormallyConnectable设成了FALSE设备空闲时直接关了射频主机唤醒后扫描不到自然没法重连。第二个是RemoteWake标志位这个标志位决定了设备能不能唤醒处于睡眠状态的主机。如果这个标志位设为FALSE说明设备不支持远程唤醒主机睡眠时会直接把这个设备排除在唤醒源之外如果设为TRUE说明设备支持远程唤醒主机睡眠时会允许这个设备通过按键操作唤醒自己。做办公键鼠的开发者一定要注意这个标志位的配置很多用户反馈键盘没法唤醒电脑就是这个标志位没设对。最后是HID ISO功能对应的额外要求如果你做的是高刷游戏手柄支持HID ISO功能并且用了多个HID Service实例那必须保证同一个设备里所有相同Report Type的报告Report ID必须全局唯一。比如你有两个HID Service实例第一个里面有Report ID 1的Input Report第二个里面绝对不能再出现Report ID 1的Input Report否则会出现报告冲突ISO通道无法正常建立主机直接拒绝进入混合模式。三、Battery Service必选的基础服务别再只做报告里的电量了很多开发者有一个误区我已经在HID Report Map里加了电量报告能上报电量了就不用再加独立的Battery Service了。这是完全错误的规范明确要求HID Device必须有至少一个Battery Service实例并且必须实例化为Primary Service这是强制必选项没有任何例外。就算你已经在HID报告里实现了电量上报也必须加一个独立的Battery Service这是规范的底线也是BQB认证的必查项。很多人的设备过不了认证就是因为缺了这个必选服务。同时如果你在HID Report Map里描述了Battery Level特征值那对应的Battery Service必须用Include声明包含到HID Service里和我们前面讲的外部服务依赖规则完全一致不能有任何遗漏。四、Device Information Service必选的身份标识PnP ID是重中之重Device Information Service简称DIS也是强制必选的服务必须实例化为Primary Service。很多人觉得这个服务就是放个厂商名、产品名可有可无随便加几个特征值就行结果踩了大坑。规范明确要求The Device Information Service shall include the PnP ID characteristic for reading the PnP ID fields for the HID Device。这句话是铁律DIS里可以不加厂商名、产品名、固件版本号这些可选特征值但PnP ID特征值是必须加的没有任何商量的余地。PnP ID里包含了厂商ID、产品ID、产品版本号主机系统会用这个ID来加载对应的驱动程序显示设备的专属图标做设备的兼容性匹配。很多人做的设备连上主机后显示未知HID设备就是因为没加PnP ID或者PnP ID里的厂商ID是随便填的。更严重的是没有PnP ID你的设备连BQB认证的入门门槛都达不到直接会被驳回。五、Scan Parameters Service与HID ISO ServiceScan Parameters Service是可选服务只有当你的设备需要配合Report Host优化扫描和重连逻辑的时候才需要实现Boot Host完全不支持这个服务所以只做Boot模式的设备不用考虑。HID ISO Service是条件必选服务只要你的设备支持HID ISO低延迟功能就必须完整实现这个服务并且只能有一个实例不能开多个。这个服务是控制混合模式切换、ISO通道配置的核心里面的HID ISO Properties和LE HID Operation Mode两个特征值都是强制必选的少一个都不行。六、安全要求合规认证的核心红线很多开发者的设备能连上主机但是无法开启HID报告的通知主机发了写CCCD的指令设备也回复成功了可就是没有数据上报Windows系统甚至会直接断开连接。这种问题90%都是因为安全要求没达标。规范对HID Device的安全要求做了非常明确的强制规定没有任何妥协空间第一HID Device必须处于GAP定义的可绑定模式必须支持和主机完成绑定流程不支持绑定的设备直接不符合规范。第二HID Service的所有特征值不管是读、写还是通知、指示都必须在加密的链路上才能执行。规范原文明确要求HID Service characteristics shall require an encrypted link for reading, writing, and notification。这是强制要求很多人把HID特征值的权限设成了无加密可读可写结果就是主机系统出于安全考虑直接拒绝开启通知甚至拒绝和设备通信。Windows、macOS、iOS、Android这些主流系统对HID设备的安全要求都和规范完全一致没有加密的链路根本不会处理HID报告数据。第三设备应该使用Peripheral Security Request流程在连接建立后主动向主机发送安全请求告诉主机自己的安全要求主机会根据这个请求发起加密和绑定流程保证链路的安全性。第四Battery Service、Device Information Service、Scan Parameters Service这些配套服务的安全级别应该和HID Service保持完全一致不能出现HID Service需要加密而DIS服务不需要加密的情况否则会导致主机的安全行为异常出现连接不稳定、频繁断连的问题。七、开发实战高频踩坑点避坑总结讲完了所有的强制要求我们再总结一下开发中最常见的踩坑点帮大家直接避开必选服务缺失没加Battery Service或者DIS服务主机不识别认证失败。HID Service类型错误做成了Secondary Service主机服务发现找不到。DIS服务缺少PnP ID特征值认证失败主机显示未知设备。外部服务引用错误Report Map里引用了外部服务没加Include声明和Report Reference描述符主机解析Report Map失败。多HID Service实例Report ID重复尤其是开ISO功能的时候直接导致混合模式无法启用。安全要求不达标没开链路加密主机无法开启通知甚至拒绝连接。NormallyConnectable标志位配置错误设备休眠唤醒后重连慢甚至连不上。HOGP规范对HID Device端的所有要求看似繁琐实则核心逻辑非常清晰必选项不能缺规则项不能破安全项不能松。所有的规则最终都是为了两个核心目标一是保证全球所有厂商的HID设备都能和不同系统的主机无缝兼容、即插即用二是在保证兼容性的前提下最大化设备的稳定性降低功耗提升用户体验。对于开发者来说吃透这些强制要求就相当于拿到了BLE HID设备开发的合规通行证不仅能让你的设备在所有主流系统上稳定运行还能轻松通过BQB认证少走无数弯路。八、检验题目HOGP规范中HID Device端的强制必选服务有哪些每个服务的核心强制要求是什么答案HOGP规范中HID Device端的强制必选服务有三个分别是HID Service、Battery Service、Device Information ServiceDIS核心强制要求如下HID Service必须实例化为Primary Service主服务不可为次服务若Report Map中引用了外部服务的特征值必须通过Include声明引用该外部服务且对应特征值必须添加Report Reference描述符所有特征值的读、写、通知操作必须在加密链路上执行多实例场景下禁止重复引用同一个外部服务。Battery Service必须至少有1个实例且必须实例化为Primary Service若Battery Level特征值被写入Report Map中对应的Battery Service必须通过Include声明包含到HID Service中安全级别需与HID Service保持一致。Device Information Service必须实例化为Primary Service必须包含PnP ID特征值不可缺失安全级别需与HID Service保持一致。题目HOGP规范中HID Service对外部服务的引用有哪些强制规则违反规则会导致什么问题答案强制规则如下若非HID Service的某个特征值其数值被定义在HID Service的Report Map描述符中该外部服务必须通过Include声明被包含到对应的HID Service定义中。被引用的外部服务特征值必须添加Report Reference特征描述符明确其对应的Report ID与Report Type。同一个外部服务禁止被多个HID Service实例同时Include引用避免特征值引用冲突。仅支持在Report Map中描述具备对应Report类型强制属性的特征值。违反规则会导致的问题主机解析Report Map描述符失败设备连接后无任何响应无法正常上报HID数据。多HID Service实例场景下出现报告ID冲突主机无法区分不同的HID报告导致功能异常。设备不符合规范要求BQB认证直接驳回无法通过合规认证。部分主机系统会直接拒绝识别设备或出现频繁断连的问题。题目HOGP规范中HID Device端的安全强制要求有哪些为什么Windows主机经常无法开启HID设备的通知答案HID Device端的安全强制要求如下设备必须处于GAP定义的可绑定模式必须支持与主机完成完整的绑定流程。HID Service的所有特征值其读、写、通知、指示操作必须在加密的BLE链路上执行无加密链路禁止执行相关操作。设备应通过Peripheral Security Request流程主动向主机告知自身的安全要求触发主机发起加密与绑定流程。配套的Battery Service、Device Information Service、Scan Parameters Service的安全模式与安全级别应与HID Service保持一致。Windows主机无法开启HID设备通知的核心原因绝大多数是安全要求不达标Windows系统严格遵循HOGP规范的安全要求对于HID Service的特征值仅允许在加密绑定的链路上开启CCCD通知。如果设备未开启链路加密要求或HID特征值的权限配置为无加密可访问Windows会出于安全策略拒绝执行CCCD写操作或写操作成功后也不处理上报的通知数据最终表现为无法开启通知、无数据上报。此外设备未处于可绑定模式无法与Windows完成绑定流程也会导致同样的问题。