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

#include "stack/include/sl_zigbee_types.h"

uint8_t sl_zigbee_get_max_mac_retries(void);

sl_status_t sl_zigbee_force_tx_after_failed_cca(uint8_t csmaAttempts);

#endif // SILABS_MAC_LAYER_H

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

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

Returns

  • uint8_t Max MAC retries


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

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
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

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


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