Transmit

APIs related to transmitting data packets.

Modules

Power Amplifier (PA)
APIs for interacting with one of the on chip PAs.

Data Structures

struct  RAIL_TxPacketDetails_t
 Detailed information requested and about the packet that was just transmitted.
 
struct  RAIL_ScheduleTxConfig_t
 A configuration structure for a scheduled transmit.
 
struct  RAIL_CsmaConfig_t
 A configuration structure for the CSMA transmit algorithm.
 
struct  RAIL_LbtConfig_t
 A configuration structure for the LBT transmit algorithm.

Macros

#define RAIL_STOP_MODES_NONE   (0U)
 Do not stop any radio operations.
 
#define RAIL_STOP_MODE_ACTIVE   (1U << RAIL_STOP_MODE_ACTIVE_SHIFT)
 Stop active radio operations only.
 
#define RAIL_STOP_MODE_PENDING   (1U << RAIL_STOP_MODE_PENDING_SHIFT)
 Stop pending radio operations.
 
#define RAIL_STOP_MODES_ALL   (0xFFU)
 Stop all radio operations.
 
#define RAIL_TX_OPTIONS_NONE   0UL
 A value representing no options enabled.
 
#define RAIL_TX_OPTIONS_DEFAULT   RAIL_TX_OPTIONS_NONE
 All options disabled by default .
 
#define RAIL_TX_OPTION_WAIT_FOR_ACK   (1UL << RAIL_TX_OPTION_WAIT_FOR_ACK_SHIFT)
 An option to configure whether or not the TXing node will listen for an ACK.
 
#define RAIL_TX_OPTION_REMOVE_CRC   (1UL << RAIL_TX_OPTION_REMOVE_CRC_SHIFT)
 An option to remove CRC bytes from TX packets.
 
#define RAIL_TX_OPTION_SYNC_WORD_ID   (1UL << RAIL_TX_OPTION_SYNC_WORD_ID_SHIFT)
 An option to select which sync word to send (0 or 1).
 
#define RAIL_TX_OPTION_ANTENNA0   (1UL << RAIL_TX_OPTION_ANTENNA0_SHIFT)
 An option to select antenna 0 for transmission.
 
#define RAIL_TX_OPTION_ANTENNA1   (1UL << RAIL_TX_OPTION_ANTENNA1_SHIFT)
 An option to select antenna 1 for transmission.
 
#define RAIL_TX_OPTION_ALT_PREAMBLE_LEN   (1UL << RAIL_TX_OPTION_ALT_PREAMBLE_LEN_SHIFT)
 An option to dynamically set an alternate preamble length for the transmission.
 
#define RAIL_TX_OPTION_CCA_PEAK_RSSI   (1UL << RAIL_TX_OPTION_CCA_PEAK_RSSI_SHIFT)
 An option to use peak rather than average RSSI energy detected during CSMA's RAIL_CsmaConfig_t::ccaDuration or LBT's RAIL_LbtConfig_t::lbtDuration to determine whether the channel is clear or busy.
 
#define RAIL_TX_OPTIONS_ALL   0xFFFFFFFFUL
 A value representing all possible options.
 
#define RAIL_MAX_LBT_TRIES   15
 The maximum number of LBT/CSMA retries supported.
 
#define RAIL_MAX_CSMA_EXPONENT   8
 The maximum power-of-2 exponent for CSMA backoffs.
 
#define RAIL_CSMA_CONFIG_802_15_4_2003_2p4_GHz_OQPSK_CSMA
 RAIL_CsmaConfig_t initializer configuring CSMA per IEEE 802.15.4-2003 on 2.4 GHz OSPSK, commonly used by ZigBee.
 
#define RAIL_CSMA_CONFIG_SINGLE_CCA
 RAIL_CsmaConfig_t initializer configuring a single CCA prior to TX.
 
#define RAIL_LBT_CONFIG_ETSI_EN_300_220_1_V2_4_1
 RAIL_LbtConfig_t initializer configuring LBT per ETSI 300 220-1 V2.4.1 for a typical Sub-GHz band.

Enumerations

enum  RAIL_StopMode_t {
  RAIL_STOP_MODE_ACTIVE_SHIFT = 0,
  RAIL_STOP_MODE_PENDING_SHIFT = 1
}
 Stop radio operation options bit mask.
 
enum  RAIL_TxOptions_t {
  RAIL_TX_OPTION_WAIT_FOR_ACK_SHIFT = 0,
  RAIL_TX_OPTION_REMOVE_CRC_SHIFT,
  RAIL_TX_OPTION_SYNC_WORD_ID_SHIFT,
  RAIL_TX_OPTION_ANTENNA0_SHIFT,
  RAIL_TX_OPTION_ANTENNA1_SHIFT,
  RAIL_TX_OPTION_ALT_PREAMBLE_LEN_SHIFT,
  RAIL_TX_OPTION_CCA_PEAK_RSSI_SHIFT
}
 Transmit options, in reality a bitmask.
 
enum  RAIL_ScheduledTxDuringRx_t {
  RAIL_SCHEDULED_TX_DURING_RX_POSTPONE_TX,
  RAIL_SCHEDULED_TX_DURING_RX_ABORT_TX
}
 Enumerates the possible outcomes of what will occur if a scheduled TX ends up firing during RX.

Functions

RAIL_Status_t RAIL_StartTx (RAIL_Handle_t railHandle, uint16_t channel, RAIL_TxOptions_t options, const RAIL_SchedulerInfo_t *schedulerInfo)
 Starts a non-blocking transmit.
 
RAIL_Status_t RAIL_StopTx (RAIL_Handle_t railHandle, RAIL_StopMode_t mode)
 Stops an active or pending transmit.
 
RAIL_Status_t RAIL_StartScheduledTx (RAIL_Handle_t railHandle, uint16_t channel, RAIL_TxOptions_t options, const RAIL_ScheduleTxConfig_t *config, const RAIL_SchedulerInfo_t *schedulerInfo)
 Schedules sending a packet.
 
RAIL_Status_t RAIL_StartCcaCsmaTx (RAIL_Handle_t railHandle, uint16_t channel, RAIL_TxOptions_t options, const RAIL_CsmaConfig_t *csmaConfig, const RAIL_SchedulerInfo_t *schedulerInfo)
 Starts a non-blocking Transmit using CSMA.
 
RAIL_Status_t RAIL_StartCcaLbtTx (RAIL_Handle_t railHandle, uint16_t channel, RAIL_TxOptions_t options, const RAIL_LbtConfig_t *lbtConfig, const RAIL_SchedulerInfo_t *schedulerInfo)
 Starts a non-blocking Transmit using LBT.
 
RAIL_Status_t RAIL_SetCcaThreshold (RAIL_Handle_t railHandle, int8_t ccaThresholdDbm)
 Sets the CCA threshold in dBm.
 
RAIL_Status_t RAIL_GetTxPacketDetails (RAIL_Handle_t railHandle, RAIL_TxPacketDetails_t *pPacketDetails)
 Gets detailed information about the last packet transmitted.
 
RAIL_Status_t RAIL_GetTxPacketDetailsAlt (RAIL_Handle_t railHandle, bool isAck, RAIL_Time_t *pPacketTime)
 Gets detailed information about the last packet transmitted.
 
RAIL_Status_t RAIL_GetTxTimePreambleStart (RAIL_Handle_t railHandle, uint16_t totalPacketBytes, RAIL_Time_t *pPacketTime)
 Adjust a RAIL TX timestamp to refer to the start of the preamble.
 
RAIL_Status_t RAIL_GetTxTimeSyncWordEnd (RAIL_Handle_t railHandle, uint16_t totalPacketBytes, RAIL_Time_t *pPacketTime)
 Adjust a RAIL TX timestamp to refer to the end of the sync word.
 
RAIL_Status_t RAIL_GetTxTimeFrameEnd (RAIL_Handle_t railHandle, uint16_t totalPacketBytes, RAIL_Time_t *pPacketTime)
 Adjust a RAIL TX timestamp to refer to the end of frame.
 
void RAIL_EnableTxHoldOff (RAIL_Handle_t railHandle, bool enable)
 Prevent the radio from starting a transmit.
 
bool RAIL_IsTxHoldOffEnabled (RAIL_Handle_t railHandle)
 Check whether or not TX hold off is enabled.
 
RAIL_Status_t RAIL_SetTxAltPreambleLength (RAIL_Handle_t railHandle, uint16_t length)
 Sets an alternate transmitter preamble length.

Detailed Description

APIs related to transmitting data packets.

Macro Definition Documentation

#define RAIL_CSMA_CONFIG_802_15_4_2003_2p4_GHz_OQPSK_CSMA
Value:
{ \
/* CSMA per 802.15.4-2003 on 2.4 GHz OSPSK, commonly used by ZigBee */ \
/* csmaMinBoExp */ 3, /* 2^3-1 for 0..7 backoffs on 1st try */ \
/* csmaMaxBoExp */ 5, /* 2^5-1 for 0..31 backoffs on 3rd+ tries */ \
/* csmaTries */ 5, /* 5 tries overall (4 re-tries) */ \
/* ccaThreshold */ -75, /* 10 dB above sensitivity */ \
/* ccaBackoff */ 320, /* 20 symbols at 16 us/symbol */ \
/* ccaDuration */ 128, /* 8 symbols at 16 us/symbol */ \
/* csmaTimeout */ 0, /* No timeout */ \
}

RAIL_CsmaConfig_t initializer configuring CSMA per IEEE 802.15.4-2003 on 2.4 GHz OSPSK, commonly used by ZigBee.

Definition at line 1871 of file rail_types.h.

#define RAIL_CSMA_CONFIG_SINGLE_CCA
Value:
{ \
/* Perform a single CCA after 'fixed' delay */ \
/* csmaMinBoExp */ 0, /* Used for fixed backoff */ \
/* csmaMaxBoExp */ 0, /* Used for fixed backoff */ \
/* csmaTries */ 1, /* Single try */ \
/* ccaThreshold */ -75, /* Override if not desired choice */ \
/* ccaBackoff */ 0, /* No backoff (override with fixed value) */ \
/* ccaDuration */ 128, /* Override if not desired length */ \
/* csmaTimeout */ 0, /* no timeout */ \
}

RAIL_CsmaConfig_t initializer configuring a single CCA prior to TX.

It can be used to as a basis for implementing other channel access schemes with custom backoff delays. Users can override ccaBackoff with a fixed delay on each use.

Definition at line 1889 of file rail_types.h.

#define RAIL_LBT_CONFIG_ETSI_EN_300_220_1_V2_4_1
Value:
{ \
/* LBT per ETSI 300 220-1 V2.4.1 */ \
/* LBT time = random backoff of 0-5 ms in .5 ms increments plus 5 ms fixed */ \
/* lbtMinBoRand */ 0, /* */ \
/* lbtMaxBoRand */ 10, /* */ \
/* lbtTries */ RAIL_MAX_LBT_TRIES, /* the maximum supported */ \
/* lbtThreshold */ -87, /* */ \
/* lbtBackoff */ 500, /* 0.5 ms */ \
/* lbtDuration */ 5000, /* 5 ms */ \
/* lbtTimeout */ 0, /* No timeout (recommend user override) */ \
}
#define RAIL_MAX_LBT_TRIES
The maximum number of LBT/CSMA retries supported.
Definition: rail_types.h:1747

RAIL_LbtConfig_t initializer configuring LBT per ETSI 300 220-1 V2.4.1 for a typical Sub-GHz band.

To be practical, users should override lbtTries and/or lbtTimeout so channel access failure will be reported in a reasonable time frame rather than the unbounded time frame ETSI defined.

Definition at line 1987 of file rail_types.h.

#define RAIL_TX_OPTION_ALT_PREAMBLE_LEN   (1UL << RAIL_TX_OPTION_ALT_PREAMBLE_LEN_SHIFT)

An option to dynamically set an alternate preamble length for the transmission.

If this option is not set, the pre-configured channel preamble length will be used.

Definition at line 1660 of file rail_types.h.

#define RAIL_TX_OPTION_ANTENNA0   (1UL << RAIL_TX_OPTION_ANTENNA0_SHIFT)

An option to select antenna 0 for transmission.

If the antenna selection option is not set or if both antenna options are set, then the transmit will occur on either antenna depending on the last receive or transmit selection. This option is only valid on platforms that support Antenna Control and have been configured via RAIL_ConfigAntenna().

Note
These TX antenna options do not control the antenna used for Auto-ACK transmissions, which always occur on the same antenna used to receive the packet being acknowledged.

Definition at line 1642 of file rail_types.h.

#define RAIL_TX_OPTION_ANTENNA1   (1UL << RAIL_TX_OPTION_ANTENNA1_SHIFT)

An option to select antenna 1 for transmission.

If the antenna selection option is not set or if both antenna options are set, then the transmit will occur on either antenna depending on the last receive or transmit selection. This option is only valid on platforms that support Antenna Control and have been configured via RAIL_ConfigAntenna().

Note
These TX antenna options do not control the antenna used for Auto-ACK transmissions, which always occur on the same antenna used to receive the packet being acknowledged.

Definition at line 1654 of file rail_types.h.

#define RAIL_TX_OPTION_CCA_PEAK_RSSI   (1UL << RAIL_TX_OPTION_CCA_PEAK_RSSI_SHIFT)

An option to use peak rather than average RSSI energy detected during CSMA's RAIL_CsmaConfig_t::ccaDuration or LBT's RAIL_LbtConfig_t::lbtDuration to determine whether the channel is clear or busy.

Note
This option does nothing on platforms like EFR32XG1 that lack support for capturing peak RSSI energy.

Definition at line 1669 of file rail_types.h.

#define RAIL_TX_OPTION_REMOVE_CRC   (1UL << RAIL_TX_OPTION_REMOVE_CRC_SHIFT)

An option to remove CRC bytes from TX packets.

To receive packets when the sender has this option set true, set RAIL_RX_OPTION_IGNORE_CRC_ERRORS on the receive side.

Definition at line 1624 of file rail_types.h.

#define RAIL_TX_OPTION_SYNC_WORD_ID   (1UL << RAIL_TX_OPTION_SYNC_WORD_ID_SHIFT)

An option to select which sync word to send (0 or 1).

Note that this does not set the actual sync words, it just picks which of the two will be sent with the packet.

Definition at line 1630 of file rail_types.h.

#define RAIL_TX_OPTION_WAIT_FOR_ACK   (1UL << RAIL_TX_OPTION_WAIT_FOR_ACK_SHIFT)

An option to configure whether or not the TXing node will listen for an ACK.

If this is false, the isAck flag in RAIL_RxPacketDetails_t of a received packet will always be false.

Definition at line 1618 of file rail_types.h.

#define RAIL_TX_OPTIONS_ALL   0xFFFFFFFFUL

A value representing all possible options.

Definition at line 1672 of file rail_types.h.

#define RAIL_TX_OPTIONS_DEFAULT   RAIL_TX_OPTIONS_NONE

All options disabled by default .

Definition at line 1612 of file rail_types.h.

#define RAIL_TX_OPTIONS_NONE   0UL

A value representing no options enabled.

Definition at line 1610 of file rail_types.h.

Enumeration Type Documentation

Enumerates the possible outcomes of what will occur if a scheduled TX ends up firing during RX.

Because RX and TX can't happen at the same time, it is up to the user how the TX should be handled. This enumeration is passed into RAIL_StartScheduledTx() as part of RAIL_ScheduleTxConfig_t.

Enumerator
RAIL_SCHEDULED_TX_DURING_RX_POSTPONE_TX 

The scheduled TX will be postponed until RX completes and then sent.

RAIL_SCHEDULED_TX_DURING_RX_ABORT_TX 

The scheduled TX will be aborted and a TX aborted event will fire.

Definition at line 1702 of file rail_types.h.

Stop radio operation options bit mask.

Enumerator
RAIL_STOP_MODE_ACTIVE_SHIFT 

Shift position of RAIL_STOP_MODE_ACTIVE bit.

RAIL_STOP_MODE_PENDING_SHIFT 

Shift position of RAIL_STOP_MODE_PENDING bit.

Definition at line 1572 of file rail_types.h.

Transmit options, in reality a bitmask.

Enumerator
RAIL_TX_OPTION_WAIT_FOR_ACK_SHIFT 

Shift position of RAIL_TX_OPTION_WAIT_FOR_ACK bit.

RAIL_TX_OPTION_REMOVE_CRC_SHIFT 

Shift position of RAIL_TX_OPTION_REMOVE_CRC bit.

RAIL_TX_OPTION_SYNC_WORD_ID_SHIFT 

Shift position of RAIL_TX_OPTION_SYNC_WORD_ID bit.

RAIL_TX_OPTION_ANTENNA0_SHIFT 

Shift position of RAIL_TX_OPTION_ANTENNA0 bit.

RAIL_TX_OPTION_ANTENNA1_SHIFT 

Shift position of RAIL_TX_OPTION_ANTENNA1 bit.

RAIL_TX_OPTION_ALT_PREAMBLE_LEN_SHIFT 

Shift position of RAIL_TX_OPTION_ALT_PREAMBLE_LEN bit.

RAIL_TX_OPTION_CCA_PEAK_RSSI_SHIFT 

Shift position of RAIL_TX_OPTION_CCA_PEAK_RSSI bit.

Definition at line 1592 of file rail_types.h.

Function Documentation

void RAIL_EnableTxHoldOff ( RAIL_Handle_t  railHandle,
bool  enable 
)

Prevent the radio from starting a transmit.

Parameters
[in]railHandleA RAIL instance handle.
[in]enableEnable/Disable TX hold off.
Returns
void.

Enable TX hold off to prevent the radio from starting any transmits. Disable TX hold off to allow the radio to transmit again. Attempting to transmit with the TX hold off enabled will result in RAIL_EVENT_TX_BLOCKED and/or RAIL_EVENT_TXACK_BLOCKED events.

Note
This function does not affect a transmit that has already started. To stop an already-started transmission, use RAIL_Idle() with RAIL_IDLE_ABORT.
RAIL_Status_t RAIL_GetTxPacketDetails ( RAIL_Handle_t  railHandle,
RAIL_TxPacketDetails_t pPacketDetails 
)

Gets detailed information about the last packet transmitted.

Parameters
[in]railHandleA RAIL instance handle.
[in,out]pPacketDetailsAn application-provided pointer to store RAIL_TxPacketDetails_t corresponding to the transmit event. The isAck and timeSent fields totalPacketBytes and timePosition must be initialized prior to each call:
  • isAck true to obtain details about the most recent ACK transmit, false to obtain details about the most recent app-initiated transmit.
  • totalPacketBytes with the total number of bytes of the transmitted packet for RAIL to use when calculating the specified timestamp. This should account for all bytes sent over the air after the Preamble and Sync word(s), including CRC bytes.
  • timePosition with a RAIL_PacketTimePosition_t value specifying the packet position to put in the timeSent field on return. This field will also be updated with the actual position corresponding to the timeSent value filled in.
Returns
RAIL_STATUS_NO_ERROR if pPacketDetails was filled in, or an appropriate error code otherwise.
Note
Consider using RAIL_GetTxPacketDetailsAlt for smaller code size.

This function can only be called from callback context for either RAIL_EVENT_TX_PACKET_SENT or RAIL_EVENT_TXACK_PACKET_SENT events.

RAIL_Status_t RAIL_GetTxPacketDetailsAlt ( RAIL_Handle_t  railHandle,
bool  isAck,
RAIL_Time_t pPacketTime 
)

Gets detailed information about the last packet transmitted.

Parameters
[in]railHandleA RAIL instance handle.
[in]isAckTrue to obtain details about the most recent ACK transmit. False to obtain details about the most recent app-initiated transmit.
[out]pPacketTimeAn application-provided non-NULL pointer to store a RAIL_Time_t corresponding to the transmit event. This will be populated with a timestamp corresponding to an arbitrary location in the packet. Call RAIL_GetTxTimePreambleStart, RAIL_GetTxTimeSyncWordEnd, or RAIL_GetTxTimeFrameEnd to adjust the timestamp for different locations in the packet.
Returns
RAIL_STATUS_NO_ERROR if pPacketTime was filled in, or an appropriate error code otherwise.

This function can only be called from callback context for either RAIL_EVENT_TX_PACKET_SENT or RAIL_EVENT_TXACK_PACKET_SENT events.

RAIL_Status_t RAIL_GetTxTimeFrameEnd ( RAIL_Handle_t  railHandle,
uint16_t  totalPacketBytes,
RAIL_Time_t pPacketTime 
)

Adjust a RAIL TX timestamp to refer to the end of frame.

Parameters
[in]railHandleA RAIL instance handle.
[in]totalPacketBytesThe total number of bytes of the transmitted packet for RAIL to use when calculating the specified timestamp. This should account for all bytes transmitted over the air after the Preamble and Sync word(s), including CRC bytes.
[in,out]pPacketTimeThe time that was returned in a RAIL_Time_t from a previous call to RAIL_GetTxPacketDetailsAlt for this same packet. After this function, the time at that location will be updated with the time that this packet finished on air. Must be non-NULL.
Returns
RAIL_STATUS_NO_ERROR if pPacketTime was successfully calculated, or an appropriate error code otherwise.

This timestamp adjustment API should be called in the same interrupt context as RAIL_GetTxPacketDetailsAlt in order to get the timestamp for the end of the frame.

RAIL_Status_t RAIL_GetTxTimePreambleStart ( RAIL_Handle_t  railHandle,
uint16_t  totalPacketBytes,
RAIL_Time_t pPacketTime 
)

Adjust a RAIL TX timestamp to refer to the start of the preamble.

Parameters
[in]railHandleA RAIL instance handle.
[in]totalPacketBytesThe total number of bytes of the transmitted packet for RAIL to use when calculating the specified timestamp. This should account for all bytes transmitted over the air after the Preamble and Sync word(s), including CRC bytes.
[in,out]pPacketTimeThe time that was returned in a RAIL_Time_t from a previous call to RAIL_GetTxPacketDetailsAlt for this same packet. After this function, the time at that location will be updated with the time that the preamble for this packet started on air. Must be non-NULL.
Returns
RAIL_STATUS_NO_ERROR if pPacketTime was successfully calculated, or an appropriate error code otherwise.

This timestamp adjustment API should be called in the same interrupt context as RAIL_GetTxPacketDetailsAlt in order to get the timestamp for the beginning of the preamble.

RAIL_Status_t RAIL_GetTxTimeSyncWordEnd ( RAIL_Handle_t  railHandle,
uint16_t  totalPacketBytes,
RAIL_Time_t pPacketTime 
)

Adjust a RAIL TX timestamp to refer to the end of the sync word.

Parameters
[in]railHandleA RAIL instance handle.
[in]totalPacketBytesThe total number of bytes of the transmitted packet for RAIL to use when calculating the specified timestamp. This should account for all bytes transmitted over the air after the Preamble and Sync word(s), including CRC bytes.
[in,out]pPacketTimeThe time that was returned in a RAIL_Time_t from a previous call to RAIL_GetTxPacketDetailsAlt for this same packet. After this function, the time at that location will be updated with the time that the sync word for this packet finished on air. Must be non-NULL.
Returns
RAIL_STATUS_NO_ERROR if pPacketTime was successfully calculated, or an appropriate error code otherwise.

This timestamp adjustment API should be called in the same interrupt context as RAIL_GetTxPacketDetailsAlt in order to get the timestamp for the end of the sync word.

bool RAIL_IsTxHoldOffEnabled ( RAIL_Handle_t  railHandle)

Check whether or not TX hold off is enabled.

Parameters
[in]railHandleA RAIL instance handle.
Returns
Returns true if TX hold off is enabled, false otherwise.

TX hold off can be enabled/disabled using RAIL_EnableTxHoldOff. Attempting to transmit with the TX hold off enabled will block the transmission and result in RAIL_EVENT_TX_BLOCKED and/or RAIL_EVENT_TXACK_BLOCKED events.

RAIL_Status_t RAIL_SetCcaThreshold ( RAIL_Handle_t  railHandle,
int8_t  ccaThresholdDbm 
)

Sets the CCA threshold in dBm.

Parameters
[in]railHandleA RAIL instance handle.
[in]ccaThresholdDbmThe CCA threshold in dBm.
Returns
Status code indicating success of the function call.

Unlike RAIL_StartCcaCsmaTx() or RAIL_StartCcaLbtTx(), which can cause a transmit, this function only modifies the CCA threshold. A possible use case for this function involves setting the CCA threshold to invalid RSSI of -128 which blocks transmission by preventing clear channel assessments from succeeding.

RAIL_Status_t RAIL_SetTxAltPreambleLength ( RAIL_Handle_t  railHandle,
uint16_t  length 
)

Sets an alternate transmitter preamble length.

Parameters
[in]railHandleA RAIL instance handle.
[in]lengthThe desired preamble length, in bits.
Returns
Status code indicating success of the function call.
Note
Attempting to set a preamble length of 0xFFFF bits will result in RAIL_STATUS_INVALID_PARAMETER.
RAIL_Status_t RAIL_StartCcaCsmaTx ( RAIL_Handle_t  railHandle,
uint16_t  channel,
RAIL_TxOptions_t  options,
const RAIL_CsmaConfig_t csmaConfig,
const RAIL_SchedulerInfo_t schedulerInfo 
)

Starts a non-blocking Transmit using CSMA.

Parameters
[in]railHandleA RAIL instance handle.
[in]channelDefine the channel to transmit on.
[in]optionsTX options to be applied to this transmit only.
[in]csmaConfigA pointer to the RAIL_CsmaConfig_t structure describing the CSMA parameters to use for this transmit.
[in]schedulerInfoInformation to allow the radio scheduler to place this transmit appropriately. This is only used in multiprotocol version of RAIL and may be set to NULL in all other versions.
Returns
Status code indicating success of the function call. If successfully initiated, a transmit completion or failure will be reported by a later RAIL_Config_t::eventsCallback with the appropriate RAIL_Events_t.

Performs the Carrier Sense Multiple Access (CSMA) algorithm and, if the channel is deemed clear (RSSI below the specified threshold), it will commence transmission of the payload previously loaded via RAIL_WriteTxFifo(). Packets can be received during CSMA backoff periods if receive is active throughout the CSMA process. This will happen either by starting the CSMA process while receive is already active, or if the csmaBackoff time in the RAIL_CsmaConfig_t is less than the idleToRx time (set by RAIL_SetStateTiming()). If the csmaBackoff time is greater than the idleToRx time, receive will only be active during CSMA's clear channel assessments.

If the CSMA algorithm deems the channel busy, the RAIL_Config_t::eventsCallback occurs with RAIL_EVENT_TX_CHANNEL_BUSY, and the contents of the transmit FIFO remain intact.

Returns an error if a previous transmit is still in progress. If changing channels, any ongoing packet reception is aborted.

In multiprotocol, ensure that the radio is properly yielded after this operation completes. See Yielding the radio for more details.

RAIL_Status_t RAIL_StartCcaLbtTx ( RAIL_Handle_t  railHandle,
uint16_t  channel,
RAIL_TxOptions_t  options,
const RAIL_LbtConfig_t lbtConfig,
const RAIL_SchedulerInfo_t schedulerInfo 
)

Starts a non-blocking Transmit using LBT.

Parameters
[in]railHandleA RAIL instance handle.
[in]channelDefine the channel to transmit on.
[in]optionsTX options to be applied to this transmit only.
[in]lbtConfigA pointer to the RAIL_LbtConfig_t structure describing the LBT parameters to use for this transmit.
[in]schedulerInfoInformation to allow the radio scheduler to place this transmit appropriately. This is only used in multiprotocol version of RAIL and may be set to NULL in all other versions.
Returns
Status code indicating success of the function call. If successfully initiated, a transmit completion or failure will be reported by a later RAIL_Config_t::eventsCallback with the appropriate RAIL_Events_t.

Performs the Listen Before Talk (LBT) algorithm and, if the channel is deemed clear (RSSI below the specified threshold), it will commence transmission of the payload previously loaded via RAIL_WriteTxFifo(). Packets can be received during LBT backoff periods if receive is active throughout the LBT process. This will happen either by starting the LBT process while receive is already active, or if the lbtBackoff time in the RAIL_LbtConfig_t is less than the idleToRx time (set by RAIL_SetStateTiming()). If the lbtBackoff time is greater than the idleToRx time, receive will only be active during LBT's clear channel assessments.

If the LBT algorithm deems the channel busy, the RAIL_Config_t::eventsCallback occurs with RAIL_EVENT_TX_CHANNEL_BUSY, and the contents of the transmit FIFO remain intact.

Returns an error if a previous transmit is still in progress. If changing channels, any ongoing packet reception is aborted.

In multiprotocol, ensure that the radio is properly yielded after this operation completes. See Yielding the radio for more details.

RAIL_Status_t RAIL_StartScheduledTx ( RAIL_Handle_t  railHandle,
uint16_t  channel,
RAIL_TxOptions_t  options,
const RAIL_ScheduleTxConfig_t config,
const RAIL_SchedulerInfo_t schedulerInfo 
)

Schedules sending a packet.

Parameters
[in]railHandleA RAIL instance handle.
[in]channelDefine the channel to transmit on.
[in]optionsTX options to be applied to this transmit only.
[in]configA pointer to the RAIL_ScheduleTxConfig_t structure containing when the transmit should occur.
[in]schedulerInfoInformation to allow the radio scheduler to place this transmit appropriately. This is only used in multiprotocol version of RAIL and may be set to NULL in all other versions.
Returns
Status code indicating success of the function call. If successfully initiated, a transmit completion or failure will be reported by a later RAIL_Config_t::eventsCallback with the appropriate RAIL_Events_t.

Will begin transmission of the payload previously loaded via RAIL_WriteTxFifo() at the scheduled time. The time (in microseconds) as well as whether that time is absolute or relative, is specified using the RAIL_ScheduleTxConfig_t structure. Also specified in this structure is what to do if a scheduled transmit fires in the midst of receiving a packet.

Returns an error if a previous transmit is still in progress. If changing channels, any ongoing packet reception is aborted.

In multiprotocol, ensure that the radio is properly yielded after this operation completes. See Yielding the radio for more details.

RAIL_Status_t RAIL_StartTx ( RAIL_Handle_t  railHandle,
uint16_t  channel,
RAIL_TxOptions_t  options,
const RAIL_SchedulerInfo_t schedulerInfo 
)

Starts a non-blocking transmit.

Parameters
[in]railHandleA RAIL instance handle.
[in]channelDefine the channel to transmit on.
[in]optionsTX options to be applied to this transmit only.
[in]schedulerInfoInformation to allow the radio scheduler to place this transmit appropriately. This is only used in multiprotocol version of RAIL and may be set to NULL in all other versions.
Returns
Status code indicating success of the function call. If successfully initiated, transmit completion or failure will be reported by a later RAIL_Config_t::eventsCallback with the appropriate RAIL_Events_t.

Will begin transmission of the payload previously loaded via RAIL_WriteTxFifo() immediately, or right after a packet currently being received is completed.

Returns an error if a previous transmit is still in progress. If changing channels, any ongoing packet reception is aborted.

In multiprotocol, ensure that the radio is properly yielded after this operation completes. See Yielding the radio for more details.

RAIL_Status_t RAIL_StopTx ( RAIL_Handle_t  railHandle,
RAIL_StopMode_t  mode 
)

Stops an active or pending transmit.

Parameters
[in]railHandleA RAIL instance handle.
[in]modeConfigure the types of transmits to stop.
Returns
RAIL_STATUS_NO_ERROR if the transmit was successfully canceled. Returns RAIL_STATUS_INVALID_STATE if the requested transmit mode cannot be stopped.
Note
This function will stop an auto-ACK in active transmit.