otMacCounters

#include <link.h>

代表 MAC 層計數器。

摘要

公開屬性

mRxAddressFiltered
uint32_t
MAC 篩選器模組捨棄的影格總數 (例如從拒絕清單的節點收到)。
mRxBeacon
uint32_t
收到的 MAC 信標影格總數。
mRxBeaconRequest
uint32_t
收到的 MAC 信標要求頁框總數。
mRxBroadcast
uint32_t
收到的廣播影格總數。
mRxData
uint32_t
收到的 MAC Data 框架總數。
mRxDataPoll
uint32_t
收到的 MAC 資料意見調查影格總數。
mRxDestAddrFiltered
uint32_t
根據目的地位址檢查所捨棄的影格總數,例如接收其他節點的影格。
mRxDuplicated
uint32_t
因重複而捨棄的影格總數,也就是接收到影格的時間。
mRxErrFcs
uint32_t
因 FCS 無效而捨棄的影格總數。
mRxErrInvalidSrcAddr
uint32_t
因來源位址無效而捨棄的影格總數。
mRxErrNoFrame
uint32_t
因缺少內容或格式錯誤而遭捨棄的影格總數。
mRxErrOther
uint32_t
因其他錯誤而捨棄的影格總數。
mRxErrSec
uint32_t
因安全性錯誤而捨棄的影格總數。
mRxErrUnknownNeighbor
uint32_t
因不明鄰點而捨棄的影格總數。
mRxOther
uint32_t
收到的其他類型的影格總數。
mRxTotal
uint32_t
收到的影格總數。
mRxUnicast
uint32_t
接收的單點傳播影格總數。
mTxAckRequested
uint32_t
含確認要求的不重複 MAC 頁框傳輸要求總數。
mTxAcked
uint32_t
已確認的不重複 MAC 頁框傳輸要求總數。
mTxBeacon
uint32_t
不重複 MAC 信標頁框傳輸要求的總數。
mTxBeaconRequest
uint32_t
不重複的 MAC 信標要求頁框傳輸要求總數。
mTxBroadcast
uint32_t
不重複廣播 MAC 影格傳輸要求總數。
mTxData
uint32_t
不重複的 MAC DataFrame 傳輸要求總數。
mTxDataPoll
uint32_t
不重複 MAC 資料意見調查影格傳輸要求的總數。
mTxDirectMaxRetryExpiry
uint32_t
符合直接封包重試次數上限的不重複 MAC 傳輸封包總數。
mTxErrAbort
uint32_t
因發生取消錯誤而造成的不重複 MAC 傳輸要求失敗總數。
mTxErrBusyChannel
uint32_t
忙碌管道 (例如 CSMA/CA 失敗) 造成的不重複 MAC 傳輸要求失敗總數。
mTxErrCca
uint32_t
CCA 失敗的總次數。
mTxIndirectMaxRetryExpiry
uint32_t
符合間接封包重試次數上限的不重複 MAC 傳輸封包總數。
mTxNoAckRequested
uint32_t
未要求確認的不重複 MAC 頁框傳輸要求總數。
mTxOther
uint32_t
其他 MAC 影格的傳輸要求總數。
mTxRetry
uint32_t
MAC 重新傳輸的總次數。
mTxTotal
uint32_t
不重複 MAC 頁框傳輸要求總數。
mTxUnicast
uint32_t
不重複的單點 MAC 頁框傳輸要求總數。

公開屬性

mRxAddressFiltered

uint32_t otMacCounters::mRxAddressFiltered

MAC 篩選器模組捨棄的影格總數 (例如從拒絕清單的節點收到)。

mRxBeacon

uint32_t otMacCounters::mRxBeacon

收到的 MAC 信標影格總數。

mRxBeaconRequest

uint32_t otMacCounters::mRxBeaconRequest

收到的 MAC 信標要求頁框總數。

mRxBroadcast

uint32_t otMacCounters::mRxBroadcast

收到的廣播影格總數。

mRxData

uint32_t otMacCounters::mRxData

收到的 MAC Data 框架總數。

mRxDataPoll

uint32_t otMacCounters::mRxDataPoll

收到的 MAC 資料意見調查影格總數。

mRxDestAddrFiltered

uint32_t otMacCounters::mRxDestAddrFiltered

根據目的地位址檢查所捨棄的影格總數,例如接收其他節點的影格。

mRxDuplicated

uint32_t otMacCounters::mRxDuplicated

因重複而捨棄的影格總數,也就是接收到影格的時間。

這個計數器可能會遞增,例如如果接收方產生的 ACK 影格尚未到達執行重新傳輸的傳送器節點。

mRxErrFcs

uint32_t otMacCounters::mRxErrFcs

因 FCS 無效而捨棄的影格總數。

mRxErrInvalidSrcAddr

uint32_t otMacCounters::mRxErrInvalidSrcAddr

因來源位址無效而捨棄的影格總數。

mRxErrNoFrame

uint32_t otMacCounters::mRxErrNoFrame

因缺少內容或格式錯誤而遭捨棄的影格總數。

mRxErrOther

uint32_t otMacCounters::mRxErrOther

因其他錯誤而捨棄的影格總數。

mRxErrSec

uint32_t otMacCounters::mRxErrSec

因安全性錯誤而捨棄的影格總數。

這個計數器可能會遞增,例如,使用低於預期的影格計數器來加密影格時。

mRxErrUnknownNeighbor

uint32_t otMacCounters::mRxErrUnknownNeighbor

因不明鄰點而捨棄的影格總數。

mRxOther

uint32_t otMacCounters::mRxOther

收到的其他類型的影格總數。

mRxTotal

uint32_t otMacCounters::mRxTotal

收到的影格總數。

這個計數器會計算平台無線電驅動程式回報的所有影格,包括因 FCS 錯誤而捨棄的影格。

mRxUnicast

uint32_t otMacCounters::mRxUnicast

接收的單點傳播影格總數。

mTxAckRequested

uint32_t otMacCounters::mTxAckRequested

含確認要求的不重複 MAC 頁框傳輸要求總數。

mTxAcked

uint32_t otMacCounters::mTxAcked

已確認的不重複 MAC 頁框傳輸要求總數。

mTxBeacon

uint32_t otMacCounters::mTxBeacon

不重複 MAC 信標頁框傳輸要求的總數。

mTxBeaconRequest

uint32_t otMacCounters::mTxBeaconRequest

不重複的 MAC 信標要求頁框傳輸要求總數。

mTxBroadcast

uint32_t otMacCounters::mTxBroadcast

不重複廣播 MAC 影格傳輸要求總數。

mTxData

uint32_t otMacCounters::mTxData

不重複的 MAC DataFrame 傳輸要求總數。

mTxDataPoll

uint32_t otMacCounters::mTxDataPoll

不重複 MAC 資料意見調查影格傳輸要求的總數。

mTxDirectMaxRetryExpiry

uint32_t otMacCounters::mTxDirectMaxRetryExpiry

符合直接封包重試次數上限的不重複 MAC 傳輸封包總數。

mTxErrAbort

uint32_t otMacCounters::mTxErrAbort

因發生取消錯誤而造成的不重複 MAC 傳輸要求失敗總數。

mTxErrBusyChannel

uint32_t otMacCounters::mTxErrBusyChannel

忙碌管道 (例如 CSMA/CA 失敗) 造成的不重複 MAC 傳輸要求失敗總數。

mTxErrCca

uint32_t otMacCounters::mTxErrCca

CCA 失敗的總次數。

這個計數器代表的意義可能會有所不同,實際情況視平台的無線電驅動程式功能而定。

如果啟用 OT_RADIO_CAPS_CSMA_BACKOFF,這個計數器代表失敗完整 CSMA/CA 嘗試總數,而每次重新傳輸時,也會遞增 1 (如果 CSMA/CA 失敗)。

如果啟用 OT_RADIO_CAPS_TRANSMIT_RETRIES,這個計數器代表嘗試完整 CSMA/CA 失敗次數,而針對每個資料影格要求,遞增一個遞增 (無論重新傳輸次數為何)。

mTxIndirectMaxRetryExpiry

uint32_t otMacCounters::mTxIndirectMaxRetryExpiry

符合間接封包重試次數上限的不重複 MAC 傳輸封包總數。

mTxNoAckRequested

uint32_t otMacCounters::mTxNoAckRequested

未要求確認的不重複 MAC 頁框傳輸要求總數。

mTxOther

uint32_t otMacCounters::mTxOther

其他 MAC 影格的傳輸要求總數。

這個計數器目前用於計算頻外影格的數量。

mTxRetry

uint32_t otMacCounters::mTxRetry

MAC 重新傳輸的總次數。

請注意,每次重新傳輸嘗試可能因為缺乏確認、CSMA/CA 故障或其他類型的傳輸錯誤所觸發,此計數器會遞增 1。單點傳播和廣播 MAC 影格的 mTxRetry 計數器都會遞增。

修改下列設定參數,控制系統的重新傳輸量:

  • 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

目前,如果平台的無線電驅動程式功能包含 OT_RADIO_CAPS_TRANSMIT_RETRIES,這個計數器就會無效。

mTxTotal

uint32_t otMacCounters::mTxTotal

不重複 MAC 頁框傳輸要求總數。

請注意,無論 CCA 失敗、CSMA-CA 嘗試次數或重新傳輸次數為何,每個 MAC 傳輸要求,其計數器都會增加 1。

這個遞增規則適用於下列計數器:

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

以下是有效的方程式:

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

mTxUnicast

uint32_t otMacCounters::mTxUnicast

不重複的單點 MAC 頁框傳輸要求總數。

資源

OpenThread API 參考資料主題源自原始碼,請前往 GitHub 取得。如要瞭解詳情或對說明文件做出貢獻,請參閱資源