A configuration structure for IEEE 802.15.4 in RAIL.

Note

  • 802.15.4 radio configurations with Forward Error Correction (FEC) enabled are incompatible with 802.15.4 filtering and AutoACK on EFR32xG1 platforms. AutoACK should be disabled and promiscuous mode enabled when using such a configuration. This is enforced implicitly on EFR32xG1 platforms with RAIL_IEEE802154_SUPPORTS_G_DYNFEC true when RAIL_IEEE802154_ConfigGOptions() is called to enable any G options.

Public Attributes#

const RAIL_IEEE802154_AddrConfig_t *
addresses

Configure the RAIL Address Filter to allow the given destination addresses.

RAIL_AutoAckConfig_t
ackConfig

Define the ACKing configuration for the IEEE 802.15.4 implementation.

RAIL_StateTiming_t
timings

Define state timings for the IEEE 802.15.4 implementation.

uint8_t
framesMask

Set which 802.15.4 frame types will be received, of Beacon, Data, ACK, and Command.

bool
promiscuousMode

Enable promiscuous mode during configuration.

bool
isPanCoordinator

Set whether the device is a PAN Coordinator during configuration.

bool
defaultFramePendingInOutgoingAcks

The default value for the Frame Pending bit in outgoing ACKs for packets that triggered the RAIL_EVENT_IEEE802154_DATA_REQUEST_COMMAND event.

Public Attribute Documentation#

addresses#

const RAIL_IEEE802154_AddrConfig_t* RAIL_IEEE802154_Config_t::addresses

Configure the RAIL Address Filter to allow the given destination addresses.

If this pointer is NULL, defer destination address configuration. If a member of addresses is NULL, defer configuration of just that member. This can be overridden via RAIL_IEEE802154_SetAddresses(), or the individual members can be changed via RAIL_IEEE802154_SetPanId(), RAIL_IEEE802154_SetShortAddress(), and RAIL_IEEE802154_SetLongAddress().


Definition at line 283 of file protocol/ieee802154/rail_ieee802154.h

ackConfig#

RAIL_AutoAckConfig_t RAIL_IEEE802154_Config_t::ackConfig

Define the ACKing configuration for the IEEE 802.15.4 implementation.


Definition at line 287 of file protocol/ieee802154/rail_ieee802154.h

timings#

RAIL_StateTiming_t RAIL_IEEE802154_Config_t::timings

Define state timings for the IEEE 802.15.4 implementation.


Definition at line 291 of file protocol/ieee802154/rail_ieee802154.h

framesMask#

uint8_t RAIL_IEEE802154_Config_t::framesMask

Set which 802.15.4 frame types will be received, of Beacon, Data, ACK, and Command.

This setting can be overridden via RAIL_IEEE802154_AcceptFrames().


Definition at line 296 of file protocol/ieee802154/rail_ieee802154.h

promiscuousMode#

bool RAIL_IEEE802154_Config_t::promiscuousMode

Enable promiscuous mode during configuration.

This can be overridden via RAIL_IEEE802154_SetPromiscuousMode() afterwards.


Definition at line 301 of file protocol/ieee802154/rail_ieee802154.h

isPanCoordinator#

bool RAIL_IEEE802154_Config_t::isPanCoordinator

Set whether the device is a PAN Coordinator during configuration.

This can be overridden via RAIL_IEEE802154_SetPanCoordinator() afterwards.


Definition at line 306 of file protocol/ieee802154/rail_ieee802154.h

defaultFramePendingInOutgoingAcks#

bool RAIL_IEEE802154_Config_t::defaultFramePendingInOutgoingAcks

The default value for the Frame Pending bit in outgoing ACKs for packets that triggered the RAIL_EVENT_IEEE802154_DATA_REQUEST_COMMAND event.

Such an ACK's Frame Pending bit can be inverted if necessary during the handling of that event by calling RAIL_IEEE802154_ToggleFramePending (formerly RAIL_IEEE802154_SetFramePending).


Definition at line 314 of file protocol/ieee802154/rail_ieee802154.h