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

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

סיכום

ספירות
`otNetworkTimeStatus { OT_NETWORK_TIME_UNSYNCHRONIZED = -1, OT_NETWORK_TIME_RESYNC_NEEDED = 0, OT_NETWORK_TIME_SYNCHRONIZED = 1 }`	enum ספירה זו מייצגת סטטוס סנכרון זמן OpenThread.

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

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

ספירות

otNetworkTimeStatus

 otNetworkTimeStatus

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

נכסים
`OT_NETWORK_TIME_RESYNC_NEEDED`	המכשיר לא קיבל סינכרון זמן במשך יותר משתי תקופות זמן.
`OT_NETWORK_TIME_SYNCHRONIZED`	זמן רשת המכשיר מסונכרן.
`OT_NETWORK_TIME_UNSYNCHRONIZED`	המכשיר לא מחובר לרשת.

טיפוסים

otNetworkTimeStatus

enum otNetworkTimeStatus otNetworkTimeStatus

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

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

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

פונקציות

otNetworkTimeGet

 otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

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

פרטים

פרמטרים

`[in] aInstance`	מבנה המופע OpenThread.
`[in,out] aNetworkTime`	זמן רשת החוט במיקרו-שניות.

החזרות

מצב סנכרון הזמן.

otNetworkTimeGetSyncPeriod

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
)

הגדר התקשרות כזו שתתקשר כאשר מתרחש סנכרון זמן רשת או שינוי מצב.

חיוג חוזר זה ייקרא רק כאשר קיזוז זמן הרשת קופץ על ידי OPENTHREAD_CONFIG_TIME_SYNC_JUMP_NOTIF_MIN_US או כאשר הסטטוס משתנה.

פרטים

פרמטרים

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

מקרואים

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

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