otMacCounters

#include <link.h>

MAC レイヤのカウンタを表します。

概要

パブリック属性

mRxAddressFiltered
uint32_t
MAC フィルタ モジュールによってドロップされたフレーム(拒否リストに登録されているノードから受信した場合など)の合計数。
mRxBeacon
uint32_t
受信した MAC ビーコン フレームの合計数。
mRxBeaconRequest
uint32_t
受信した MAC ビーコン リクエスト フレームの合計数。
mRxBroadcast
uint32_t
受信したブロードキャスト フレームの合計数。
mRxData
uint32_t
受信した MAC データフレームの合計数。
mRxDataPoll
uint32_t
受信した MAC Data Poll フレームの合計数。
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 データフレーム送信リクエストの合計数。
mTxDataPoll
uint32_t
一意の MAC Data Poll フレーム送信リクエストの合計数。
mTxDirectMaxRetryExpiry
uint32_t
ダイレクト パケットの再試行上限を満たす一意の MAC 送信パケットの合計数。
mTxErrAbort
uint32_t
中止エラーによって発生した一意の MAC 送信リクエストの失敗の合計数。
mTxErrBusyChannel
uint32_t
ビジー チャネルが原因で発生した一意の MAC 送信リクエストが失敗した場合(CSMA/CA の失敗)の合計数。
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 データフレームの合計数。

mRxDataPoll

uint32_t otMacCounters::mRxDataPoll

受信した MAC Data Poll フレームの合計数。

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 データフレーム送信リクエストの合計数。

mTxDataPoll

uint32_t otMacCounters::mTxDataPoll

一意の MAC Data Poll フレーム送信リクエストの合計数。

mTxDirectMaxRetryExpiry

uint32_t otMacCounters::mTxDirectMaxRetryExpiry

ダイレクト パケットの再試行上限を満たす一意の MAC 送信パケットの合計数。

mTxErrAbort

uint32_t otMacCounters::mTxErrAbort

中止エラーによって発生した一意の MAC 送信リクエストの失敗の合計数。

mTxErrBusyChannel

uint32_t otMacCounters::mTxErrBusyChannel

ビジー チャネルが原因で発生した一意の MAC 送信リクエストが失敗した場合(CSMA/CA の失敗)の合計数。

mTxErrCca

uint32_t otMacCounters::mTxErrCca

CCA の失敗の合計数。

このカウンタの意味は、プラットフォームのラジオドライバの機能によって異なります。

OT_RADIO_CAPS_CSMA_BACKOFF が有効になっている場合、このカウンタは CSMA/CA のフル失敗回数の合計を表します。このカウンタは再送のたびに 1 ずつ増加します(CSMA/CA が失敗した場合)。

OT_RADIO_CAPS_TRANSMIT_RETRIES が有効になっている場合、このカウンタは CSMA/CA のフル失敗回数の合計を表します。このカウンタは(再送信の量に関係なく)個々のデータフレーム リクエストごとに 1 ずつ増加します。

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 ずつ加算されることに注意してください。mTxRetry カウンタは、ユニキャストおよびブロードキャスト MAC フレームの両方でインクリメントされます。

次の構成パラメータを変更して、システム内の再送信の量を制御します。

  • 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 で入手できるソースコードに由来しています。 詳細について、またはドキュメントへの投稿については、リソースをご覧ください。