nrf_802154_trx_receive_frame()

void nrf_802154_trx_receive_frame	(	uint8_t	bcc,
		nrf_802154_trx_ramp_up_trigger_mode_t	rampup_trigg_mode,
		nrf_802154_trx_receive_notifications_t	notifications_mask,
		const nrf_802154_fal_tx_power_split_t *	p_ack_tx_power
	)

Puts the trx module into receive frame mode.

The frame will be received into buffer set by nrf_802154_trx_receive_buffer_set.

• during receive nrf_802154_trx_receive_frame_started handler is called when SHR field of a frame being received is received (only when notifications_mask contained TRX_RECEIVE_NOTIFICATION_STARTED flag)
• during receive nrf_802154_trx_receive_frame_bcmatched handler is called when bcc octets are received.
• when a frame is received with correct crc, nrf_802154_trx_receive_frame_received is called
• when a frame is received with incorrect crc, nrf_802154_trx_receive_frame_crcerror is called

When in nrf_802154_trx_receive_frame_received, the TIMER is running allowing sending response (e.g. ACK frame) in time regime by a call to nrf_802154_trx_transmit_after_frame_received.

Note

To receive ACK use nrf_802154_trx_receive_ack

Parameters

[in]	bcc	Number of received bytes after which nrf_802154_trx_receive_frame_bcmatched will be called.
[in]	rampup_trigg_mode	Radio ramp up triggering mode to be used. If TRX_RAMP_UP_SW_TRIGGER is selected, this function will trigger radio ramp up in a software manner and the caller is guaranteed that ramp up is ongoing when the function ends. If TRX_RAMP_UP_HW_TRIGGER is selected, this function will prepare the operation but it will end without starting radio ramp up. In this case, it is assumed that the trigger will be generated on the (D)PPI channel specified by nrf_802154_trx_ramp_up_ppi_channel_get. It is the user's responsibility to prepare the stimulation of this (D)PPI.
[in]	notifications_mask	Selects additional notifications generated during a frame reception. It is bitwise combination of nrf_802154_trx_receive_notifications_t values.
[in]	p_ack_tx_power	Selects the power which should be used to transmitted an ACK if required.