nrf_802154_energy_detection()

bool nrf_802154_energy_detection

(

uint32_t

time_us

)

#include <nrf_802154/common/include/nrf_802154.h>

Changes the radio state to energy detection.

In the energy detection state, the radio detects the maximum energy for a given time. The result of the detection is reported to the higher layer by nrf_802154_energy_detected.

Note

nrf_802154_energy_detected can be called before this function returns a result.

Performing the energy detection procedure can take longer than requested in time_us. The procedure is performed only during the timeslots granted by a radio arbiter. It can be interrupted by other protocols using the radio hardware. If the procedure is interrupted, it is automatically continued and the sum of time periods during which the procedure is carried out is not less than the requested time_us.

Parameters

[in]

time_us

Duration of energy detection procedure. The given value is rounded up to multiplication of 8 symbols (128 us).

Return values

true	The energy detection procedure was scheduled.
false	The driver could not schedule the energy detection procedure.