Sfd Event; Receiving Packets; Configuring Radio Filters For Packet Reception - ST SimpleMAC STM32W108 Series User Manual

UM0893
Note: The "framePending" parameter is TRUE if the received ACK indicates that a frame is
pending. This is a very important information to notify the sender node that the destination
node has pending data for it.
5.3.4

SFD event

It is possible to be notified of an SFD event (see
through the ST_RadioSfdSentIsrCallback (uint32_t sfdSentTime) callback.
The SFD event notification is disabled by default. To enable it, call the
ST_RadioEnableSfdSentNotification function:
/* Enable SFD event notification */
ST_RadioEnableSfdSentNotification(TRUE);
Once enabled, an SFD event notification is sent through the related callback:
void ST_RadioSfdSentIsrCallback(uint32_t sfdSentTime)
{
/* user code */
}
5.4

Receiving packets

5.4.1

Configuring radio filters for packet reception

To receive a packet, the radio device filters must have been configured. The following steps
are required to configure radio filters:
1. Set the radio filtering mode according to the user application targets:
/* Set promiscuous mode: receive any packet on the selected radio channel */
/* Disable address filtering*/
ST_RadioEnableAddressFiltering(FALSE);
/* Turn off automatic acknowledgment */
ST_RadioEnableAutoAck(FALSE);
or
/* Receive packets only on a specific pan id and long or short address
(default configuration )*/
ST_RadioEnableAddressFiltering(TRUE);
2. Enable/disable the automatic transmission of an acknowledgment on packet reception
(only for packets with FCF acknowledge request bit set to 1). Address filtering must be
enabled for the automatic transmission of acknowledgment packet to occur:
/* Enable automatic packet acknowledgement (default is enabled) */
ST_RadioEnableAutoAck(TRUE);
3. Enable/disable the discarding of received packets for which a CRC verification has
failed. When this feature is enabled, the library automatically removes the CRC bytes
from the packets that passed the CRC verification:
/* Enable discarding packets which fail CRC (default is enabled) */
Designing an application using the SimpleMAC Library APIs
Doc ID 16995 Rev 10
IEEE 802.15.4 general MAC frame format )
45/54