דף זה תורגם על ידי Cloud Translation API.

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

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

סיכום

ספירות
`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` קבלת זמן הרשת של Thread.
`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
)

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

פרטים

פרמטרים

`[in] aInstance`	מבנה המכונה של OpenThread.
`[in,out] aNetworkTime`	זמן הרשת ב-Thread במיליוניות השנייה.

החזרות

סטטוס הסנכרון של השעה.

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
)

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

הקריאה החוזרת (callback) הזו תיקרא רק כאשר היסט הזמן של הרשת יקפוץ ב-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

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

מקורות מידע

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