זיהוי ג'אם

המודול הזה כולל פונקציות של תכונת זיהוי פקקים.

סיכום

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

סוג Dedef

otJamDetectionCallback)(bool aJamState, void *aContext) Typedef
void(*
המערכת מפעילה את הסמן של הפונקציה אם מזוהה זיהוי Jam והמערכת מזהה פקק.

פונקציות

otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
תחילת התקופה של זיהוי מסמך ה-Jam (בשניות)
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
קבלת מפת סיביות נוכחית של ההיסטוריה.
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
קבלת סף RSSI לזיהוי Jam (ב-dBm).
otJamDetectionGetState(otInstance *aInstance)
bool
קבלת מצב זיהוי Jam.
otJamDetectionGetWindow(otInstance *aInstance)
uint8_t
משיגים את חלון זיהוי הפקקים (בשניות).
otJamDetectionIsEnabled(otInstance *aInstance)
bool
קבלת סטטוס זיהוי Jam (מופעל/מושבת)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
מגדירים את פרק הזמן הנוכחי לזיהוי Jam (בשניות).
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
מגדירים את סף ה-RSS לזיהוי Jam (ב-dBm).
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
מגדירים את חלון זיהוי הפקקים (בשניות).
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
התחלת הזיהוי של מסמך ה-Jam.
otJamDetectionStop(otInstance *aInstance)
הפסקת הזיהוי של מסמך ה-Jam.

סוג Dedef

otJamDetectionCallback

void(* otJamDetectionCallback)(bool aJamState, void *aContext)

המערכת מפעילה את הסמן של הפונקציה אם מזוהה זיהוי Jam והמערכת מזהה פקק.

פרטים
פרמטרים
[in] aJamState
המצב הנוכחי של מסמך ה-Jam (true אם זוהה מסמך Jam, אחרת false).
[in] aContext
מצביע על הקשר ספציפי לאפליקציה.

פונקציות

otJamDetectionGetBusyperiod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

תחילת התקופה של זיהוי מסמך ה-Jam (בשניות)

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

otJamDetectionGethistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

קבלת מפת סיביות נוכחית של ההיסטוריה.

הערך הזה מספק מידע על המצב הנוכחי של מודול זיהוי Jam לצורך מעקב/ניפוי באגים. היא מחזירה ערך של 64 ביט כאשר כל ביט תואם למרווח של שנייה אחת החל מביט 0 עבור המרווח האחרון, וביט 63 למרווחי הזמן הישנים ביותר (63 שניות לפני כן). אם המודול של זיהוי ה-Jam זיהה/זוהה רמה גבוהה של אות במהלך המרווח של שנייה אחת, מוגדר למקדח 1.

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

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

קבלת סף RSSI לזיהוי Jam (ב-dBm).

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

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

קבלת מצב זיהוי Jam.

פרטים
פרמטרים
[in] aInstance
מצביע על מופע של OpenThread.
החזרות
המצב של זיהוי Jam (זוהה true Jam, `false' אחרת).

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

משיגים את חלון זיהוי הפקקים (בשניות).

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

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

קבלת סטטוס זיהוי Jam (מופעל/מושבת)

פרטים
פרמטרים
[in] aInstance
מצביע על מופע של OpenThread.
החזרות
סטטוס זיהוי ה-Jam (True אם מופעל, False אם לא).

otJamDetectionSetBusyperiod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

מגדירים את פרק הזמן הנוכחי לזיהוי Jam (בשניות).

מספר השניות המצטברות בחלון הזיהוי שבו RSSI חייב להיות מעל לסף כדי להפעיל את הזיהוי.

פרטים
פרמטרים
[in] aInstance
מצביע על מופע של OpenThread.
[in] aBusyPeriod
התקופה העמוסה של זיהוי ה-Jam (לא יכולה להיות אפס מאפס או נמוכה מחלון זיהוי Jam)
ערכי החזרה
OT_ERROR_NONE
הגדרת החלון הסתיימה.
OT_ERROR_INVALID_ARGS
הקלט הנתון אינו בטווח החוקי.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

מגדירים את סף ה-RSS לזיהוי Jam (ב-dBm).

פרטים
פרמטרים
[in] aInstance
מצביע על מופע של OpenThread.
[in] aRssiThreshold
סף RSSI.
ערכי החזרה
OT_ERROR_NONE
הגדרת את הסף בהצלחה.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

מגדירים את חלון זיהוי הפקקים (בשניות).

פרטים
פרמטרים
[in] aInstance
מצביע על מופע של OpenThread.
[in] aWindow
החלון לזיהוי Jam (הטווח החוקי הוא 1 עד 63)
ערכי החזרה
OT_ERROR_NONE
הגדרת החלון הסתיימה.
OT_ERROR_INVALID_ARGS
פרמטר הקלט הנתון אינו בטווח חוקי (1 עד 63)

otJamDetectionStart

otError otJamDetectionStart(
  otInstance *aInstance,
  otJamDetectionCallback aCallback,
  void *aContext
)

התחלת הזיהוי של מסמך ה-Jam.

פרטים
פרמטרים
[in] aInstance
מצביע על מופע של OpenThread.
[in] aCallback
הפניה לפונקציה שנקראת כדי להודיע על שינוי במצב Jam.
[in] aContext
מצביע על הקשר ספציפי לאפליקציה.
ערכי החזרה
OT_ERROR_NONE
הזיהוי של מסמך ה-Jam הופעל.
OT_ERROR_ALREADY
זיהוי מסמך Jam התחיל בעבר.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

הפסקת הזיהוי של מסמך ה-Jam.

פרטים
פרמטרים
[in] aInstance
מצביע על מופע של OpenThread.
ערכי החזרה
OT_ERROR_NONE
זיהוי מסמך ה-Jam הופסק.
OT_ERROR_ALREADY
זיהוי ה-Jam כבר הופסק.

מקורות מידע

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