Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Pelacak Histori

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

Ringkasan

Semua entri yang dilacak memiliki stempel waktu.

Fungsi dalam modul ini tersedia saat OPENTHREAD_CONFIG_HISTOR_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
Enumerasi ini 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
Enumerasi ini menentukan peristiwa dalam informasi di sekitar (yaitu
otHistoryTrackerNetDataEvent{
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED = 0,
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED = 1
}
enum
Enumerasi ini menentukan peristiwa untuk entri Data Jaringan (yaitu, apakah entri ditambahkan atau dihapus).

Typedef

otHistoryTrackerExternalRouteInfo typedef
Struktur ini menunjukkan info rute eksternal Data Jaringan.
otHistoryTrackerIterator typedef
Jenis ini mewakili iterator untuk melakukan iterasi melalui daftar histori.
otHistoryTrackerMessageInfo typedef
Struktur ini mewakili info pesan RX/TX IPv6.
otHistoryTrackerMulticastAddressInfo typedef
Struktur ini mewakili info alamat multicast IPv6.
otHistoryTrackerNeighborInfo typedef
Struktur ini mewakili info tetangga.
otHistoryTrackerNetworkInfo typedef
Struktur ini mewakili info jaringan Thread.
otHistoryTrackerOnMeshPrefixInfo typedef
Struktur ini mewakili Data Jaringan pada info awalan mesh.
otHistoryTrackerUnicastAddressInfo typedef
Struktur ini mewakili info alamat IPv6 unicast.

Fungsi

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

Struct

otHistoryTrackerExternalRouteInfo

Struktur ini menunjukkan info rute eksternal Data Jaringan.

otHistoryTrackerIterator

Jenis ini mewakili iterator untuk melakukan iterasi melalui daftar histori.

otHistoryTrackerMessageInfo

Struktur ini mewakili info pesan RX/TX IPv6.

otHistoryTrackerMulticastAddressInfo

Struktur ini mewakili info alamat multicast IPv6.

otHistoryTrackerNeighborInfo

Struktur ini mewakili info tetangga.

otHistoryTrackerNetworkInfo

Struktur ini mewakili info jaringan Thread.

otHistoryTrackerOnMeshPrefixInfo

Struktur ini mewakili Data Jaringan pada info awalan mesh.

otHistoryTrackerUnicastAddressInfo

Struktur ini mewakili 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

Enumerasi ini 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

Enumerasi ini menentukan peristiwa dalam informasi di sekitar (yaitu

apakah tetangga ditambahkan, dihapus, atau diubah).

Acara OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING hanya berlaku untuk tetangga turunan. Hal ini akan dipicu setelah perangkat dimulai ulang (dan saat daftar turunan sebelumnya diambil dari setelan yang tidak stabil dan perangkat mencoba memulihkan koneksinya).

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

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

otHistoryTrackerNetDataEvent

 otHistoryTrackerNetDataEvent

Enumerasi ini 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 akan dihapus.

Typedef

otHistoryTrackerExternalRouteInfo

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

Struktur ini menunjukkan info rute eksternal Data Jaringan.

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

Jenis ini mewakili iterator untuk melakukan iterasi melalui daftar histori.

Kolom dalam jenis ini buram (dimaksudkan untuk digunakan oleh OpenThread Core) dan karenanya tidak boleh diakses/digunakan oleh pemanggil.

Sebelum menggunakan iterator, HARUS dilakukan inisialisasi menggunakan otHistoryTrackerInitIterator(),

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

Struktur ini mewakili info pesan RX/TX IPv6.

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

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

Struktur ini mewakili info alamat multicast IPv6.

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

Struktur ini mewakili info tetangga.

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

Struktur ini mewakili info jaringan Thread.

otHistoryTrackerOnMeshPrefixInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

Struktur ini mewakili Data Jaringan pada info awalan mesh.

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

Struktur ini mewakili info alamat IPv6 unicast.

Fungsi

otHistoryTrackerEntryAgeToString

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

Fungsi ini mengonversi usia entri tertentu menjadi string yang dapat dibaca manusia.

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

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

Jika string yang dihasilkan tidak sesuai dalam aBuffer (dalam aSize karakternya), string tersebut akan dipotong tetapi string yang dihasilkan selalu diakhiri null.

Detail
Parameter
[in] aEntryAge
Usia entri (durasi dalam mdtk).
[out] aBuffer
Pointer ke array char untuk mengeluarkan string (HARUS TIDAK berupa NULL).
[in] aSize
Ukuran aBuffer. Direkomendasikan untuk menggunakan OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE.

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

Fungsi ini 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 tersebut diberikan relatif terhadap waktu iterator diinisialisasi, yaitu, usia entri diberikan sebagai durasi (dalam milidetik) dari peristiwa (saat entri direkam) ke waktu inisialisasi iterator.

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

otHistoryTrackerIterateExternalRouteHistory

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

Fungsi ini 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 menghasilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri direkam ke waktu inisialisasi aIterator. 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 lagi dalam daftar.

otHistoryTrackerIterateMulticastAddressHistory

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

Fungsi ini 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 menghasilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri direkam ke waktu inisialisasi aIterator. 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 entri lagi dalam daftar.

otHistoryTrackerIterateNeighborHistory

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

Fungsi ini melakukan iterasi 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 menghasilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri direkam ke waktu inisialisasi aIterator. 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 lagi dalam daftar.

otHistoryTrackerIterateNetInfoHistory

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

Fungsi ini 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 menghasilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri direkam ke waktu inisialisasi aIterator. 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 entri lagi dalam daftar.

otHistoryTrackerIterateOnMeshPrefixHistory

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

Fungsi ini melakukan iterasi 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 menghasilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri direkam ke waktu inisialisasi aIterator. 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 lagi dalam daftar.

otHistoryTrackerIterateRxHistory

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

Fungsi ini 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 menghasilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri direkam ke waktu inisialisasi aIterator. 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 lagi dalam daftar.

otHistoryTrackerIterateTxHistory

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

Fungsi ini 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 menghasilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri direkam ke waktu inisialisasi aIterator. 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 lagi dalam daftar.

otHistoryTrackerIterateUnicastAddressHistory

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

Fungsi ini melakukan iterasi 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 menghasilkan usia entri. TIDAK BOLEH NULL. Usia diberikan sebagai durasi (dalam milidetik) sejak entri direkam ke waktu inisialisasi aIterator. 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 entri lagi 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_MAX_AGE

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

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

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

Resource

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