זיהוי Jam

המודול הזה כולל פונקציות לתכונה של זיהוי חסימות אות.

סיכום

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

סוג שגיאות

otJamDetectionCallback)(bool aJamState, void *aContext) typedef
void(*
המצביע מציין אם זיהוי Jam Jam מופעל וזוהה 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
קבלת חלון הזיהוי של מסמך Jam (בשניות).
otJamDetectionIsEnabled(otInstance *aInstance)
bool
קבלת הסטטוס של זיהוי Jam (מופעל/מושבת)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
הגדרת התקופה העמוסה לזיהוי Jam (בשניות).
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
הגדרה של סף ה-RSSI לזיהוי Jam (ב-dBm).
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
מגדירים את חלון הזיהוי של Jam (בשניות).
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
התחלת זיהוי החסימות.
otJamDetectionStop(otInstance *aInstance)
עצירת זיהוי החסימות.

סוג שגיאות

otJamDetectionCallback

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

המצביע מציין אם זיהוי Jam Jam מופעל וזוהה Jam.

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

פונקציות

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

הצגת התקופה העמוסה בזיהוי Jam (בשניות)

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

otJamDetectionGetהיסטוריהBitmap

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 (זוהה Jam true, אחרת 'false' ).

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

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

פרטים
פרמטרים
[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
)

הגדרה של סף ה-RSSI לזיהוי Jam (ב-dBm).

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

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

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

פרטים
פרמטרים
[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
)

התחלת זיהוי החסימות.

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

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

עצירת זיהוי החסימות.

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

משאבים

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