ردیاب تاریخ
سابقه رویدادهای مختلف، برای مثال پیامهای RX و TX یا تغییرات اطلاعات شبکه را ثبت میکند.
خلاصه
تمام ورودی های پیگیری شده دارای مهر زمانی هستند.
عملکردهای این ماژول زمانی در دسترس هستند که OPENTHREAD_CONFIG_HISTOR_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 سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.
،ردیاب تاریخ
سابقه رویدادهای مختلف، برای مثال پیامهای RX و TX یا تغییرات اطلاعات شبکه را ثبت میکند.
خلاصه
تمام ورودی های پیگیری شده دارای مهر زمانی هستند.
عملکردهای این ماژول زمانی در دسترس هستند که OPENTHREAD_CONFIG_HISTOR_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 سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.