安卓HID连接与服务发现
HID设备可用:
- BLE 已连接:双方已经可以传数据。
- 配对、加密成功:身份和安全手续完成。
- HID 已就绪:系统知道怎样解释遥控器的数据,也开始接收输入报告。

上层发起 HID 连接后,大致经过:
HidHostService.connect
→ btif_hh_connect
→ BTA_HhOpen
→ HID 的 GATT client 打开
→ 检查安全状态
配对、加密完成
│
├─ 系统 DM 模块:建立服务、特征、描述符目录
│
└─ 上层请求 HID 连接
↓
打开 HID 自己的 GATT client
↓
HID 安全检查完成
↓
判断是否可以恢复 HID 缓存
│
├─ 可以:恢复并尝试完成 HID 连接
│
└─ 需要新初始化
│
├─ 读取 PnP ID
│
└─ 请求搜索 HID 服务
↓
等目录建立完成
↓
HID 搜索完成回调
↓
遍历 HID 特征
↓
Information、Report Map 等读取入队
↓
发送 ATT Read,处理响应
↓
配置输入报告通知
↓
HID 连接完成,注册输入设备
↓
接收遥控器报告
代码完整调用链:
上层 HID connect 怎样进入原生状态机
沿用前面已梳理的业务链。本节从 HidHostService.connect(device) 开始,展开到 HH 状态机选择 LE 动作并发起 GATT Open;后续 GATT 打开、安全检查不在本节展开。
左侧以代码调用为主,缩进表示被调用;右侧只补充作用和条件。子层结束默认继续上一层。⇢ 表示异步事件,接收位置另起一段,不能当作普通同步调用。
源码链接使用 AOSP Android 9 固定版本 android-9.0.0_r61。正文只显示函数名或短行号,鼠标悬停可查看完整位置;该版本与本机对照代码有少量行号偏移,链接已按公开版本对应。
Java 服务 → Java Handler
| 代码调用 | 辅助说明 |
|---|---|
| HidHostService.connect(device) | 连接入口;先检查权限、连接状态和 priority。 |
| └─ mHandler.obtainMessage(MESSAGE_CONNECT, device) | 构造连接消息。 |
| └─ mHandler.sendMessage(msg) | ⇢ 发送 MESSAGE_CONNECT,进入下面的 Handler 接收段。 |
| 代码调用 | 辅助说明 |
|---|---|
| mHandler.handleMessage(): case MESSAGE_CONNECT | 接收上段消息;蓝牙应用的 Java Handler 上下文。 |
| └─ connectHidNative(address) | 调用 JNI;Java 方法与 C++ 函数的绑定见下方索引。 |
| └─ sBluetoothHidInterface->connect(address) | C++ connectHidNative 调用 HID 接口函数指针。 |
| └─ btif_hh.cc::connect(bd_addr) | 函数指针的实际目标;全局正在 CONNECTING 时返回 BUSY。 |
| └─ btif_transfer_context() | ⇢ 发送 BTIF_HH_CONNECT_REQ_EVT,接收位置见下一段。 |
BTIF 接收 → BTA_HhOpen
| 代码调用 | 辅助说明 |
|---|---|
| btif_hh_handle_evt(): case BTIF_HH_CONNECT_REQ_EVT | 接收上段事件;切换到 BTIF/JNI 线程。 |
| └─ btif_hh_connect(bd_addr) | 检查初始化、设备数量及已添加设备状态。 |
| └─ BTA_HhOpen(bd_addr, mode, sec_mask) | 携带设备地址、报告模式和安全要求。 |
| └─ p_buf->hdr.event = BTA_HH_API_OPEN_EVT | 设置 HH 打开事件。 |
| └─ bta_sys_sendmsg(p_buf) | ⇢ 发送 BTA_HH_API_OPEN_EVT,业务接收位置见下一段。 |
BTA 接收 → HH 状态机 → LE 分支
| 代码调用 | 辅助说明 |
|---|---|
| bta_hh_hdl_event(p_msg) | 接收上段事件;BTU/BTA 业务上下文。 |
| └─ bta_hh_find_cb(bd_addr) | 按设备地址查找或取得 HH 控制块。 |
| └─ bta_hh_sm_execute(p_cb, event, p_data) | 进入 HH 状态机。 |
| └─ state_table = bta_hh_st_tbl[p_cb->state - 1] | 按原状态选表;本节展开 IDLE 接收 API_OPEN 的正常分支。 |
| └─ API_OPEN → {START_SDP, W4_CONN} | 事件映射:动作 START_SDP,下一状态 W4_CONN。 |
| └─ p_cb->state = state_table[event][NEXT_STATE] | 先把 HH 状态更新为 W4_CONN。 |
| └─ action = state_table[event][ACTION] | 取得 START_SDP 动作索引。 |
| └─ (*bta_hh_action[action])(p_cb, p_data) | 函数指针调用;动作表绑定 START_SDP → bta_hh_start_sdp,见下方索引。 |
| └─ bta_hh_start_sdp(p_cb, p_data) | 实际动作函数;名称包含 SDP,但 BLE 走下面的 LE 分支。 |
| └─ bta_hh_is_le_device(p_cb, bd_addr) | 分支判断:识别为 LE 才继续下项;经典 HID 不在本节展开。 |
| └─ bta_hh_le_open_conn(p_cb, bd_addr) | 进入 LE HID 打开处理。 |
| └─ bta_hh_le_get_le_dev_hdl(p_cb->index) | 取得 HID handle;无可用 handle 时走失败分支。 |
| └─ BTA_GATTC_Open(gatt_if, bd_addr, true, LE, false) | 发起 HID client 的 GATT 打开请求;这是下一阶段的入口。 |
查看 JNI、接口函数指针和状态机动作的绑定位置
| 代码调用 | 辅助说明 |
|---|---|
| HidHostService.initBinder() | 服务创建 BluetoothHidHostBinder。若从 framework 的 BluetoothHidHost.connect 继续跟入该服务,应先经过 Binder 业务入口;本节以服务内部 connect 为起点。 |
| JNI 方法表:connectHidNative | Java connectHidNative → C++ connectHidNative;注册调用将该表注册给 HidHostService。 |
| get_profile_interface(HIDHOST) | 取得 sBluetoothHidInterface;profile 分派在 bluetooth.cc:363 调 btif_hh_get_interface。 |
| btif_hh_get_interface() | 返回 bthhInterface;其 connect 槽位在 btif_hh.cc:1649,绑定本文件 static connect()。 |
| bta_hh_action 动作表 | START_SDP 对应 bta_hh_start_sdp;状态/事件映射见 IDLE + API_OPEN,调用动作见 动作执行语句。 |
正常路径以各层检查通过为前提:Java 服务可因状态/priority 拒绝,原生接口可返回 BUSY,BTIF 可因资源或设备状态失败;HH 的其他状态也可能选择忽略动作。这些分支不会自动汇合到下面一段,必须看到对应事件被接收后才能认定继续执行。
GATT 打开完成,怎样回到 HID 并启动安全检查
接上一节的 BTA_GATTC_Open()。沿用已梳理的正常路径:BLE/ATT 链路已经建立,HID 以自己的 GATT client 使用该链路;终点是调用 bta_hh_start_security(),安全检查内部的分支留待下一节。
GATTC 状态机和 HH 状态机是两套独立状态机。下面分别标明事件、状态映射与动作,不把 GATT Open 完成当作 HID 初始化完成。
GATT Open 请求 → GATTC 状态机
| 代码调用 | 辅助说明 |
|---|---|
| BTA_GATTC_Open(client_if, remote_bda, is_direct, transport, opportunistic) | 上一节发起的 GATT 打开请求;携带 HID 注册所得的 client_if。 |
| └─ p_buf->hdr.event = BTA_GATTC_API_OPEN_EVT | 构造 GATTC 打开事件。 |
| └─ bta_sys_sendmsg(p_buf) | ⇢ 发送 BTA_GATTC_API_OPEN_EVT,业务接收见下一表。 |
GATTC 连接动作 → OPEN 业务回调
| 代码调用 | 辅助说明 |
|---|---|
| bta_gattc_conn(p_clcb, p_data) | 保存连接信息,并先检查共享服务目录。 |
| └─ bta_gattc_cache_load(p_clcb) | 目录为空且 server 状态为 IDLE 时,尝试从存储加载。 |
| └─ bta_gattc_reset_discover_st(p_srcb, GATT_SUCCESS) | 加载成功分支:目录恢复为可用状态。 |
| └─ bta_gattc_start_discover(p_clcb, NULL) | 加载失败分支:启动远端发现;不会在这里同步等完整目录发现结束。 |
| └─ p_clcb->state = BTA_GATTC_DISCOVER_ST | 共享目录已经在构建时,不重复启动发现,client 等待该目录。 |
| └─ bta_gattc_sm_execute(p_clcb, BTA_GATTC_INT_DISCOVER_EVT, NULL) | 已有可用目录但收到服务变化指示时,调度重新发现;目录的详细处理不在本节展开。 |
| └─ bta_gattc_send_open_cback(p_rcb, GATT_SUCCESS, remote_bda, conn_id, transport, mtu) | 上述正常目录分支随后汇合到这里,通知本 client 已打开。 |
| └─ (*p_clreg->p_cback)(BTA_GATTC_OPEN_EVT, &cb_data) | 通过注册的业务回调通知 HID;回调目标是 bta_hh_gattc_callback,绑定见下方索引。 |
HID 接收 OPEN → 保存 HID 连接信息
| 代码调用 | 辅助说明 |
|---|---|
| bta_hh_gattc_callback(): case BTA_GATTC_OPEN_EVT | 上段函数指针调用的接收分支;没有额外线程切换。 |
| └─ bta_hh_le_find_dev_cb_by_bda(remote_bda) | 按远端地址找到 HID 控制块;找不到时不执行后面的状态机动作。 |
| └─ bta_hh_sm_execute(p_dev_cb, BTA_HH_GATT_OPEN_EVT, &open) | 把 GATTC 的 OPEN 通知转成 HH 业务事件。 |
| └─ GATT_OPEN → {BTA_HH_GATT_OPEN, W4_CONN} | HH 的 W4_CONN 状态映射,与前面的 GATTC 状态机不同。 |
| └─ (*bta_hh_action[BTA_HH_GATT_OPEN])(p_cb, p_data) | 动作表 L78 绑定 bta_hh_gatt_open。 |
| └─ bta_hh_gatt_open(p_cb, p_buf) | 成功时取得 HID handle,保存 conn_id、LE 标志和设备映射。 |
| └─ BtaGattQueue::Clean(p_cb->conn_id) | 清理该 conn_id 的上层 GATT 操作队列。 |
| └─ bta_hh_sm_execute(p_cb, BTA_HH_START_ENC_EVT, NULL) | 继续驱动 HH 安全阶段;这是同步状态机调用。 |
HH 安全事件 → 安全检查入口
| 代码调用 | 辅助说明 |
|---|---|
| START_ENC → {BTA_HH_START_SEC, W4_SEC} | HH 的 W4_CONN 状态收到 START_ENC;下一状态改为 W4_SEC。 |
| └─ (*bta_hh_action[BTA_HH_START_SEC])(p_cb, p_data) | 动作表 L79 绑定 bta_hh_start_security。 |
| └─ bta_hh_start_security(p_cb, NULL) | 本节终点:检查已加密状态,或等待/请求安全处理;内部条件分支下一节再展开。 |
查看 HID 的 GATTC 业务回调注册与保存位置
| 代码调用 | 辅助说明 |
|---|---|
| BTA_GATTC_AppRegister(bta_hh_gattc_callback, registration_done) | HID 初始化时注册业务回调;注册完成后在 L179 保存 HID gatt_if。 |
| bta_gattc_register(app_uuid, p_client_cb, registration_done) | 异步执行注册业务;传入的 p_client_cb 就是 bta_hh_gattc_callback。 |
| cl_rcb[i].p_cback = p_cback | 把 HID 业务回调保存到注册对象。 |
| (*p_clreg->p_cback)(BTA_GATTC_OPEN_EVT, &cb_data) | OPEN 时调用之前保存的函数指针,进入上面的 HID 接收段。 |
本节使用“链路已连接、HID direct Open、各层检查通过”的主线。若 GATT_Connect 失败、控制块分配失败或 OPEN 状态失败,会转失败回调;若链路尚未连接,bta_gattc_open 会等待外部连接完成通知,不能把本文的同步 INT_CONN 分支直接套上去。
服务目录的建立和 HID 安全检查仍可交错:bta_gattc_conn 能先启动目录发现,再发 OPEN 回调;HID 收到 OPEN 后就进入安全检查,不要求远端所有服务、特征和描述符已全部发现完成。

浙公网安备 33010602011771号