סנכרון זמן ברשת

מודול זה כולל פונקציות ששולטות בשירות הסנכרון של זמן הרשת.

סיכום

מספור

otNetworkTimeStatus{
  OT_NETWORK_TIME_UNSYNCHRONIZED = -1,
  OT_NETWORK_TIME_RESYNC_NEEDED = 0,
  OT_NETWORK_TIME_SYNCHRONIZED = 1
}
טיפוסים בני מנייה (enum)
ספירה זו מייצגת את סטטוס הסנכרון של אירועי OpenThread.

סוג Dedef

otNetworkTimeStatus Typedef
ספירה זו מייצגת את סטטוס הסנכרון של אירועי OpenThread.
otNetworkTimeSyncCallbackFn)(void *aCallbackContext) Typedef
void(*
מצביע הפונקציה הזה מתרחש כשמתרחשת סנכרון זמן או שינוי סטטוס של הרשת.

פונקציות

otNetworkTimeGet(otInstance *aInstance, uint64_t *aNetworkTime)
קבלת זמן הרשת של השרשור.
otNetworkTimeGetSyncPeriod(otInstance *aInstance)
uint16_t
מקבלים את פרק הזמן לסנכרון.
otNetworkTimeGetXtalThreshold(otInstance *aInstance)
uint16_t
קבלת סף הדיוק של XTAL לסנכרון זמן עבור נתב.
otNetworkTimeSetSyncPeriod(otInstance *aInstance, uint16_t aTimeSyncPeriod)
מגדירים את תקופת סנכרון הזמן.
otNetworkTimeSetXtalThreshold(otInstance *aInstance, uint16_t aXTALThreshold)
קביעת סף דיוק XTAL לסנכרון זמן עבור מכשיר התומך בנתב.
otNetworkTimeSyncSetCallback(otInstance *aInstance, otNetworkTimeSyncCallbackFn aCallbackFn, void *aCallbackContext)
void
הגדרה של קריאה חוזרת (callback) שתתבצע כשמתבצע סנכרון של שעת הרשת או שינוי סטטוס.

מספור

סטטוס otNetworkTime

 otNetworkTimeStatus

ספירה זו מייצגת את סטטוס הסנכרון של אירועי OpenThread.

מאפיינים
OT_NETWORK_TIME_RESYNC_NEEDED

המכשיר לא חיפש סנכרון למשך יותר משתי נקודות.

OT_NETWORK_TIME_SYNCHRONIZED

זמן הרשת של המכשיר מסונכרן.

OT_NETWORK_TIME_UNSYNCHRONIZED

המכשיר לא צורף לרשת.

סוג Dedef

סטטוס otNetworkTime

enum otNetworkTimeStatus otNetworkTimeStatus

ספירה זו מייצגת את סטטוס הסנכרון של אירועי OpenThread.

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

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

פונקציות

הורדה של otNetworkTimeGet

otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

קבלת זמן הרשת של השרשור.

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

otNetworkTimeGetSyncSync

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

מקבלים את פרק הזמן לסנכרון.

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

otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

קבלת סף הדיוק של XTAL לסנכרון זמן עבור נתב.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
החזרות
סף הדיוק של XTAL עבור נתב, ב-PPM.

otNetworkTimeSetSyncperiod

otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

מגדירים את תקופת סנכרון הזמן.

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

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aTimeSyncPeriod
פרק הזמן של סנכרון הזמן, בשניות.
ערכי החזרה
OT_ERROR_NONE
הסתיימה התקופה של סנכרון הזמן.
OT_ERROR_INVALID_STATE
הפרוטוקולים לשרשורים מופעלים.

otNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

קביעת סף דיוק XTAL לסנכרון זמן עבור מכשיר התומך בנתב.

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

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aXTALThreshold
סף הדיוק של XTAL עבור נתב, ב-PPM.
ערכי החזרה
OT_ERROR_NONE
הסתיימה התקופה של סנכרון הזמן.
OT_ERROR_INVALID_STATE
הפרוטוקולים לשרשורים מופעלים.

otNetworkTimeSyncSetCallback

void otNetworkTimeSyncSetCallback(
  otInstance *aInstance,
  otNetworkTimeSyncCallbackFn aCallbackFn,
  void *aCallbackContext
)

הגדרה של קריאה חוזרת (callback) שתתבצע כשמתבצע סנכרון של שעת הרשת או שינוי סטטוס.

קריאה זו לקריאה חוזרת תתבצע רק לאחר היסט הזמן של הרשת ב-OPENthread_CONFIG_TIME_SYNC_JUMP_NOTIF_MIN_US או כשהסטטוס משתנה.

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

פקודות מאקרו

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

אפס נחשב לרצף סנכרון לא חוקי של זמנים.

מקורות מידע

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