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

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

ملخّص

عمليات التعداد

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