Function openthread_sys::otLinkFilterAddRssIn

source ·

pub unsafe extern "C" fn otLinkFilterAddRssIn(
    aInstance: *mut otInstance,
    aExtAddress: *const otExtAddress,
    aRss: i8
) -> otError

Expand description

Adds the specified Extended Address to the RssIn list (or modifies an existing address in the RssIn list) and sets the received signal strength (in dBm) entry for messages from that address. The Extended Address does not necessarily have to be in the address allowlist/denylist filter to set the rss. @note The RssIn list contains Extended Addresses whose rss or link quality indicator (lqi) values have been set to be different from the defaults.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

@param[in] aInstance A pointer to an OpenThread instance. @param[in] aExtAddress A pointer to the IEEE 802.15.4 Extended Address. MUST NOT be NULL. @param[in] aRss A received signal strength (in dBm).

@retval OT_ERROR_NONE Successfully added an entry for @p aExtAddress and @p aRss. @retval OT_ERROR_NO_BUFS No available entry exists.