Jam 检测

在 GitHub 上查看源代码

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

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

工作原理

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

启用 Jam 检测功能后：

1. Jam 检测状态设为“false”。
2. 节点每 1 秒间隔多次对 RSSI 进行采样。
3. 如果整个样本内的 RSSI 超过每个样本配置的 RSSI 阈值，则认为一秒钟的间隙卡住了。
4. 如果一秒间隔内卡住的卡数总数大于等于上述配置的检测窗口秒中配置的忙碌期秒总数，则相应时间点的 Jam 检测状态会设置为 true。
5. 如果任意一秒间隔内卡顿的总数不到任何一个时间点在前述配置的检测窗口秒内配置的忙碌期秒总数，则相应时间点的 Jam 检测状态会设置为 false。

历史位图

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

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

0xC248068C416E7FF0

转换为二进制文件会生成前 63 秒内 RSSI 超出配置的 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 检测功能，请在构建 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 说明 指定以高于 dBm 为单位的 RSSI 阈值（高于此值时，视为信道卡顿）。
检测窗口	默认值 63 秒 说明 指定检查信号干扰的时间范围（以秒为单位）。范围：1-63。
繁忙时段	默认值 63 秒 说明 指定检测窗口内 RSSI 必须高于 RSSI 阈值才能触发 Jam 检测的汇总秒数。必须小于检测窗口。范围：1-63。

API

OpenThread

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

• 启动和停止此功能
• 查看 Jam 检测状态
• 管理所有参数
• 检索当前的 Jam 检测历史记录位图
• 注册一个回调函数，以便在检测到 Jam 时执行此操作

旋转陀螺

Spinel 协议使主机设备能够直接与 NCP 通信。 此协议公开了 openthread/src/lib/spinel/spinel.h 中包含以下功能的 Jam 检测属性：

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

CLI

OpenThread

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

Wpantund

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

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

属性
JamDetection:Status	格式 布尔值 说明 只读。Jam 检测状态。指明当前是否检测到信号干扰。
JamDetection:Enable	格式 布尔值 说明 启用或停用 Jam 检测功能。
JamDetection:RssiThreshold	格式 dBm 说明 指定以高于 dBm 为单位的 RSSI 阈值（高于此值时，应视为信道被屏蔽）。
JamDetection:Window	格式 秒 说明 指定检查信号干扰的时间范围（以秒为单位）。范围：1-63。
JamDetection:BusyPeriod	格式 秒 说明 指定 JamDetection:Window 中的聚合秒数，其中 RSSI 必须高于 JamDetection:RssiThreshold 才能触发 Jam 检测。必须小于 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 代码库。