otMacCounters

#include <link.h>

Stellt die MAC-Ebenenzähler dar.

Zusammenfassung

Öffentliche Attribute

mRxAddressFiltered
uint32_t
Die Gesamtzahl der Frames, die vom MAC-Filter-Modul gelöscht wurden, z. B. von einem Knoten auf der Sperrliste.
mRxBeacon
uint32_t
Gesamtzahl der empfangenen MAC-Beacon-Frames.
mRxBeaconRequest
uint32_t
Gesamtzahl der empfangenen Frames für MAC-Beacon-Anfragen.
mRxBroadcast
uint32_t
Die Gesamtzahl der empfangenen Broadcast-Frames.
mRxData
uint32_t
Die Gesamtzahl der empfangenen MAC-Datenframes.
mRxDataPoll
uint32_t
Die Gesamtzahl der empfangenen MAC-Datenabfrage-Frames.
mRxDestAddrFiltered
uint32_t
Die Gesamtzahl der Frames, die bei der Zieladressenprüfung verworfen wurden, z. B. der empfangene Frame für einen anderen Knoten.
mRxDuplicated
uint32_t
Die Gesamtzahl der Frames, die aufgrund von Duplizierung verworfen wurden, d. h. wenn der Frame bereits empfangen wurde.
mRxErrFcs
uint32_t
Die Gesamtzahl der Frames, die aufgrund eines ungültigen FCS gelöscht wurden.
mRxErrInvalidSrcAddr
uint32_t
Die Gesamtzahl der Frames, die aufgrund einer ungültigen Quelladresse gelöscht wurden.
mRxErrNoFrame
uint32_t
Die Gesamtzahl der Frames, die aufgrund von fehlenden oder fehlerhaften Inhalten entfernt wurden.
mRxErrOther
uint32_t
Die Gesamtzahl der Frames, die aufgrund eines anderen Fehlers verworfen wurden.
mRxErrSec
uint32_t
Die Gesamtzahl der Frames, die aufgrund eines Sicherheitsfehlers gelöscht wurden.
mRxErrUnknownNeighbor
uint32_t
Die Gesamtzahl der Frames, die aufgrund eines unbekannten Nachbarn gelöscht wurden.
mRxOther
uint32_t
Die Gesamtzahl der sonstigen empfangenen Frame-Typen.
mRxTotal
uint32_t
Die Gesamtzahl der empfangenen Frames.
mRxUnicast
uint32_t
Die Gesamtzahl der empfangenen Unicast-Frames.
mTxAckRequested
uint32_t
Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Frames mit angeforderter Bestätigung.
mTxAcked
uint32_t
Die Gesamtzahl der bestätigten Übertragungsanfragen für einzelne MAC-Frames.
mTxBeacon
uint32_t
Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Beacon-Frames.
mTxBeaconRequest
uint32_t
Die Gesamtzahl der einzelnen Frame-Übertragungsanfragen für MAC-Beacon-Anfragen.
mTxBroadcast
uint32_t
Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Broadcasts.
mTxData
uint32_t
Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Datenframes.
mTxDataPoll
uint32_t
Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Datenumfrage-Frames.
mTxDirectMaxRetryExpiry
uint32_t
Die Gesamtzahl der einzelnen MAC-Übertragungspakete, die das maximale Wiederholungslimit für direkte Pakete erreichen.
mTxErrAbort
uint32_t
Die Gesamtzahl der einzelnen fehlgeschlagenen MAC-Übertragungsanfragen, die durch einen Abbruchfehler verursacht wurden.
mTxErrBusyChannel
uint32_t
Die Gesamtzahl der einzelnen Fehler bei MAC-Übertragungsanfragen, die durch einen ausgelasteten Kanal verursacht wurden (CSMA/CA-Fehler).
mTxErrCca
uint32_t
Die Gesamtzahl der CCA-Fehler.
mTxIndirectMaxRetryExpiry
uint32_t
Die Gesamtzahl der einzelnen MAC-Übertragungspakete, die das maximale Wiederholungslimit für indirekte Pakete erreichen.
mTxNoAckRequested
uint32_t
Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Frames ohne angeforderte Bestätigung.
mTxOther
uint32_t
Die Gesamtzahl einzelner anderer Übertragungsanfragen für MAC-Frames.
mTxRetry
uint32_t
Die Gesamtzahl der Versuche zur erneuten Übertragung von MACs.
mTxTotal
uint32_t
Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Frames.
mTxUnicast
uint32_t
Die Gesamtzahl der eindeutigen Unicast-MAC-Frame-Übertragungsanfragen.

Öffentliche Attribute

mRxAddressFiltered

uint32_t otMacCounters::mRxAddressFiltered

Die Gesamtzahl der Frames, die vom MAC-Filter-Modul gelöscht wurden, z. B. von einem Knoten auf der Sperrliste.

mRxBeacon

uint32_t otMacCounters::mRxBeacon

Gesamtzahl der empfangenen MAC-Beacon-Frames.

mRxBeaconRequest

uint32_t otMacCounters::mRxBeaconRequest

Gesamtzahl der empfangenen Frames für MAC-Beacon-Anfragen.

mRxBroadcast

uint32_t otMacCounters::mRxBroadcast

Die Gesamtzahl der empfangenen Broadcast-Frames.

mRxData

uint32_t otMacCounters::mRxData

Die Gesamtzahl der empfangenen MAC-Datenframes.

mRxDataPoll

uint32_t otMacCounters::mRxDataPoll

Die Gesamtzahl der empfangenen MAC-Datenabfrage-Frames.

mRxDestAddrFiltered

uint32_t otMacCounters::mRxDestAddrFiltered

Die Gesamtzahl der Frames, die bei der Zieladressenprüfung verworfen wurden, z. B. der empfangene Frame für einen anderen Knoten.

mRxDuplicated

uint32_t otMacCounters::mRxDuplicated

Die Gesamtzahl der Frames, die aufgrund von Duplizierung verworfen wurden, d. h. wenn der Frame bereits empfangen wurde.

Dieser Zähler kann erhöht werden, z. B. wenn der vom Empfänger generierte ACK-Frame den Senderknoten nicht erreicht hat, der eine erneute Übertragung durchgeführt hat.

mRxErrFcs

uint32_t otMacCounters::mRxErrFcs

Die Gesamtzahl der Frames, die aufgrund eines ungültigen FCS gelöscht wurden.

mRxErrInvalidSrcAddr

uint32_t otMacCounters::mRxErrInvalidSrcAddr

Die Gesamtzahl der Frames, die aufgrund einer ungültigen Quelladresse gelöscht wurden.

mRxErrNoFrame

uint32_t otMacCounters::mRxErrNoFrame

Die Gesamtzahl der Frames, die aufgrund von fehlenden oder fehlerhaften Inhalten entfernt wurden.

mRxErrOther

uint32_t otMacCounters::mRxErrOther

Die Gesamtzahl der Frames, die aufgrund eines anderen Fehlers verworfen wurden.

mRxErrSec

uint32_t otMacCounters::mRxErrSec

Die Gesamtzahl der Frames, die aufgrund eines Sicherheitsfehlers gelöscht wurden.

Dieser Zähler kann erhöht werden, z. B. wenn ein niedrigerer als erwarteter Frame-Zähler zum Verschlüsseln des Frames verwendet wird.

mRxErrUnknownNeighbor

uint32_t otMacCounters::mRxErrUnknownNeighbor

Die Gesamtzahl der Frames, die aufgrund eines unbekannten Nachbarn gelöscht wurden.

mRxOther

uint32_t otMacCounters::mRxOther

Die Gesamtzahl der sonstigen empfangenen Frame-Typen.

mRxTotal

uint32_t otMacCounters::mRxTotal

Die Gesamtzahl der empfangenen Frames.

Dieser Zähler zählt alle Frames, die vom Radiotreiber der Plattform gemeldet wurden, einschließlich Frames, die beispielsweise aufgrund eines FCS-Fehlers verworfen wurden.

mRxUnicast

uint32_t otMacCounters::mRxUnicast

Die Gesamtzahl der empfangenen Unicast-Frames.

mTxAckRequested

uint32_t otMacCounters::mTxAckRequested

Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Frames mit angeforderter Bestätigung.

mTxAcked

uint32_t otMacCounters::mTxAcked

Die Gesamtzahl der bestätigten Übertragungsanfragen für einzelne MAC-Frames.

mTxBeacon

uint32_t otMacCounters::mTxBeacon

Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Beacon-Frames.

mTxBeaconRequest

uint32_t otMacCounters::mTxBeaconRequest

Die Gesamtzahl der einzelnen Frame-Übertragungsanfragen für MAC-Beacon-Anfragen.

mTxBroadcast

uint32_t otMacCounters::mTxBroadcast

Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Broadcasts.

mTxData

uint32_t otMacCounters::mTxData

Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Datenframes.

mTxDataPoll

uint32_t otMacCounters::mTxDataPoll

Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Datenumfrage-Frames.

mTxDirectMaxRetryExpiry

uint32_t otMacCounters::mTxDirectMaxRetryExpiry

Die Gesamtzahl der einzelnen MAC-Übertragungspakete, die das maximale Wiederholungslimit für direkte Pakete erreichen.

mTxErrAbort

uint32_t otMacCounters::mTxErrAbort

Die Gesamtzahl der einzelnen fehlgeschlagenen MAC-Übertragungsanfragen, die durch einen Abbruchfehler verursacht wurden.

mTxErrBusyChannel

uint32_t otMacCounters::mTxErrBusyChannel

Die Gesamtzahl der einzelnen Fehler bei MAC-Übertragungsanfragen, die durch einen ausgelasteten Kanal verursacht wurden (CSMA/CA-Fehler).

mTxErrCca

uint32_t otMacCounters::mTxErrCca

Die Gesamtzahl der CCA-Fehler.

Die Bedeutung dieses Zählers kann unterschiedlich sein und hängt von den Funktreibern der Plattform ab.

Wenn OT_RADIO_CAPS_CSMA_BACKOFF aktiviert ist, stellt dieser Zähler die Gesamtzahl der vollständigen CSMA/CA-fehlgeschlagenen Versuche dar und wird bei jeder erneuten Übertragung um 1 erhöht (falls ein CSMA/CA-Fehler fehlschlägt).

Wenn OT_RADIO_CAPS_TRANSMIT_RETRIES aktiviert ist, stellt dieser Zähler die Gesamtzahl der vollständigen CSMA/CA-fehlgeschlagenen Versuche dar und wird bei jeder einzelnen Dataframe-Anfrage um 1 erhöht (unabhängig von der Anzahl der erneuten Übertragungen).

mTxIndirectMaxRetryExpiry

uint32_t otMacCounters::mTxIndirectMaxRetryExpiry

Die Gesamtzahl der einzelnen MAC-Übertragungspakete, die das maximale Wiederholungslimit für indirekte Pakete erreichen.

mTxNoAckRequested

uint32_t otMacCounters::mTxNoAckRequested

Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Frames ohne angeforderte Bestätigung.

mTxOther

uint32_t otMacCounters::mTxOther

Die Gesamtzahl einzelner anderer Übertragungsanfragen für MAC-Frames.

Dieser Zähler wird derzeit zum Zählen von Out-of-Band-Frames verwendet.

mTxRetry

uint32_t otMacCounters::mTxRetry

Die Gesamtzahl der Versuche zur erneuten Übertragung von MACs.

Dieser Zähler wird bei jedem erneuten Übertragungsversuch um eins erhöht, der möglicherweise durch fehlende Bestätigung, einen CSMA/CA-Fehler oder eine andere Art von Übertragungsfehler ausgelöst wird. Der Zähler mTxRetry wird sowohl für Unicast- als auch für Broadcast-MAC-Frames inkrementiert.

Ändern Sie die folgenden Konfigurationsparameter, um die Anzahl der erneuten Übertragungen im System zu steuern:

  • 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

Derzeit ist dieser Zähler ungültig, wenn die Radiotreiberfunktion der Plattform OT_RADIO_CAPS_TRANSMIT_RETRIES enthält.

mTxTotal

uint32_t otMacCounters::mTxTotal

Die Gesamtzahl der einzelnen Übertragungsanfragen für MAC-Frames.

Beachten Sie, dass dieser Zähler für jede MAC-Übertragungsanfrage nur um eins erhöht wird, unabhängig von der Anzahl der CCA-Fehler, CSMA-CA-Versuche oder der erneuten Übertragungen.

Diese Regel gilt für die folgenden Zähler:

  • mTxUnicast
  • mTxBroadcast
  • mTxAckRequested
  • mTxNoAckRequested
  • mTxData
  • mTxDataPoll
  • mTxBeacon
  • mTxBeaconRequest
  • mTxOther
  • mTxErrAbort
  • mTxErrBusyChannel

Die folgenden Gleichungen sind gültig:

  • mTxTotal = mTxUnicast + mTxBroadcast
  • mTxTotal = mTxAckRequested + mTxNoAckRequested
  • mTxTotal = mTxData + mTxDataPoll + mTxBeacon + mTxBeaconRequest + mTxOther

mTxUnicast

uint32_t otMacCounters::mTxUnicast

Die Gesamtzahl der eindeutigen Unicast-MAC-Frame-Übertragungsanfragen.

Ressourcen

OpenThread API-Referenzthemen stammen aus dem Quellcode, der auf GitHub verfügbar ist. Weitere Informationen finden Sie unter Ressourcen. Dort können Sie auch einen Beitrag zu unserer Dokumentation leisten.