otMacCounters

#include <link.h>

מייצג את המונים של שכבות ה-MAC.

סיכום

מאפיינים ציבוריים

mRxAddressFiltered
uint32_t
המספר הכולל של פריימים שהמודול 'מסנן MAC' צמצם, לדוגמה, שהתקבלו מצומת של רשימת הישויות שנחסמו.
mRxBeacon
uint32_t
המספר הכולל של מסגרות משׂואת רשת (beacon) של MAC שהתקבלו.
mRxBeaconRequest
uint32_t
המספר הכולל של מסגרות 'בקשת Beacon של 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
המספר הכולל של פריימים בפורמט unicast שהתקבלו.
mTxAckRequested
uint32_t
המספר הכולל של בקשות ייחודיות לשידור מסגרת של MAC שקיבלו את האישור המבוקש.
mTxAcked
uint32_t
המספר הכולל של בקשות ייחודיות לשידור מסגרות של MAC שדווחו.
mTxBeacon
uint32_t
המספר הכולל של בקשות ייחודיות לשידור מסגרת של משׂואת רשת (beacon) של 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 ייחודי ל-Uncast.

מאפיינים ציבוריים

mRxAddressFiltered

uint32_t otMacCounters::mRxAddressFiltered

המספר הכולל של פריימים שהמודול 'מסנן MAC' צמצם, לדוגמה, שהתקבלו מצומת של רשימת הישויות שנחסמו.

mRxBeacon

uint32_t otMacCounters::mRxBeacon

המספר הכולל של מסגרות משׂואת רשת (beacon) של MAC שהתקבלו.

mRxBeaconRequest

uint32_t otMacCounters::mRxBeaconRequest

המספר הכולל של מסגרות 'בקשת Beacon של 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

המספר הכולל של פריימים בפורמט unicast שהתקבלו.

mTxAckRequested

uint32_t otMacCounters::mTxAckRequested

המספר הכולל של בקשות ייחודיות לשידור מסגרת של MAC שקיבלו את האישור המבוקש.

mTxAcked

uint32_t otMacCounters::mTxAcked

המספר הכולל של בקשות ייחודיות לשידור מסגרות של MAC שדווחו.

mTxBeacon

uint32_t otMacCounters::mTxBeacon

המספר הכולל של בקשות ייחודיות לשידור מסגרת של משׂואת רשת (beacon) של 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, והוא יגדל ב-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 או שגיאה אחרת בשידור. המונה mTxRetry גדל גם עבור פריימים בפורמט Unicode וגם עבור מסגרות 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 ייחודי ל-Uncast.

מקורות מידע

המקור של נושאי העזר של OpenThread API הוא קוד המקור, שזמין ב-GitHub. אפשר לקרוא מידע נוסף או לתרום למסמכי התיעוד שלנו בדף מקורות מידע.