Feature: Jam Detection

Jamming detection is a feature that allows the NCP to report when it detects high levels of interference that are characteristic of intentional signal jamming.

The presence of this feature can be detected by checking for the presence of the CAP_JAM_DETECT (value 6) capability in PROP_CAPS.

Properties

PROP 4608: PROP_JAM_DETECT_ENABLE

  • Type: Read-Write
  • Packed-Encoding: b
  • Default Value: false
  • REQUIRED for CAP_JAM_DETECT
Octets:1
Fields:PROP_JAM_DETECT_ENABLE

Indicates if jamming detection is enabled or disabled. Set to true to enable jamming detection.

This property is only available if the CAP_JAM_DETECT capability is present in PROP_CAPS.

PROP 4609: PROP_JAM_DETECTED

  • Type: Read-Only
  • Packed-Encoding: b
  • REQUIRED for CAP_JAM_DETECT
Octets:1
Fields:PROP_JAM_DETECTED

Set to true if radio jamming is detected. Set to false otherwise.

When jamming detection is enabled, changes to the value of this property are emitted asynchronously via CMD_PROP_VALUE_IS.

This property is only available if the CAP_JAM_DETECT capability is present in PROP_CAPS.

PROP 4610: PROP_JAM_DETECT_RSSI_THRESHOLD

  • Type: Read-Write
  • Packed-Encoding: c
  • Units: dBm
  • Default Value: Implementation-specific
  • RECOMMENDED for CAP_JAM_DETECT

This parameter describes the threshold RSSI level (measured in dBm) above which the jamming detection will consider the channel blocked.

PROP 4611: PROP_JAM_DETECT_WINDOW

  • Type: Read-Write
  • Packed-Encoding: c
  • Units: Seconds (1-64)
  • Default Value: Implementation-specific
  • RECOMMENDED for CAP_JAM_DETECT

This parameter describes the window period for signal jamming detection.

PROP 4612: PROP_JAM_DETECT_BUSY

  • Type: Read-Write
  • Packed-Encoding: i
  • Units: Seconds (1-64)
  • Default Value: Implementation-specific
  • RECOMMENDED for CAP_JAM_DETECT

This parameter describes the number of aggregate seconds within the detection window where the RSSI must be above PROP_JAM_DETECT_RSSI_THRESHOLD to trigger detection.

The behavior of the jamming detection feature when PROP_JAM_DETECT_BUSY is larger than PROP_JAM_DETECT_WINDOW is undefined.

PROP 4613: PROP_JAM_DETECT_HISTORY_BITMAP

  • Type: Read-Only
  • Packed-Encoding: LL
  • Default Value: Implementation-specific
  • RECOMMENDED for CAP_JAM_DETECT

This value provides information about current state of jamming detection module for monitoring/debugging purpose. It returns a 64-bit value where each bit corresponds to one second interval starting with bit 0 for the most recent interval and bit 63 for the oldest intervals (63 sec earlier). The bit is set to 1 if the jamming detection module observed/detected high signal level during the corresponding one second interval. The value is read-only and is encoded as two L (uint32) values in little-endian format (first L (uint32) value gives the lower bits corresponding to more recent history).