ترجمت واجهة Cloud Translation API‏ هذه الصفحة.

مزامنة وقت الشبكة

تتضمن هذه الوحدة الوظائف التي تتحكم في خدمة مزامنة وقت الشبكة.

ملخص

التعداد
`otNetworkTimeStatus { OT_NETWORK_TIME_UNSYNCHRONIZED = -1, OT_NETWORK_TIME_RESYNC_NEEDED = 0, OT_NETWORK_TIME_SYNCHRONIZED = 1 }`	تعداد يمثل هذا التعداد حالة مزامنة وقت 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`	وظيفة رد الاتصال المطلوب استدعاؤها
`[in] aCallbackContext`	السياق الذي سيتم تمريره إلى وظيفة رد الاتصال عند الاستدعاء

وحدات الماكرو

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

يعتبر الصفر بمثابة تسلسل تزامن زمني غير صالح.