Google is committed to advancing racial equity for Black communities. See how.

تعقب التاريخ

ملخص

التعداد

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
}
تعداد
يحدد هذا التعداد الأحداث في معلومات الجار (أي

النوع

otHistoryTrackerIterator typedef
يمثل هذا النوع مكررًا للتكرار من خلال قائمة المحفوظات.
otHistoryTrackerMessageInfo typedef
يمثل هذا الهيكل معلومات رسالة RX / TX IPv6.
otHistoryTrackerMulticastAddressInfo typedef
تمثل هذه البنية معلومات عنوان الإرسال المتعدد IPv6.
otHistoryTrackerNeighborInfo typedef
يمثل هذا الهيكل معلومات الجار.
otHistoryTrackerNetworkInfo typedef
يمثل هذا الهيكل معلومات شبكة الموضوع.
otHistoryTrackerUnicastAddressInfo typedef
تمثل هذه البنية معلومات عنوان IPv6 أحادية الإرسال.

المهام

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

الهياكل

otHistoryTrackerIterator

يمثل هذا النوع مكررًا للتكرار من خلال قائمة المحفوظات.

otHistoryTrackerMessageInfo

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

otHistoryTrackerMulticastAddressInfo

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

otHistoryTrackerNeighborInfo

يمثل هذا الهيكل معلومات الجار.

otHistoryTrackerNetworkInfo

يمثل هذا الهيكل معلومات شبكة الموضوع.

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

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

النوع

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

يمثل هذا النوع مكررًا للتكرار من خلال قائمة المحفوظات.

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

قبل استخدام مكرر، لا بد من تهيئة باستخدام 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

يمثل هذا الهيكل معلومات شبكة الموضوع.

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
مؤشر إلى مكرر التهيئة (يجب ألا يكون فارغًا).

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 إذا لم يكن أكثر من إدخالات في القائمة.

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
)

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

تفاصيل
العوامل
[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
)

تتكرر هذه الوظيفة عبر الإدخالات في قائمة محفوظات عناوين الإرسال الأحادي.

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

وحدات الماكرو

OT_HISTORY_TRACKER_ENTRY_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)

يحدد هذا العنوان واجهة برمجة التطبيقات العامة لمتتبع السجل.

تقوم وحدة History Tracker بتسجيل تاريخ الأحداث المختلفة (مثل رسائل RX و TX أو تغييرات معلومات الشبكة ، إلخ) أثناء عمل شبكة Thread. جميع الإدخالات المتعقبة لها طابع زمني.

تتوفر وظائف في هذه الوحدة عندما OPENTHREAD_CONFIG_HISTOR_TRACKER_ENABLE تمكين. يحدد هذا الثابت الحد الأقصى لعمر الإدخالات وهو 49 يومًا (بالمللي ثانية).

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