【0x0008】HCI_Create_Connection_Cancel命令详解

HCI_Create_Connection_Cancel 命令的核心作用在于请求取消由HCI_Create_Connection 命令所启动正在进行的连接创建过程。当出于某些原因，比如发现连接目标不合适、环境因素影响连接或者用户主动取消等情况时，就可以使用该命令来终止尚未完成的连接创建流程。

一、命令概述

当本地设备尝试与远程设备建立连接时，如果出于某种原因需要取消这个连接创建过程（例如，用户取消了操作，或者连接超时等），可以使用 HCI_Create_Connection_Cancel 命令。该命令会通知蓝牙控制器停止尝试与指定 BD_ADDR 的设备建立连接。

如果命令成功执行，蓝牙控制器将停止正在进行的连接创建过程，并返回状态码 0x00。如果命令失败（例如，因为指定的 BD_ADDR 无效，或者没有正在进行的连接创建过程与该 BD_ADDR 相关联），蓝牙控制器将返回相应的错误状态码。

二、命令格式及参数说明

2.1. HCI_Create_Connection_Cancel 命令格式

HCI_Create_Connection 命令的格式通常遵循 HCI 命令的一般结构，包括：

• 命令前缀（一个字节，表示这是一个 HCI 命令包）
• 操作码（Opcode，由 OGF 和 OCF 组成，用于标识具体的 HCI 命令）
• 参数长度（表示后续参数的总长度）
• 参数（本命令中为 BD_ADDR）

2.2. BD_ADDR

在 HCI_Create_Connection_Cancel 命令里，通过填写对应的 BD_ADDR，来明确是针对哪一个目标设备的连接创建过程要进行取消操作，就如同通过地址来指定要取消某项服务对应的具体对象一样。

• 描述：这是一个 48 位的蓝牙设备地址（Bluetooth Device Address，简称 BD_ADDR），用于唯一标识一个蓝牙设备。
• 格式：由 6 个十六进制数表示，例如 0xXX:0xXX:0xXX:0xXX:0xXX:0xXX。
• 作用：准确地定位到之前发起连接创建的那个目标设备，确保取消操作作用在期望的连接创建流程上，避免误取消其他无关的连接尝试或者操作，保证命令执行的针对性和准确性。

三、返回事件及参数说明

当 HCI_Create_Connection_Cancel 命令执行完毕后，会触发一系列的事件和状态反馈，具体取决于连接的状态和之前的操作。

3.1. HCI_Command_Complete 事件

• 基本事件生成：无论结果如何，当 HCI_Create_Connection_Cancel 命令执行完成后，都会生成一个 HCI_Command_Complete 事件。该事件用于通知主机（Host）该命令的执行状态。
• 连接未建立时的处理：
  • 如果在基带（Baseband）层连接尚未建立，但有一个与指定 BD_ADDR（蓝牙设备地址）相关联的连接创建过程正在进行，那么取消命令会成功执行，断开任何可能的连接尝试，并返回状态为“Success”（0x00）的 HCI_Command_Complete 事件。
  • 如果之前没有针对该 BD_ADDR 发起连接创建过程，那么控制器会返回状态为“Unknown Connection Identifier”（0x02）的 HCI_Command_Complete 事件，表示没有找到要取消的连接。
• 连接已建立但尚未通知时的处理：如果在基带层连接已经建立，但 BR/EDR 控制器（蓝牙控制器）尚未向主机发送 HCI_Connection_Complete 事件（表示连接成功建立的事件），那么收到取消命令后，本地设备会断开连接，并返回状态为“Success”（0x00）的 HCI_Command_Complete 事件。
• 连接已建立且已通知时的处理：如果连接已经建立，并且 HCI_Connection_Complete 事件已经发送给主机，那么控制器会返回状态为“Connection Already Exists”（0x0B）的 HCI_Command_Complete 事件，表示连接已经存在，无法取消。

3.2. HCI_Connection_Complete 事件

• 发送顺序及关联：无论取消命令是否成功，与原始 HCI_Create_Connection 命令相对应的 HCI_Connection_Complete 事件都会发送。并且其发送顺序是在 HCI_Create_Connection_Cancel 命令的 HCI_Command_Complete 事件之后。
• 取消成功时的情况：如果取消成功，HCI_Connection_Complete 事件将包含错误代码“Unknown Connection Identifier”（0x02），表示连接标识符未知，因为连接已经被取消。

HCI_Create_Connection_Cancel 命令的执行结果会通过 HCI_Command_Complete 事件反馈给主机，同时根据连接的状态和之前的操作，可能会伴随 HCI_Connection_Complete 事件的发送。这些事件和状态码为主机提供了关于连接创建和取消过程的详细信息。

四、命令执行流程梳理

4.1. 命令发起

• 触发条件：主机决定取消之前由蓝牙BR/EDR Host发出的HCI_Create_Connection命令所启动的连接创建过程。
• 构建命令：主机构建HCI_Create_Connection_Cancel命令，并包含目标设备的BD_ADDR（蓝牙设备地址）。
• 发送命令：主机将构建好的命令发送给蓝牙控制器。

4.2. 命令接收与初步判断

• 接收命令：蓝牙控制器接收HCI_Create_Connection_Cancel命令。
• 初步判断：控制器检查是否存在针对相同BD_ADDR且正在进行的连接创建过程。

4.3. 根据连接状态执行操作

• 连接未建立或未发送HCI_Connection_Complete事件：
  • 控制器执行取消操作。
  • 生成状态为“Success”的HCI_Command_Complete事件。
  • 若连接已部分建立，则断开链路。
• 连接已建立且已发送HCI_Connection_Complete事件：控制器返回带有错误码“Connection Already Exists (0x0B)”的HCI_Command_Complete事件。
• 无对应连接创建过程：控制器返回带有错误码“Unknown Connection Identifier (0x02)”的HCI_Command_Complete事件。

4.4. 相关事件发送顺序

• HCI_Connection_Complete事件：无论哪种情况，该事件总是会被发送，且发送顺序在HCI_Create_Connection_Cancel命令的HCI_Command_Complete事件之后。
• 取消成功后的HCI_Connection_Complete事件：若取消操作成功，则后续发送的HCI_Connection_Complete事件将带有错误码“Unknown Connection Identifier (0x02)”。

4.5. 主机处理反馈

• 接收并解析事件：主机接收并解析蓝牙控制器返回的事件。
• 根据状态或错误码判断结果：
  • 状态为“Success”：取消操作成功，主机可根据需求进行后续操作。
  • 错误码“Connection Already Exists (0x0B)”：连接已存在，取消失败，主机需进一步检查或处理。
  • 错误码“Unknown Connection Identifier (0x02)”：无对应连接创建过程，取消失败，主机需检查操作流程或重新发起操作。

4.6. 示例代码

以下代码是一个高度简化的示例，它并不包含与真实蓝牙硬件的直接交互，也不包含完整的蓝牙协议栈实现。只是为了展示如何设计这样的处理流程。

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

// 假设的蓝牙设备地址类型
typedef struct {
    uint8_t address[6];
} BD_ADDR;

// 假设的HCI命令和事件结构体
typedef struct {
    uint16_t opcode;
    BD_ADDR bd_addr;
} HCI_Command;

typedef struct {
    uint8_t event_code;
    uint8_t status;
    // 其他可能的参数...
} HCI_Event;

// 假设的连接状态结构体
typedef struct {
    BD_ADDR bd_addr;
    bool is_connecting;
    // 其他可能的连接状态信息...
} ConnectionState;

// 假设的全局连接状态数组（为了简化，只使用一个）
ConnectionState connection_state = { .is_connecting = false };

// 模拟发送HCI命令的函数（在实际中，这将与蓝牙硬件控制器交互）
void send_hci_command(HCI_Command *command) {
    // 在这里，我们简单地打印命令以模拟发送
    printf("Sending HCI Command: Opcode=0x%04X, BD_ADDR=%02X:%02X:%02X:%02X:%02X:%02X\n",
           command->opcode,
           command->bd_addr.address[0], command->bd_addr.address[1],
           command->bd_addr.address[2], command->bd_addr.address[3],
           command->bd_addr.address[4], command->bd_addr.address[5]);

    // 假设我们根据BD_ADDR找到了一个正在进行的连接
    if (memcmp(command->bd_addr.address, connection_state.bd_addr.address, 6) == 0) {
        connection_state.is_connecting = false; // 取消连接
    }

    // 在这里，我们应该生成并发送一个HCI_Command_Complete事件，但为了简化，我们省略了这部分
}

// 模拟接收HCI事件的函数（在实际中，这将从蓝牙硬件控制器接收事件）
void receive_hci_event(HCI_Event *event) {
    // 在这里，我们简单地打印事件以模拟接收
    printf("Received HCI Event: EventCode=0x%02X, Status=0x%02X\n", event->event_code, event->status);

    // 根据事件的状态码，主机可以执行相应的后续操作
    if (event->event_code == 0x0E) { // 假设0x0E是HCI_Command_Complete事件的代码
        if (event->status == 0x00) {
            printf("HCI_Create_Connection_Cancel succeeded.\n");
            // 执行取消成功后的操作...
        } else if (event->status == 0x0B) {
            printf("Connection already exists, cannot cancel.\n");
            // 执行连接已存在时的操作...
        } else if (event->status == 0x02) {
            printf("Unknown connection identifier, cannot cancel.\n");
            // 执行未知连接标识符时的操作...
        }
        // 其他状态码的处理...
    }
    // 其他事件代码的处理...
}

int main() {
    // 假设的HCI_Create_Connection_Cancel命令
    HCI_Command cancel_command = {
        .opcode = 0xXXXX, // 实际的HCI_Create_Connection_Cancel命令的opcode
        .bd_addr = { .address = {0x00, 0x11, 0x22, 0x33, 0x44, 0x55} } // 假设的BD_ADDR
    };

    // 发送取消连接命令
    send_hci_command(&cancel_command);

    // 假设接收到的HCI_Command_Complete事件
    HCI_Event event = {
        .event_code = 0x0E, // HCI_Command_Complete事件的代码
        .status = 0x00 // 假设状态为成功
    };

    // 接收并处理事件
    receive_hci_event(&event);

    return 0;
}

在这个示例中，我们定义了一些结构体来模拟HCI命令、事件和连接状态。send_hci_command函数模拟了发送HCI命令的过程，并简单地根据BD_ADDR取消了连接（在实际中，涉及到与蓝牙硬件的交互）。receive_hci_event函数模拟了接收HCI事件的过程，并根据事件的状态码执行了相应的后续操作。

五、应用场景

HCI_Create_Connection_Cancel命主要用于取消正在进行的连接操作、避免不必要的等待和资源浪费、处理异常情况以及满足用户交互需求等。

5.1. 用户操作引发的取消

• 智能设备连接：用户误操作或改变主意，想取消连接创建。例如，连接蓝牙耳机时，发现电量低或连接了错误的设备，可通过发送HCI_Create_Connection_Cancel命令取消。

5.2. 环境因素导致的取消

• 信号干扰：在复杂电磁环境中，蓝牙连接创建可能受影响。若检测到信号质量差或干扰严重，主机可发送HCI_Create_Connection_Cancel命令取消连接创建，以避免建立不稳定连接。

5.3. 设备状态改变引发的取消

• 资源分配：当设备资源紧张（如内存、带宽不足）时，可根据资源分配策略发送HCI_Create_Connection_Cancel命令，取消对部分设备的连接创建，确保重要设备连接。
• 设备故障：若在连接创建过程中检测到硬件或软件故障，如打印机墨盒故障或蓝牙模块温度过高，可发送HCI_Create_Connection_Cancel命令，防止建立可能出问题的连接。

5.4. 其他应用场景

• 避免不必要的等待和资源浪费：连接过程因网络问题、设备响应超时等原因长时间无法完成时，使用HCI_Create_Connection_Cancel命令可避免设备长时间等待，节省系统资源和电量。
• 处理异常情况：连接过程中出现设备断电、通信中断等异常时，使用HCI_Create_Connection_Cancel命令可确保设备正确处理异常，释放相关资源。
• 满足用户交互需求：用户可能需要在蓝牙配对过程中手动取消连接操作。此时，可通过发送HCI_Create_Connection_Cancel命令取消当前连接尝试。

六、注意事项

使用HCI_Create_Connection_Cancel命令时，需要关注命令参数的准确性、事件处理与响应、连接状态管理以及错误处理与命令协调等方面的问题。

6.1. 命令参数准确性

• BD_ADDR精确性：
  • 确保BD_ADDR（蓝牙设备地址）与目标设备的实际地址完全一致。
  • 在发送命令前，验证BD_ADDR对应的设备是否确实处于连接创建过程中。

6.2. 事件处理与响应

• HCI_Command_Complete事件状态分析
  • 仔细解析HCI_Command_Complete事件的状态码，区分成功与失败情况。
  • 成功状态表示连接创建过程被成功取消。
  • 错误码“Connection Already Exists (0x0B)”表示连接已建立，无法取消。
  • 错误码“Unknown Connection Identifier (0x02)”可能表示没有对应的连接创建过程或BD_ADDR错误。
• HCI_Connection_Complete事件顺序与错误码理解
  • 注意HCI_Connection_Complete事件的发送顺序，确保在HCI_Command_Complete事件之后接收。
  • 正确解读HCI_Connection_Complete事件中的错误码“Unknown Connection Identifier (0x02)”，表示连接创建过程已被取消。

6.3. 连接状态管理

• 连接建立程度的考量
  • 在发送取消命令前，了解连接的建立程度，避免在连接已完全建立时发送无效命令。
  • 如果连接部分建立后取消，注意可能存在的数据冲突或丢失问题，并在应用层面进行相应处理。
• 资源释放与状态重置
  • 取消连接创建过程后，确保本地BR/EDR控制器释放与连接建立相关的资源。
  • 如果取消操作导致设备状态不一致，考虑在应用层面进行状态重置或数据恢复。

6.4. 错误处理与命令协调

• 错误处理机制
  • 如果HCI_Create_Connection_Cancel命令执行失败，根据错误代码采取相应的错误处理措施。
  • 记录错误信息，以便后续分析和问题排查。
• 与其他命令的协调使用
  • 在使用HCI_Create_Connection_Cancel命令时，注意与其他相关命令（如HCI_Create_Connection、HCI_Disconnect等）的协调使用。
  • 避免命令冲突或不一致的情况，确保蓝牙通信的顺畅进行。

综上所述，HCI_Create_Connection_Cancel命令用于取消正在进行的蓝牙连接建立过程。需确保BD_ADDR准确，并注意命令执行后的事件处理。若连接已建立，则取消无效。命令执行成功会释放相关资源，错误时需根据错误码处理。使用时需与其他蓝牙命令协调，避免冲突。