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

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

ملخّص

التعدادات

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

أنواع المحددات

otNetworkTimeStatus typedef
يمثّل حالة مزامنة الوقت في OpenThread.
otNetworkTimeSyncCallbackFn)(void *aCallbackContext) typedef
void(*
يُسمى المؤشر عند حدوث مزامنة لوقت الشبكة أو حدوث تغيير في الحالة.

الدوال

otNetworkTimeGet(otInstance *aInstance, uint64_t *aNetworkTime)
اطّلِع على وقت شبكة Thread.
otNetworkTimeGetSyncPeriod(otInstance *aInstance)
uint16_t
احصل على فترة المزامنة الزمنية.
otNetworkTimeGetXtalThreshold(otInstance *aInstance)
uint16_t
يمكنك الحصول على الحدّ الأقصى لدقة دقة XTAL للمزامنة مع جهاز التوجيه.
otNetworkTimeSetSyncPeriod(otInstance *aInstance, uint16_t aTimeSyncPeriod)
اضبط فترة المزامنة الزمنية.
otNetworkTimeSetXtalThreshold(otInstance *aInstance, uint16_t aXTALThreshold)
تضبط هذه السياسة الحدّ الأدنى لدقة 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. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.