מעקב אחר ערוצים

המודול הזה כולל פונקציות לתכונה 'מעקב אחר ערוצים'.

סיכום

הפונקציות במודול הזה זמינות כשתכונת מעקב הערוצים (OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE) מופעלת.

במסגרת התכונה 'מעקב אחר ערוצים' יתבצע מעקב מדי פעם אחר כל הערוצים כדי לקבוע אילו ערוצים נקיים יותר (ערוצים עם פחות הפרעות).

כשמעקב אחר הערוץ פעיל, מתבצעת סריקת אנרגיה באורך אפס שאוספת דגימה אחת של RSSI בכל ערוץ לכל מרווח לדגימה. נערכת השוואה בין דגימות ה-RSSI לסף מוגדר מראש של RSSI. כמדד לאיכות הערוץ, המודול למעקב אחר הערוצים שומר על שיעור ממוצע של דגימות RSSI שגבוהות מהסף שהוגדר (בערך) של חלון דגימה שהוגדר (המכונה 'תפוסת ערוץ').

פונקציות
otChannelMonitorGetChannelOccupancy(otInstance *aInstance, uint8_t aChannel)
uint16_t
מקבל את התפוסה הנוכחית בערוץ עבור ערוץ נתון.
otChannelMonitorGetRssiThreshold(otInstance *aInstance)
int8_t
קבלת סף RSSI למעקב ערוצים ב-dBm.
otChannelMonitorGetSampleCount(otInstance *aInstance)
uint32_t
קבלת המספר הכולל של דגימות RSSI למעקב אחר ערוצים (לכל ערוץ).
otChannelMonitorGetSampleInterval(otInstance *aInstance)
uint32_t
קבלת מרווח לדוגמה של ניטור ערוץ באלפיות שנייה.
otChannelMonitorGetSampleWindow(otInstance *aInstance)
uint32_t
מעקב אחר אורך ממוצע של דגימה של מעקב ערוצים (מספר דגימות).
otChannelMonitorIsEnabled(otInstance *aInstance)
bool
אינדיקטור שמציין אם הפעולה 'מעקב אחר ערוצים' מופעלת.
otChannelMonitorSetEnabled(otInstance *aInstance, bool aEnabled)
הפעלה או השבתה של הפעולה 'מעקב אחר ערוצים'.

פונקציות

OTChannelMonitorGetGetcupncy

uint16_t otChannelMonitorGetChannelOccupancy(
  otInstance *aInstance,
  uint8_t aChannel
)

מקבל את התפוסה הנוכחית בערוץ עבור ערוץ נתון.

ערך התפוסה בערוץ מייצג את התעריף הממוצע/האחוז של דגימות RSSI שהיו מעל לסף של RSSI ('דגימות RSSI גרועות').

עבור דוגמאות "חלון הדגימה" הראשונות, הממוצע נשמר כאחוז בפועל (כלומר, היחס בין מספר הדוגמאות של דוגמאות "גרועות" למספר הכולל של דוגמאות). אחרי דגימות של "חלון", הממוצע משתמש בממוצע משוקלל בצורה מעריכית. בפועל, המשמעות היא שהממוצע מייצג עד 3 * window דוגמאות אחרונות, עם המשקל הגבוה ביותר שניתן לדגימות האחרונות של kSampleWindow.

הערך המקסימלי של 0xffff מציין שכל דגימות ה-RSSI היו מעל לסף ה-RSSI (כלומר, 100% מהדגימות היו 'גרועות').

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aChannel
הערוץ שעבורו ניתן לקבל את מספר האורחים.
החזרות
התפוסה הנוכחית בערוץ.

otChannelMonitorGetRssiThreshold

int8_t otChannelMonitorGetRssiThreshold(
  otInstance *aInstance
)

קבלת סף RSSI למעקב ערוצים ב-dBm.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
החזרות
סף ה-RSSI ב-dBm.

OTChannelMonitorGetSampleCount

uint32_t otChannelMonitorGetSampleCount(
  otInstance *aInstance
)

קבלת המספר הכולל של דגימות RSSI למעקב אחר ערוצים (לכל ערוץ).

המספר מציין את סך כל הדגימות לכל ערוץ, לפי מודול המעקב אחר הערוץ מאז הפעלתו (מפני שממשק הרשת של Thread הופעל).

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
החזרות
המספר הכולל של דגימות RSSI (לכל ערוץ) עד כה.

otChannelMonitorGetSampleInterval

uint32_t otChannelMonitorGetSampleInterval(
  otInstance *aInstance
)

קבלת מרווח לדוגמה של ניטור ערוץ באלפיות שנייה.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
החזרות
מרווח הזמן לדוגמה של המעקב אחר הערוץ באלפיות שנייה.

otChannelMonitorGetWindow

uint32_t otChannelMonitorGetSampleWindow(
  otInstance *aInstance
)

מעקב אחר אורך ממוצע של דגימה של מעקב ערוצים (מספר דגימות).

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
החזרות
חלון הדגימה הממוצע.

otChannelMonitorIsEnabled

bool otChannelMonitorIsEnabled(
  otInstance *aInstance
)

אינדיקטור שמציין אם הפעולה 'מעקב אחר ערוצים' מופעלת.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
החזרות
הערך TRUE אם הפעולה 'מעקב אחר ערוצים' מופעלת, אחרת FALSE.

otChannelMonitorSetEnabled

otError otChannelMonitorSetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

הפעלה או השבתה של הפעולה 'מעקב אחר ערוצים'.

אחרי שהפעולות יתחילו, הנתונים שכבר נאספו יימחקו. עם זאת, אחרי ההשבתה של הפעולה, הנתונים הקודמים שנאספו עדיין יהיו תקפים וניתן יהיה לקרוא אותם.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aEnabled
הערך TRUE כדי להפעיל/להפעיל את הפעולה של מעקב אחר ערוצים, ו-FALSE כדי להשבית/להפסיק אותה.
ערכי החזרה
OT_ERROR_NONE
מצב המעקב אחר הערוצים השתנה בהצלחה
OT_ERROR_ALREADY
הערוץ למעקב ערוצים כבר נמצא באותו מצב.

משאבים

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