otMacCounters

#include <link.h>

شمارنده های لایه MAC را نشان می دهد.

خلاصه

صفات عمومی

mRxAddressFiltered
uint32_t
تعداد کل فریم هایی که توسط ماژول MAC Filter رها شده است، به عنوان مثال دریافت شده از گره فهرست نشده.
mRxBeacon
uint32_t
تعداد کل فریم های MAC Beacon دریافت شده.
mRxBeaconRequest
uint32_t
تعداد کل فریم های درخواستی MAC Beacon دریافت شده است.
mRxBroadcast
uint32_t
تعداد کل فریم های پخش دریافتی.
mRxData
uint32_t
تعداد کل فریم های MAC Data دریافت شده.
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 Beacon.
mTxBeaconRequest
uint32_t
تعداد کل درخواست‌های ارسال فریم درخواست منحصر به فرد MAC Beacon.
mTxBroadcast
uint32_t
تعداد کل درخواست های ارسال فریم MAC پخش منحصر به فرد.
mTxData
uint32_t
تعداد کل درخواست‌های ارسال فریم داده منحصر به فرد MAC.
mTxDataPoll
uint32_t
تعداد کل درخواست های ارسال فریم نظرسنجی داده های MAC منحصر به فرد.
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 unicast یکتا.

صفات عمومی

mRxAddressFiltered

uint32_t otMacCounters::mRxAddressFiltered

تعداد کل فریم هایی که توسط ماژول MAC Filter رها شده است، به عنوان مثال دریافت شده از گره فهرست نشده.

mRxBeacon

uint32_t otMacCounters::mRxBeacon

تعداد کل فریم های MAC Beacon دریافت شده.

mRxBeaconRequest

uint32_t otMacCounters::mRxBeaconRequest

تعداد کل فریم های درخواستی MAC Beacon دریافت شده است.

mRxBroadcast

uint32_t otMacCounters::mRxBroadcast

تعداد کل فریم های پخش دریافتی.

mRxData

uint32_t otMacCounters::mRxData

تعداد کل فریم های MAC Data دریافت شده.

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

تعداد کل فریم ها به دلیل خطای امنیتی کاهش یافته است.

این شمارنده ممکن است افزایش یابد، برای مثال زمانی که از Frame Counter کمتر از حد انتظار برای رمزگذاری فریم استفاده می شود.

mRxErrUnknown Neighbor

uint32_t otMacCounters::mRxErrUnknownNeighbor

تعداد کل فریم ها به دلیل همسایه ناشناس کاهش یافته است.

mRxOther

uint32_t otMacCounters::mRxOther

تعداد کل انواع دیگر فریم های دریافتی.

mRxTotal

uint32_t otMacCounters::mRxTotal

تعداد کل فریم های دریافتی

این شمارنده تمام فریم‌های گزارش‌شده توسط درایور رادیویی پلت‌فرم، از جمله فریم‌هایی را که به‌عنوان مثال به‌دلیل خطای FCS رها شده‌اند، شمارش می‌کند.

mRxUnicast

uint32_t otMacCounters::mRxUnicast

تعداد کل فریم های یونیکاست دریافت شده.

mTxAck Requested

uint32_t otMacCounters::mTxAckRequested

تعداد کل درخواست‌های انتقال فریم MAC منحصربه‌فرد با تأیید درخواست‌شده.

mTxAcked

uint32_t otMacCounters::mTxAcked

تعداد کل درخواست های انتقال فریم MAC منحصر به فرد که پذیرفته شد.

mTxBeacon

uint32_t otMacCounters::mTxBeacon

تعداد کل درخواست های انتقال فریم منحصر به فرد MAC Beacon.

mTxBeaconRequest

uint32_t otMacCounters::mTxBeaconRequest

تعداد کل درخواست‌های ارسال فریم درخواست منحصر به فرد MAC Beacon.

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

تعداد کل درخواست‌های انتقال MAC منحصربه‌فرد ناشی از یک کانال شلوغ (یک شکست CSMA/CA).

mTxErrCca

uint32_t otMacCounters::mTxErrCca

تعداد کل خرابی های CCA.

معنای این شمارنده می تواند متفاوت باشد و به قابلیت های درایور رادیویی پلت فرم بستگی دارد.

اگر OT_RADIO_CAPS_CSMA_BACKOFF فعال باشد، این شمارنده تعداد کل تلاش‌های ناموفق کامل CSMA/CA را نشان می‌دهد و همچنین برای هر ارسال مجدد (در صورت شکست 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، یا نوع دیگری از خطای انتقال ایجاد شود. شمارنده mTxRetry هم برای فریم های unicast و هم برای پخش 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 منحصر به فرد.

توجه داشته باشید که این شمارنده برای هر درخواست انتقال MAC، صرف نظر از میزان خرابی‌های CCA، تلاش‌های CSMA-CA یا ارسال‌های مجدد، تنها یک بار افزایش می‌یابد.

این قانون افزایش برای شمارنده های زیر اعمال می شود:

  • 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 unicast یکتا.

منابع

موضوعات مرجع OpenThread API از کد منبع موجود در GitHub سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.