MAC Interface Layer APIs#

This file defines routines for probing and configuring MAC-related items.

See mac-layer.h for source code.

Functions#

uint8_t

Get max number of MAC retries.

sl_status_t

Disable CCA after a number of consecutive CSMA failures due to CCA.

Function Documentation#

sl_zigbee_get_max_mac_retries#

uint8_t sl_zigbee_get_max_mac_retries (void )

Get max number of MAC retries.

Parameters
TypeDirectionArgument NameDescription
voidN/A

Returns the maximum number of no-ack retries that will be attempted

Returns

  • uint8_t Max MAC retries


sl_zigbee_force_tx_after_failed_cca#

sl_status_t sl_zigbee_force_tx_after_failed_cca (uint8_t csmaAttempts)

Disable CCA after a number of consecutive CSMA failures due to CCA.

Parameters
TypeDirectionArgument NameDescription
uint8_tN/AcsmaAttempts

The number of consecutive CSMA failures due to CCA prior to disabling CCA. The maximum allowed value is 3. A value of 0 disables the feature.

For each packet to be transmitted by the MAC, disables CCA after a number of consecutive CSMA failures due to CCA. The packet is then transmitted using the standard number of mac retries, but with CCA off. Note that each CSMA failure consists of 5 failed and backed off CCA checks, which can take up to 35 milliseconds. The maximum allowed value for csmaAttempts is 3. A value of 0 disables the feature.

Returns

  • sl_status_t SL_STATUS_INVALID_PARAMETER, if csmaAttempts is out of range, SL_STATUS_OK otherwise.