安卓HID连接与服务发现

HID设备可用:

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

安卓 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,业务接收见下一表。
代码调用 辅助说明
bta_gattc_hdl_event(): case BTA_GATTC_API_OPEN_EVT 接收打开事件;BTU/BTA 业务上下文。
 └─ bta_gattc_process_api_open(p_msg) 按 client_if 找注册对象;HID 的 direct 请求继续下面分支。
  └─ bta_gattc_find_alloc_clcb(client_if, remote_bda, transport) 取得这个 GATT client 的连接控制块。
  └─ bta_gattc_sm_execute(p_clcb, API_OPEN, p_msg) 进入 GATTC 状态机。
   └─ API_OPEN → {BTA_GATTC_OPEN, W4_CONN} 本节正常打开分支的状态/动作映射。
   └─ (*bta_gattc_action[action])(p_clcb, p_data) 动作表 L73 将 BTA_GATTC_OPEN 绑定到 bta_gattc_open。
    └─ bta_gattc_open(p_clcb, p_data) 执行打开/持有链路的业务动作。
     └─ GATT_Connect(client_if, remote_bda, true, transport, opportunistic, initiating_phys) 使用带 initiating_phys 的重载;不是另建一个 HID 专属无线链路。
      └─ gatt_act_connect(p_reg, bd_addr, transport, opportunistic, initiating_phys) direct 分支进入底层 GATT 的连接/链路持有处理。
       └─ gatt_update_app_use_link_flag(gatt_if, p_tcb, true, false) 已有打开链路且非 opportunistic 时,记录该 client 正在使用链路。
     └─ GATT_GetConnIdIfConnected(client_if, remote_bda, &conn_id, transport) 同一 bta_gattc_open 中继续执行:确认连接已建立并取得 conn_id。
     └─ bta_gattc_sm_execute(p_clcb, BTA_GATTC_INT_CONN_EVT, &gattc_data) 已有连接的直接完成分支;这次是同步调用状态机,不是异步发消息。
      └─ INT_CONN → {BTA_GATTC_CONN, CONN_ST} GATTC 的 W4_CONN 状态收到连接完成事件。
      └─ (*bta_gattc_action[BTA_GATTC_CONN])(p_clcb, p_data) 动作表 L79 绑定 bta_gattc_conn;继续下一段。

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 后就进入安全检查,不要求远端所有服务、特征和描述符已全部发现完成。

posted @ 2026-11-18 17:21  feige123456  阅读(2)  评论(0)    收藏  举报