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

المرتجعات

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

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
)

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

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

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

الموارد

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