ردیاب تاریخ
سابقه رویدادهای مختلف، برای مثال پیامهای 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 این ساختار یک داده شبکه بر روی اطلاعات پیشوند مش را نشان می دهد. |
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 * این تابع بر روی ورودیهای فهرست تاریخچه ورود پیشوند شبکه دادههای شبکه تکرار میشود. |
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 | این ساختار یک داده شبکه بر روی اطلاعات پیشوند مش را نشان می دهد. |
otHistoryTrackerUnicastAddressInfo | این ساختار اطلاعات آدرس IPv6 unicast را نشان می دهد. |
شمارش ها
شماره ناشناس
anonymous enum
ثابت نشان دهنده اولویت پیام مورد استفاده در ساختار otHistoryTrackerMessageInfo
.
otHistoryTrackerAddressEvent
otHistoryTrackerAddressEvent
otHistoryTrackerNeighborEvent
otHistoryTrackerNeighborEvent
این شمارش رویدادها را در اطلاعات همسایه تعریف می کند (به عنوان مثال
خواه همسایه اضافه، حذف یا تغییر داده شود).
رویداد OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING
فقط برای همسایگان کودک قابل اجرا است. پس از راهاندازی مجدد دستگاه و هنگامی که فهرست فرزندان قبلی از تنظیمات غیرفرار بازیابی میشود و دستگاه تلاش میکند اتصال را به آنها بازیابی کند، فعال میشود.
otHistoryTrackerNetDataEvent
otHistoryTrackerNetDataEvent
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
این ساختار یک داده شبکه بر روی اطلاعات پیشوند مش را نشان می دهد.
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 اگر ورودی دیگری در لیست نباشد. |
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_MAX_AGE
OT_HISTORY_TRACKER_MAX_AGE (49 * 24 * 60 * 60 * 1000u)
این ثابت حداکثر سن ورودی ها را مشخص می کند که 49 روز (بر حسب میلی ثانیه) است.
ورودیهای بزرگتر از حداکثر سن، این مقدار را به عنوان سن خود نشان میدهند.
منابع
موضوعات مرجع OpenThread API از کد منبع موجود در GitHub سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.