EmberZNet API for accessing and setting MAC configuration. See MAC Interface Layer APIs for documentation.

License#

Copyright 2018 Silicon Laboratories Inc. www.silabs.com

The licensor of this software is Silicon Laboratories Inc. Your use of this software is governed by the terms of Silicon Labs Master Software License Agreement (MSLA) available at www.silabs.com/about-us/legal/master-software-license-agreement. This software is distributed to you in Source Code format and is governed by the sections of the MSLA applicable to Source Code.

/***************************************************************************/
#ifndef SILABS_MAC_LAYER_H
#define SILABS_MAC_LAYER_H

uint8_t emberGetMaxMacRetries(void);

EmberStatus emberForceTxAfterFailedCca(uint8_t csmaAttempts);

#endif // SILABS_MAC_LAYER_H

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