این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

همگام سازی زمان شبکه

این ماژول شامل توابعی است که سرویس همگام سازی زمان شبکه را کنترل می کند.

خلاصه

شمارش ها
`otNetworkTimeStatus { OT_NETWORK_TIME_UNSYNCHRONIZED = -1, OT_NETWORK_TIME_RESYNC_NEEDED = 0, OT_NETWORK_TIME_SYNCHRONIZED = 1 }`	enum وضعیت همگام سازی زمان OpenThread را نشان می دهد.

Typedefs
`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`	دستگاه به شبکه متصل نشده است.

Typedefs

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
)

دوره همگام سازی زمانی را تنظیم کنید.

فقط زمانی می توان فراخوانی کرد که پروتکل های Thread غیرفعال هستند.

جزئیات

مولفه های

`[in] aInstance`	ساختار نمونه OpenThread.
`[in] aTimeSyncPeriod`	دوره همگام سازی زمانی، در ثانیه.

ارزش های بازگشتی

`OT_ERROR_NONE`	دوره همگام سازی زمانی را با موفقیت تنظیم کرد.
`OT_ERROR_INVALID_STATE`	پروتکل های رشته فعال هستند.

otNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

آستانه دقت XTAL همگام سازی زمانی را برای دستگاه دارای قابلیت روتر تنظیم کنید.

فقط زمانی می توان فراخوانی کرد که پروتکل های Thread غیرفعال هستند.

جزئیات

مولفه های

`[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`	تابع فراخوانی که باید فراخوانی شود
`[in] aCallbackContext`	متنی که باید پس از فراخوانی به تابع callback منتقل شود

ماکروها

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

صفر به عنوان دنباله همگام سازی زمانی نامعتبر در نظر گرفته می شود.

منابع

موضوعات مرجع OpenThread API از کد منبع موجود در GitHub سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.