【0x000E】HCI_PIN_Code_Request_Negative_Reply命令详解

HCI_PIN_Code_Request_Negative_Reply命令用于在蓝牙设备配对过程中，当主机（Host）无法为连接指定一个PIN码时，回复来自BR/EDR（基本速率/增强数据速率）控制器的PIN码请求事件。这个命令会导致与远程设备的配对请求失败。

一、命令概述

当BR/EDR控制器生成一个HCI_PIN_Code_Request事件，以响应来自远程链路管理器（Link Manager）的请求时（通常是由于远程主机发送了HCI_Create_Connection或HCI_Authentication_Requested命令），本地主机需要在远程链路管理器检测到LMP（链路管理协议）响应超时之前，使用HCI_PIN_Code_Request_Reply或HCI_PIN_Code_Request_Negative_Reply命令进行回复。

如果主机无法为连接指定一个PIN码，则应发送HCI_PIN_Code_Request_Negative_Reply命令。这会导致配对请求失败，并且远程设备将不会与本地设备建立连接。

二、命令事件及参数说明

2.1. HCI_PIN_Code_Request_Negative_Reply命令事件格式

HCI_PIN_Code_Request_Negative_Reply命令事件格式遵循蓝牙HCI协议的规范。该命令的格式如下：

• 事件类型：HCI Command Packet（命令分组），以0x01开头。
• 操作码（Opcode）：由操作码组字段（OGF）和操作码命令字段（OCF）组成。对于HCI_PIN_Code_Request_Negative_Reply命令，OGF为0x01，OCF为0x000E（或简写为0x040E，其中高4位为OGF，低8位为OCF）。
• 参数总长度：表示后续参数的总长度，以字节为单位。
• 参数(BD_ADDR)：6个字节，表示请求PIN码的远程蓝牙设备的地址。

2.2. BD_ADDR（蓝牙设备地址）

当 HCI_PIN_Code_Request_Negative_Reply 命令被发送时，BD_ADDR 参数用于指定哪个设备的 PIN 码请求被拒绝。控制器会使用这个地址来识别哪个远程设备正在尝试与本地设备建立连接，并因其无法提供有效的 PIN 码而被拒绝。

BD_ADDR 代表着蓝牙设备地址（Bluetooth Device Address），它是一个在全球范围内唯一标识每个蓝牙设备的标识符，类似于网络通信中设备的 MAC 地址。在复杂的蓝牙网络环境或者多设备同时存在的场景中，通过 BD_ADDR 能清晰地界定命令的目标设备，避免出现误操作或者回复到错误设备的情况，保证整个命令执行的准确性和针对性。蓝牙MAC地址-CSDN博客

三、生成事件及参数说明

3.1.HCI_Command_Complete 事件

当HCI_PIN_Code_Request_Negative_Reply命令执行完成后，会生成一个HCI_Command_Complete事件。这个事件包含了：

• Num_HCI_Command_Packets：一个表示主机可以发送到控制器的HCI命令包数量的字段（这通常是一个固定的值，对于大多数命令来说都是1）。
• Command_Opcode：执行完成的命令的操作码。
• Return_Parameters：对于某些命令来说，这里可能包含额外的返回参数（对于HCI_PIN_Code_Request_Negative_Reply来说，通常不会有额外的参数）。
• Status：表示命令执行结果的状态码（与上面提到的状态码相同）。

3.2. Status（状态）

Status用于指示 HCI_PIN_Code_Request_Negative_Reply 命令是否成功执行。大小为 1 个八位组（octet），即 1 字节。

• 0x00：表示HCI_PIN_Code_Request_Negative_Reply命令成功执行。
• 0x01至0xFF：表示命令执行失败。具体的错误码和描述可以在蓝牙核心规范的第1卷的第F部分找到。蓝牙Controller错误代码全面概览_connection rejected due to limited resources-CSDN博客

3.3. BD_ADDR（蓝牙设备地址）

BD_ADDR用于明确是哪个设备对应的 HCI_PIN_Code_Request_Negative_Reply 命令已经完成。

BD_ADDR 用于指定哪个远程蓝牙设备的PIN码请求已被本地蓝牙设备（或控制器）拒绝。

四、命令执行流程

4.1. 命令发起背景

• 当外部设备（如蓝牙主机）请求蓝牙设备的PIN码时，如果蓝牙设备出于安全策略考虑或用户拒绝提供PIN码，就会发起HCI_PIN_Code_Request_Negative_Reply命令。

4.2. 命令格式与参数

• 命令格式：该命令遵循HCI命令的通用格式，包括命令码、参数长度和具体参数。
• 参数：主要参数用于标识该命令是对PIN码请求的否定回复，包含设备地址等信息，用于明确是哪个设备拒绝提供PIN码。

4.3. 命令在蓝牙协议栈中的传输路径

• 应用层或安全管理模块决策：决定拒绝提供PIN码。
• 传递给HCI层：通过蓝牙协议栈的接口，将HCI_PIN_Code_Request_Negative_Reply命令传递给HCI层。
• HCI层封装：HCI层将命令按照蓝牙通信协议格式进行封装。
• 物理链路传输：通过物理链路（如UART、USB等）发送给蓝牙控制器。

4.4. 蓝牙控制器的处理过程

• 命令解析：蓝牙控制器接收并解析命令。
• 状态机与安全设置处理：根据内部状态机和安全设置进行相应处理。
• 停止等待PIN码：如果之前已在等待PIN码以完成配对，则停止等待。
• 发送配对失败或PIN码不可用信号：向配对的对端设备发送信号。

4.5. 对配对过程及通信的影响

• 配对过程中断：收到否定回复后，配对流程中断。
• 安全协商重新评估：如果是在已配对成功后的连接过程中收到此命令，可能导致安全协商重新评估。
• 加密通道无法建立：正在建立的加密通道可能无法建立。
• 连接被断开或安全参数重新协商：根据安全策略，已建立的加密通信可能被断开或重新协商安全参数。

4.6. 反馈机制

• 确认消息返回：蓝牙控制器处理完命令后，通过HCI层向发送命令的上层返回确认消息。
• 处理结果状态：确认消息包含处理结果的简单状态，如成功接收并执行了否定回复命令。
• 错误码返回：如出现错误，返回相应的错误码。
• 上层决策：上层根据反馈信息决定是否需要采取进一步措施，如向用户显示配对失败的提示。

4.7. 示例代码

下面是一个简化的C语言代码示例，用于展示如何在某个假设的蓝牙协议栈框架内发送HCI_PIN_Code_Request_Negative_Reply命令。请注意，这个示例仅用于教学目的，并不能直接用于任何实际的蓝牙设备。

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

// 假设的HCI命令结构体
typedef struct {
    uint16_t opcode;       // 命令码
    uint8_t  param_len;    // 参数长度
    uint8_t  bd_addr[6];   // 设备地址（假设为6个字节）
    // 可能还有其他参数，根据具体实现而定
} hci_command_t;

// 假设的HCI命令发送函数（在实际中，这个函数会调用底层硬件接口）
void hci_send_command(hci_command_t *command) {
    // 这里只是打印命令信息，实际中应该通过UART、USB等接口发送
    printf("Sending HCI command: opcode=0x%04X, param_len=%d, bd_addr=%02X:%02X:%02X:%02X:%02X:%02X\n",
           command->opcode, command->param_len,
           command->bd_addr[0], command->bd_addr[1], command->bd_addr[2],
           command->bd_addr[3], command->bd_addr[4], command->bd_addr[5]);

    // 假设发送成功，并立即返回结果（在实际中，这通常是异步的）
    // 这里省略了错误处理和反馈机制的代码
}

// 发送HCI_PIN_Code_Request_Negative_Reply命令的函数
void send_pin_code_request_negative_reply(const uint8_t *bd_addr) {
    hci_command_t command;
    command.opcode = 0xXXXX; // 需要替换为实际的HCI_PIN_Code_Request_Negative_Reply命令码
    command.param_len = 6;   // 假设只包含设备地址作为参数
    memcpy(command.bd_addr, bd_addr, 6);

    // 发送命令
    hci_send_command(&command);
}

int main() {
    // 假设的设备地址
    uint8_t bd_addr[] = {0x00, 0x11, 0x22, 0x33, 0x44, 0x55};

    // 发送HCI_PIN_Code_Request_Negative_Reply命令
    send_pin_code_request_negative_reply(bd_addr);

    return 0;
}

请注意，这个示例非常简化，并且省略了很多重要的细节，比如错误处理、反馈机制、与蓝牙控制器的实际通信等。在实际应用中，需要根据具体的蓝牙协议栈和硬件接口来实现这些功能。

五、使用场景

HCI_PIN_Code_Request_Negative_Reply命令在蓝牙配对过程中至关重要，当主机无法或不愿提供PIN码进行配对时，会发送此命令以拒绝配对请求。

• 用户未输入PIN码
  • 场景描述：配对过程中，主机等待用户输入PIN码，但用户未在规定时间内输入或取消配对。
  • 处理措施：主机发送HCI_PIN_Code_Request_Negative_Reply命令拒绝配对请求。
• PIN码不匹配
  • 场景描述：主机与另一方设备在配对过程中使用的PIN码不一致。
  • 处理措施：主机无法生成有效的Link Key，发送HCI_PIN_Code_Request_Negative_Reply命令拒绝配对。
• 主机不支持PIN码配对
  • 场景描述：主机采用其他更安全的配对方式（如Simple Pairing），不支持PIN码配对。
  • 处理措施：当另一方设备发起PIN码请求时，主机发送HCI_PIN_Code_Request_Negative_Reply命令。
• 安全策略限制
  • 场景描述：企业级或高度安全的蓝牙设备网络中，安全策略禁止通过PIN码进行配对。
  • 处理措施：如医疗设备蓝牙连接系统，当外部设备请求PIN码配对时，受安全策略约束的设备发送HCI_PIN_Code_Request_Negative_Reply命令。
• 用户隐私保护
  • 场景描述：个人蓝牙设备用户不希望通过PIN码进行配对，特别是在公共场合。
  • 处理措施：用户可在设备设置中选择拒绝PIN码配对请求，设备发送HCI_PIN_Code_Request_Negative_Reply命令保护隐私。
• 设备兼容性问题
  • 场景描述：旧设备尝试使用PIN码与不再支持PIN码配对的新设备进行配对。
  • 处理措施：新设备发送HCI_PIN_Code_Request_Negative_Reply命令，保证安全和兼容性。
• 防止中间人攻击
  • 场景描述：设备检测到可能存在中间人攻击风险，如配对请求来源不明或蓝牙信号异常。
  • 处理措施：为避免PIN码被恶意获取，设备发送HCI_PIN_Code_Request_Negative_Reply命令拒绝配对请求。

六、注意事项

6.1. 安全影响方面

• 连接终止风险
  • 描述：发送此命令会导致配对流程中断，可能使安全连接无法建立。
  • 注意事项：在发送前确认是否真的需要拒绝配对请求，以避免不必要的连接中断。
• 安全重新评估需求
  • 描述：拒绝PIN码请求后，设备可能需要重新评估安全机制。
  • 注意事项：设备应具备灵活的安全策略，能够根据实际情况调整安全措施。

6.2. 兼容性考虑方面

• 协议版本差异
  • 描述：不同蓝牙协议版本对命令的支持和处理方式可能不同。
  • 注意事项：在发送命令前，确认目标设备的蓝牙协议版本，以确保命令能够被正确理解。
• 设备类型差异
  • 描述：不同类型设备对命令的响应可能不同。
  • 注意事项：了解目标设备的类型和配对机制，以便在发送命令后做出适当的处理。

6.3. 应用层反馈方面

• 用户提示需求
  • 描述：发送命令后，应用层需要向用户提供清晰的反馈。
  • 注意事项：设计良好的用户交互界面，确保用户能够理解配对失败的原因。
• 错误处理机制
  • 描述：应用层需要有完善的错误处理机制。
  • 注意事项：在发送命令前，检查通信接口和命令格式是否正确；在发送后，检查命令响应和错误处理逻辑是否完善。

6.4. 命令发送与处理

• 命令时机
  • 描述：应在收到PIN Code Request event后，且无法提供PIN码时发送。
  • 注意事项：确保在LMP响应超时之前发送命令。
• 命令格式
  • 描述：包含远端设备地址（BD_ADDR）作为参数。
  • 注意事项：确保BD_ADDR正确无误，以避免配对错误。
• 命令发送
  • 描述：使用适当的HCI命令发送接口发送命令。
  • 注意事项：确保蓝牙主机与控制器之间的通信接口已正确配置并处于活动状态。
• 命令响应
  • 描述：蓝牙控制器会返回一个命令完成事件以确认命令已接收并处理。
  • 注意事项：检查命令完成事件的返回参数，确保命令已成功执行且没有错误发生。

6.5. 其他注意事项

• 配对状态
  • 描述：发送命令后，配对过程将被终止。
  • 注意事项：如果需要重新进行配对，应重新启动配对过程。
• 错误处理
  • 描述：在发送命令时可能遇到错误（如通信故障、超时等）。
  • 注意事项：进行相应的错误处理，并尝试重新发送命令或采取其他恢复措施。
• 安全性考虑
  • 描述：注意保护蓝牙设备的安全性。
  • 注意事项：避免在不安全的环境中进行配对操作，以防止未经授权的访问和数据泄露。

综上所述，HCI_PIN_Code_Request_Negative_Reply命令是蓝牙配对过程中用于拒绝PIN码请求的重要工具。允许主机在无法提供PIN码时通知控制器，从而导致配对请求失败。通过仔细考虑使用场景、及时响应和准确填写参数，可以确保此命令在蓝牙设备间的通信中有效发挥作用。