Pelacak Histori

Merekam histori berbagai peristiwa, misalnya pesan RX dan TX atau perubahan info jaringan.

Ringkasan

Semua entri yang dilacak diberi stempel waktu.

Fungsi dalam modul ini tersedia saat OPENTHREAD_CONFIG_HISTORY_TRACKER_ENABLE diaktifkan.

Enumerasi
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
} 		enum
Konstanta yang mewakili prioritas pesan yang digunakan dalam struct otHistoryTrackerMessageInfo.
otHistoryTrackerAddressEvent{
  OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1
} 		enum
Menentukan peristiwa untuk info alamat IPv6 (unicast atau multicast) (yaitu, apakah alamat ditambahkan atau dihapus).
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
} 		enum
Mendefinisikan peristiwa dalam info tetangga (yaitu
otHistoryTrackerNetDataEvent{
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED = 0,
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED = 1
} 		enum
Menentukan peristiwa untuk entri Data Jaringan (yaitu, apakah entri ditambahkan atau dihapus).
otHistoryTrackerRouterEvent{
  OT_HISTORY_TRACKER_ROUTER_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ROUTER_EVENT_REMOVED = 1,
  OT_HISTORY_TRACKER_ROUTER_EVENT_NEXT_HOP_CHANGED = 2,
  OT_HISTORY_TRACKER_ROUTER_EVENT_COST_CHANGED = 3
} 		enum
Menentukan peristiwa dalam info router (yaitu

Typedef
otHistoryTrackerExternalRouteInfo typedef
Menampilkan info rute eksternal Data Jaringan.
otHistoryTrackerIterator typedef
Menampilkan iterator untuk melakukan iterasi melalui daftar histori.
otHistoryTrackerMessageInfo typedef
Mewakili info pesan IPv6 RX/TX.
otHistoryTrackerMulticastAddressInfo typedef
Merepresentasikan info alamat multicast IPv6.
otHistoryTrackerNeighborInfo typedef
Menampilkan info tetangga.
otHistoryTrackerNetworkInfo typedef
Menampilkan info jaringan Thread.
otHistoryTrackerOnMeshPrefixInfo typedef
Merepresentasikan Data Jaringan pada info awalan mesh.
otHistoryTrackerRouterInfo typedef
Menampilkan peristiwa entri tabel router.
otHistoryTrackerUnicastAddressInfo typedef
Merepresentasikan info alamat IPv6 unicast.

Fungsi
otHistoryTrackerEntryAgeToString(uint32_t aEntryAge, char *aBuffer, uint16_t aSize)
void
Mengonversi usia entri yang ditentukan menjadi string yang dapat dibaca manusia.
otHistoryTrackerInitIterator(otHistoryTrackerIterator *aIterator)
void
Menginisialisasi otHistoryTrackerIterator.
otHistoryTrackerIterateExternalRouteHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Melakukan iterasi pada entri dalam daftar histori entri rute eksternal Data Jaringan.
otHistoryTrackerIterateMulticastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Melakukan iterasi pada entri dalam daftar histori alamat multicast.
otHistoryTrackerIterateNeighborHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Melakukan iterasi pada entri dalam daftar histori tetangga.
otHistoryTrackerIterateNetInfoHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Melakukan iterasi pada entri dalam daftar histori info jaringan.
otHistoryTrackerIterateOnMeshPrefixHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Melakukan iterasi pada entri dalam Data Jaringan pada daftar histori entri awalan mesh.
otHistoryTrackerIterateRouterHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Melakukan iterasi pada entri dalam daftar histori router.
otHistoryTrackerIterateRxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Melakukan iterasi pada entri dalam daftar histori pesan RX.
otHistoryTrackerIterateTxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Melakukan iterasi pada entri dalam daftar histori pesan TX.
otHistoryTrackerIterateUnicastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Melakukan iterasi pada entri dalam daftar histori alamat unicast.

Struct
otHistoryTrackerExternalRouteInfo

Menampilkan info rute eksternal Data Jaringan.

otHistoryTrackerIterator

Menampilkan iterator untuk melakukan iterasi melalui daftar histori.

otHistoryTrackerMessageInfo

Mewakili info pesan IPv6 RX/TX.

otHistoryTrackerMulticastAddressInfo

Merepresentasikan info alamat multicast IPv6.

otHistoryTrackerNeighborInfo

Menampilkan info tetangga.

otHistoryTrackerNetworkInfo

Menampilkan info jaringan Thread.

otHistoryTrackerOnMeshPrefixInfo

Merepresentasikan Data Jaringan pada info awalan mesh.

otHistoryTrackerRouterInfo

Menampilkan peristiwa entri tabel router.

otHistoryTrackerUnicastAddressInfo

Merepresentasikan info alamat IPv6 unicast.

Enumerasi

enum anonim

 anonymous enum

Konstanta yang mewakili prioritas pesan yang digunakan dalam struct otHistoryTrackerMessageInfo.

Properti
OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH

Tingkat prioritas tinggi.

OT_HISTORY_TRACKER_MSG_PRIORITY_LOW

Tingkat prioritas rendah.

OT_HISTORY_TRACKER_MSG_PRIORITY_NET

Tingkat prioritas Kontrol Jaringan.

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

Tingkat prioritas normal.

otHistoryTrackerAddressEvent

 otHistoryTrackerAddressEvent

Menentukan peristiwa untuk info alamat IPv6 (unicast atau multicast) (yaitu, apakah alamat ditambahkan atau dihapus).

Properti
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

Alamat ditambahkan.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

Alamat dihapus.

otHistoryTrackerNeighborEvent

 otHistoryTrackerNeighborEvent

Mendefinisikan peristiwa dalam info tetangga (yaitu

apakah tetangga ditambahkan, dihapus, atau diubah).

Acara OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING hanya berlaku untuk tetangga anak. Ini dipicu setelah perangkat (ulang) dimulai dan saat daftar turunan sebelumnya diambil dari setelan non-volatil dan perangkat mencoba memulihkan koneksi ke setelan tersebut.

Properti
OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED

Tetangga ditambahkan.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED

Tetangga berubah (misalnya, tanda mode perangkat diubah).

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED

Tetangga dihapus.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

Lingkungan sedang dipulihkan (hanya berlaku untuk anak-anak).

otHistoryTrackerNetDataEvent

 otHistoryTrackerNetDataEvent

Menentukan peristiwa untuk entri Data Jaringan (yaitu, apakah entri ditambahkan atau dihapus).

Properti
OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED

Entri data jaringan ditambahkan.

OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED

Entri data jaringan dihapus.

otHistoryTrackerRouterEvent

 otHistoryTrackerRouterEvent

Menentukan peristiwa dalam info router (yaitu

apakah router ditambahkan, dihapus, atau diubah).

Properti
OT_HISTORY_TRACKER_ROUTER_EVENT_ADDED

Router ditambahkan (ID router dialokasikan).

OT_HISTORY_TRACKER_ROUTER_EVENT_COST_CHANGED

Biaya jalur masuk router diubah (hop berikutnya seperti sebelumnya).

OT_HISTORY_TRACKER_ROUTER_EVENT_NEXT_HOP_CHANGED

Hop berikutnya entri router dan biaya berubah.

OT_HISTORY_TRACKER_ROUTER_EVENT_REMOVED

Entri router dihapus (ID router dirilis).

Typedef

otHistoryTrackerExternalRouteInfo

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

Menampilkan info rute eksternal Data Jaringan.

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

Menampilkan iterator untuk melakukan iterasi melalui daftar histori.

Kolom dalam jenis ini buram (ditujukan untuk digunakan oleh inti OpenThread) sehingga tidak boleh diakses/digunakan oleh pemanggil.

Sebelum menggunakan iterator, iterator HARUS diinisialisasi menggunakan otHistoryTrackerInitIterator(),

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

Mewakili info pesan IPv6 RX/TX.

Beberapa kolom dalam struct ini hanya berlaku untuk pesan RX atau pesan TX, misalnya, mAveRxRss adalah RSS rata-rata dari semua frame fragmen yang membentuk pesan yang diterima dan hanya berlaku untuk pesan RX.

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

Merepresentasikan info alamat multicast IPv6.

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

Menampilkan info tetangga.

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

Menampilkan info jaringan Thread.

otHistoryTrackerOnMeshPrefixInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

Merepresentasikan Data Jaringan pada info awalan mesh.

otHistoryTrackerRouterInfo

struct otHistoryTrackerRouterInfo otHistoryTrackerRouterInfo

Menampilkan peristiwa entri tabel router.

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

Merepresentasikan info alamat IPv6 unicast.

Fungsi

otHistoryTrackerEntryAgeToString

void otHistoryTrackerEntryAgeToString(
  uint32_t aEntryAge,
  char *aBuffer,
  uint16_t aSize
)

Mengonversi usia entri yang ditentukan menjadi string yang dapat dibaca manusia.

String usia entri mengikuti format "::." untuk jam, menit, detik, dan milidetik (jika kurang dari satu hari) atau "

hari ::." (jika lebih dari satu hari).

Jika string yang dihasilkan tidak sesuai dengan aBuffer (dalam karakter aSize-nya), string akan terpotong tetapi string yang dihasilkan selalu dihentikan null.

Detail
Parameter
[in] aEntryAge
Usia entri (durasi dalam milidetik).
[out] aBuffer
Pointer ke array char untuk menghasilkan string (TIDAK BOLEH NULL).
[in] aSize
Ukuran aBuffer. Sebaiknya gunakan OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE.

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

Menginisialisasi otHistoryTrackerIterator.

Iterator HARUS diinisialisasi sebelum digunakan.

Iterator dapat diinisialisasi lagi untuk memulai dari awal daftar.

Saat melakukan iterasi pada entri dalam daftar, untuk memastikan usia entri konsisten, usia diberikan relatif terhadap waktu iterator diinisialisasi, yaitu usia entri diberikan sebagai durasi (dalam milidetik) dari peristiwa (saat entri dicatat) ke waktu inisialisasi iterator.

Detail
Parameter
[in] aIterator
Pointer ke iterator yang akan diinisialisasi (HARUS TIDAK NULL).

otHistoryTrackerIterateExternalRouteHistory

const otHistoryTrackerExternalRouteInfo * otHistoryTrackerIterateExternalRouteHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Melakukan iterasi pada entri dalam daftar histori entri rute eksternal Data Jaringan.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in,out] aIterator
Pointer ke iterator. HARUS diinisialisasi atau perilaku tidak ditentukan.
[out] aEntryAge
Pointer ke variabel untuk menampilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri dicatat hingga waktu inisialisasi aIterator. Setelan ini disetel ke OT_HISTORY_TRACKER_MAX_AGE untuk entri yang lebih lama dari usia maksimum.
Hasil
Entri otHistoryTrackerExternalRouteInfo atau NULL jika tidak ada entri lain dalam daftar.

otHistoryTrackerIterateMulticastAddressHistory

const otHistoryTrackerMulticastAddressInfo * otHistoryTrackerIterateMulticastAddressHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Melakukan iterasi pada entri dalam daftar histori alamat multicast.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in,out] aIterator
Pointer ke iterator. HARUS diinisialisasi atau perilaku tidak ditentukan.
[out] aEntryAge
Pointer ke variabel untuk menampilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri dicatat hingga waktu inisialisasi aIterator. Setelan ini disetel ke OT_HISTORY_TRACKER_MAX_AGE untuk entri yang lebih lama dari usia maksimum.
Hasil
Pointer ke entri otHistoryTrackerMulticastAddressInfo atau NULL jika tidak ada lagi entri dalam daftar.

otHistoryTrackerIterateNeighborHistory

const otHistoryTrackerNeighborInfo * otHistoryTrackerIterateNeighborHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Melakukan iterasi pada entri dalam daftar histori tetangga.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in,out] aIterator
Pointer ke iterator. HARUS diinisialisasi atau perilaku tidak ditentukan.
[out] aEntryAge
Pointer ke variabel untuk menampilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri dicatat hingga waktu inisialisasi aIterator. Setelan ini disetel ke OT_HISTORY_TRACKER_MAX_AGE untuk entri yang lebih lama dari usia maksimum.
Hasil
Entri otHistoryTrackerNeighborInfo atau NULL jika tidak ada entri lain dalam daftar.

otHistoryTrackerIterateNetInfoHistory

const otHistoryTrackerNetworkInfo * otHistoryTrackerIterateNetInfoHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Melakukan iterasi pada entri dalam daftar histori info jaringan.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in,out] aIterator
Pointer ke iterator. HARUS diinisialisasi atau perilaku tidak ditentukan.
[out] aEntryAge
Pointer ke variabel untuk menampilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri dicatat hingga waktu inisialisasi aIterator. Setelan ini disetel ke OT_HISTORY_TRACKER_MAX_AGE untuk entri yang lebih lama dari usia maksimum.
Hasil
Pointer ke entri otHistoryTrackerNetworkInfo atau NULL jika tidak ada lagi entri dalam daftar.

otHistoryTrackerIterateOnMeshPrefixHistory

const otHistoryTrackerOnMeshPrefixInfo * otHistoryTrackerIterateOnMeshPrefixHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Melakukan iterasi pada entri dalam Data Jaringan pada daftar histori entri awalan mesh.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in,out] aIterator
Pointer ke iterator. HARUS diinisialisasi atau perilaku tidak ditentukan.
[out] aEntryAge
Pointer ke variabel untuk menampilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri dicatat hingga waktu inisialisasi aIterator. Setelan ini disetel ke OT_HISTORY_TRACKER_MAX_AGE untuk entri yang lebih lama dari usia maksimum.
Hasil
Entri otHistoryTrackerOnMeshPrefixInfo atau NULL jika tidak ada entri lain dalam daftar.

otHistoryTrackerIterateRouterHistory

const otHistoryTrackerRouterInfo * otHistoryTrackerIterateRouterHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Melakukan iterasi pada entri dalam daftar histori router.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in,out] aIterator
Pointer ke iterator. HARUS diinisialisasi atau perilaku tidak ditentukan.
[out] aEntryAge
Pointer ke variabel untuk menampilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri dicatat hingga waktu inisialisasi aIterator. Setelan ini disetel ke OT_HISTORY_TRACKER_MAX_AGE untuk entri yang lebih lama dari usia maksimum.
Hasil
Entri otHistoryTrackerRouterInfo atau NULL jika tidak ada entri lain dalam daftar.

otHistoryTrackerIterateRxHistory

const otHistoryTrackerMessageInfo * otHistoryTrackerIterateRxHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Melakukan iterasi pada entri dalam daftar histori pesan RX.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in,out] aIterator
Pointer ke iterator. HARUS diinisialisasi atau perilaku tidak ditentukan.
[out] aEntryAge
Pointer ke variabel untuk menampilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri dicatat hingga waktu inisialisasi aIterator. Setelan ini disetel ke OT_HISTORY_TRACKER_MAX_AGE untuk entri yang lebih lama dari usia maksimum.
Hasil
Entri otHistoryTrackerMessageInfo atau NULL jika tidak ada entri lain dalam daftar.

otHistoryTrackerIterateTxHistory

const otHistoryTrackerMessageInfo * otHistoryTrackerIterateTxHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Melakukan iterasi pada entri dalam daftar histori pesan TX.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in,out] aIterator
Pointer ke iterator. HARUS diinisialisasi atau perilaku tidak ditentukan.
[out] aEntryAge
Pointer ke variabel untuk menampilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri dicatat hingga waktu inisialisasi aIterator. Setelan ini disetel ke OT_HISTORY_TRACKER_MAX_AGE untuk entri yang lebih lama dari usia maksimum.
Hasil
Entri otHistoryTrackerMessageInfo atau NULL jika tidak ada entri lain dalam daftar.

otHistoryTrackerIterateUnicastAddressHistory

const otHistoryTrackerUnicastAddressInfo * otHistoryTrackerIterateUnicastAddressHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Melakukan iterasi pada entri dalam daftar histori alamat unicast.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in,out] aIterator
Pointer ke iterator. HARUS diinisialisasi atau perilaku tidak ditentukan.
[out] aEntryAge
Pointer ke variabel untuk menampilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri dicatat hingga waktu inisialisasi aIterator. Setelan ini disetel ke OT_HISTORY_TRACKER_MAX_AGE untuk entri yang lebih lama dari usia maksimum.
Hasil
Pointer ke entri otHistoryTrackerUnicastAddressInfo atau NULL jika tidak ada lagi entri dalam daftar.

Makro

OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE

 OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21

Ukuran yang direkomendasikan untuk representasi string usia entri.

OT_HISTORY_TRACKER_INFINITE_PATH_COST

 OT_HISTORY_TRACKER_INFINITE_PATH_COST 0

Biaya jalur tak terbatas - digunakan di otHistoryTrackerRouterInfo.

OT_HISTORY_TRACKER_MAX_AGE

 OT_HISTORY_TRACKER_MAX_AGE (49 * 24 * 60 * 60 * 1000u)

Konstanta ini menentukan usia maksimum entri, yaitu 49 hari (dalam milidetik).

Entri yang lebih lama dari usia maksimum akan memberikan nilai ini sebagai usia mereka.

OT_HISTORY_TRACKER_NO_NEXT_HOP

 OT_HISTORY_TRACKER_NO_NEXT_HOP 63

Tidak ada hop berikutnya - Untuk mNextHop di otHistoryTrackerRouterInfo.

Referensi

Topik Referensi OpenThread API berasal dari kode sumber yang tersedia di GitHub. Untuk informasi selengkapnya, atau untuk berkontribusi pada dokumentasi kami, lihat Referensi.