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

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

ملخص

التعدادات
`otNetworkTimeStatus { OT_NETWORK_TIME_UNSYNCHRONIZED = -1, OT_NETWORK_TIME_RESYNC_NEEDED = 0, OT_NETWORK_TIME_SYNCHRONIZED = 1 }`	تعداد يمثل هذا التعداد حالة مزامنة وقت OpenThread.

مطبوعات
`otNetworkTimeStatus`	مطبوع `enum otNetworkTimeStatus` يمثل هذا التعداد حالة مزامنة وقت OpenThread.
`otNetworkTimeSyncCallbackFn )(void *aCallbackContext)`	مطبوع `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

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