Channel Monitor

This module includes configuration variables for Channel Monitor.

Summary

Macros

OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE 0
Define to 1 to enable Channel Monitor support.
OPENTHREAD_CONFIG_CHANNEL_MONITOR_RSSI_THRESHOLD -75
The RSSI threshold in dBm used by Channel Monitoring feature.
OPENTHREAD_CONFIG_CHANNEL_MONITOR_SAMPLE_INTERVAL 41000
The sample interval in milliseconds used by Channel Monitoring feature.
OPENTHREAD_CONFIG_CHANNEL_MONITOR_SAMPLE_WINDOW 960
The averaging sample window length (in units of channel sample interval) used by Channel Monitoring feature.

Macros

OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE

 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE 0

Define to 1 to enable Channel Monitor support.

OPENTHREAD_CONFIG_CHANNEL_MONITOR_RSSI_THRESHOLD

 OPENTHREAD_CONFIG_CHANNEL_MONITOR_RSSI_THRESHOLD -75

The RSSI threshold in dBm used by Channel Monitoring feature.

The RSSI samples are compared with the given threshold. Channel monitoring reports the average rate of RSSI samples that are above this threshold within an observation window (per channel).

It is recommended that this value is set to same value as the CCA threshold used by radio.

Applicable only if Channel Monitoring feature is enabled (i.e., OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE is set).

OPENTHREAD_CONFIG_CHANNEL_MONITOR_SAMPLE_INTERVAL

 OPENTHREAD_CONFIG_CHANNEL_MONITOR_SAMPLE_INTERVAL 41000

The sample interval in milliseconds used by Channel Monitoring feature.

When enabled, a zero-duration Energy Scan is performed, collecting a single RSSI sample per channel during each interval.

Applicable only if Channel Monitoring feature is enabled (i.e., OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE is set).

OPENTHREAD_CONFIG_CHANNEL_MONITOR_SAMPLE_WINDOW

 OPENTHREAD_CONFIG_CHANNEL_MONITOR_SAMPLE_WINDOW 960

The averaging sample window length (in units of channel sample interval) used by Channel Monitoring feature.

Channel monitoring will sample all channels every sample interval. It maintains the average rate of RSSI samples that are above the RSSI threshold within (approximately) this sample window.

Applicable only if Channel Monitoring feature is enabled (i.e., OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE is set).

Resources

OpenThread API Reference topics originate from the source code, available on GitHub. For more information, or to contribute to our documentation, refer to Resources.