安卓BLE HID跨层交互与状态机
AI 生成声明:本文内容由 AI 生成或经 AI 辅助完成,请注意甄别。
接《安卓HID连接与服务发现》。这里用一次 BLE 遥控器连接说明:Java、JNI、BTIF 和 BTA 怎样交接请求,HH 与 GATTC 怎样各自推进状态,以及服务搜索为什么有时需要等。
假设遥控器已配对,BLE/ATT 链路已建立并加密,GATTC 正在构建同一远端设备的服务目录,HH 尚无可用的 HID 服务和报告信息。这是正常分支示例。源码链接使用 AOSP Android 9 固定版本 android-9.0.0_r61。
跨层时序:从 Java 请求到 HID CONNECTED

| 位置 | 负责的事 |
|---|---|
| Java · HidHostService | 检查连接请求,维护对上层可见的 HID Profile 状态,广播状态变化。 |
| JNI | 把 Java 调用转到原生 HID 接口,把原生状态回调交回 Java。 |
| BTIF | 接收接口请求,检查原生 HID 资源,向 BTA 发起业务,再接回 HID 结果。 |
| BTA HH | 按设备推进 HID 业务:打开 GATT 客户端、安全检查、读取报告信息和配置通知。 |
| BTA GATTC | 按客户端连接推进 Open、服务发现和读写。多个客户端可以指向同一远端设备的服务目录。共享目录绑定 |
时序图从上往下读。虚线为异步消息,实线为直接调用或同步回调。调用表一跳一行,└─ 表示本段内的下一层;同一缩进表示回到同一调用者继续执行。⇢ 表示异步投递,接收端另起一段。HH 和 GATTC 都在 BTA 层,分别使用 HH 设备控制块和 GATTC 客户端连接控制块。即使两个模块都写着 W4_CONN,等的东西也不同:GATTC 等客户端连接就绪,HH 则还要完成 HID 初始化。
Java → JNI → BTIF → HH
Java 服务发起连接
| 代码调用 | 辅助说明 |
|---|---|
| HidHostService.connect(device) | 检查权限、连接状态和 priority。 |
| └─ mHandler.sendMessage(msg) | ⇢ 投递 MESSAGE_CONNECT,接收见下一段。返回 true 表示请求已提交。 |
Java Handler 收到 MESSAGE_CONNECT
| 代码调用 | 辅助说明 |
|---|---|
| case MESSAGE_CONNECT | 进入 Java Handler 的连接处理。 |
| └─ connectHidNative(address) | 调用 JNI。 |
| └─ sBluetoothHidInterface->connect(address) | 同步调用 HID 接口;接口的 connect 槽位绑定到 BTIF 的 connect()。 |
| └─ btif_transfer_context(..., BTIF_HH_CONNECT_REQ_EVT, ...) | ⇢ 投递连接请求,接收见下一段。 |
BTIF 收到 BTIF_HH_CONNECT_REQ_EVT
| 代码调用 | 辅助说明 |
|---|---|
| case BTIF_HH_CONNECT_REQ_EVT | 切到 BTIF 业务上下文。 |
| └─ btif_hh_connect(bd_addr) | 检查资源和设备状态。 |
| └─ BTA_HhOpen(bd_addr, mode, sec_mask) | 交给 BTA 的 HH 接口。 |
| └─ bta_sys_sendmsg(p_buf) | ⇢ 投递 BTA_HH_API_OPEN_EVT,接收见下一段。 |
HH 收到 BTA_HH_API_OPEN_EVT
| 代码调用 | 辅助说明 |
|---|---|
| bta_hh_hdl_event(p_msg) | Open 分支按远端地址查找 HH 设备控制块。 |
| └─ bta_hh_sm_execute(p_cb, event, p_data) | IDLE + API_OPEN → START_SDP / W4_CONN,先更新状态再执行动作。 |
| └─ (*bta_hh_action[action])(p_cb, p_data) | START_SDP 对应 bta_hh_start_sdp。 |
| └─ bta_hh_le_open_conn(p_cb, bd_addr) | 被识别为 BLE 的设备走 LE 分支。 |
| └─ BTA_GATTC_Open(gatt_if, bd_addr, true, LE, false) | 请求为 HID 的 GATT 客户端打开连接。 |
| └─ bta_sys_sendmsg(p_buf) | ⇢ 投递 BTA_GATTC_API_OPEN_EVT,接收见下一节。 |
查看 JNI 绑定和 HID 接口来源
- Java 方法和原生函数的绑定在JNI 方法表,由注册调用注册。
- JNI 初始化时调用 get_profile_interface(HIDHOST);原生 profile 分派调用 btif_hh_get_interface(),后者返回 bthhInterface。
HH ↔ GATTC:同层交互和状态机重入
GATTC 收到 BTA_GATTC_API_OPEN_EVT
| 代码调用 | 辅助说明 |
|---|---|
| case BTA_GATTC_API_OPEN_EVT | GATTC 在 BTA 上下文处理自己的 Open 事件。 |
| └─ bta_gattc_process_api_open(p_msg) | 按客户端与设备取得 GATTC 连接控制块。 |
| └─ bta_gattc_sm_execute(p_clcb, event, p_msg) | IDLE + API_OPEN → OPEN / W4_CONN。先更新状态,再取动作。 |
| └─ (*bta_gattc_action[action])(p_clcb, p_data) | OPEN 对应 bta_gattc_open。 |
| └─ GATT_Connect(client_if, remote_bda, ...) | 本例复用已建立的 BLE/ATT 链路。 |
| └─ gatt_act_connect(p_reg, bd_addr, ...) | direct 分支请求使用链路。 |
| └─ gatt_update_app_use_link_flag(...) | 记录 HID 客户端正在使用链路。 |
| └─ GATT_GetConnIdIfConnected(...) | 回到 bta_gattc_open,取得已存在的 conn_id。 |
| └─ bta_gattc_sm_execute(p_clcb, BTA_GATTC_INT_CONN_EVT, ...) | 同步重入本状态机。W4_CONN + INT_CONN → CONN / CONN_ST。 |
| └─ (*bta_gattc_action[action])(p_clcb, p_data) | CONN 对应 bta_gattc_conn。 |
| └─ p_clcb->state = BTA_GATTC_DISCOVER_ST | 本例服务目录仍在构建。其他目录处理分支也汇合到下方 Open 回调。 |
| └─ bta_gattc_send_open_cback(...) | 继续在同一个 bta_gattc_conn 中通知客户端已打开。 |
| └─ (*p_clreg->p_cback)(BTA_GATTC_OPEN_EVT, &cb_data) | 同步回调到 HH,下面单独展开回调内部。 |
HH 同步接收 GATTC OPEN,继续自己的安全检查
| 代码调用 | 辅助说明 |
|---|---|
| case BTA_GATTC_OPEN_EVT | bta_hh_gattc_callback 收到上段同步回调。 |
| └─ bta_hh_sm_execute(p_dev_cb, BTA_HH_GATT_OPEN_EVT, ...) | 转成 HH 自己的事件。W4_CONN + GATT_OPEN → GATT_OPEN / W4_CONN。 |
| └─ (*bta_hh_action[action])(p_cb, p_data) | GATT_OPEN 对应 bta_hh_gatt_open。 |
| └─ p_cb->conn_id = p_data->conn_id | 保存 GATT 连接 ID。 |
| └─ bta_hh_sm_execute(p_cb, BTA_HH_START_ENC_EVT, NULL) | W4_CONN + START_ENC → START_SEC / W4_SEC。 |
| └─ (*bta_hh_action[action])(p_cb, p_data) | START_SEC 对应 bta_hh_start_security。 |
| └─ bta_hh_sm_execute(p_cb, BTA_HH_ENC_CMPL_EVT, NULL) | 已加密分支同步触发。W4_SEC + ENC_CMPL → SEC_CMPL / W4_CONN。 |
| └─ (*bta_hh_action[action])(p_cb, p_data) | SEC_CMPL 对应 bta_hh_security_cmpl。安全检查已过,继续等待 HID 初始化。 |
| └─ bta_hh_le_pri_service_discovery(p_cb) | 本例没有可复用的 HID 信息,进入服务初始化。其内部搜索请求见下一节。 |
查看 GATTC 回调注册及链路未建立时的分支
- HH 初始化时注册 bta_hh_gattc_callback,把注册业务交给 BTA 线程。注册端把函数指针保存到 GATTC 注册对象,完成回调把 client_if 保存到 HH。
- 若链路尚未连接,bta_gattc_open 从查询连接的分支返回并等待外部连接完成。底层 GATT 回调投递 INT_CONN,GATTC 接收后执行状态机,汇合到相同的 CONN 动作。
- DM 和 HH 可以是各自独立的 GATT 客户端。DM 有自己的注册回调和自己的 Open 请求;底层 GATTC 按远端地址查找服务目录。
GATTC 内部轮转:同一个搜索事件的两条路

HH 发出 HID 服务搜索
| 代码调用 | 辅助说明 |
|---|---|
| bta_hh_le_pri_service_discovery(p_cb) | 从上节安全检查成功且无可复用 HID 信息的分支进入。 |
| └─ DIS_ReadDISInfo(..., bta_hh_le_dis_cback, ...) | 并行请求 DIS 的 PnP ID,完成回调见下一节。 |
| └─ BTA_GATTC_ServiceSearchRequest(conn_id, &pri_srvc) | 查询目录里的 HID 主服务。 |
| └─ bta_sys_sendmsg(p_buf) | ⇢ 投递 BTA_GATTC_API_SEARCH_EVT,接收见下一段。 |
GATTC 收到搜索请求,服务目录仍在构建
| 代码调用 | 辅助说明 |
|---|---|
| bta_gattc_sm_execute(p_clcb, p_msg->event, ...) | 本例客户端处于 DISCOVER_ST。 |
| └─ DISCOVER_ST + API_SEARCH → Q_CMD / DISCOVER_ST | 先暂存请求。 |
| └─ (*bta_gattc_action[action])(p_clcb, p_data) | Q_CMD 对应 bta_gattc_q_cmd。 |
| └─ bta_gattc_enqueue(p_clcb, p_data) | 将请求交给控制块的等待槽。 |
| └─ p_clcb->p_q_cmd = p_data | 槽位空闲时保存,等待目录完成。 |
目录完成后重跑请求
| 代码调用 | 辅助说明 |
|---|---|
| bta_gattc_reset_discover_st(p_srcb, GATT_SUCCESS) | 共享目录已就绪,通知相关客户端。 |
| └─ bta_gattc_sm_execute(..., BTA_GATTC_DISCOVER_CMPL_EVT, NULL) | 每个使用该目录的客户端分别推进。DISCOVER_ST + DISCOVER_CMPL → DISC_CMPL / CONN_ST。 |
| └─ (*bta_gattc_action[action])(p_clcb, p_data) | DISC_CMPL 对应 bta_gattc_disc_cmpl。 |
| └─ bta_gattc_sm_execute(p_clcb, p_q_cmd->hdr.event, p_q_cmd) | 链路仍在且无需再次发现时,同步重跑暂存请求,进入下段的 CONN_ST 分支。 |
GATTC 在 CONN_ST 查询目录,结果同步回到 HH
| 代码调用 | 辅助说明 |
|---|---|
| CONN_ST + API_SEARCH → SEARCH / CONN_ST | 目录已可用时首次收到请求就走这里;暂存后重跑也汇合于此。 |
| └─ (*bta_gattc_action[action])(p_clcb, p_data) | SEARCH 对应 bta_gattc_search。 |
| └─ bta_gattc_search_service(p_clcb, p_srvc_uuid) | 查询本地 GATT 服务目录。 |
| └─ (*p_clcb->p_rcb->p_cback)(BTA_GATTC_SEARCH_CMPL_EVT, ...) | 查询返回后,同步调用已注册的 HH 业务回调。 |
| └─ bta_hh_le_srvc_search_cmpl(&p_data->search_cmpl) | 处理查询结果。是否有 HID 主服务,看HH 对服务 UUID 的检查。 |
HH 完成初始化 → BTIF → Java
HH 读取 HID 特征并开始配置输入通知
| 代码调用 | 辅助说明 |
|---|---|
| bta_hh_le_srvc_search_cmpl(p_data) | 展开上节的 HH 搜索完成处理。 |
| └─ bta_hh_le_search_hid_chars(p_dev_cb, &service) | 找到主服务后遍历 HID 特征。 |
| └─ BtaGattQueue::ReadCharacteristic(..., read_hid_report_map_cb, ...) | 将 Report Map 的读取入队。它描述遥控器输入报告的格式。 |
| └─ bta_hh_le_gatt_disc_cmpl(p_dev_cb, p_dev_cb->status) | 回到搜索完成处理,进入 HID 发现收尾。 |
| └─ bta_hh_le_write_rpt_clt_cfg(p_cb) | 成功分支开始配置输入报告通知。 |
| └─ bta_hh_le_write_ccc(..., write_rpt_ctl_cfg_cb, p_cb) | 为 CCC 写操作传入完成回调,结果回来后进入下一段。 |
CCC 写回调推进下一项;DIS 独立收尾
| 代码调用 | 辅助说明 |
|---|---|
| tmp_cb(conn_id, status, handle, tmp_cb_data) | 上段传入的 write_rpt_ctl_cfg_cb 由 GATT 操作队列调用。 |
| └─ p_dev_cb->clt_cfg_idx++ | 推进到下一项输入报告。 |
| └─ bta_hh_le_write_rpt_clt_cfg(p_dev_cb) | 驱动下一项配置。列表走完时清除 HID 服务发现标志。 |
| └─ bta_hh_le_open_cmpl(p_cb) | 配置分支完成,尝试汇合。 |
| p_cb->disc_active &= ~BTA_HH_LE_DISC_DIS | DIS 读取结束后独立清除自己的标志,两边完成顺序可以不同。 |
| └─ bta_hh_le_open_cmpl(p_cb) | DIS 分支也尝试汇合。 |
HH 两个发现标志清除后完成 Open
| 代码调用 | 辅助说明 |
|---|---|
| p_cb->disc_active == BTA_HH_LE_DISC_NONE | 两条完成路径汇合在同一个条件;任一标志未清除就继续等待。 |
| └─ bta_hh_le_register_input_notif(p_cb, p_cb->mode, true) | 注册本地输入通知接收。 |
| └─ bta_hh_sm_execute(p_cb, BTA_HH_OPEN_CMPL_EVT, NULL) | W4_CONN + OPEN_CMPL → OPEN_CMPL_ACT / CONN_ST。 |
| └─ (*bta_hh_action[action])(p_cb, p_data) | OPEN_CMPL_ACT 对应 bta_hh_open_cmpl_act。 |
| └─ bta_hh_co_open(...) | 初始化设备驱动侧。 |
| └─ (*bta_hh_cb.p_cback)(BTA_HH_OPEN_EVT, ...) | 同步调用已注册的 BTIF 回调 bte_hh_evt。 |
| └─ btif_transfer_context(btif_hh_upstreams_evt, event, ...) | ⇢ 把 BTA_HH_OPEN_EVT 异步转到 BTIF 业务上下文。 |
BTIF 收到 BTA_HH_OPEN_EVT,向 Java 回报
| 代码调用 | 辅助说明 |
|---|---|
| case BTA_HH_OPEN_EVT | BTIF 接收上段消息。成功路径还要求能找到设备、UHID 文件描述符有效。 |
| └─ HAL_CBACK(..., connection_state_cb, ...) | 上报 BTHH_CONN_STATE_CONNECTED。 |
| └─ CallVoidMethod(..., method_onConnectStateChanged, ...) | JNI 同步回调 Java 的 onConnectStateChanged()。 |
| └─ mHandler.sendMessage(msg) | ⇢ 投递 MESSAGE_CONNECT_STATE_CHANGED,接收见下一段。 |
Java Handler 收到 MESSAGE_CONNECT_STATE_CHANGED
| 代码调用 | 辅助说明 |
|---|---|
| case MESSAGE_CONNECT_STATE_CHANGED | 在 Java Handler 上下文接收状态变化。 |
| └─ broadcastConnectionState(device, convertHalState(halState)) | 正常分支上报新的 HID Profile 状态。 |
| └─ mInputDevices.put(device, newState) | 更新设备的 Java 状态。 |
| └─ sendBroadcastAsUser(intent, ...) | 广播 HID Profile 状态变化。 |
查看从 HH 返回 BTIF、JNI、Java 的回调绑定
看日志时怎样判断卡在哪
| 已看到的事件 | 可以确认什么 | 下一步看哪里 |
|---|---|---|
BTA_GATTC_OPEN_EVT 成功 |
GATT 客户端已打开,HH 可以继续安全检查。 | 看 HH 是否发起搜索、GATTC 目录是否就绪、暂存请求有没有重新执行。 |
BTA_GATTC_SEARCH_CMPL_EVT 成功 |
GATTC 已完成目录查询。 | 看 HH 有没有找到 HID 主服务,Report Map 和通知配置是否推进,DIS/HID 发现标志有没有清除。 |
BTA_HH_OPEN_EVT 成功 |
HH 已完成 HID 连接初始化。 | 若 Java 仍未更新,查 BTIF 是否找到设备、UHID 是否可用,以及 JNI 和 Java Handler 是否收到状态。 |
这里跟到 Java 的 HID Profile 状态广播。ATT 报文收发、UHID 描述符交给内核,以及具体按键报告的上报链路,属于后续阶段。

浙公网安备 33010602011771号