تتبّع التاريخ

تسجيل سجلّ للأحداث المختلفة، على سبيل المثال، رسائل RX وTX أو تغييرات معلومات الشبكة.

الملخّص

الطابع الزمني لكل الإدخالات التي يتم تتبعها

تتوفر الوظائف في هذه الوحدة عند تفعيل OPENTHREAD_CONFIG_HISTOR_TRACKER_ENABLE.

التعدادات

anonymous enum{
  OT_HISTORY_TRACKER_MSG_PRIORITY_LOW = OT_MESSAGE_PRIORITY_LOW,
  OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL = OT_MESSAGE_PRIORITY_NORMAL,
  OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH = OT_MESSAGE_PRIORITY_HIGH,
  OT_HISTORY_TRACKER_MSG_PRIORITY_NET = OT_MESSAGE_PRIORITY_HIGH + 1
}
عدد
الثوابت التي تمثّل أولوية الرسائل المستخدمة في بنية otHistoryTrackerMessageInfo
otHistoryTrackerAddressEvent{
  OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1
}
عدد
وتحدّد هذه القائمة العددية الأحداث لمعلومات عنوان IPv6 (أحادي البث أو متعدد البث) (أي ما إذا كان تتم إضافة العنوان أو إزالته).
otHistoryTrackerNeighborEvent{
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED = 1,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED = 2,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING = 3
}
عدد
يحدّد هذا العدد الأحداث في معلومات الجيران (أي
otHistoryTrackerNetDataEvent{
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED = 0,
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED = 1
}
عدد
يحدد هذا العدد أحداث إدخال بيانات الشبكة (أي ما إذا تمت إضافة إدخال أو إزالته).

مواقد الخط

otHistoryTrackerExternalRouteInfo مَعلمة typetype
تمثّل هذه البنية معلومات المسار الخارجي لبيانات الشبكة.
otHistoryTrackerIterator مَعلمة typetype
يمثل هذا النوع تكرارًا للتكرار من خلال قائمة سِجل.
otHistoryTrackerMessageInfo مَعلمة typetype
وتمثل هذه البنية معلومات رسالة RX/TX IPv6.
otHistoryTrackerMulticastAddressInfo مَعلمة typetype
وتمثّل هذه البنية معلومات عنوان البث المتعدد لبروتوكول IPv6.
otHistoryTrackerNeighborInfo مَعلمة typetype
تمثّل هذه البنية معلومات الجيران.
otHistoryTrackerNetworkInfo مَعلمة typetype
تمثّل هذه البنية معلومات شبكة سلاسل المحادثات.
otHistoryTrackerOnMeshPrefixInfo مَعلمة typetype
تمثّل هذه البنية بيانات الشبكة على معلومات بادئة الشبكة المتداخلة.
otHistoryTrackerUnicastAddressInfo مَعلمة typetype
تمثّل هذه البنية معلومات عنوان IPv6 الأحادي.

الدوال

otHistoryTrackerEntryAgeToString(uint32_t aEntryAge, char *aBuffer, uint16_t aSize)
void
تحوِّل هذه الدالة عمر إدخال معيّن إلى سلسلة يمكن للمستخدمين قراءتها.
otHistoryTrackerInitIterator(otHistoryTrackerIterator *aIterator)
void
تؤدي هذه الدالة إلى إعداد otHistoryTrackerIterator.
otHistoryTrackerIterateExternalRouteHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
يتم تكرار هذه الدالة على الإدخالات في قائمة إدخال المسار الخارجي لبيانات الشبكة.
otHistoryTrackerIterateMulticastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
يتم تكرار هذه الدالة على الإدخالات في قائمة سجلّ عناوين البث المتعدد.
otHistoryTrackerIterateNeighborHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
يتم تكرار هذه الدالة فوق الإدخالات في قائمة السجلّ المجاور.
otHistoryTrackerIterateNetInfoHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
ويتم تكرار هذه الدالة فوق الإدخالات في قائمة سجلّ معلومات الشبكة.
otHistoryTrackerIterateOnMeshPrefixHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
يتم تكرار هذه الدالة فوق الإدخالات في بيانات الشبكة في قائمة إدخال بادئة الشبكة المتداخلة.
otHistoryTrackerIterateRxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
ويتم تكرار هذه الدالة فوق الإدخالات في قائمة سجلّ رسائل RX.
otHistoryTrackerIterateTxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
هذه الدالة تتكرر على الإدخالات في قائمة سجلّ رسائل TX.
otHistoryTrackerIterateUnicastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
يتم تكرار هذه الدالة فوق الإدخالات في قائمة سجلّ عناوين unicast.

التشريعات

otHistoryTrackerExternalRouteInfo

تمثّل هذه البنية معلومات المسار الخارجي لبيانات الشبكة.

otHistoryTrackerIterator

يمثل هذا النوع تكرارًا للتكرار من خلال قائمة سِجل.

otHistoryTrackerMessageInfo

وتمثل هذه البنية معلومات رسالة RX/TX IPv6.

otHistoryTrackerMulticastAddressInfo

وتمثّل هذه البنية معلومات عنوان البث المتعدد لبروتوكول IPv6.

otHistoryTrackerNeighborInfo

تمثّل هذه البنية معلومات الجيران.

otHistoryTrackerNetworkInfo

تمثّل هذه البنية معلومات شبكة سلاسل المحادثات.

otHistoryTrackerOnMeshPrefixInfo

تمثّل هذه البنية بيانات الشبكة على معلومات بادئة الشبكة المتداخلة.

otHistoryTrackerUnicastAddressInfo

تمثّل هذه البنية معلومات عنوان IPv6 الأحادي.

التعدادات

عدد مجهول

 anonymous enum

الثوابت التي تمثّل أولوية الرسائل المستخدمة في بنية otHistoryTrackerMessageInfo

المنشآت الفندقية
OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH

مستوى الأولوية القصوى.

OT_HISTORY_TRACKER_MSG_PRIORITY_LOW

مستوى الأولوية منخفض.

OT_HISTORY_TRACKER_MSG_PRIORITY_NET

مستوى أولوية التحكم بالشبكة.

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

مستوى الأولوية العادي.

otHistoryTrackerAddressEvent

 otHistoryTrackerAddressEvent

وتحدّد هذه القائمة العددية الأحداث لمعلومات عنوان IPv6 (أحادي البث أو متعدد البث) (أي ما إذا كان تتم إضافة العنوان أو إزالته).

المنشآت الفندقية
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

تمت إضافة العنوان.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

تمت إزالة العنوان.

otHistoryTrackerNeighborEvent

 otHistoryTrackerNeighborEvent

يحدّد هذا العدد الأحداث في معلومات الجيران (أي

ما إذا تمت إضافة الجيران أو إزالته أو تغييره

ينطبق الحدث OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING على جيران الأطفال فقط. يتم تشغيله بعد إعادة تشغيل الجهاز وعند استرداد القائمة الفرعية السابقة من إعدادات غير متغيّرة ويحاول الجهاز استعادة الاتصال بها.

المنشآت الفندقية
OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED

تمت إضافة الجيران.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED

تم تغيير الحي (على سبيل المثال، تم تغيير علامات وضع الجهاز).

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED

تمت إزالة الجيران.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

تتم استعادة الجيران (تنطبق على الأطفال فقط).

otHistoryTrackerNetDataEvent

 otHistoryTrackerNetDataEvent

يحدد هذا العدد أحداث إدخال بيانات الشبكة (أي ما إذا تمت إضافة إدخال أو إزالته).

المنشآت الفندقية
OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED

تمت إضافة إدخال بيانات الشبكة.

OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED

تتم إزالة إدخال بيانات الشبكة.

مواقد الخط

otHistoryTrackerExternalRouteInfo

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

تمثّل هذه البنية معلومات المسار الخارجي لبيانات الشبكة.

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

يمثل هذا النوع تكرارًا للتكرار من خلال قائمة سِجل.

الحقول من هذا النوع غير شفافة (مخصصة للاستخدام من قِبل OpenThread الأساسية) وبالتالي يجب ألا يتم الوصول إليها/استخدامها من قِبل المتصل.

قبل استخدام المكرر، يجب إعداده باستخدام otHistoryTrackerInitIterator()،

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

وتمثل هذه البنية معلومات رسالة RX/TX IPv6.

تنطبق بعض الحقول في هذه البنية على رسالة RX أو رسالة TX فقط، على سبيل المثال mAveRxRss هو متوسط RSS لجميع إطارات التجزئة التي تُشكِّل رسالة مستلمة ولا ينطبق إلا على رسالة RX.

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

وتمثّل هذه البنية معلومات عنوان البث المتعدد لبروتوكول IPv6.

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

تمثّل هذه البنية معلومات الجيران.

otHistoryTrackerNetworkمعلومات

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

تمثّل هذه البنية معلومات شبكة سلاسل المحادثات.

otHistoryTrackerOnMeshPrefixInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

تمثّل هذه البنية بيانات الشبكة على معلومات بادئة الشبكة المتداخلة.

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

تمثّل هذه البنية معلومات عنوان IPv6 الأحادي.

الدوال

otHistoryTrackerEntryAgeToString

void otHistoryTrackerEntryAgeToString(
  uint32_t aEntryAge,
  char *aBuffer,
  uint16_t aSize
)

تحوِّل هذه الدالة عمر إدخال معيّن إلى سلسلة يمكن للمستخدمين قراءتها.

تتبع السلسلة العمرية للإدخال التنسيق "::." للساعات والدقائق والثواني والملّي ثانية (إذا كانت أقصر من يوم واحد) أو "

يوم ::." (إذا كان أطول من يوم واحد).

إذا كانت السلسلة الناتجة لا تندرج ضمن aBuffer (ضمن aSize من الأحرف)، سيتم اقتطاع السلسلة، ولكن يتم دائمًا إنهاء السلسلة التي تم إخراجها.

التفاصيل
المعلَمات
[in] aEntryAge
عمر الإدخال (المدة بالمللي ثانية).
[out] aBuffer
مؤشر إلى مصفوفة الأحرف لإخراج السلسلة (يجب ألا يكون فارغًا).
[in] aSize
حجم aBuffer. ننصح باستخدام OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE.

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

تؤدي هذه الدالة إلى إعداد otHistoryTrackerIterator.

يجب أن يتم إعداد المكرر قبل استخدامه.

يمكن إعداد المكرر مرة أخرى للبدء من بداية القائمة.

عند تكرار الإدخالات في قائمة، للتأكّد من اتساق الأعمار، يتم منح العمر نسبيًا للوقت الذي تم فيه إعداد المكرر، أي يتم تقديم عمر الإدخال على أنه المدة (بالمللي ثانية) من الحدث (عندما كان الإدخال مسجّل) إلى وقت إعداد المكرر.

التفاصيل
المعلَمات
[in] aIterator
مؤشر للمكرر للتهيئة (يجب ألا يكون فارغًا).

otHistoryTrackerIterateExternalRouteHistory

const otHistoryTrackerExternalRouteInfo * otHistoryTrackerIterateExternalRouteHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

يتم تكرار هذه الدالة على الإدخالات في قائمة إدخال المسار الخارجي لبيانات الشبكة.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر للتكرار. يجب أن تتم إعدادها أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغير لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم توفير العمر على أنه المدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت الإعداد aIterator. تم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
طلبات الإرجاع
إدخال otHistoryTrackerExternalRouteInfo أو NULL إذا لم يكن هناك أي إدخالات أخرى في القائمة.

otHistoryTrackerIterateMulticastAddressHistory

const otHistoryTrackerMulticastAddressInfo * otHistoryTrackerIterateMulticastAddressHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

يتم تكرار هذه الدالة على الإدخالات في قائمة سجلّ عناوين البث المتعدد.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر للتكرار. يجب أن تتم إعدادها أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغير لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم توفير العمر على أنه المدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت الإعداد aIterator. تم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
طلبات الإرجاع
إشارة إلى إدخال otHistoryTrackerMulticastAddressInfo أو NULL إذا لم يكن هناك أي إدخالات في القائمة.

otHistoryTrackerIterateNeighborHistory

const otHistoryTrackerNeighborInfo * otHistoryTrackerIterateNeighborHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

يتم تكرار هذه الدالة فوق الإدخالات في قائمة السجلّ المجاور.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر للتكرار. يجب أن تتم إعدادها أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغير لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم توفير العمر على أنه المدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت الإعداد aIterator. تم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
طلبات الإرجاع
إدخال otHistoryTrackerNeighborInfo أو NULL إذا لم يكن هناك أي إدخالات أخرى في القائمة.

otHistoryTrackerIterateNetInfoHistory

const otHistoryTrackerNetworkInfo * otHistoryTrackerIterateNetInfoHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

ويتم تكرار هذه الدالة فوق الإدخالات في قائمة سجلّ معلومات الشبكة.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر للتكرار. يجب أن تتم إعدادها أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغير لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم توفير العمر على أنه المدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت الإعداد aIterator. تم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
طلبات الإرجاع
إشارة إلى إدخال otHistoryTrackerNetworkInfo أو NULL إذا لم يكن هناك أي إدخالات في القائمة.

otHistoryTrackerIterateOnMeshPrefixHistory

const otHistoryTrackerOnMeshPrefixInfo * otHistoryTrackerIterateOnMeshPrefixHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

يتم تكرار هذه الدالة فوق الإدخالات في بيانات الشبكة في قائمة إدخال بادئة الشبكة المتداخلة.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر للتكرار. يجب أن تتم إعدادها أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغير لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم توفير العمر على أنه المدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت الإعداد aIterator. تم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
طلبات الإرجاع
إدخال otHistoryTrackerOnMeshPrefixInfo أو NULL إذا لم يكن هناك أي إدخالات أخرى في القائمة.

otHistoryTrackerIterateRxHistory

const otHistoryTrackerMessageInfo * otHistoryTrackerIterateRxHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

ويتم تكرار هذه الدالة فوق الإدخالات في قائمة سجلّ رسائل RX.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر للتكرار. يجب أن تتم إعدادها أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغير لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم توفير العمر على أنه المدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت الإعداد aIterator. تم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
طلبات الإرجاع
إدخال otHistoryTrackerMessageInfo أو NULL إذا لم يكن هناك أي إدخالات أخرى في القائمة.

otHistoryTrackerIterateTxHistory

const otHistoryTrackerMessageInfo * otHistoryTrackerIterateTxHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

هذه الدالة تتكرر على الإدخالات في قائمة سجلّ رسائل TX.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر للتكرار. يجب أن تتم إعدادها أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغير لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم توفير العمر على أنه المدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت الإعداد aIterator. تم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
طلبات الإرجاع
إدخال otHistoryTrackerMessageInfo أو NULL إذا لم يكن هناك أي إدخالات أخرى في القائمة.

otHistoryTrackerIterateUnicastAddressHistory

const otHistoryTrackerUnicastAddressInfo * otHistoryTrackerIterateUnicastAddressHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

يتم تكرار هذه الدالة فوق الإدخالات في قائمة سجلّ عناوين unicast.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in,out] aIterator
مؤشر للتكرار. يجب أن تتم إعدادها أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغير لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم توفير العمر على أنه المدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت الإعداد aIterator. تم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
طلبات الإرجاع
إشارة إلى إدخال otHistoryTrackerUnicastAddressInfo أو NULL إذا لم يكن هناك أي إدخالات في القائمة.

وحدات ماكرو

OT_History_TRACKER_EXIT_AGE_STRING_SIZE

 OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21

الحجم المُوصى به لتمثيل سلسلة عمر الإدخال.

OT_History_TRACKER_MAX_AGE

 OT_HISTORY_TRACKER_MAX_AGE (49 * 24 * 60 * 60 * 1000u)

يحدد هذا الثابت الحد الأقصى المسموح به للإدخالات وهو 49 يومًا (بالمللي ثانية).

وستُعطى الإدخالات التي يزيد عمرها عن الحد الأقصى لهذه القيمة قيمتها على أنها العمر.

المراجع

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