安卓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

BLE HID 遥控器连接的跨层时序

位置 负责的事
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 接口来源

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 回调注册及链路未建立时的分支

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 描述符交给内核,以及具体按键报告的上报链路,属于后续阶段。

posted @ 2026-11-18 18:38  feige123456  阅读(3)  评论(0)    收藏  举报