Jam 检测

在 GitHub 上查看源代码

如需为任何 OpenThread 节点提供可配置的信号干扰检测功能，请启用 Jam Detection 功能。

此功能对于需要能够检测特定信道上的信号干扰的设备认证非常有用。它可以配置为满足各类认证的要求。

工作原理

Jam Detection 会在指定时间段内监控节点的 RSSI（接收信号强度指示器）以确定信道是否被干扰。

启用 Jam Detection 后：

1. Jam 检测状态设为“false”。
2. 节点每 1 秒多次对 RSSI 进行多次采样。
3. 如果整个 1 秒内的 RSSI 仍高于每个样本的 RSSI 阈值，则 1 秒的时间间隔会被视为卡住了。
4. 如果卡顿的时间间隔的总数超过或等于上述配置的检测窗口秒数内任何时间点配置的已配置繁忙时段的总数，则该时间点的 Jam 检测状态会设置为 true。
5. 如果卡顿时间的一秒总数低于在配置的任一检测窗口秒数内配置的任一时间点的忙碌时段总时间，则在该时间点的 Jam 检测状态会设置为 false。

历史记录位图

在 OpenThread API 和 wpantund 属性中，可以检索前 63 秒的位图。此位图会指明 RSSI 在过去每 63 秒是否超过配置的 RSSI 阈值。

例如，您可以检索以下位图：

0xC248068C416E7FF0

转换为二进制文件会生成 RSSI 在前 63 秒内超出配置的 RSSI 阈值的每个实例：

11000010 01001000 00000110 10001100 01000001 01101110 01111111 11110000

如果检测窗口设置为 16 秒，并且繁忙时段设置为 8 秒，则 Jam 检测状态会在 51 秒变为 true，因为这是在前 16 秒内至少连续 8 秒超过 RSSI 阈值。在此示例中，Jam 检测状态在接下来的 13 秒内将保持 true 状态。

11000010 01001000 00000110 10001100 01000001 01101110 01111111 11110000
                                      [00001 01101110 011] = 8 in 16

如果配置的 RSSI 阈值为 -45 dBm，则此位图可能由以下图表表示：

启用方式

默认情况下，此功能处于停用状态。

根据定义

如需启用 Jam Detection，请在构建 OpenThread 之前，在 openthread/src/core/config/openthread-core-default-config.h 文件中将 OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE 定义为 1：

#ifndef OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE
#define OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE 1
#endif

按选项

或者，在构建 OpenThread 时使用 -DOT_JAM_DETECTION=ON 构建选项：

./script/build -DOT_JAM_DETECTION=ON

参数

只能通过 OpenThread API、Spinel 协议或 wpanctl（用于网络协处理器 (NCP) 管理的 wpantund 命令行工具）配置 Jam 检测参数。如果在未启用后续配置的情况下启用此功能，则会应用默认值。

使用以下参数自定义此功能：

参数
RSSI 阈值	默认值 0 dBm 说明 指定超过此阈值的 RSSI 级别（以 dBm 为单位），高于此值时视为频道受到干扰。
检测窗口	默认值 63 秒 说明 指定检查信号干扰的秒数。范围：1-63。
繁忙时段	默认值 63 秒 说明 指定检测时间范围内 RSSI 必须超过 RSSI 阈值以触发 Jam 检测的汇总秒数。必须小于检测窗口。范围：1-63。

API

OpenThread

使用 Jam Detection API 直接在您的 OpenThread 应用中管理 Jam Detection 功能。OpenThread API 提供以下功能：

• 启动和停止此功能
• 查看 Jam 检测状态
• 管理所有参数
• 检索当前的 Jam 检测历史记录位图
• 注册回调函数，以便在检测到 Jam 时发出相关请求

旋转图标

Spinel 协议使主机设备能够直接与 NCP 通信。 此协议会在 openthread/src/lib/spinel/spinel.h 中提供具有以下功能的 Jam Detection 属性：

• 启动和停止此功能
• 查看 Jam 检测状态
• 管理所有参数
• 检索当前的 Jam 检测历史记录位图

CLI

OpenThread

没有与此功能相关的 OpenThread CLI 命令。

Wpantund

使用 wpanctl CLI 管理 OpenThread NCP 配置的 Jam 检测功能。wpantund 会在 NCP 重置后保留所有 Jam Detection 配置。

wpanctl 提供对以下 wpantund 属性的访问权限：

属性
JamDetection:Status	格式 boolean 说明 只读。Jam 检测状态。指示当前是否检测到信号干扰。
JamDetection:Enable	格式 boolean 说明 启用或停用 Jam 检测功能。
JamDetection:RssiThreshold	格式 dBm 说明 指定高于此阈值的 RSSI 级别（以 dBm 为单位），即被视为已屏蔽的频道。
JamDetection:Window	格式 秒 说明 指定检查信号干扰的秒数。范围：1-63。
JamDetection:BusyPeriod	格式 秒 说明 指定 JamDetection:Window 内的聚合秒数，其中 RSSI 必须高于 JamDetection:RssiThreshold 才能触发 Jam Detection。必须小于 JamDetection:Window。范围：1-63。
JamDetection:Debug:HistoryBitmap	格式 64 位值 说明 提供有关 Jam 检测状态历史记录的信息，以用于监控和调试。

例如，如需获取 NCP 的 Jam 检测状态，请运行以下命令：

sudo wpanctl getprop JamDetection:Status
JamDetection:Status = false

如需在 NCP 上将 Jam 检测 RSSI 阈值设为 -45 dBm，请执行以下操作：

sudo wpanctl setprop JamDetection:RssiThreshold -45
sudo wpanctl getprop JamDetection:RssiThreshold
JamDetection:RssiThreshold = -45

如需详细了解 wpantund 属性，请参阅 wpantund GitHub 代码库。