ردیاب تاریخ
سابقه رویدادهای مختلف، برای مثال پیامهای RX و TX یا تغییرات اطلاعات شبکه را ثبت میکند.
خلاصه
تمام ورودی های پیگیری شده دارای مهر زمانی هستند.
عملکردهای این ماژول زمانی در دسترس هستند که OPENTHREAD_CONFIG_HISTORY_TRACKER_ENABLE
فعال باشد.
Typedefs | |
---|---|
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 unicast را نشان دهد. |
کارکرد | |
---|---|
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) | روی ورودیهای فهرست تاریخچه آدرس unicast تکرار میشود. |
سازه ها | |
---|---|
otHistoryTrackerExternalRouteInfo | اطلاعات مسیر خارجی داده شبکه را نشان دهد. |
otHistoryTrackerIterator | یک تکرار کننده را برای تکرار از طریق فهرست تاریخ نشان می دهد. |
otHistoryTrackerMessageInfo | اطلاعات پیام RX/TX IPv6 را نشان می دهد. |
otHistoryTrackerMulticastAddressInfo | نمایش اطلاعات آدرس چندپخشی IPv6. |
otHistoryTrackerNeighborInfo | نشان دهنده اطلاعات همسایه است. |
otHistoryTrackerNetworkInfo | اطلاعات شبکه Thread را نشان می دهد. |
otHistoryTrackerOnMeshPrefixInfo | یک داده شبکه را روی اطلاعات پیشوند مش نمایش دهید. |
otHistoryTrackerRouterInfo | یک رویداد ورود به جدول روتر را نشان می دهد. |
otHistoryTrackerUnicastAddressInfo | اطلاعات آدرس IPv6 unicast را نشان دهد. |
شمارش ها
شماره ناشناس
anonymous enum
ثابت ها نشان دهنده اولویت پیام مورد استفاده در ساختار otHistoryTrackerMessageInfo
.
otHistoryTrackerAddressEvent
otHistoryTrackerAddressEvent
otHistoryTrackerNeighborEvent
otHistoryTrackerNeighborEvent
رویدادها را در اطلاعات همسایه تعریف می کند (به عنوان مثال
خواه همسایه اضافه، حذف یا تغییر داده شود).
رویداد OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING
فقط برای همسایگان کودک قابل اجرا است. پس از راهاندازی مجدد دستگاه و هنگامی که فهرست فرزندان قبلی از تنظیمات غیرفرار بازیابی میشود و دستگاه سعی میکند اتصال به آنها را بازیابی کند، فعال میشود.
otHistoryTrackerNetDataEvent
otHistoryTrackerNetDataEvent
otHistoryTrackerRouterEvent
otHistoryTrackerRouterEvent
رویدادها را در اطلاعات روتر تعریف می کند (به عنوان مثال
آیا روتر اضافه، حذف یا تغییر کرده است).
Typedefs
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
نشان دهنده اطلاعات همسایه است.
otHistoryTrackerNetworkInfo
struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo
اطلاعات شبکه Thread را نشان می دهد.
otHistoryTrackerOnMeshPrefixInfo
struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo
یک داده شبکه را روی اطلاعات پیشوند مش نمایش دهید.
otHistoryTrackerRouterInfo
struct otHistoryTrackerRouterInfo otHistoryTrackerRouterInfo
یک رویداد ورود به جدول روتر را نشان می دهد.
otHistoryTrackerUnicastAddressInfo
struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo
اطلاعات آدرس IPv6 unicast را نشان دهد.
کارکرد
otHistoryTrackerEntryAgeToString
void otHistoryTrackerEntryAgeToString( uint32_t aEntryAge, char *aBuffer, uint16_t aSize )
یک سن ورودی معین را به یک رشته قابل خواندن توسط انسان تبدیل می کند.
رشته سنی ورودی از قالب پیروی می کند
اگر رشته به دست آمده در aBuffer
(در کاراکترهای aSize
آن) قرار نگیرد، رشته کوتاه میشود اما رشته خروجی همیشه تهی است.
جزئیات | |||||||
---|---|---|---|---|---|---|---|
مولفه های |
|
otHistoryTrackerInitIterator
void otHistoryTrackerInitIterator( otHistoryTrackerIterator *aIterator )
یک otHistoryTrackerIterator
را راه اندازی می کند.
یک تکرار کننده باید قبل از استفاده مقداردهی اولیه شود.
یک تکرار کننده را می توان دوباره برای شروع از ابتدای لیست مقداردهی کرد.
هنگام تکرار بیش از ورودیها در یک فهرست، برای اطمینان از سازگاری سنهای ورودی، سن نسبت به زمانی که تکرارکننده اولیه شد، داده میشود، یعنی سن ورود به عنوان مدت زمان (بر حسب میلیثانیه) از رویداد (زمانی که ورود انجام شد) ارائه میشود. ثبت شده) به زمان اولیه سازی تکرار کننده.
جزئیات | |||
---|---|---|---|
مولفه های |
|
otHistoryTrackerIterateExternalRouteHistory
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 اگر ورودی دیگری در لیست نباشد. |
otHistoryTrackerIterateOnMeshPrefixHistory
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 )
روی ورودیهای فهرست تاریخچه آدرس unicast تکرار میشود.
جزئیات | |||||||
---|---|---|---|---|---|---|---|
مولفه های |
| ||||||
برمی گرداند | یک اشارهگر به ورودی 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 API از کد منبع موجود در GitHub سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.