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

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

الملخّص

التعدادات

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

مواقد الخط

otNetworkTimeStatus مَعلمة typetype
تمثّل هذه القائمة حالة مزامنة وقت OpenThread.
otNetworkTimeSyncCallbackFn)(void *aCallbackContext) مَعلمة typetype
void(*
يتم استدعاء مؤشر الدالة هذا عند حدوث مزامنة وقت الشبكة أو حدوث تغيير في الحالة.

الدوال

otNetworkTimeGet(otInstance *aInstance, uint64_t *aNetworkTime)
الحصول على وقت شبكة سلسلة المحادثات.
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
)

الحصول على وقت شبكة سلسلة المحادثات.

التفاصيل
المعلَمات
[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. للاطّلاع على مزيد من المعلومات أو للمساهمة في مستنداتنا، يُرجى الرجوع إلى المراجع.