当前位置： 首页 > news >正文

【android bluetooth 协议分析 01】【HCI 层介绍 8】【ReadLocalVersionInformation命令介绍】

news 2025/5/20 5:17:18

1. HCI_Read_Local_Version_Information 命令介绍

在这里插入图片描述在这里插入图片描述

1. 功能（Description）

HCI_Read_Local_Version_Information 命令用于读取本地 Bluetooth Controller 的版本信息，包括 HCI 和 LMP 层的版本，以及厂商 ID 和子版本号。
这类信息用于 Host 识别当前控制器的 功能支持范围、厂商来源 及其具体的实现版本，通常用于以下场景：

  • 协议栈 兼容性判断
  • 对应厂商定制功能 条件启用
  • 调试定位 版本差异导致的问题

2.命令参数（Command Parameters）


11	2025-04-24 15:55:53.353695	host	controller	HCI_CMD	4	Sent Read Local Version InformationBluetooth HCI Command - Read Local Version InformationCommand Opcode: Read Local Version Information (0x1001)0001 00.. .... .... = Opcode Group Field: Informational Parameters (0x04).... ..00 0000 0001 = Opcode Command Field: Read Local Version Information (0x001)Parameter Total Length: 0[Response in frame: 12][Command-Response Delta: 0.572ms]

无参数
只需发送命令，不带任何附加内容。

3.返回参数（Return Parameters）

12	2025-04-24 15:55:53.354267	controller	host	HCI_EVT	15	Rcvd Command Complete (Read Local Version Information)Bluetooth HCI Event - Command CompleteEvent Code: Command Complete (0x0e)Parameter Total Length: 12Number of Allowed Command Packets: 1Command Opcode: Read Local Version Information (0x1001)0001 00.. .... .... = Opcode Group Field: Informational Parameters (0x04).... ..00 0000 0001 = Opcode Command Field: Read Local Version Information (0x001)Status: Success (0x00)HCI Version: 5.3 (0x0c)HCI Revision: 0LMP Version: 5.3 (0x0c)Manufacturer Name: Qualcomm (0x001d)LMP Subversion: 29337[Command in frame: 11][Command-Response Delta: 0.572ms]
参数名大小描述
Status1 字节表示命令执行结果，0x00 表示成功
HCI_Version1 字节控制器 HCI 层的版本号
HCI_Subversion2 字节控制器厂商定义的 HCI 子版本号
LMP_Version1 字节LMP（Link Manager Protocol）版本号
Company_Identifier2 字节控制器厂商 ID，定义于 Bluetooth SIG
LMP_Subversion2 字节厂商自定义的 LMP 子版本号

4. 事件

成功后，Controller 会通过 HCI_Command_Complete 事件返回这些参数。

2. aosp 中如何使用

1. 字段作用与 AOSP 中的意义

下面我们逐个解释这些字段在 AOSP 蓝牙协议栈（如 stack/bt） 中的用途和意义：

1. HCI_Version（1 byte）

  • 定义：控制器实现的 HCI 层版本
  • 可能值：
值含义
0x06Bluetooth 4.0
0x07Bluetooth 4.1
0x08Bluetooth 4.2
0x09Bluetooth 5.0
0x0ABluetooth 5.1
…持续增长
  • 在 AOSP 中的作用：
    • 用于判断是否支持某些 HCI 命令或功能，比如 Extended Advertising（需要 BT5.0+）
    • 控制某些 feature 的使能与 fallback（降级）策略

2. HCI_Subversion（2 bytes）

  • 定义：控制器厂商定义的子版本号（可能代表固件版本）
  • 在 AOSP 中的作用：
    • 主要用于 调试 和 厂商定制功能的兼容适配
    • 某些厂商驱动层（如 Qualcomm 或 Broadcom）可能会用这个字段判断是否加载特定补丁

3. LMP_Version（1 byte）

  • 定义：Link Manager Protocol 的版本号，用于表示底层链路控制协议的版本

  • 常见值：

值LMP 版本标准版本
0x06LMP 6BT 2.0
0x07LMP 7BT 2.1
0x08LMP 8BT 3.0
0x09LMP 9BT 4.0
………
  • 在 AOSP 中的作用：
    • 判断是否支持特性如 eSCO、Secure Simple Pairing、LE、BR/EDR coexistence
    • 某些协议或逻辑的 fallback 依据

4. Company_Identifier（2 bytes）

  • 定义：厂商 ID，由 Bluetooth SIG 分配
  • 例子：
ID厂商
0x000FBroadcom
0x000CCSR
0x001DApple
0x003DIntel
0x0001Cambridge Silicon Radio (CSR)
  • 在 AOSP 中的作用：
    • 用于厂商特定补丁加载
    • 在 log 中标记设备来源
    • 控制 chipset-specific workarounds

5. LMP_Subversion（2 bytes）

  • 定义：LMP 层的子版本号，由厂商定义
  • 在 AOSP 中的作用：
    • 仅对特定厂商驱动有用
    • 通常用于识别固件版本差异
    • 与 HCI_Subversion 一起，辅助调试判断“是否为某个具体平台”

2.这些版本信息“能干啥”？意义在哪里？

用途说明
功能判断判断 Controller 是否支持特定协议功能，如 LE Extended Advertising、Secure Connections 等
厂商识别确定芯片是 Broadcom、Qualcomm、Intel 还是其他，从而决定加载哪些定制行为
平台兼容在 AOSP 中决定是否使用某些 vendor hooks 或者是否 fallback 某些功能
调试分析蓝牙功能异常时用于判断是否为固件版本问题
日志可读性蓝牙连接日志中可以清晰显示 Controller 的版本与厂商，方便排查

3. aosp 中的例子

  
// system/gd/hci/controller.ccstruct Controller::impl {void Start(hci::HciLayer* hci) {
...hci_->EnqueueCommand(ReadLocalVersionInformationBuilder::Create(),handler->BindOnceOn(this, &Controller::impl::read_local_version_information_complete_handler));...
}

在 Controller::impl::Start 函数中，我们会获取 本地蓝牙控制器的版本信息。
当我们获取到内容后，回调 read_local_version_information_complete_handler

1. read_local_version_information_complete_handler


// system/gd/hci/controller.ccvoid read_local_version_information_complete_handler(CommandCompleteView view) {auto complete_view = ReadLocalVersionInformationCompleteView::Create(view);ASSERT(complete_view.IsValid());ErrorCode status = complete_view.GetStatus();ASSERT_LOG(status == ErrorCode::SUCCESS, "Status 0x%02hhx, %s", status, ErrorCodeText(status).c_str());local_version_information_ = complete_view.GetLocalVersionInformation();bluetooth::os::LogMetricBluetoothLocalVersions(local_version_information_.manufacturer_name_,static_cast<uint8_t>(local_version_information_.lmp_version_),local_version_information_.lmp_subversion_,static_cast<uint8_t>(local_version_information_.hci_version_),local_version_information_.hci_revision_);}
  • 最终将 controller 获取到的版本信息，保存在 local_version_information_ 中。
LocalVersionInformation Controller::GetLocalVersionInformation() const {return impl_->local_version_information_;
}
  • 通过 Controller::GetLocalVersionInformation 来获取版本信息

看看如何使用

// system/main/shim/controller.cc
static const char GD_CONTROLLER_MODULE[] = "gd_controller_module";EXPORT_SYMBOL extern const module_t gd_controller_module = {.name = GD_CONTROLLER_MODULE,.start_up = start_up, // 这里};static future_t* start_up(void) {LOG_INFO("%s Starting up", __func__);data_.ready = true;if (gd_rust_is_enabled()) {} else {// 获取 mac 地址std::string string_address = GetController()->GetMacAddress().ToString();RawAddress::FromString(string_address, data_.raw_address);data_.le_supported_states =bluetooth::shim::GetController()->GetLeSupportedStates();// 获取 localVersionInfoauto local_version_info =bluetooth::shim::GetController()->GetLocalVersionInformation();data_.bt_version.hci_version =static_cast<uint8_t>(local_version_info.hci_version_);data_.bt_version.hci_revision = local_version_info.hci_revision_;data_.bt_version.lmp_version =static_cast<uint8_t>(local_version_info.lmp_version_);data_.bt_version.lmp_subversion = local_version_info.lmp_subversion_;data_.bt_version.manufacturer = local_version_info.manufacturer_name_;LOG_INFO("Mac address:%s", string_address.c_str());}

在 gd_controller_module 模块的 start_up 函数中，我们会将 local version info 信息放置在 data_.bt_version 中

// system/main/shim/controller.cc
static const RawAddress* get_address(void) { return &data_.raw_address; }static const bt_version_t* get_bt_version(void) { return &data_.bt_version; }

2. 使用案例

1. BTM_SetBleDataLength
// system/stack/btm/btm_ble.cc
tBTM_STATUS BTM_SetBleDataLength(const RawAddress& bd_addr,uint16_t tx_pdu_length) {
...if (controller_get_interface()->get_bt_version()->hci_version >=HCI_PROTO_VERSION_5_0)tx_time = BTM_BLE_DATA_TX_TIME_MAX;...}

根据 hci_version 来调整 ble 数据发送最大时间。

2.BTM_CreateSco
// system/stack/btm/btm_sco.cctBTM_STATUS BTM_CreateSco(const RawAddress* remote_bda, bool is_orig,uint16_t pkt_types, uint16_t* p_sco_inx,tBTM_SCO_CB* p_conn_cb, tBTM_SCO_CB* p_disc_cb) {...if (controller_get_interface()->get_bt_version()->hci_version >=HCI_PROTO_VERSION_2_0) {p_setup->packet_types |=(pkt_types & BTM_SCO_EXCEPTION_PKTS_MASK) |(btm_cb.btm_sco_pkt_types_supported & BTM_SCO_EXCEPTION_PKTS_MASK);}
...
}
3.l2cu_set_acl_priority 和 l2cu_set_acl_latency
// system/stack/l2cap/l2c_utils.cc
bool l2cu_set_acl_priority(const RawAddress& bd_addr, tL2CAP_PRIORITY priority,bool reset_after_rs) {...if ((!reset_after_rs && (priority != p_lcb->acl_priority)) ||(reset_after_rs && p_lcb->acl_priority == L2CAP_PRIORITY_HIGH)) {/* Use vendor specific commands to set the link priority */switch (controller_get_interface()->get_bt_version()->manufacturer) {case LMP_COMPID_BROADCOM:l2cu_set_acl_priority_latency_brcm(p_lcb, priority);break;case LMP_COMPID_SYNAPTICS:l2cu_set_acl_priority_syna(p_lcb->Handle(), priority);break;default:/* Not supported/required for other vendors */break;}}...
}bool l2cu_set_acl_latency(const RawAddress& bd_addr, tL2CAP_LATENCY latency) {
.../* only change controller's latency when stream using latency mode */if (p_lcb->use_latency_mode && p_lcb->is_high_priority() &&latency != p_lcb->acl_latency) {switch (controller_get_interface()->get_bt_version()->manufacturer) {case LMP_COMPID_BROADCOM:l2cu_set_acl_latency_brcm(p_lcb, latency);break;default:/* Not supported/required for other vendors */break;}p_lcb->set_latency(latency);}
...
}

根据不同的厂商做不同的处理

http://www.xdnf.cn/news/523747.html

相关文章：

  • 【Android构建系统】Soong构建系统，通过.bp + .go定制编译
  • MySQL 故障排查与生产环境优化
  • verify_ssl 与 Token 验证的区别详解
  • Node 服务监控及通过钉钉推送告警提醒
  • 3.安卓逆向2-安卓文件目录
  • WPF点击按钮弹出一个窗口
  • 深入理解 Hadoop 核心组件 Yarn：架构、配置与实战
  • 物联网简介：万物互联的未来图景
  • Eclipse Java 开发调优：如何让 Eclipse 运行更快？
  • Spring Cloud Seata 深度解析：原理与架构设计
  • 甘特图工具怎么选？免费/付费项目管理工具对比测评（2025最新版）
  • java中如何优雅处理多租户系统的查询？
  • Hexo的Next主题的Config文件内方便修改的参数（Chat-Gpt）
  • 多线程进阶
  • java每日精进 5.19【Excel 导入导出】
  • 使用Python将 Excel 中的图表、形状和其他元素导出为图片
  • YouTube视频字幕转成文章算重复内容吗？
  • FD+Mysql的Insert时的字段赋值乱码问题
  • ffmpeg 把一个视频复制3次
  • java配置webSocket、前端使用uniapp连接
  • 【git config --global alias | Git分支操作效率提升实践指南】
  • 开源音视频转文字工具：基于 Vosk 和 Whisper 的多语言语音识别项目
  • 数据分析与应用---数据可视化基础
  • 精益数据分析（70/126）：MVP迭代中的数据驱动决策与功能取舍
  • 【three】给立方体的每个面加载不同贴图
  • 【工具】ncdu工具安装与使用指南：高效管理Linux磁盘空间
  • javaScript学习第三章(流程控制小练习)
  • 华为ODgolang后端一面面经
  • uniapp自用辅助类小记
  • Fiddler无法抓包的问题分析