【0x006D】HCI_Write_LE_Host_Support命令详解

目录

一、命令概述

二、命令格式及参数说明

2.1. HCI_Write_LE_Host_Support命令格式

2.2. LE_Supported_Host

三、生成事件及参数

3.1. HCI_Command_Complete 事件

3.2. Status

四、命令执行流程

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

4.2. 命令处理阶段（蓝牙控制器端）

4.3. 命令反馈阶段

4.4. 示例代码

五、使用场景

5.1. 设备初始化阶段

5.2. 功能切换场景

5.3. 兼容性和测试场景

六、注意事项

6.1. 参数设置要点

6.2. 设备状态与兼容性考量

6.3. 命令执行及反馈处理

6.4. 综合保障措施

---

HCI_Write_LE_Host_Support 命令用于设置低功耗蓝牙（Low Energy, LE）主机支持的链路管理协议（Link Manager Protocol, LMP）功能位。以指示设备是否支持低功耗蓝牙主机功能。

一、命令概述

HCI_Write_LE_Host_Support 命令用于设置LMP特征掩码中的低功耗蓝牙主机支持位。根据蓝牙核心规范的描述，这个特征位的默认值是禁用的。当LE_Supported_Host被设置为启用时，LMP特征掩码中相应的位将被设置，表明设备支持低功耗蓝牙主机功能。

这个命令通常在蓝牙设备的初始化过程中使用，或者当设备需要动态地启用或禁用低功耗蓝牙主机支持时使用。通过修改这个设置，设备可以调整其行为，以更好地适应不同的应用场景或兼容性需求。 

二、命令格式及参数说明

2.1. HCI_Write_LE_Host_Support命令格式

HCI_Write_LE_Host_Support命令的格式遵循蓝牙核心规范中定义的HCI（Host Controller Interface）命令格式。

其基本格式如下：

• HCI_type：1个字节，标识命令的类型。对于HCI命令包，该字段的值通常为0x01。
• OpCode：2个字节，用于唯一标识命令的操作码（Opcode）。这个操作码由操作码组字段（OGF）和操作码命令字段（OCF）组成。
  • OGF：占用高6位字节，表示命令所属的组。
  • OCF：占用低10位字节，表示在特定组内的命令。
• ParamLength：1个字节，表示后续参数的长度。对于HCI_Write_LE_Host_Support命令，参数长度通常为2个字节（包括LE_Supported_Host和Unused两个参数）。
• Parameters：命令的核心部分，用于传递具体的设置信息。对于HCI_Write_LE_Host_Support命令，参数包括：
  • LE_Supported_Host：1个字节，一个布尔值，用于指示是否启用低功耗蓝牙主机支持。值为0x00时表示禁用，值为0x01时表示启用。
  • Unused：1个字节，一个未使用的参数，通常设置为0x00。

2.2. LE_Supported_Host

LE_Supported_Host 参数主要用于主机（Host）对链路管理协议中的低功耗蓝牙（LE）支持功能位进行读取和设置。

• 0x00：LE Supported（Host）被禁用（默认值）。意味着设备不支持作为低功耗蓝牙（LE）的主机功能。
• 0x01：LE Supported（Host）被启用。表示设备支持作为低功耗蓝牙的主机功能，可以发起LE连接、管理LE连接等。

这一功能位的具体定义和操作细节参考蓝牙协议文档 [Vol 2] Part C, Section 3.2。

 

三、生成事件及参数

3.1. HCI_Command_Complete 事件

当HCI_Write_LE_Host_Support命令成功执行完毕后，蓝牙主机会生成一个HCI_Command_Complete事件。

HCI_Command_Complete是一个标准的事件类型，用于通知主机之前发送的HCI命令已经成功执行并完成了其预期的操作。

• 事件内容：

  • 事件码：具有一个特定的事件码，用于标识这是一个命令完成事件。
  • 参数总长度：指示整个事件携带的参数部分的总长度。
  • 命令操作码：之前发送的HCI_Write_LE_Host_Support命令的操作码，用于确认是哪个命令完成了。
  • 状态：表示命令执行的结果状态。如果命令成功执行，则状态码通常为0x00。如果命令执行失败，则状态码将指示失败的原因。
  • 返回参数（如果有）：对于HCI_Write_LE_Host_Support命令，通常没有额外的返回参数。

3.2. Status

Status状态码是HCI_Command_Complete事件中的一个关键部分，用于指示HCI_Write_LE_Host_Support命令的执行结果。

• 0x00：HCI_Write_LE_Host_Support命令成功执行。意味着蓝牙控制器已经成功接收到命令，并且已经根据命令中的参数更新了其配置。
• 0x01 至 0xFF：HCI_Write_LE_Host_Support命令执行失败。这些值表示不同的错误代码，每个代码都对应一个特定的错误情况。蓝牙Controller错误代码全面概览_蓝牙错误代码-优快云博客

四、命令执行流程

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

• 准备参数
  • 主机确定LE_Supported_Host参数的值（0x00禁用，0x01启用）。
  • 填充Unused参数（通常为0x00，因为目前未使用）。
• 构建命令数据包
  • 使用命令操作码（OCF）0x006D。
  • 按规定格式添加LE_Supported_Host和Unused参数。
  • 假设小端序传输，命令数据包可能为6D 00 01 00。
• 发送命令
  • 通过HCI接口发送构建好的命令数据包给蓝牙控制器。
  • 涉及物理层和链路层传输，确保命令准确到达。

4.2. 命令处理阶段（蓝牙控制器端）

• 接收并解析命令
  • 控制器接收命令数据包，检查完整性和正确性。
  • 解析命令，提取操作码和参数（LE_Supported_Host和Unused）。
• 执行命令操作
  • 根据LE_Supported_Host值设置LE支持（主机）功能位。
  • 可能涉及更新内部寄存器、配置链路管理模块等。
• 检查执行情况并生成状态码：检查操作是否成功，生成状态码（0x00表示成功，0x01-0xFF表示失败）。

4.3. 命令反馈阶段

• 生成事件和状态反馈
  • 控制器生成HCI_Command_Complete事件，包含状态码。
  • 通过HCI接口传输给主机。
• 主机接收并处理反馈
  • 主机接收HCI_Command_Complete事件和状态码。
  • 根据状态码判断命令是否成功执行。
  • 成功则进行后续LE相关操作，失败则根据错误代码采取措施。

4.4. 示例代码

以下是一个简化的C语言代码示例，用于展示如何在一个蓝牙HCI实现中发送HCI_Write_LE_Host_Support命令。请注意，这个示例并不包含完整的蓝牙HCI协议栈实现，而是专注于展示如何构建和发送该特定命令。

#include <stdint.h>
#include <stdio.h>
#include <string.h>
 
// 假设有一个发送HCI命令的函数
// 这个函数在实际应用中应该由蓝牙HCI库或驱动程序提供
extern int hci_send_command(const uint8_t *data, uint16_t length);
 
// HCI_Write_LE_Host_Support命令的操作码
#define HCI_WRITE_LE_HOST_SUPPORT_OCF 0x006D
#define HCI_WRITE_LE_HOST_SUPPORT_OGF 0x03 // OGF for LE Controller Commands
 
// 构建并发送HCI_Write_LE_Host_Support命令
int send_hci_write_le_host_support(uint8_t le_supported_host) {
    // 命令数据包：OGF（1字节）+ OCF（1字节）+ 参数（2字节）
    uint8_t command[4];
    
    // 设置OGF和OCF
    command[0] = (HCI_WRITE_LE_HOST_SUPPORT_OGF << 2) | 0x01; // OGF在高位，Bit 3-0为命令类型（0x01表示命令）
    command[1] = HCI_WRITE_LE_HOST_SUPPORT_OCF;
    
    // 设置参数：LE_Supported_Host（1字节）+ Unused（1字节）
    command[2] = le_supported_host;
    command[3] = 0x00; // Unused参数，目前未使用
 
    // 发送命令
    int result = hci_send_command(command, sizeof(command));
    
    if (result < 0) {
        // 发送失败
        fprintf(stderr, "Failed to send HCI_Write_LE_Host_Support command\n");
        return -1;
    }
    
    // 注意：这里并没有等待或处理HCI_Command_Complete事件的代码
    // 在实际应用中，需要实现一个机制来接收并处理该事件
    
    return 0;
}
 
int main() {
    // 启用低功耗蓝牙（LE）主机支持
    int status = send_hci_write_le_host_support(0x01);
    
    if (status == 0) {
        printf("HCI_Write_LE_Host_Support command sent successfully\n");
    } else {
        printf("Failed to send HCI_Write_LE_Host_Support command\n");
    }
    
    // 注意：在实际应用中，需要继续等待并处理HCI_Command_Complete事件
    // 以确定命令是否真正成功执行
    
    return status;
}

这个示例代码是为了教学目的而编写的，并且可能需要根据你的具体需求进行调整。

五、使用场景

5.1. 设备初始化阶段

• 多功能设备配置
  • 在支持经典蓝牙和低功耗蓝牙（LE）的多功能设备中，HCI_Write_LE_Host_Support命令用于根据用户设置或默认策略决定是否开启低功耗蓝牙主机支持功能。
  • 例如，智能手机在系统初始化蓝牙模块时，会使用此命令来设置低功耗蓝牙功能是否启用。
• 单一功能设备启动：对于专门的低功耗蓝牙设备（如智能手环、无线耳机），在开机初始化过程中，该命令用于确保设备能够正常开启低功耗蓝牙主机支持功能，从而与其他蓝牙设备建立连接并进行数据传输。

5.2. 功能切换场景

• 节能模式调整
  • 当设备需要进入节能模式时，可以通过HCI_Write_LE_Host_Support命令关闭低功耗蓝牙主机支持功能，以延长电池寿命。
  • 例如，物联网传感器设备在电量较低时，可以关闭低功耗蓝牙功能以节省能源。
• 连接类型切换
  • 在复杂的蓝牙应用场景中，设备可能需要在经典蓝牙连接和低功耗蓝牙连接之间进行切换。此时，该命令用于开启或关闭低功耗蓝牙主机支持功能，以适应不同的连接需求。
  • 例如，车载蓝牙系统可以在传输大量音乐数据时使用经典蓝牙连接，而在传输简单控制指令时切换到低功耗蓝牙连接。

5.3. 兼容性和测试场景

• 设备兼容性验证：在蓝牙设备的开发和测试过程中，HCI_Write_LE_Host_Support命令用于验证设备的兼容性。测试人员可以通过设置低功耗蓝牙主机支持功能的开启和关闭状态，检查设备在不同设置下与其他设备的连接和通信情况。
• 协议一致性测试：为了确保蓝牙设备遵循蓝牙协议标准，测试工具可以使用此命令来测试设备对低功耗蓝牙主机支持功能设置的响应是否符合协议规定。有助于保证设备在不同的蓝牙生态系统中的互操作性。

六、注意事项

使用 HCI_Write_LE_Host_Support 命令，需从多方面留意。

6.1. 参数设置要点

• LE_Supported_Host 参数：掌控低功耗蓝牙（LE）主机功能的启用与否，仅能取0x00（禁用）与0x01（启用），编程时要设边界检查，防错设，规避不可预测状况 。
• Unused 参数：虽当下闲置，但构建命令包得按协议格式填充，常填默认值（如全0），维持格式兼容，以防传输、解析出错。
• 整体命令格式：遵循蓝牙 HCI 协议要求，保证 OGF、OCF 等关键字段无误，保障命令规范。

6.2. 设备状态与兼容性考量

• 设备状态：发令前，确认蓝牙设备处于可配置状态，避开忙碌时段，防止命令发送失败。
• 兼容性：不同品牌、型号的蓝牙设备对该命令支持有别，使用前参考官方资料，核实设备能否支持。

6.3. 命令执行及反馈处理

• 执行：发出命令后，等待蓝牙控制器回应，成功有对应成功事件，失败则返回错误事件。
• 反馈：收到响应，依事件码、参数判断执行情况，失败就排查参数、状态，或重发命令。

6.4. 综合保障措施

• 文档查阅：用前查蓝牙 HCI 协议、设备规格书，明晰命令详情与注意点。
• 测试验证：投入使用前，充分测试，保证命令准确、可靠。
• 更新维护：随蓝牙技术迭代，留意固件、技术支持动态，维持设备兼容性与性能。

综上所述，HCI_Write_LE_Host_Support 命令是蓝牙设备配置中的一个重要部分，它允许设备动态地启用或禁用低功耗蓝牙主机支持功能。正确理解和使用这个命令，有助于更好地控制和优化蓝牙设备的行为。