【0x0001】HCI_Read_Local_Version_Information详解

HCI_Read_Local_Version_Information 是蓝牙核心规范（Bluetooth Core Specification）中定义的一个主机控制器接口（Host Controller Interface, HCI）命令。该命令用于从蓝牙控制器（如蓝牙芯片或模块）获取其版本信息，包括硬件版本、LMP（Link Manager Protocol）版本以及制造商信息。这对于了解蓝牙设备的兼容性、调试和特性支持非常有用。

一、命令概述

HCI_Read_Local_Version_Information 主要用于读取本地控制器（通常是指蓝牙设备中的控制器部分）的版本信息相关的值。

通过执行该命令，可以获取到关于蓝牙设备在不同层面的版本以及制造商等关键信息，这些信息对于了解设备的特性、兼容性以及进行相关的调试、开发等工作都非常重要。

二、命令格式

HCI_Read_Local_Version_Information 命令的格式非常简单，不包含任何参数。

其结构如下：

• Opcode：16位操作码，用于标识命令。
• Parameter Total Length：8位，表示命令参数的总长度。对于此命令，该值为 0，因为没有参数。

命令示例：

| Opcode         | Parameter Total Length |  
|----------------|------------------------|  
| 0x1001         | 0x00                   |

三、响应命令格式及参数说明

当HCI_Read_Local_Version_Information命令执行完成后，蓝牙控制器会生成一个HCI_Command_Complete事件。这个事件是蓝牙核心规范中定义的一种标准HCI事件，用于通知主机（例如，计算机、智能手机等）HCI命令已经成功完成，并且附带了命令执行的结果。

3.1. HCI_Command_Complete事件格式

HCI_Command_Complete事件的格式通常包括以下几个字段：

• Event Code：8位字段，表示事件类型。对于HCI_Command_Complete事件，事件码固定为0x0E。
• Packet Length：8位字段，表示事件数据包的长度（包括所有后续字段）。
• Opcode：16位字段，表示已经完成的HCI命令的操作码。。
• Return Parameters：这是一个可变长度的字段，包含了命令执行的结果。对于HCI_Read_Local_Version_Information命令，返回参数将包括HCI版本、HCI修订、LMP版本、制造商名称（Company Identifier），以及可能还包括LMP子版本（如果蓝牙控制器支持的话）。

响应示例：

| Event Code     | Parameter Length | HCI Version | HCI Revision | LMP Version | Manufacturer Name | LMP Subversion |  
|----------------|------------------|-------------|--------------|-------------|------------------|----------------|  
| 0x0E           | 0x08             | 0x06        | 0x9652       | 0x06        | 0x0059           | 0x0000         |

3.2. 对于HCI_Read_Local_Version_Information命令返回参数

3.2.1. Status

status字段是一个8位（1字节）的字段，用于表示HCI_Read_Local_Version_Information命令的执行结果。它的值决定了后续字段的存在与否以及它们的解释方式。

• 0x00：HCI_Read_Local_Version_Information命令成功执行。后续字段将包含请求的版本信息，如HCI版本、HCI修订、LMP版本、制造商名称等。
• 0x01至0xFF：HCI_Read_Local_Version_Information命令执行失败。
  • 后续操作：后续字段（如果有的话）可能无法正确解释或根本不存在。此时，应参考蓝牙核心规范的第一卷（Vol 1）的F部分，即控制器错误代码列表，来查找具体的错误代码及其描述。蓝牙Controller错误代码全面概览_lmp response timeout-CSDN博客
  • 这些错误代码通常与蓝牙控制器的硬件或固件实现相关，并且可能因不同的制造商而异。

3.2.2. HCI_Version

• 这是一个8位字段，用于表示HCI（Host Controller Interface）层的版本号。
• HCI版本通常遵循蓝牙核心规范的版本，例如，蓝牙5.0、蓝牙5.1等。
• 字段的值会根据蓝牙规范的版本而变化。

3.2.3. HCI_Subversion

• 这是一个16位字段，用于表示HCI层的修订版本号。
• 修订版本提供了关于HCI层实现的更详细信息，可能包括错误修复、性能改进或新功能。
• 字段的值是控制器制造商定义的，并且可能因不同的控制器而异。

3.2.4. LMP_Version

• 这是一个8位字段，用于表示LMP（Link Manager Protocol）层的版本号。
• LMP是蓝牙协议栈中负责链路管理的一部分，包括建立、维护和终止蓝牙连接。
• LMP版本通常与HCI版本相关联，但可能有所不同，因为LMP版本可能更频繁地更新以修复安全问题或添加新功能。

3.2.5. Company_Identifier

• 这是一个16位字段，用于表示蓝牙控制器的制造商ID。
• 制造商ID是一个唯一的标识符，用于区分不同的蓝牙控制器制造商。
• 字段的值是根据蓝牙SIG（Special Interest Group）分配的制造商ID列表来确定的。

3.2.6. LMP_Subversion（可选）

• 这是一个16位字段，如果蓝牙控制器支持的话，用于提供关于LMP层的进一步详细信息。
• 并非所有蓝牙控制器都支持LMP子版本字段。如果控制器不支持该字段，则不会在响应中包含它。
• 字段的值是控制器制造商定义的，并且可能因不同的控制器而异。

当蓝牙控制器接收到HCI_Read_Local_Version_Information命令时，它会读取上面这些参数的值，并将它们作为响应的一部分返回给主机。主机可以使用这些信息来了解蓝牙控制器的版本和制造商，以及确定是否支持特定的蓝牙功能或特性。

四、命令执行流程

4.1. 命令发起阶段（主机）

• 决定获取版本信息：主机在需要了解本地蓝牙控制器版本信息的场景下，决定发起HCI_Read_Local_Version_Information命令。
• 构建命令数据包：根据蓝牙核心规范，主机构建命令数据包，其中主要包含固定的命令操作码。由于此命令不需要额外参数，因此参数长度为0字节。
• 发送命令：主机通过HCI传输层（如UART、USB等）将构建好的命令数据包发送给蓝牙控制器。

4.2. 命令接收与处理阶段（蓝牙控制器）

• 接收命令：蓝牙控制器接收到来自主机的命令数据包。
• 验证命令格式：控制器检查命令数据包的格式，特别是验证操作码和参数长度是否正确。
• 提取与封装版本信息：如果命令格式正确，控制器提取本地版本信息，包括HCI版本、LMP版本、公司标识符等，并将这些信息按照规定的格式封装好。

4.3. 命令完成与反馈阶段（蓝牙控制器）

• 生成完成事件：控制器完成版本信息的提取和封装后，生成HCI_Command_Complete事件，表示命令执行完成。
• 返回版本信息和状态码：在HCI_Command_Complete事件中，控制器返回之前封装好的版本信息以及一个状态码。状态码用于指示命令是否成功执行。

4.4. 主机处理响应阶段

• 接收响应：主机通过HCI传输层接收来自蓝牙控制器的响应数据包。
• 解析响应：主机解析响应数据包，提取出状态码和版本信息。
• 检查状态码：主机检查状态码以确定命令是否成功执行。如果状态码为0x00，表示命令成功执行；如果状态码为非零值，表示命令执行失败，此时应参考蓝牙核心规范或制造商的文档进行故障排除。
• 处理版本信息：如果命令成功执行，主机将处理提取出的版本信息，用于后续操作或显示给用户。

4.5. 示例代码

以下是一个简化的代码示例，用于展示如何在一个假设的蓝牙主机环境中发送HCI_Read_Local_Version_Information命令，并处理蓝牙控制器的响应。

请注意，这只是一个非常基础的示例，并不包含完整的蓝牙协议栈实现或错误处理细节。在实际应用中，蓝牙协议栈的实现通常更为复杂，并且会包含更多的错误检查和状态管理。

#include <stdio.h>  
#include <stdint.h>  
#include <string.h>  
  
// 假设的HCI传输层函数声明（在实际应用中，这些函数会由蓝牙协议栈提供）  
void hci_send_command(uint16_t opcode, const uint8_t *params, uint8_t param_len);  
void hci_register_command_complete_callback(void (*callback)(const uint8_t *event, uint8_t event_len));  
  
// 假设的命令完成回调函数  
void on_command_complete(const uint8_t *event, uint8_t event_len) {  
    // 检查事件长度是否足够  
    if (event_len < 7) {  
        printf("Invalid event length\n");  
        return;  
    }  
  
    // 提取状态码  
    uint8_t status = event[1];  
  
    // 检查状态码是否为0（成功）  
    if (status == 0) {  
        // 提取HCI版本信息  
        uint8_t hci_version = event[4];  
        uint16_t hci_revision = (event[5] << 8) | event[6];  
        uint8_t lmp_version = event[7];  
        uint16_t manufacturer_name = (event[8] << 8) | event[9];  
        uint16_t lmp_subversion = (event[10] << 8) | event[11];  
  
        // 打印版本信息  
        printf("HCI Version: 0x%02X\n", hci_version);  
        printf("HCI Revision: 0x%04X\n", hci_revision);  
        printf("LMP Version: 0x%02X\n", lmp_version);  
        printf("Manufacturer Name: 0x%04X\n", manufacturer_name);  
        printf("LMP Subversion: 0x%04X\n", lmp_subversion);  
    } else {  
        // 打印错误状态码  
        printf("Command failed with status code: 0x%02X\n", status);  
    }  
}  
  
int main() {  
    // 注册命令完成回调函数  
    hci_register_command_complete_callback(on_command_complete);  
  
    // HCI_Read_Local_Version_Information命令的操作码  
    const uint16_t opcode = 0x1001;  
  
    // 由于此命令不需要参数，因此params为NULL，param_len为0  
    const uint8_t *params = NULL;  
    uint8_t param_len = 0;  
  
    // 发送命令  
    hci_send_command(opcode, params, param_len);  
  
    // 在实际应用中，这里通常会有一个等待或轮询机制来接收响应  
    // 由于这是一个简化的示例，我们没有实现这样的机制  
  
    return 0;  
}  
  
// 假设的HCI传输层函数实现（在实际应用中，这些函数会由蓝牙协议栈库提供）  
// 这里只是占位符，实际实现会涉及到底层通信（如UART、USB等）  
void hci_send_command(uint16_t opcode, const uint8_t *params, uint8_t param_len) {  
    // 发送命令的实现（省略）  
    printf("Sending HCI command: opcode=0x%04X, param_len=%u\n", opcode, param_len);  
}  
  
void hci_register_command_complete_callback(void (*callback)(const uint8_t *event, uint8_t event_len)) {  
    // 注册回调函数的实现（省略）  
    // 在实际应用中，这里会保存回调函数指针，并在接收到命令完成事件时调用它  
}

注意事项：

• 传输层实现：在实际应用中，hci_send_command和hci_register_command_complete_callback等函数会由蓝牙协议栈库提供，并且会涉及到底层通信（如UART、USB等）。在这个示例中，这些函数只是占位符。
• 事件处理：在实际应用中，通常会有一个事件循环或中断服务程序来接收和处理来自蓝牙控制器的响应。在这个示例中，我们没有实现这样的机制。
• 错误处理：在实际应用中，需要更详细的错误处理逻辑来应对各种可能的错误情况。这个示例只包含了一个简单的状态码检查。
• 同步/异步：在实际应用中，发送命令和接收响应可能是异步的，因此需要一个机制来确保在接收到响应之前不会继续执行其他操作。这个示例没有涉及这样的同步机制。
• 内存管理：在实际应用中，需要考虑内存分配和释放的问题，以确保不会发生内存泄漏。这个示例没有涉及内存管理。

五、使用场景

HCI_Read_Local_Version_Information命令在蓝牙技术中发挥着关键作用，其应用广泛，涵盖了从设备初始化到技术研究等多个方面。

5.1. 设备初始化与自检

• 场景描述：在蓝牙设备启动或重启时，设备需要通过自检来确认软件和硬件状态。
• 使用方式：发送HCI_Read_Local_Version_Information命令，获取蓝牙控制器的版本信息，包括HCI版本、LMP版本、制造商标识符等，以验证设备的基本配置和软硬件兼容性。

5.2. 设备兼容性检查

• 场景描述：在蓝牙设备尝试建立连接之前，需要确认设备间的兼容性。
• 使用方式：主机设备发送此命令获取自身蓝牙控制器的版本信息，并与待连接设备的版本信息进行对比，以判断双方是否能够正常通信和协作。

5.3. 故障诊断与排除

• 场景描述：当蓝牙设备出现连接问题或性能下降时，需要进行故障诊断。
• 使用方式：通过发送此命令，技术人员可以获取蓝牙控制器的详细版本信息，有助于诊断是否存在已知的软件缺陷或兼容性问题，从而制定修复方案。

5.4. 软件更新与维护

• 场景描述：在蓝牙设备的软件更新过程中，需要了解设备的当前版本信息。
• 使用方式：发送此命令获取蓝牙控制器的版本信息，帮助开发者或制造商判断设备是否已经是最新版本，或者是否需要针对特定版本进行特定的更新操作。

5.5. 设备信息展示与管理

• 场景描述：在设备管理软件或系统设置界面中，需要展示蓝牙设备的详细信息。
• 使用方式：通过发送此命令，可以获取蓝牙控制器的版本信息，并将其展示给用户或管理人员，有助于了解设备的技术规格，以及在出现问题时提供准确的设备信息给技术支持人员。

5.6. 蓝牙技术研究与开发

• 场景描述：在蓝牙技术的研究和开发过程中，需要深入了解不同蓝牙控制器的版本信息和功能特性。
• 使用方式：研究人员可以发送此命令，收集并分析不同蓝牙控制器的版本信息和功能特性，为蓝牙技术的研究和开发提供数据支持。

HCI_Read_Local_Version_Information命令在蓝牙技术的多个领域都具有广泛的应用价值，是确保蓝牙设备正常运行、优化系统性能、推动技术创新和发展的重要工具。

六、注意事项

使用HCI_Read_Local_Version_Information命令时，需要注意以下几个关键方面：

6.1. 命令格式与参数要求

1. 正确的操作码：

• 确保发送的命令操作码是HCI_Read_Local_Version_Information对应的正确代码。
• 操作码错误将导致蓝牙控制器无法正确解析命令，可能返回错误信息或无法返回期望的版本信息。

2. 参数长度的一致性：

• 该命令通常不接受任何参数，参数长度应为0字节。
• 避免在命令中添加额外的、不符合要求的参数，以免引起命令格式错误。

6.2. 设备兼容性与版本差异

1. 版本兼容性考虑：

• 不同设备的HCI版本和LMP版本可能有所不同。
• 在设计蓝牙应用程序或设备连接策略时，需考虑版本差异对功能实现的影响。

2. 参考标准文档：

• 查阅蓝牙技术文档中的“Assigned Numbers”等相关内容，以准确理解版本信息中每个编号的含义。
• 这有助于进行设备兼容性判断和功能支持评估。

6.3. 事件处理与错误排查

1. 关注命令完成事件：

• 命令执行后会生成HCI_Command_Complete事件。
• 检查该事件的返回状态码，状态码为0x00表示命令成功执行，其他值表示出现错误。

2. 错误可能的原因与解决方法：

• 错误可能由蓝牙链路干扰、控制器硬件问题或设备软件不兼容等原因导致。
• 解决方法包括检查蓝牙连接稳定性、更新设备软件或固件、对控制器硬件进行检测和维修等。

6.4. 数据使用与隐私保护

1. 合理使用版本信息：

• 将版本信息用于设备管理、兼容性检查、软件更新等正当目的。
• 避免将信息用于未经授权的用途，如恶意软件攻击或非法收集用户设备信息。

2. 隐私考虑：

• 版本信息可能包含设备制造商等隐私相关内容。
• 在信息处理过程中遵守隐私政策，确保用户隐私不被侵犯。

6.5. 其他注意事项

1. 权限与初始化：

• 在发送命令前，确保蓝牙控制器已初始化并具有适当的访问权限。
• 在某些情况下，可能需要先发送HCI_Reset命令来重置蓝牙控制器。

2. 应用场景：

• 该命令通常用于诊断、调试或配置蓝牙设备时获取版本信息。
• 在开发蓝牙应用或驱动程序时，了解版本信息有助于确保兼容性和稳定性。

使用HCI_Read_Local_Version_Information命令时，需要关注命令格式、参数要求、设备兼容性、事件处理、错误排查、数据使用与隐私保护以及其他相关注意事项。通过正确使用该命令，可以获取蓝牙控制器的版本信息，为后续的蓝牙通信和开发工作提供有力支持。

综上所述，通过HCI_Read_Local_Version_Information命令，开发者能轻松获取蓝牙控制器版本信息，这对于确保设备兼容性、高效调试及评估特性支持至关重要。正确使用此命令，可有力支持后续蓝牙通信与开发工作，提升整体效率和稳定性。