基于Bluez5.60的树莓派BLE GATT服务端连接身份认证配置
树莓派3B+ Bluez5.60 BLE GATT服务端 PIN认证全配置
核心配置模块
1. 自定义Agent类的逻辑补全
原代码仅完成了Agent对象的初始化,没有实现Bluez规定的认证交互回调,这是PIN流程无法触发的核心原因,需要完成以下实现:
- 在自定义的
Agent类中,按D-Bus规范实现所有认证相关接口方法- 选用
KeyboardDisplay能力时,实现RequestPinCode方法,返回固定的6位数字PIN值作为认证校验依据 - 实现
DisplayPinCode方法,将当前认证用的PIN主动回传给Android端做页面展示 - 实现
Cancel、Release方法,处理认证中断、Agent注销场景下的异常退出逻辑,避免Bluez进程挂起
- 选用
- 注意Bluez5.60版本的硬性限制:BLE配对场景下,传入的PIN长度不能超过6位,超长值会被Bluez直接拦截,无法完成认证
2. Agent能力参数的正确选型
之前尝试的多个能力配置中,只有部分参数能适配Android原生BLE配对的交互逻辑,需要避开以下误用:
- 禁用
NoInputNoOutput能力:该能力对应Just Works无加密配对流程,全程不会触发PIN输入弹窗,完全无法实现身份校验 - 禁用
DisplayYesNo能力:该能力要求两端做本地YES/NO确认交互,Android原生BLE配对弹窗不支持该类交互,会直接导致认证超时 - 面向Android客户端的PIN认证场景,统一选用
KeyboardDisplay能力:该能力同时匹配树莓派端可展示PIN、Android端可输入PIN的交互路径,Bluez会在配对时主动拉起PIN校验流程
3. Bluez系统层配置修正
- 修改
/etc/bluetooth/main.conf配置项:将AutoPair从默认值true改为false,关闭Bluez自动配对逻辑,避免系统层绕过自定义Agent直接完成无PIN配对;将FastConnectable设为false,避免快速连接逻辑跳过认证流程 - 修正GATT特征值权限:所有需要对外提供访问的GATT特征值,必须配置
encrypt-read、encrypt-write权限;如果特征值是开放无权限访问,Bluez不会主动触发配对流程,就算注册了Agent也不会走PIN校验分支 - 认证成功后的处理:在PIN校验通过的回调里,手动调用
SetTrusted接口将已认证的设备标记为信任设备,否则后续设备重连时,Bluez会直接复用缓存的连接信息,跳过PIN校验
4. 注册流程的顺序校验
- 保持Agent的注册顺序:必须先完成
RegisterAgent接口调用,再调用RequestDefaultAgent将当前Agent设为系统默认配对处理入口,顺序颠倒会导致Agent无法接管配对请求 - 在设备属性变更回调
dis_properties_changed中,对所有已缓存的旧配对设备调用RemoveDevice接口清理配对信息,确保每次Android客户端连接时,都会重新触发完整的PIN认证流程
内容的提问来源于stack exchange,提问作者shiv patil
相关产品推荐
相关产品推荐

