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.

emberForceTxAfterFailedCca(uint8_t csmaAttempts)

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

Function Documentation#

emberGetMaxMacRetries#

uint8_t emberGetMaxMacRetries (void)

Get max number of MAC retries.

Parameters
N/A

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

Returns

  • uint8_t Max MAC retries


Definition at line 37 of file stack/include/mac-layer.h

emberForceTxAfterFailedCca#

EmberStatus emberForceTxAfterFailedCca (uint8_t csmaAttempts)

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

Parameters
N/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

  • EmberStatus EMBER_BAD_ARGUMENT, if csmaAttempts is out of range, EMBER_SUCCESS otherwise.


Definition at line 57 of file stack/include/mac-layer.h