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

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

ملخّص

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