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

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

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

الملخّص

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

مواقد الخط
`otNetworkTimeStatus`	مَعلمة typetype `enum otNetworkTimeStatus` تمثّل هذه القائمة حالة مزامنة وقت OpenThread.
`otNetworkTimeSyncCallbackFn)(void *aCallbackContext)`	مَعلمة typetype `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`	بنية المثال المفتوح.
`[in,out] aNetworkTime`	مدة شبكة سلسلة المحادثات بالميكروثانية.

طلبات الإرجاع

حالة مزامنة الوقت

otNetworkTimeGetSyncPeriod

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

يمكنك الحصول على فترة المزامنة الزمنية.

التفاصيل

المعلَمات

[in] aInstance

بنية المثال المفتوح.

طلبات الإرجاع

فترة مزامنة الوقت.

otNetworkTimeGetXtalالحد الأدنى

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

احصل على الحد الأدنى لدقة XTAL لمزامنة الوقت لجهاز التوجيه.

التفاصيل

المعلَمات

[in] aInstance

بنية المثال المفتوح.

طلبات الإرجاع

الحد الأدنى لدقة XTAL لجهاز التوجيه، في PPM.

otNetworkTimeSetSyncPeriod

otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

إعداد فترة المزامنة الزمنية.

لا يمكن استدعاء هذه الدالة إلا أثناء إيقاف بروتوكولات سلاسل المحادثات.

التفاصيل

المعلَمات

`[in] aInstance`	بنية المثال المفتوح.
`[in] aTimeSyncPeriod`	فترة مزامنة الوقت، بالثواني.

قيم الإرجاع

`OT_ERROR_NONE`	تم ضبط فترة مزامنة الوقت بنجاح.
`OT_ERROR_INVALID_STATE`	تم تفعيل بروتوكولات سلاسل المحادثات.

otNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

يمكنك ضبط الحدّ الأدنى لدقة XTAL لمزامنة الوقت على الجهاز المزوّد بجهاز توجيه.

لا يمكن استدعاء هذه الدالة إلا أثناء إيقاف بروتوكولات سلاسل المحادثات.

التفاصيل

المعلَمات

`[in] aInstance`	بنية المثال المفتوح.
`[in] aXTALThreshold`	الحد الأدنى لدقة XTAL لجهاز التوجيه، في PPM.

قيم الإرجاع

`OT_ERROR_NONE`	تم ضبط فترة مزامنة الوقت بنجاح.
`OT_ERROR_INVALID_STATE`	تم تفعيل بروتوكولات سلاسل المحادثات.

otNetworkTimeSyncSetcallback

void otNetworkTimeSyncSetCallback(
  otInstance *aInstance,
  otNetworkTimeSyncCallbackFn aCallbackFn,
  void *aCallbackContext
)

يمكنك إعداد معاودة الاتصال لكي يتم الاتصال بها عند مزامنة وقت الشبكة أو حدوث تغيير في الحالة.

يجب استدعاء هذه الدالة فقط عندما ترتفع قيمة معادلة وقت الشبكة عن طريق OpenGLWORD_CONFIG_TIME_SYNC_JUMP_NOTIF_MIN_US أو عند تغيير الحالة.

التفاصيل

المعلَمات

`[in] aInstance`	بنية المثال المفتوح.
`[in] aCallbackFn`	استدعاء الدالة المطلوب الاتصال به
`[in] aCallbackContext`	السياق الذي يتم تمريره إلى دالة رد الاتصال عند الاستدعاء

وحدات ماكرو

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

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

المراجع

تنشأ مواضيع واجهة برمجة التطبيقات المرجعية لـ OpenThread من رمز المصدر، المتوفر على GitHub. للاطّلاع على مزيد من المعلومات أو للمساهمة في مستنداتنا، يُرجى الرجوع إلى المراجع.