أداة تتبُّع السجلّ
تسجِّل سجلّ الأحداث المختلفة، مثل رسائل RX وTX أو تغييرات في معلومات الشبكة.
ملخّص
يتم إدراج طابع زمني لكل الإدخالات التي يتم تتبُّعها.
الدوال في هذه الوحدة متاحة عند تفعيل OPENTHREAD_CONFIG_HISTORY_TRACKER_ENABLE
.
أنواع المحددات |
|
---|---|
otHistoryTrackerExternalRouteInfo
|
typedef يمثل معلومات المسار الخارجي لبيانات الشبكة. |
otHistoryTrackerIterator
|
typedefstruct otHistoryTrackerIterator
يمثل مكرّرًا لتكراره من خلال قائمة سجلّات. |
otHistoryTrackerMessageInfo
|
typedefstruct otHistoryTrackerMessageInfo
يمثّل معلومات رسالة RX/TX IPv6. |
otHistoryTrackerMulticastAddressInfo
|
typedef قدِّم معلومات عنوان البث المتعدد IPv6. |
otHistoryTrackerNeighborInfo
|
typedefstruct otHistoryTrackerNeighborInfo
يمثل معلومات الجيران |
otHistoryTrackerNetworkInfo
|
typedefstruct otHistoryTrackerNetworkInfo
يعرض معلومات شبكة Thread. |
otHistoryTrackerOnMeshPrefixInfo
|
typedef تمثيل بيانات الشبكة في معلومات بادئة الشبكة المتداخلة. |
otHistoryTrackerRouterInfo
|
typedefstruct otHistoryTrackerRouterInfo
يمثل حدث إدخال في جدول جهاز التوجيه. |
otHistoryTrackerUnicastAddressInfo
|
typedef تمثيل معلومات عنوان 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)
|
const otHistoryTrackerNeighborInfo *
تكرار هذه الإدخالات في قائمة سجلّ الجيران
|
otHistoryTrackerIterateNetInfoHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
|
const otHistoryTrackerNetworkInfo *
تكرار الإدخالات في قائمة سجلّ معلومات الشبكة.
|
otHistoryTrackerIterateOnMeshPrefixHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
|
const otHistoryTrackerOnMeshPrefixInfo *
تكرار الإدخالات في بيانات الشبكة في قائمة سجلّ بادئة الشبكة المتداخلة.
|
otHistoryTrackerIterateRouterHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
|
const otHistoryTrackerRouterInfo *
تكرار هذه الإدخالات في قائمة سجلّ جهاز التوجيه
|
otHistoryTrackerIterateRxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
|
const otHistoryTrackerMessageInfo *
تكرار هذه الإدخالات في قائمة سجلّ رسائل RX.
|
otHistoryTrackerIterateTxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
|
const otHistoryTrackerMessageInfo *
تكرار هذه الإدخالات في قائمة سجلّ رسائل TX.
|
otHistoryTrackerIterateUnicastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
|
تكرار هذه الإدخالات في قائمة سجلّ عناوين يونيكود.
|
هياكل |
|
---|---|
otHistoryTrackerExternalPathInfo |
يمثل معلومات المسار الخارجي لبيانات الشبكة. |
otHistoryTrackerIterator |
يمثل مكرّرًا لتكراره من خلال قائمة سجلّات. |
otHistoryTrackerMessageInfo |
يمثّل معلومات رسالة RX/TX IPv6. |
otHistoryTrackerMulticastAddressInfo |
قدِّم معلومات عنوان البث المتعدد IPv6. |
otHistoryTrackerNeighborInfo |
يمثل معلومات الجيران |
otHistoryTrackerNetworkInfo |
يعرض معلومات شبكة Thread. |
otHistoryTrackerOnMeshPrefixInfo |
تمثيل بيانات الشبكة في معلومات بادئة الشبكة المتداخلة. |
otHistoryTrackerrrInfo |
يمثل حدث إدخال في جدول جهاز التوجيه. |
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
|
تمت إزالة إدخال بيانات الشبكة. |
otHistoryTrackerrrEvent
otHistoryTrackerRouterEvent
يتم تحديد الأحداث في معلومات جهاز التوجيه (أي
إضافة أو إزالة جهاز توجيه أو تغييره).
أماكن إقامة | |
---|---|
OT_HISTORY_TRACKER_ROUTER_EVENT_ADDED
|
تمت إضافة جهاز التوجيه (تم تخصيص رقم تعريف جهاز التوجيه). |
OT_HISTORY_TRACKER_ROUTER_EVENT_COST_CHANGED
|
تم تغيير تكلفة مسار دخول جهاز التوجيه (القفز التالي كما في السابق). |
OT_HISTORY_TRACKER_ROUTER_EVENT_NEXT_HOP_CHANGED
|
تم تغيير الدخول إلى جهاز التوجيه التالي وتكلفته. |
OT_HISTORY_TRACKER_ROUTER_EVENT_REMOVED
|
تمت إزالة إدخال جهاز التوجيه (تم إصدار معرّف جهاز التوجيه). |
أنواع المحددات
otHistoryTrackerExternalPathInfo
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
يمثل معلومات الجيران
otHistoryTrackerNetworkInfo
struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo
يعرض معلومات شبكة Thread.
otHistoryTrackerOnMeshPrefixInfo
struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo
تمثيل بيانات الشبكة في معلومات بادئة الشبكة المتداخلة.
otHistoryTrackerrrInfo
struct otHistoryTrackerRouterInfo otHistoryTrackerRouterInfo
يمثل حدث إدخال في جدول جهاز التوجيه.
otHistoryTrackerUnicastAddressInfo
struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo
تمثيل معلومات عنوان IPv6 أحادي البث.
الدوال
otHistoryTrackerEntryAgeToString
void otHistoryTrackerEntryAgeToString( uint32_t aEntryAge, char *aBuffer, uint16_t aSize )
تحوِّل عمر إدخال معيّن إلى سلسلة يمكن للمستخدم قراءتها.
تتبع سلسلة عمر الإدخال التنسيق "
إذا كانت السلسلة الناتجة لا تناسب aBuffer
(خلال aSize
من الأحرف)، سيتم اقتطاع السلسلة ولكن يتم دائمًا إنهاء السلسلة التي يتم إخراجها.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otHistoryTrackerInitIterator
void otHistoryTrackerInitIterator( otHistoryTrackerIterator *aIterator )
لإعداد otHistoryTrackerIterator
.
يجب إعداد المكرِّر قبل استخدامه.
يمكن إعداد المكرر مرة أخرى للبدء من بداية القائمة.
عند تكرار الإدخالات في إحدى القوائم، لضمان تطابق أعمار الإدخالات، يتم منح العمر بالنسبة إلى وقت إعداد التكرار، بمعنى أن يكون عمر الإدخال هو المدة (بالمللي ثانية) من الحدث (عند تسجيل الإدخال) إلى وقت إعداد التكرار.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
otHistoryTrackerIterateExternalPathHistory
const otHistoryTrackerExternalRouteInfo * otHistoryTrackerIterateExternalRouteHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
تكرار هذه الإدخالات في قائمة سجلّ المسار الخارجي لبيانات الشبكة
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
المرتجعات |
إدخال
otHistoryTrackerExternalRouteInfo أو NULL في حال عدم توفر المزيد من الإدخالات في القائمة. |
otHistoryTrackerIterateMulticastAddressHistory
const otHistoryTrackerMulticastAddressInfo * otHistoryTrackerIterateMulticastAddressHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
تكرار الإدخال في قائمة سجلّ عناوين البث المتعدد
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
المرتجعات |
مؤشر على إدخال
otHistoryTrackerMulticastAddressInfo أو NULL إذا لم يكن هناك المزيد من الإدخالات في القائمة. |
otHistoryTrackerIterateNeighborHistory
const otHistoryTrackerNeighborInfo * otHistoryTrackerIterateNeighborHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
تكرار هذه الإدخالات في قائمة سجلّ الجيران
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
المرتجعات |
إدخال
otHistoryTrackerNeighborInfo أو NULL في حال عدم توفر المزيد من الإدخالات في القائمة. |
otHistoryTrackerIterateNetInfoHistory
const otHistoryTrackerNetworkInfo * otHistoryTrackerIterateNetInfoHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
تكرار الإدخالات في قائمة سجلّ معلومات الشبكة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
المرتجعات |
مؤشر على إدخال
otHistoryTrackerNetworkInfo أو NULL إذا لم يكن هناك المزيد من الإدخالات في القائمة. |
otHistoryTrackerIterateOnMishPrefixHistory
const otHistoryTrackerOnMeshPrefixInfo * otHistoryTrackerIterateOnMeshPrefixHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
تكرار الإدخالات في بيانات الشبكة في قائمة سجلّ بادئة الشبكة المتداخلة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
المرتجعات |
إدخال
otHistoryTrackerOnMeshPrefixInfo أو NULL في حال عدم توفر المزيد من الإدخالات في القائمة. |
otHistoryTrackerIteraterouterHistory
const otHistoryTrackerRouterInfo * otHistoryTrackerIterateRouterHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
تكرار هذه الإدخالات في قائمة سجلّ جهاز التوجيه
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
المرتجعات |
إدخال
otHistoryTrackerRouterInfo أو NULL في حال عدم توفر المزيد من الإدخالات في القائمة. |
otHistoryTrackerIterateRxHistory
const otHistoryTrackerMessageInfo * otHistoryTrackerIterateRxHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
تكرار هذه الإدخالات في قائمة سجلّ رسائل RX.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
المرتجعات |
إدخال
otHistoryTrackerMessageInfo أو NULL في حال عدم توفر المزيد من الإدخالات في القائمة. |
otHistoryTrackerIterateTxHistory
const otHistoryTrackerMessageInfo * otHistoryTrackerIterateTxHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
تكرار هذه الإدخالات في قائمة سجلّ رسائل TX.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
المرتجعات |
إدخال
otHistoryTrackerMessageInfo أو NULL في حال عدم توفر المزيد من الإدخالات في القائمة. |
otHistoryTrackerIterateUnicastAddressHistory
const otHistoryTrackerUnicastAddressInfo * otHistoryTrackerIterateUnicastAddressHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
تكرار هذه الإدخالات في قائمة سجلّ عناوين يونيكود.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
المرتجعات |
مؤشر على إدخال
otHistoryTrackerUnicastAddressInfo أو NULL إذا لم يكن هناك المزيد من الإدخالات في القائمة. |
وحدات ماكرو
OT_history_trackER_ENTRY_AGE_STRING_SIZE
OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21
الحجم المقترح لتمثيل السلسلة في عمر الإدخال
OT_history_trackER_INFINITE_PATH_COST
OT_HISTORY_TRACKER_INFINITE_PATH_COST 0
تكلفة مسار غير محدود - تُستخدم في otHistoryTrackerRouterInfo
OT_history_trackER_MAX_AGE
OT_HISTORY_TRACKER_MAX_AGE (49 * 24 * 60 * 60 * 1000u)
يحدّد هذا الثابت الحدّ الأقصى لعمر الإدخالات وهو 49 يومًا (بالثانية).
وستُعطى هذه الإدخالات اعتبارًا من العمر الأكبر سنًا.
OT_history_trackER_NO_next_HOP
OT_HISTORY_TRACKER_NO_NEXT_HOP 63
ما مِن قفزة جديدة - مقابل mNextHop
في otHistoryTrackerRouterInfo
.
الموارد
تبدأ مواضيع مراجع واجهة برمجة تطبيقات OpenThread من رمز المصدر، وهو متاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.