【0x0045】HCI_Write_Inquiry_Mode详解

byte轻骑兵

发布于 2026-01-20 20:37:20

1290

HCI_Write_Inquiry_Mode指令是蓝牙技术中用于设置本地BR/EDR（Basic Rate/Enhanced Data Rate）控制器查询模式（Inquiry Mode）的HCI（Host Controller Interface）指令。通过该命令，可以控制蓝牙设备如何主动去发现周围其他可连接的蓝牙设备，以满足不同应用场景下设备发现与连接的需求。

一、命令概述

HCI_Write_Inquiry_Mode命令允许主机（Host）配置本地BR/EDR控制器（Controller）在查询（Inquiry）过程中的工作模式。查询是蓝牙设备发现机制的一部分，允许一个蓝牙设备（称为主设备或Master）搜索其通信范围内的其他蓝牙设备（称为从设备或Slave）。

通过设置不同的查询模式，主机可以控制蓝牙控制器在查询过程中返回的信息类型和详细程度。有助于主机根据具体需求优化设备发现过程，例如，在需要获取更多设备详细信息时选择RSSI和EIR查询模式，而在仅需要基本设备信息时选择标准查询模式以节省资源和时间。

二、命令格式及参数说明

HCI 命令通用格式基础：
- HCI（主机控制器接口）命令通常遵循一定的格式，包括操作码（Opcode）和参数部分。操作码用于标识命令的类型，由操作码组字段（OGF - Opcode Group Field）和操作码命令字段（OCF - Opcode Command Field）组成。对于HCI_Write_Inquiry_Mode命令，有其特定的操作码组合，通过这个操作码，蓝牙设备的主机可以向蓝牙控制器表明这是一个设置查询模式的命令。
- 参数部分则跟在操作码之后，用于传递具体的设置信息，如查询模式的参数值。这些参数的格式和长度等都要符合蓝牙协议的规定。
可能的字节顺序和数据类型：在指令格式中，数据的字节顺序（大端序或小端序）也需要遵循蓝牙协议规定。例如，如果参数是一个多字节的整数，那么其存储顺序可能是按照大端序（高位字节在前）或者小端序（低位字节在前）来排列的。而且参数的数据类型（如无符号整数、有符号整数等）也是明确规定的，这保证了指令在不同设备之间的一致性和可理解性。

2.1. HCI_Write_Inquiry_Mode命令格式

HCI_Write_Inquiry_Mode命令通常遵循蓝牙核心规范中定义的HCI指令格式。

具体来说，它可能包括一个操作码（Opcode），后跟一个或多个参数，用于指定所需的查询模式。

2.2. Inquiry_Mode

Inquiry_Mode是一个关键参数，用于指定查询模式。不同的模式会影响查询结果的详细程度和格式。

Inquiry_Mode的模式包括标准查询模式（可能不包含RSSI或EIR信息）、带RSSI的查询模式（包含设备信号强度信息）以及RSSI和EIR查询模式（同时包含设备信号强度和扩展查询响应信息）。

0x00：标准查询结果事件格式
- 描述：标准查询结果事件格式，作为默认设置。
- 应用场景：此模式返回的查询结果仅涵盖被发现设备的基本信息，如设备地址等，不包含RSSI（接收信号强度指示）信息。它适用于设备发现与初步筛选阶段，帮助用户快速识别并筛选出周围的蓝牙设备，为后续操作提供基础数据。
0x01：带RSSI的查询结果格式
- 描述：查询结果带有RSSI信息的格式。
- 应用场景：此模式不仅返回设备的基本信息，还包含RSSI信息，有助于评估与被发现设备之间的连接质量和距离。在需要根据信号强度选择优先连接设备的场景中，如多耳机连接选择，此模式尤为适用。
0x02：带RSSI的查询结果格式或扩展查询结果格式
- 描述：可以是带有RSSI的格式或扩展查询结果格式。
- 应用场景：此模式提供了更大的灵活性。它既可以返回带有RSSI的常规查询结果，用于信号强度分析；也可以返回更详细的扩展查询结果，满足对设备信息要求更高的场景，如蓝牙设备调试或高级应用场景。
其他值
- 描述：保留用于未来扩展或新功能添加。
- 注意事项：在当前的蓝牙协议应用中，应避免使用这些保留值，以确保兼容性和稳定性。这些保留值为未来的技术发展和功能升级预留了空间。

Inquiry_Mode参数是蓝牙查询操作中用于指定结果格式的关键参数。通过正确配置该参数，用户可以优化设备发现过程，并获取所需的设备信息。在选择Inquiry_Mode时，应根据实际应用场景和需求进行权衡，以确保查询结果的准确性和实用性。同时，遵循蓝牙协议的规范，避免使用保留值，以确保系统的稳定性和兼容性。

三、响应事件格式及参数

当HCI_Write_Inquiry_Mode命令执行完毕后，会生成一个HCI_Command_Complete事件（除非该事件被屏蔽）。这是蓝牙HCI（Host Controller Interface，主机控制器接口）协议中的标准行为。

3.1. HCI_Command_Complete事件格式

HCI_Write_Inquiry_Mode命令的响应事件（HCI_Command_Complete）通常遵循蓝牙HCI协议的通用事件格式。

该事件包含有关命令执行结果的信息，一般包括事件头（Event Header）和事件参数（Event Parameters）部分。事件头用于标识事件的类型等基本信息，如事件码（Event Code），通过这个事件码可以确定这是一个与命令完成相关的事件。事件参数部分则用于传递关于命令执行结果的详细信息。

3.2. 参数说明

3.2.1. 事件代码（Event Code）

含义：表示该事件的类型，对于HCI_Write_Inquiry_Mode命令的响应，其事件代码通常为特定的HCI事件代码，用于标识这是一个查询模式设置完成的响应事件。
示例：具体的事件代码值依赖于蓝牙协议栈的实现和版本，但通常会有一个标准或推荐的值。

3.2.2. 参数总长度（Parameter Total Length）

含义：表示该事件参数部分的长度，即后续跟随的字节数。
计算：事件长度通常根据事件参数的具体内容来确定，并包括所有必要的字段和数据。

3.2.3. 事件参数（Event Parameters）

命令操作码（Command Opcode）：与发送的命令中的操作码相对应，用于确认这个事件是关于 “HCI_Write_Inquiry_Mode” 命令完成的反馈。主机通过比对这个操作码和之前发送命令的操作码，能够准确无误地确定事件是与该命令相关的，避免错误地处理其他无关命令的事件。

返回状态（Return Status）：这是一个关键的参数，用于告知命令执行的结果。

返回 0x00：表示 “HCI_Write_Inquiry_Mode” 命令成功执行，即查询模式已经按照主机发送的要求成功设置。主机在收到这个返回状态后，可以认为设备现在的查询模式已经更新，可以继续进行其他相关的蓝牙操作，如开始查询周围的设备。
返回 0x01 - 0xFF 范围内的错误码：表示命令执行失败。主机需要根据这个错误码参考蓝牙协议中的控制器错误码列表（[Vol 1] Part F）来确定具体的错误原因。蓝牙Controller错误代码全面概览_蓝牙错误代码-CSDN博客
例如，错误码可能表示参数设置错误、蓝牙控制器硬件故障、当前设备状态不允许执行该命令等情况。根据不同的错误原因，主机可能需要采取重新发送命令、调整参数或者进行硬件故障排查等相应的措施。

四、命令执行流程

HCI_Write_Inquiry_Mode命令的执行流程梳理如下。

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

主机准备工作：确定要设置的查询模式参数，根据设备状态和用户需求选择合适的查询模式。根据蓝牙协议规定的命令格式，构建HCI_Write_Inquiry_Mode命令包，包括操作码和查询模式参数。
命令发送：通过主机控制器接口（HCI）将构建好的命令包发送给蓝牙控制器。

4.2. 命令接收与解析阶段（蓝牙控制器端）

接收命令包：蓝牙控制器通过HCI接口接收来自主机的HCI_Write_Inquiry_Mode命令包。
解析命令包：提取命令包中的操作码，确定这是一个HCI_Write_Inquiry_Mode命令。提取查询模式参数，并检查命令包的格式和参数合法性。

4.3. 执行查询模式设置阶段（蓝牙控制器端）

配置底层硬件：根据提取的查询模式参数，配置蓝牙控制器的底层硬件（如射频模块），设置不同的射频扫描策略。

4.4. 完成操作与事件反馈阶段（蓝牙控制器端）

完成命令操作：当查询模式参数设置完成后，生成一个HCI_Command_Complete事件。
构建并发送事件包：将HCI_Command_Complete事件打包，包括事件码、参数总长度、命令操作码和返回状态。通过HCI接口将事件包发送回主机。

4.5. 主机接收事件并处理阶段（主机端）

接收事件包：主机通过HCI接口接收来自蓝牙控制器的HCI_Command_Complete事件包。
解析事件包：
- 提取事件码，确认这是一个HCI_Command_Complete事件。
- 读取命令操作码，确定是HCI_Write_Inquiry_Mode命令完成的反馈。
- 查看返回状态，判断命令是否成功执行。
后续处理：
- 如果命令成功执行（返回状态为0x00），则查询模式已按预期设置，可以进行后续的查询操作。
- 如果命令执行失败（返回状态为0x01 - 0xFF范围内的错误码），则根据错误码进行错误处理，如重新发送命令、调整参数或进行硬件故障排查。

通过以上流程，HCI_Write_Inquiry_Mode命令能够成功设置蓝牙设备的查询模式，从而满足不同的查询需求。在实际应用中，需要仔细遵循这些步骤，并确保每个阶段都正确执行，以确保蓝牙设备的正常工作和查询效率。

4.6. 示例代码

以下是一个简化的代码示例，用于模拟HCI_Write_Inquiry_Mode命令的执行流程。请注意，这只是一个高度简化的示例，用于说明流程，并不包含实际的蓝牙硬件接口或完整的蓝牙协议栈实现。

#include <stdio.h>
#include <stdint.h>
#include <stdbool.h>

// 假设的HCI命令和事件结构体
typedef struct {
    uint16_t opcode;  // 操作码
    uint8_t  inquiry_mode;  // 查询模式参数
} HCI_Write_Inquiry_Mode_Cmd;

typedef struct {
    uint8_t  event_code;  // 事件码
    uint16_t opcode;      // 命令操作码
    uint8_t  status;      // 返回状态
} HCI_Command_Complete_Event;

// 假设的HCI接口函数（在实际应用中，这些函数将由蓝牙协议栈提供）
bool HCI_Send_Command(const uint8_t* data, uint16_t length);
bool HCI_Receive_Event(HCI_Command_Complete_Event* event);

// 查询模式设置函数
bool Set_Inquiry_Mode(uint8_t mode) {
    // 构建HCI_Write_Inquiry_Mode命令
    HCI_Write_Inquiry_Mode_Cmd cmd;
    cmd.opcode = 0x0401;  // 假设的HCI_Write_Inquiry_Mode操作码
    cmd.inquiry_mode = mode;

    // 发送命令给蓝牙控制器
    if (!HCI_Send_Command((const uint8_t*)&cmd, sizeof(cmd))) {
        printf("Failed to send HCI_Write_Inquiry_Mode command.\n");
        return false;
    }

    // 等待并接收HCI_Command_Complete事件
    HCI_Command_Complete_Event event;
    if (!HCI_Receive_Event(&event)) {
        printf("Failed to receive HCI_Command_Complete event.\n");
        return false;
    }

    // 检查事件码和命令操作码
    if (event.event_code != 0x0E || event.opcode != 0x0401) {
        printf("Received unexpected event or opcode.\n");
        return false;
    }

    // 检查返回状态
    if (event.status != 0x00) {
        printf("HCI_Write_Inquiry_Mode command failed with status 0x%02X.\n", event.status);
        return false;
    }

    printf("HCI_Write_Inquiry_Mode command succeeded.\n");
    return true;
}

int main() {
    // 假设要设置的查询模式为某种特定模式（例如，标准查询模式）
    uint8_t inquiry_mode = 0x01;  // 这是一个假设的值，实际值应根据蓝牙协议确定

    // 设置查询模式
    if (Set_Inquiry_Mode(inquiry_mode)) {
        // 查询模式设置成功，可以进行后续的查询操作
        // ...（后续操作代码）
    } else {
        // 查询模式设置失败，进行错误处理
        // ...（错误处理代码）
    }

    return 0;
}

// 假设的HCI接口函数实现（仅用于示例，实际实现应由蓝牙协议栈提供）
bool HCI_Send_Command(const uint8_t* data, uint16_t length) {
    // 这里应该包含将数据发送到蓝牙控制器的代码
    // 但由于这是一个示例，所以直接返回true表示发送成功
    return true;
}

bool HCI_Receive_Event(HCI_Command_Complete_Event* event) {
    // 这里应该包含从蓝牙控制器接收事件的代码
    // 但由于这是一个示例，所以直接填充一个假设的成功事件并返回true
    event->event_code = 0x0E;
    event->opcode = 0x0401;
    event->status = 0x00;
    return true;
}

这个示例代码仅用于说明流程，并不包含任何实际的蓝牙硬件交互或错误处理逻辑。在实际项目中，需要根据具体的硬件和协议栈文档来实现完整的错误处理和状态管理。

五、使用场景

HCI_Write_Inquiry_Mode命令使用场景主要涉及到蓝牙设备的查询模式设置。以下是该命令的具体使用场景。

5.1. 蓝牙设备发现

核心功能：主设备通过该命令设置查询模式，以高效地搜索并发现周围的从设备。
关键参数：查询结果的返回格式，包括是否包含RSSI信息、扩展查询结果（设备名称、服务UUID等）。
应用场景：用户希望找到并连接新的蓝牙设备，如耳机、音箱等。

5.2. 蓝牙设备连接前的准备

核心功能：为主设备提供收集从设备信息的手段，为连接操作做准备。
关键参数：查询模式的设置，确保能够获取到足够且准确的信息。
应用场景：在建立蓝牙连接之前，主设备需要了解周围有哪些可用的从设备及其相关信息。

5.3. 蓝牙设备配对与绑定

核心功能：在配对过程中，为主设备提供查询从设备特定信息的手段。
关键参数：查询模式应能够获取到用于身份验证和密钥交换的必要信息。
应用场景：用户希望将蓝牙设备与另一设备配对，如手机与智能手表。

5.4. 蓝牙设备管理与监控

核心功能：允许主设备定期或不定期地查询周围蓝牙设备的状态。
关键参数：查询操作的频率和范围，以满足管理和监控需求。
应用场景：在智能家居、企业网络等环境中，对蓝牙设备进行管理和监控。

5.5. 设备连接维护场景

连接中断后的重新连接
- 场景描述：由于信号干扰或设备超出范围导致蓝牙连接中断。
- 命令作用：主机通过调整查询模式，尝试重新连接中断的蓝牙设备。
- 实例：用户带着蓝牙耳机离开手机一定距离后连接中断，回到附近时手机重新发现并连接耳机。
定期检查连接设备状态
- 场景描述：智能网关定期检查已连接的蓝牙传感器等设备状态。
- 命令作用：智能网关使用低频率查询模式扫描周围设备，确保设备连接稳定。
- 实例：智能家居系统中的智能网关定期检查蓝牙传感器的状态。

5.6. 多设备协同工作场景

设备角色切换后的发现
- 场景描述：在复杂的多设备协同系统中，设备角色可能会切换。
- 命令作用：设备根据角色切换调整查询模式，确保有效通信和协作。
- 实例：蓝牙设备在作为数据发送端时不需要主动发现其他设备，但当切换为数据接收端后，使用HCI_Write_Inquiry_Mode命令调整查询模式以发现数据源设备。

5.7. 蓝牙协议栈开发与调试

核心功能：作为开发和调试蓝牙协议栈的工具。
关键参数：测试查询功能是否正常工作，验证查询模式的设置。
应用场景：开发人员使用该命令来确保蓝牙设备的查询功能符合预期，并优化协议栈性能。

HCI_Write_Inquiry_Mode命令在蓝牙通信中扮演着至关重要的角色。通过合理使用该命令，可以显著提高蓝牙设备的查询效率和准确性，为蓝牙通信的可靠性和稳定性提供有力保障。同时，在使用过程中也需要关注安全性、兼容性和功耗等问题。

六、注意事项

以下是在使用HCI_Write_Inquiry_Mode命令时需要注意的几个事项。

6.1. 参数设置方面

遵循协议规范：严格按照蓝牙协议规定的取值范围和格式设置查询模式参数。确保参数符合当前蓝牙协议版本要求。
考虑设备兼容性：测试不同设备和芯片对查询模式参数的支持情况。注意设备可能对特定查询模式有特殊限制或扩展功能。

6.2. 命令执行顺序和时机方面

设备状态检查：确保蓝牙设备处于合适状态以接收和执行命令。避免在高优先级蓝牙操作期间发送命令。
避免频繁操作：不要过于频繁地发送查询模式命令。平衡查询需求与设备性能和功耗。

6.3. 事件处理方面

正确接收和解析事件：接收并解析“HCI_Command_Complete”事件以确认命令执行状态。准确解读事件码和返回状态。
处理错误事件：根据错误码确定具体错误原因。采取相应措施处理错误，如重新发送命令或调整参数。

6.4. 硬件和资源限制方面

射频资源占用：考虑查询模式对射频资源的影响。合理安排查询模式设置以平衡查询需求和其他射频操作。
功耗考虑：根据设备电池续航需求选择低功耗查询模式。谨慎使用积极查询模式以避免过度消耗电量。

6.5. 安全性方面

虽命令本身不直接涉安全性问题，但所选查询模式可能影响后续通信安全：

如选择包含设备名称和服务的 EIR 模式，可能暴露更多设备信息给潜在攻击者。
在公开或不受信任环境中，要谨慎选查询模式并采取相应安全措施保护设备信息。

6.6. 执行流程方面

前置配置：执行 “HCI_Write_Inquiry_Mode” 命令前，通常需先配置其他相关 HCI 命令和参数，如设置查询扫描活动（HCI_Write_Inquiry_Scan_Activity）和启用查询扫描（HCI_Write_Scan_Enable）等。
事件监控：命令执行过程中，要监控 HCI 事件（HCI Event）的上报情况，以便及时处理查询结果和异常情况。