Abtin Keshavarzian
07f4ae1ff3
This commit changes the `JAM_DETECT_HISTORY_BITMAP` format to use spinel primitive type of `uint64_t` instead of two `uint32_t`.
2.9 KiB
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:
X - 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.