#include <nrf_802154/common/include/nrf_802154_callouts.h>
Notifies that a frame was received.
- Note
- Currently this callout is only available on the CPU which is running the core of the radio driver. If the higher layer runs on a different core it should use nrf_802154_received_timestamp_raw instead.
-
The buffer pointed to by
p_data
is not modified by the radio driver (and cannot be used to receive a frame) until nrf_802154_buffer_free_raw is called.
-
The buffer pointed to by
p_data
may be modified by the function handler (and other modules) until nrf_802154_buffer_free_raw is called.
-
This callout is called by the nRF 802.15.4 Radio Driver if NRF_802154_USE_RAW_API is enabled. Default implementation of this function provided by the nRF 802.15.4 Radio Driver calls nrf_802154_received_timestamp_raw .
* p_data
* v
* +-----+-----------------------------------------------------------+------------+
* | PHR | MAC Header and payload | FCS |
* +-----+-----------------------------------------------------------+------------+
* | |
* | <---------------------------- PHR -----------------------------------> |
*
- Parameters
-
[in] | p_data | Pointer to a buffer that contains PHR and PSDU of the received frame. The first byte in the buffer is the length of the frame (PHR). The following bytes contain the frame itself (PSDU). The length byte (PHR) includes FCS. FCS is already verified by the hardware and may be modified by the hardware. |
[in] | power | RSSI of the received frame. |
[in] | lqi | LQI of the received frame. |