Function openthread_sys::otLinkSetRadioFilterEnabled

source ·

pub unsafe extern "C" fn otLinkSetRadioFilterEnabled(
    aInstance: *mut otInstance,
    aFilterEnabled: bool
)

Expand description

Enables/disables IEEE 802.15.4 radio filter mode.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

The radio filter is mainly intended for testing. It can be used to temporarily block all tx/rx on the 802.15.4 radio. When radio filter is enabled, radio is put to sleep instead of receive (to ensure device does not receive any frame and/or potentially send ack). Also the frame transmission requests return immediately without sending the frame over the air (return “no ack” error if ack is requested, otherwise return success).

@param[in] aInstance A pointer to an OpenThread instance. @param[in] aFilterEnabled TRUE to enable radio filter, FALSE to disable