Symbols ![]()
loading...
Files ![]()
loading...
otMacCounters struct
Represents the MAC layer counters.
Syntax
typedef struct otMacCounters
{
uint32_t mTxTotal;
uint32_t mTxUnicast;
uint32_t mTxBroadcast;
uint32_t mTxAckRequested;
uint32_t mTxAcked;
uint32_t mTxNoAckRequested;
uint32_t mTxData;
uint32_t mTxDataPoll;
uint32_t mTxBeacon;
uint32_t mTxBeaconRequest;
uint32_t mTxOther;
uint32_t mTxRetry;
uint32_t mTxDirectMaxRetryExpiry;
uint32_t mTxIndirectMaxRetryExpiry;
uint32_t mTxErrCca;
uint32_t mTxErrAbort;
uint32_t mTxErrBusyChannel;
uint32_t mRxTotal;
uint32_t mRxUnicast;
uint32_t mRxBroadcast;
uint32_t mRxData;
uint32_t mRxDataPoll;
uint32_t mRxBeacon;
uint32_t mRxBeaconRequest;
uint32_t mRxOther;
uint32_t mRxAddressFiltered;
uint32_t mRxDestAddrFiltered;
uint32_t mRxDuplicated;
uint32_t mRxErrNoFrame;
uint32_t mRxErrUnknownNeighbor;
uint32_t mRxErrInvalidSrcAddr;
uint32_t mRxErrSec;
uint32_t mRxErrFcs;
uint32_t mRxErrOther;
} otMacCounters;
Fields
Field
Declared as
Description
uint32_t
The total number of unique MAC frame transmission requests. Note that this counter is incremented for each MAC transmission request only by one, regardless of the amount of CCA failures, CSMA-CA attempts, or retransmissions. This increment rule applies to the following counters: - @p mTxUnicast - @p mTxBroadcast - @p mTxAckRequested - @p mTxNoAckRequested - @p mTxData - @p mTxDataPoll - @p mTxBeacon - @p mTxBeaconRequest - @p mTxOther - @p mTxErrAbort - @p mTxErrBusyChannel The following equations are valid: - @p mTxTotal = @p mTxUnicast + @p mTxBroadcast - @p mTxTotal = @p mTxAckRequested + @p mTxNoAckRequested - @p mTxTotal = @p mTxData + @p mTxDataPoll + @p mTxBeacon + @p mTxBeaconRequest + @p mTxOther.
uint32_t
The total number of unique unicast MAC frame transmission requests.
uint32_t
The total number of unique broadcast MAC frame transmission requests.
uint32_t
The total number of unique MAC frame transmission requests with requested acknowledgment.
uint32_t
The total number of unique MAC frame transmission requests that were acked.
uint32_t
The total number of unique MAC frame transmission requests without requested acknowledgment.
uint32_t
The total number of unique MAC Data Poll frame transmission requests.
uint32_t
The total number of unique MAC Beacon Request frame transmission requests.
uint32_t
The total number of unique other MAC frame transmission requests. This counter is currently used for counting out-of-band frames.
uint32_t
The total number of MAC retransmission attempts. Note that this counter is incremented by one for each retransmission attempt that may be triggered by lack of acknowledgement, CSMA/CA failure, or other type of transmission error. The @p mTxRetry counter is incremented both for unicast and broadcast MAC frames. Modify the following configuration parameters to control the amount of retransmissions in the system: - OPENTHREAD_CONFIG_MAC_DEFAULT_MAX_FRAME_RETRIES_DIRECT - OPENTHREAD_CONFIG_MAC_DEFAULT_MAX_FRAME_RETRIES_INDIRECT - OPENTHREAD_CONFIG_MAC_TX_NUM_BCAST - OPENTHREAD_CONFIG_MAC_MAX_CSMA_BACKOFFS_DIRECT - OPENTHREAD_CONFIG_MAC_MAX_CSMA_BACKOFFS_INDIRECT Currently, this counter is invalid if the platform's radio driver capability includes OT_RADIO_CAPS_TRANSMIT_RETRIES.
uint32_t
The total number of unique MAC transmission packets that meet maximal retry limit for direct packets.
uint32_t
The total number of unique MAC transmission packets that meet maximal retry limit for indirect packets.
uint32_t
The total number of CCA failures. The meaning of this counter can be different and it depends on the platform's radio driver capabilities. If OT_RADIO_CAPS_CSMA_BACKOFF is enabled, this counter represents the total number of full CSMA/CA failed attempts and it is incremented by one also for each retransmission (in case of a CSMA/CA fail). If OT_RADIO_CAPS_TRANSMIT_RETRIES is enabled, this counter represents the total number of full CSMA/CA failed attempts and it is incremented by one for each individual data frame request (regardless of the amount of retransmissions).
uint32_t
The total number of unique MAC transmission request failures cause by an abort error.
uint32_t
The total number of unique MAC transmission requests failures caused by a busy channel (a CSMA/CA fail).
uint32_t
The total number of received frames. This counter counts all frames reported by the platform's radio driver, including frames that were dropped, for example because of an FCS error.
uint32_t
The total number of frames dropped by MAC Filter module, for example received from denylisted node.
uint32_t
The total number of frames dropped by destination address check, for example received frame for other node.
uint32_t
The total number of frames dropped due to duplication, that is when the frame has been already received. This counter may be incremented, for example when ACK frame generated by the receiver hasn't reached transmitter node which performed retransmission.
uint32_t
The total number of frames dropped because of missing or malformed content.
uint32_t
The total number of frames dropped due to unknown neighbor.
uint32_t
The total number of frames dropped due to invalid source address.
uint32_t
The total number of frames dropped due to security error. This counter may be incremented, for example when lower than expected Frame Counter is used to encrypt the frame.