【0x001C】HCI_Write_Page_Scan_Activity详解

HCI_Write_Page_Scan_Activity 是蓝牙主机控制器接口（HCI）中的一个命令。它主要用于控制蓝牙设备的寻呼扫描（Page Scan）活动。寻呼扫描是蓝牙设备在被其他设备寻呼（建立连接请求）时的一种监听机制，通过这个命令可以设置扫描的开启、关闭以及扫描的参数等，从而使设备能够响应其他设备的连接请求。

一、命令概述

HCI_Write_Page_Scan_Activity命令用于写入Page_Scan_Interval（寻呼扫描间隔）和Page_Scan_Window（寻呼扫描窗口）这两个配置参数的值。这两个参数共同决定了蓝牙设备在进行寻呼扫描时的行为。

• 参数关系：Page_Scan_Window必须小于或等于Page_Scan_Interval。这是因为寻呼扫描窗口是在寻呼扫描间隔所设定的时间范围内实际进行扫描的时间部分。
• 寻呼扫描的启用：Page Scan 仅在 Page_Scan 启用时执行，这表示，即使设置了寻呼扫描间隔和窗口，如果寻呼扫描功能（Page_Scan）没有被启用，设备也不会执行寻呼扫描。寻呼扫描的启用通常通过另一个命令（如HCI_Write_Scan_Enable）来控制。【0x001A】HCI_Write_Scan_Enable详解-CSDN博客
• 参数影响：改变 Page_Scan_Interval 可能会影响本地 Page Scan Repetition Mode，寻呼扫描间隔的改变可能会影响设备的寻呼扫描重复模式。寻呼扫描重复模式决定了设备在多长时间内重复进行寻呼扫描，以及每次扫描之间的间隔。

例如，在蓝牙设备实际应用场景中，假设一个蓝牙耳机，它平时处于待机状态，当用户想要将其与手机连接时，手机会向蓝牙耳机发送连接请求（寻呼）。蓝牙耳机的主机需要先确保 “Page_Scan” 功能是开启的，然后之前通过 “HCI_Write_Page_Scan_Activity” 命令设置好的 “Page_Scan_Interval” 和 “Page_Scan_Window” 参数才能起作用，让蓝牙耳机在合适的时间范围内开启射频接收来监听手机的寻呼信号，从而建立连接。并且，如果调整了 “Page_Scan_Interval”，蓝牙耳机的寻呼扫描重复模式可能会随之改变，这可能会影响它对其他设备后续连接请求的响应方式和效率。

二、命令格式和参数说明

2.1. HCI_Write_Page_Scan_Activity命令格式

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

具体来说，它包含以下几个部分：

• HCI_type：1个字节，用于标识命令的类型。对于HCI命令包，该字段的值通常为0x01。
• OpCode：2个字节，用于唯一标识命令的操作码（Opcode）。
• OpCode：2个字节，用于唯一标识命令的操作码（Opcode）。这个操作码由操作码组字段（OGF）和操作码命令字段（OCF）组成。
  • OGF：占用高6位字节，表示命令所属的组。
  • OCF：占用低10位字节，表示在特定组内的命令。
• Parameter Length：1个字节，表示后续参数的长度。
• Parameters：这是命令的核心部分，用于传递具体的设置信息，主要包括寻呼扫描间隔（Page_Scan_Interval）和寻呼扫描窗口（Page_Scan_Window）的值，还可能包含扫描模式等信息。

2.2. Page_Scan_Interval

Page_Scan_Interval这个配置参数用于明确连续两次寻呼扫描之间相隔的时间量。具体而言，它所规定的时间间隔是从蓝牙控制器启动上一次寻呼扫描的那个时间点开始，一直到其启动下一次寻呼扫描为止的这一段时长。可以说，这个参数掌控着设备进行寻呼扫描操作的节奏，对设备能否及时响应其他设备的连接请求以及设备自身的功耗情况有着关键影响。

• 大小：该参数占用2个八位字节（octets），即16位。
• 值范围：从0x0012到0x1000，且仅偶数值有效。其取值通过十六进制数值 N = 0xXXXX 来表示。
• 默认值：Page_Scan_Interval的默认值为0x0800。
• 时间（Time）：表示Page_Scan_Interval所对应的时间长度，计算公式为N × 0.625毫秒（ms）。时间范围：
  • 最小值：当N=0x0012时，Time=0x0012 × 0.625 ms = 11.25 ms。
  • 最大值：当N=0x1000时，Time=0x1000 × 0.625 ms = 2560 ms（即2.56秒）。
  • 默认时间：当N为默认值0x0800时，Time=0x0800 × 0.625 ms = 1280 ms（即1.28秒）。

Page_Scan_Interval的设置会影响设备的寻呼扫描频率。较小的值意味着设备会更频繁地进行寻呼扫描，从而可能更快地响应其他设备的连接请求。然而，这也可能增加设备的功耗。相反，较大的值会降低设备的寻呼扫描频率，减少功耗，但可能延长连接建立的时间。

2.3. Page_Scan_Window

Page_Scan_Window这个配置参数主要用于定义一次寻呼扫描持续的时间长度。简单来讲，就是在每次寻呼扫描过程中，蓝牙设备开启扫描以接收其他设备发出的寻呼信号的实际时间段。可以将其想象成设备打开了一个 “窗口”，在这个 “窗口” 时间内来监听其他设备的寻呼信号，而这个 “窗口” 打开多久就是由Page_Scan_Window来确定的。

• 大小：该参数占用2个八位字节（octets），即16位。
• 值范围：Page_Scan_Window的值范围从0x0011到0x1000。其取值通过十六进制数值 N = 0xXXXX 来表示。
• 默认值：Page_Scan_Window的默认值为0x0012，对应的时间长度为11.25 ms。
• 时间（Time）：表示Page_Scan_Window所对应的时间长度，计算公式为N × 0.625毫秒（ms）。时间范围：
  • 最小值：当N=0x0011时，Time=0x0011 × 0.625 ms = 10.625 ms。
  • 最大值：由于Page_Scan_Window必须小于或等于Page_Scan_Interval，因此其最大值取决于Page_Scan_Interval的设置。然而，从参数定义来看，其最大可能值为0x1000 × 0.625 ms = 2560 ms（即2.56秒），但实际应用中会受到Page_Scan_Interval的限制。
• 限制条件：Page_Scan_Window的值必须小于或等于Page_Scan_Interval的值。这是为了确保设备在每次寻呼扫描过程中有足够的时间进行监听，但不会超过两次连续扫描之间的时间间隔。

Page_Scan_Window的设置会影响设备的寻呼扫描效率。较小的值意味着设备在每次寻呼扫描过程中进行监听的时间较短，可能会错过一些连接请求。而较大的值则增加了设备在每次扫描过程中进行监听的时间，提高了连接请求的检测概率，但也可能增加功耗。

HCI_Write_Page_Scan_Activity命令的格式和参数设置对于蓝牙设备的寻呼扫描活动至关重要。正确的配置可以提高设备的连接性能和可靠性，同时降低功耗。在进行参数配置时，需要仔细参考蓝牙规范和相关文档，以确保配置的正确性和有效性。

三、响应事件及参数说明

当HCI_Write_Page_Scan_Activity命令执行完毕后，会生成一个HCI_Command_Complete事件。这是蓝牙主机控制器接口（HCI）协议中定义的标准行为，用于通知主机该命令已经成功执行或指出了执行过程中出现的任何错误。

3.1. HCI_Command_Complete事件

HCI_Command_Complete事件遵循蓝牙主机控制器接口（HCI）事件的通用格式。一般来说，它包含事件头（Event Header）和事件参数（Event Parameters）两大部分。

• 事件头部分：
  • HCI_type：1个字节，用于标识数据包的类型。对于HCI事件包，该字段的值通常为0x04。
  • Event_Code：1个字节，用于标识事件的类型。对于HCI_Command_Complete事件，该字段的值是固定的，用于指示这是一个命令完成事件。
  • Parameter_Total_Length：1个字节，表示后续参数的总长度，以字节为单位。这个长度信息有助于接收方正确地解析后续的参数内容。
• 事件参数部分
  • 命令操作码（OpCode）：2个字节，表示之前发送的HCI命令的操作码（Opcode）。对于HCI_Write_Page_Scan_Activity命令的返回事件，这个字段将包含该命令的操作码，以便接收方能够识别是哪个命令完成了。
  • 状态码（Status Code）：1个字节，表示命令的执行状态。如果命令成功执行，该字段的值通常为0x00。如果命令执行失败，该字段将包含一个错误状态码，用于指示失败的原因。

对于HCI_Write_Page_Scan_Activity命令，由于其主要是配置设备的寻呼扫描活动，因此通常不需要返回额外的结果数据。所以，在Status字段之后，可能不会有其他与命令直接相关的参数。

​​​​​​​3.2. Status

Status 字段是 HCI_Write_Page_Scan_Activity 命令返回事件中的一个关键组成部分，它用于指示命令的执行结果。该字段的大小为1个字节（octet），即8位。

• 0x00：表示 HCI_Write_Page_Scan_Activity 命令已成功执行。当您看到这个值时，可以认为设备的寻呼扫描活动已根据命令参数进行了相应的配置。
• 0x01 至 0xFF：这些值表示 HCI_Write_Page_Scan_Activity 命令执行失败。
  • 当看到这些值时，应参考蓝牙核心规范的第一卷（Vol 1）的F部分，查找控制器错误代码列表，以了解具体的错误原因。这些错误代码提供了关于为何命令未能成功执行的详细信息。蓝牙Controller错误代码全面概览_connection rejected due to limited resources-CSDN博客
  • 主机需要根据具体的错误码来确定问题所在，并采取相应的措施，如重新发送命令、调整参数或者检查设备状态等。

3.3. 示例

以下是一个可能的HCI_Command_Complete事件的示例（注意：这只是一个示例，实际的返回事件可能因设备和协议栈的不同而有所差异）：

HCI_type: 0x04  // HCI事件包
Event_Code: 0x0E  // HCI_Command_Complete事件代码（注意：0x0E是示例值，实际值可能因蓝牙规范版本而异）
Parameter_Total_Length: 0x04  // 参数总长度为4个字节（包括Command_Opcode和Status）
Command_Opcode: 0xXXXX  // 之前发送的HCI_Write_Page_Scan_Activity命令的操作码
Status: 0x00  // 命令执行成功

（注意：在上面的示例中，0xXXXX表示HCI_Write_Page_Scan_Activity命令的操作码，需要根据具体的蓝牙设备和蓝牙协议栈实现来确定。）

四、命令执行流程

HCI_Write_Page_Scan_Activity命令的执行流程通常涉及主机（Host）和蓝牙控制器（Bluetooth Controller）之间的交互。以下是该命令执行流程的详细步骤。

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

• 确定需求：主机（如手机、电脑等设备的操作系统或蓝牙应用程序）根据应用需求或配置要求，决定需要配置蓝牙设备的寻呼扫描活动。
• 构建命令：根据蓝牙协议规范，主机确定“HCI_Write_Page_Scan_Activity”命令的操作码，并设置参数长度和参数内容。参数内容包括页面扫描间隔（Page Scan Interval）和页面扫描窗口（Page Scan Window）的值，这些值必须符合蓝牙规范规定的范围和格式要求。

4.2. 命令传输阶段

• 发送命令：主机通过蓝牙主机控制器接口（HCI）将构建好的命令发送给蓝牙控制器。这个传输过程是基于蓝牙通信协议规定的方式进行的，确保命令能够准确无误地到达蓝牙控制器。

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

• 接收命令：蓝牙控制器接收到主机发送的命令。
• 解析命令：控制器对命令进行解析，提取出命令类型、操作码以及参数等信息。同时，检查命令的完整性和正确性，确保没有数据丢失或损坏。
• 验证参数：控制器验证接收到的寻呼扫描间隔和寻呼扫描窗口参数是否符合蓝牙规范。如果参数不合法，控制器可能会直接判定命令执行失败。

4.4. 执行寻呼扫描活动设置阶段（蓝牙控制器端）

• 更新配置：如果参数合法，蓝牙控制器将新的寻呼扫描间隔和寻呼扫描窗口参数值更新到内部的配置寄存器或相关存储区域中。
• 物理层操作：在更新配置参数的同时，蓝牙控制器可能还需要对物理层（如射频模块）进行一些操作，以确保能够按照新的参数进行寻呼扫描。

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

• 生成事件：在完成命令的执行（无论成功与否）后，蓝牙控制器生成一个“HCI_Command_Complete”事件。
• 设置状态码：在“HCI_Command_Complete”事件中，设置一个状态码来指示命令的执行情况。如果命令成功执行，状态码设置为0x00；如果命令执行失败，状态码设置为0x01到0xFF之间的一个值。

4.6. 主机接收反馈阶段

• 接收事件：主机接收蓝牙控制器发送回来的“HCI_Command_Complete”事件。
• 解析事件：主机解析事件，检查状态码以确定命令是否成功执行。
• 处理结果：
  • 如果状态码为0x00，主机知道命令成功执行，可以继续进行后续的操作或配置。
  • 如果状态码为非0x00的值，主机需要根据错误码查找具体的错误原因，并采取相应的错误处理措施，如重新构建和发送命令，或调整参数值使其符合规范要求。

4.7. 示例代码

下面提供一个简化的示例，展示如何构建和发送HCI_Write_Page_Scan_Activity命令，以及如何处理接收到的响应。请注意，这个示例是高度简化的，并且假设已经有一个蓝牙协议栈库或API来处理HCI命令和事件。在实际应用中，需要使用蓝牙协议栈提供的函数和结构体。

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

// 假设这是蓝牙协议栈库提供的函数和结构体
// 这些在实际应用中会有所不同，需要根据所用蓝牙协议栈文档进行调整

typedef struct {
    uint16_t opcode;
    uint8_t param_len;
    uint16_t page_scan_interval;
    uint16_t page_scan_window;
} hci_write_page_scan_activity_cp;

typedef struct {
    uint8_t status;
} hci_command_complete_rp;

// 假设这是蓝牙协议栈库提供的发送HCI命令的函数
// 在实际应用中，需要使用蓝牙协议栈提供的相应函数
bool send_hci_command(const uint8_t *data, uint16_t length);

// 假设这是蓝牙协议栈库提供的接收HCI事件的回调函数
// 在实际应用中，需要设置这个回调函数来处理接收到的HCI事件
void on_hci_event(const uint8_t *data, uint16_t length);

// 应用程序代码
int main() {
    // 设置页面扫描间隔和窗口（这些值应该符合蓝牙规范）
    uint16_t page_scan_interval = 0x0800; // 例如，1.28秒
    uint16_t page_scan_window = 0x0400;   // 例如，0.64秒

    // 构建HCI_Write_Page_Scan_Activity命令
    hci_write_page_scan_activity_cp cp;
    cp.opcode = 0x1C0C; // HCI_Write_Page_Scan_Activity的操作码（示例值，实际值可能不同）
    cp.param_len = 4;   // 参数长度（2个字节的间隔 + 2个字节的窗口）
    cp.page_scan_interval = page_scan_interval;
    cp.page_scan_window = page_scan_window;

    // 发送命令
    if (!send_hci_command((const uint8_t*)&cp, sizeof(cp))) {
        fprintf(stderr, "Failed to send HCI_Write_Page_Scan_Activity command\n");
        return -1;
    }

    // 等待并处理HCI_Command_Complete事件（在实际应用中，这通常是通过异步回调来完成的）
    // 这里我们假设on_hci_event函数会在接收到事件后被调用
    // 注意：这个等待循环是简化的，实际应用中应该有更好的机制来处理异步事件
    while (true) {
        // 这里的代码应该是事件循环的一部分，用于处理接收到的HCI事件
        // 由于这个示例是简化的，所以我们只是在这里等待（在实际应用中，不要这样做！）
    }

    // 注意：在实际应用中，应该在on_hci_event函数中处理HCI_Command_Complete事件
    // 并根据状态码来决定后续的操作

    return 0;
}

// 假设的发送HCI命令的函数实现（在实际应用中，需要使用蓝牙协议栈提供的实现）
bool send_hci_command(const uint8_t *data, uint16_t length) {
    // 这里应该是发送HCI命令到蓝牙控制器的代码
    // 由于这个示例是简化的，所以我们只是返回true来表示成功
    return true;
}

// 假设的接收HCI事件的回调函数实现（在实际应用中，需要根据蓝牙协议栈文档来调整）
void on_hci_event(const uint8_t *data, uint16_t length) {
    // 这里应该是处理接收到的HCI事件的代码
    // 由于这个示例是简化的，所以我们只是打印一些信息
    printf("Received HCI event with length %u\n", length);

    // 检查是否是HCI_Command_Complete事件
    // 在实际应用中，需要根据事件代码和参数来解析和处理事件
    if (length >= sizeof(hci_command_complete_rp)) {
        const hci_command_complete_rp *rp = (const hci_command_complete_rp*)data;
        if (rp->status == 0x00) {
            printf("HCI_Write_Page_Scan_Activity command succeeded\n");
        } else {
            printf("HCI_Write_Page_Scan_Activity command failed with status 0x%02X\n", rp->status);
        }
    }
}

请注意，这个示例中的send_hci_command和on_hci_event函数是假设的，需要根据所使用的蓝牙协议栈库提供的API来实现它们。此外，这个示例中的事件循环也是简化的，实际应用中应该有一个更健壮的事件处理机制。最后，请确保蓝牙协议栈库和硬件支持HCI_Write_Page_Scan_Activity命令，并且已经正确地初始化了蓝牙设备。

五、使用场景

5.1. 设备连接场景

• 主动等待连接：
  • 场景描述：蓝牙设备（如耳机、鼠标）需要被其他设备（如手机、电脑）发现并连接。
  • 命令应用：通过HCI_Write_Page_Scan_Activity命令设置合适的寻呼扫描间隔（Page_Scan_Interval）和寻呼扫描窗口（Page_Scan_Window），使设备在特定时间范围内监听其他设备的寻呼信号。
  • 参数设置：根据设备的连接需求和性能，调整扫描间隔和窗口大小，以平衡连接速度和功耗。
• 优化连接响应速度：
  • 场景描述：对连接响应速度要求较高的场景，如蓝牙游戏手柄。
  • 命令应用：设置较短的寻呼扫描间隔和适当大小的寻呼扫描窗口，以更频繁地监听连接请求。
  • 参数设置：缩短扫描间隔，增加扫描窗口的占比，以提高连接响应速度。

5.2. 低功耗场景

• 延长电池续航：
  • 场景描述：依靠电池供电的蓝牙设备（如智能手表、蓝牙传感器）需要降低功耗以延长电池寿命。
  • 命令应用：通过HCI_Write_Page_Scan_Activity命令设置较长的寻呼扫描间隔和较小的寻呼扫描窗口。
  • 参数设置：增加扫描间隔，减少扫描窗口的占比，以降低设备的功耗。

5.3. 多设备协同场景

• 避免信号干扰：
  • 场景描述：多个蓝牙设备同时工作的环境中，需要避免设备间的信号干扰。
  • 命令应用：通过调整不同设备的寻呼扫描参数，优化设备的连接性能。
  • 参数设置：为不经常被连接的设备设置较长的扫描间隔和较小的扫描窗口，以减少对其他设备的干扰。
• 设备连接优先级设置：
  • 场景描述：在有多个蓝牙设备等待连接的情况下，需要设置连接优先级。
  • 命令应用：通过调整不同设备的寻呼扫描参数来设置连接优先级。
  • 参数设置：为经常使用的设备设置较短的扫描间隔和较大的扫描窗口，使其能够优先响应连接请求；为偶尔使用的设备设置较长的扫描间隔和较小的扫描窗口，以降低其连接优先级。

HCI_Write_Page_Scan_Activity命令在蓝牙设备连接过程中起到关键作用，通过调整寻呼扫描间隔和寻呼扫描窗口的参数，可以适应不同的连接需求和场景。在实际应用中，需要根据设备的具体需求和性能考虑来选择合适的扫描参数配置，以实现连接速度、功耗和信号干扰等方面的优化。

六、注意事项

6.1. 命令格式与参数

• 命令格式：HCI_Write_Page_Scan_Activity命令通常遵循蓝牙核心规范中定义的HCI（Host Controller Interface）命令格式。包括HCI_type、OpCode、Parameter Length和Parameters等字段。
• 参数设置：确保Page_Scan_Interval（寻呼扫描间隔）和Page_Scan_Window（寻呼扫描窗口）的参数值在蓝牙核心规范规定的范围内。这两个参数的设置将直接影响设备的扫描效率和功耗。

6.2. 命令执行与响应

• 命令执行：在发送HCI_Write_Page_Scan_Activity命令之前，确保蓝牙设备处于可配置状态。使用适当的接口（如hci_send_cmd）发送命令，并等待蓝牙控制器的响应。
• 响应处理：当蓝牙控制器接收到HCI_Write_Page_Scan_Activity命令后，会返回一个HCI_Command_Complete事件来确认命令的执行结果。检查事件中的状态码和参数，以确认命令是否成功执行。

6.3. 设备兼容性与互操作性

• 设备兼容性：不同品牌和型号的蓝牙设备可能对HCI_Write_Page_Scan_Activity命令的支持程度不同。在使用前，请查阅设备的官方文档或技术规格书，以确保命令的兼容性。
• 互操作性：在多设备协同工作的环境中，确保所有设备的扫描参数设置得当，以避免信号干扰和连接冲突。

6.4. 功耗与性能权衡

• 功耗考虑：较长的Page_Scan_Interval和较小的Page_Scan_Window可以降低设备的功耗。但过长的间隔可能导致设备无法及时响应连接请求，影响用户体验。
• 性能优化：根据设备的具体应用场景和需求，调整扫描参数以实现性能优化。例如，在需要快速建立连接的场景中，可以设置较短的扫描间隔和较大的扫描窗口。

6.5. 安全与隐私保护

• 避免非法连接：通过合理设置扫描参数，可以降低设备被非法连接的风险。例如，在不需要连接时，可以禁用寻呼扫描功能。
• 隐私保护：在公共环境中使用蓝牙设备时，注意保护个人隐私信息。避免在不安全的网络或环境下进行蓝牙连接和数据传输。

使用HCI_Write_Page_Scan_Activity命令时需要注意命令格式与参数、命令执行与响应、设备兼容性与互操作性、功耗与性能权衡以及安全与隐私保护等方面的问题。在实际应用中，需要根据设备的具体需求和性能考虑来选择合适的扫描参数配置。

综上所述，HCI_Write_Page_Scan_Activity命令用于配置蓝牙设备的寻呼扫描活动，包括设置扫描间隔和窗口。它影响设备连接速度、功耗及多设备环境下的互操作性。合理设置参数可优化性能，确保设备兼容与安全。