זיהוי מסמכי Jam

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

סיכום

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

ערכי דף

otJamDetectionCallback)(bool aJamState, void *aContext) typedef
void(*
המצביע מופעל אם זיהוי חסימות האותות מופעל ומזוהה פקק.

פונקציות

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)

המצביע מופעל אם זיהוי חסימות האותות מופעל ומזוהה פקק.

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

פונקציות

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

קבלת פרק הזמן הלא עמוס לזיהוי מסמך Jam (בשניות)

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

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

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

הערך הזה מספק מידע על המצב הנוכחי של מודול הזיהוי שיבוש למטרות מעקב או ניפוי באגים. היא מחזירה ערך של 64 ביט כאשר כל ביט מתאים למרווח של שנייה אחת, המתחיל ב-0 למרווח הזמן האחרון, ו-63 למרווחי הזמן הישנים ביותר (63 שניות קודם לכן). הביט מוגדר ל-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), אחרת 'FALSE'.

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

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

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

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

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

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
החזרות
סטטוס זיהוי ה-Jam (נכון אם מופעל, 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
מצביע לפונקציה שנקראת כדי להודיע על שינוי במצב של הפרעה.
[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. אפשר לקרוא מידע נוסף או לתרום למסמכי התיעוד שלנו בדף מקורות מידע.