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 取得。如要瞭解詳情或對說明文件做出貢獻,請參閱資源。