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
إجمالي عدد طلبات إرسال 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 المستلمة.
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
إجمالي عدد طلبات إرسال 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 لكل من إطارات MAC الأحادي البث وإطارات 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+mTxBroadcastmTxTotal=mTxAckRequested+mTxNoAckRequestedmTxTotal=mTxData+mTxDataPoll+mTxBeacon+mTxBeaconRequest+mTxOther
mTxUnicast
uint32_t otMacCounters::mTxUnicast
إجمالي عدد طلبات إرسال إطار MAC الأحادي الفردي.
المراجِع
تنشأ المواضيع المرجعية لواجهة برمجة تطبيقات OpenThread من رمز المصدر المتاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.