如需为任何 OpenThread 节点提供可配置的信号干扰检测功能,请启用 Jam Detection 功能。
此功能对于需要能够检测特定信道上的信号干扰的设备认证非常有用。它可以配置为满足各类认证的要求。
工作原理
Jam Detection 会在指定时间段内监控节点的 RSSI(接收信号强度指示器)以确定信道是否被干扰。
启用 Jam Detection 后:
- Jam 检测状态设为“
false
”。 - 节点每 1 秒多次对 RSSI 进行多次采样。
- 如果整个 1 秒内的 RSSI 仍高于每个样本的 RSSI 阈值,则 1 秒的时间间隔会被视为卡住了。
- 如果卡顿的时间间隔的总数超过或等于上述配置的检测窗口秒数内任何时间点配置的已配置繁忙时段的总数,则该时间点的 Jam 检测状态会设置为
true
。 - 如果卡顿时间的一秒总数低于在配置的任一检测窗口秒数内配置的任一时间点的忙碌时段总时间,则在该时间点的 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 阈值 |
|
||||
检测窗口 |
|
||||
繁忙时段 |
|
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 |
|
||||
JamDetection:Enable |
|
||||
JamDetection:RssiThreshold |
|
||||
JamDetection:Window |
|
||||
JamDetection:BusyPeriod |
|
||||
JamDetection:Debug:HistoryBitmap |
|
例如,如需获取 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 代码库。