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 数据轮询帧总数。
|
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 数据轮询帧传输请求的总数。
|
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 数据帧总数。
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 数据帧传输请求的总数。
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 失败尝试的总次数,并且每次重新传输时(如果 CSMA/CA 失败)都会增加 1 次。
如果启用了 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。对于单播和广播 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 上提供的源代码。如需了解详情,或者为我们的文档做贡献,请参阅资源。