تمت ترجمة هذه الصفحة بواسطة 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` الحصول على وقت شبكة 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 لجهاز التوجيه، بوحدة في الدقيقة.

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 لجهاز التوجيه، بوحدة في الدقيقة.

قيم الإرجاع

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

otNetworkTimeSyncSetCallback

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

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

يجب أن يتم استدعاء معاودة الاتصال هذه فقط عندما تقفز إزاحة وقت الشبكة بمقدار OPENLENGTH_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

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

المراجِع

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