Geçmiş İzleyici

RX ve TX mesajları veya ağ bilgisi değişiklikleri gibi farklı etkinliklerin geçmişini kaydeder.

Özet

İzlenen tüm girişlerin zaman damgası vardır.

Bu modüldeki işlevler, OPENTHREAD_CONFIG_HISTOR_TRACKER_ENABLE etkinleştirildiğinde kullanılabilir.

Sıralamalar

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
otHistoryTrackerMessageInfo yapısında kullanılan mesaj önceliğini temsil eden sabitler.
otHistoryTrackerAddressEvent{
  OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1
}
enum
Bu numaralandırma, bir IPv6 (tek noktaya yayın veya çoklu yayın) adres bilgisi (ör. adres ekleme veya kaldırma) için etkinlikleri tanımlar.
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
Bu numaralandırma, bir komşu bilgideki etkinlikleri (ör.
otHistoryTrackerNetDataEvent{
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED = 0,
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED = 1
}
enum
Bu numaralandırma, bir Ağ Veri girişi (ör. giriş ekleme veya kaldırma) etkinliklerini tanımlar.

Typedef

otHistoryTrackerExternalRouteInfo typedef
Bu yapı, bir Ağ Verileri harici rota bilgisini temsil eder.
otHistoryTrackerIterator typedef
Bu tür, geçmiş listesi üzerinden yineleme yapmak için bir yinelemeyi temsil eder.
otHistoryTrackerMessageInfo typedef
Bu yapı bir RX/TX IPv6 mesaj bilgisini temsil eder.
otHistoryTrackerMulticastAddressInfo typedef
Bu yapı bir IPv6 çoklu yayın adres bilgisini temsil eder.
otHistoryTrackerNeighborInfo typedef
Bu yapı bir komşu bilgiyi temsil eder.
otHistoryTrackerNetworkInfo typedef
Bu yapı, İş Parçacığı ağ bilgilerini temsil eder.
otHistoryTrackerOnMeshPrefixInfo typedef
Bu yapı, örgü öneki bilgisiyle ilgili bir Ağ Verisini temsil eder.
otHistoryTrackerUnicastAddressInfo typedef
Bu yapı, tek noktaya yayın IPv6 adresi bilgisini temsil eder.

İşlevler

otHistoryTrackerEntryAgeToString(uint32_t aEntryAge, char *aBuffer, uint16_t aSize)
void
Bu işlev, belirli bir giriş yaşını kullanıcılar tarafından okunabilir bir dizeye dönüştürür.
otHistoryTrackerInitIterator(otHistoryTrackerIterator *aIterator)
void
Bu işlev, bir otHistoryTrackerIterator başlatır.
otHistoryTrackerIterateExternalRouteHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Bu işlev, Ağ Verileri harici rota giriş geçmişi listesindeki girişleri yineler.
otHistoryTrackerIterateMulticastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Bu işlev, çoklu yayın adres geçmişi listesindeki girişler üzerinde yineleme yapar.
otHistoryTrackerIterateNeighborHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Bu işlev, komşu geçmiş listesindeki girişler için yineleme oluşturur.
otHistoryTrackerIterateNetInfoHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Bu işlev, ağ bilgileri geçmişi listesindeki girişler üzerinde yinelenir.
otHistoryTrackerIterateOnMeshPrefixHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Bu işlev, Örgü üzerinde ağ verisi giriş geçmişi listesindeki girişleri tekrarlar.
otHistoryTrackerIterateRxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Bu işlev, RX ileti geçmişi listesindeki girişler üzerinde yinelenir.
otHistoryTrackerIterateTxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Bu işlev, TX ileti geçmişi listesindeki girişleri yineler.
otHistoryTrackerIterateUnicastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Bu işlev, tek tip adres geçmişi listesindeki girişler üzerinde yineleme yapar.

Strucs

otHistoryTrackerExternalRouteInfo

Bu yapı, bir Ağ Verileri harici rota bilgisini temsil eder.

otHistoryTrackerIterator

Bu tür, geçmiş listesi üzerinden yineleme yapmak için bir yinelemeyi temsil eder.

otHistoryTrackerMessageInfo

Bu yapı bir RX/TX IPv6 mesaj bilgisini temsil eder.

otHistoryTrackerMulticastAddressInfo

Bu yapı bir IPv6 çoklu yayın adres bilgisini temsil eder.

otHistoryTrackerNeighborInfo

Bu yapı bir komşu bilgiyi temsil eder.

otHistoryTrackerNetworkInfo

Bu yapı, İş Parçacığı ağ bilgilerini temsil eder.

otHistoryTrackerOnMeshPrefixInfo

Bu yapı, örgü öneki bilgisiyle ilgili bir Ağ Verisini temsil eder.

otHistoryTrackerUnicastAddressInfo

Bu yapı, tek noktaya yayın IPv6 adresi bilgisini temsil eder.

Sıralamalar

anonim numaralandırma

 anonymous enum

otHistoryTrackerMessageInfo yapısında kullanılan mesaj önceliğini temsil eden sabitler.

Özellikler
OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH

Yüksek öncelik düzeyi.

OT_HISTORY_TRACKER_MSG_PRIORITY_LOW

Düşük öncelik düzeyi.

OT_HISTORY_TRACKER_MSG_PRIORITY_NET

Ağ Kontrolü öncelik düzeyi.

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

Normal öncelik düzeyi.

otHistoryTrackerAddressEvent

 otHistoryTrackerAddressEvent

Bu numaralandırma, bir IPv6 (tek noktaya yayın veya çoklu yayın) adres bilgisi (ör. adres ekleme veya kaldırma) için etkinlikleri tanımlar.

Özellikler
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

Adres eklendi.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

Adres kaldırıldı.

otHistoryTrackerNeighborEvent

 otHistoryTrackerNeighborEvent

Bu numaralandırma, bir komşu bilgideki etkinlikleri (ör.

komşunun eklenmesi, kaldırılması veya değiştirilmesi.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING etkinliği yalnızca alt komşular için geçerlidir. Cihaz yeniden başlatıldıktan ve geçici alt ayarlardan önceki alt liste alındığında ve cihaz bu bağlantıyı yeniden kurmaya çalıştığında tetiklenir.

Özellikler
OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED

Komşu eklendi.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED

Komşu değiştirildi (ör. cihaz modu işaretleri değişti).

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED

Komşu kaldırıldı.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

Komşular geri yükleniyor (yalnızca çocuk için geçerli).

otHistoryTrackerNetDataEvent

 otHistoryTrackerNetDataEvent

Bu numaralandırma, bir Ağ Veri girişi (ör. giriş ekleme veya kaldırma) etkinliklerini tanımlar.

Özellikler
OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED

Ağ veri girişi eklendi.

OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED

Ağ veri girişi kaldırıldı.

Typedef

otHistoryTrackerHarici Rota Bilgisi

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

Bu yapı, bir Ağ Verileri harici rota bilgisini temsil eder.

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

Bu tür, geçmiş listesi üzerinden yineleme yapmak için bir yinelemeyi temsil eder.

Bu türdeki alanlar opaktır (OpenThread Core tarafından kullanılmak üzere tasarlanmıştır). Bu nedenle, arayan tarafından erişilmemesi/kullanılmaması gerekir.

Yineleyici kullanmadan önce otHistoryTrackerInitIterator() kullanılarak başlatılması ZORUNLUDUR

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

Bu yapı bir RX/TX IPv6 mesaj bilgisini temsil eder.

Bu yapıdaki alanlardan bazıları yalnızca RX mesajı veya TX mesajı için geçerlidir.Ör. mAveRxRss, alınan bir mesajı oluşturan tüm parça karelerinin ortalama RSS'sidir ve yalnızca bir RX mesajı için geçerlidir.

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

Bu yapı bir IPv6 çoklu yayın adres bilgisini temsil eder.

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

Bu yapı bir komşu bilgiyi temsil eder.

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

Bu yapı, İş Parçacığı ağ bilgilerini temsil eder.

otHistoryTrackerOnMeshPrefixInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

Bu yapı, örgü öneki bilgisiyle ilgili bir Ağ Verisini temsil eder.

otHistoryTrackerUnicastAdres Bilgisi

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

Bu yapı, tek noktaya yayın IPv6 adresi bilgisini temsil eder.

İşlevler

otHistoryTrackerEntryAgeToString

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

Bu işlev, belirli bir giriş yaşını kullanıcılar tarafından okunabilir bir dizeye dönüştürür.

Giriş yaş dizesi "::," saat, dakika, saniye ve milisaniye için (bir günden kısaysa) veya "

gün ::." (bir günden uzunsa).

Sonuç dizesi aBuffer içinde yer almıyorsa (aSize karakterleri içindeyse) dize kesilir, ancak çıkan dize her zaman geçersiz olur.

Ayrıntılar
Parametreler
[in] aEntryAge
Giriş yaşı (saniye cinsinden süre).
[out] aBuffer
Dizenin çıkışını almak için bir karakter dizisi işaretçisi (BOŞ OLMAMALIDIR).
[in] aSize
Boyutu: aBuffer. OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE kullanılması önerilir.

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

Bu işlev, bir otHistoryTrackerIterator başlatır.

Yineleyici kullanılmadan önce başlatılması ZORUNLUDUR.

Yineleyici, listenin başından başlamak için tekrar başlatılabilir.

Bir listedeki girişler üzerinde yineleme yapılırken, giriş yaşlarının tutarlı olmasını sağlamak için yaş, yinelemenin başlatıldığı zamana göre verilir. Örneğin, giriş yaşı, etkinlikten itibaren süre (milisaniye cinsinden) olarak sağlanır (girişin için) tekrarlanır.

Ayrıntılar
Parametreler
[in] aIterator
Başlatmak için yinelemenin işaretçisi (BOŞ OLMAMALIDIR).

otHistoryTrackerIterateExternalRouteHistory

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

Bu işlev, Ağ Verileri harici rota giriş geçmişi listesindeki girişleri yineler.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği için bir işaretçi.
[in,out] aIterator
Yineleyiciye işaret eden bir işaret. Başlatılması ZORUNLU veya davranışın tanımlanmamış olması gerekir.
[out] aEntryAge
Girişin yaşını görüntülemek için bir değişkenin işaretçisi. BOŞ OLMAMALIDIR. Yaş, girişin kaydedildiği andan aIterator başlatma zamanına kadar geçen süre (milisaniye cinsinden) olarak belirtilir. Maksimum yaştan daha eski girişler için OT_HISTORY_TRACKER_MAX_AGE olarak ayarlanır.
İadeler
otHistoryTrackerExternalRouteInfo girişi veya listede başka giriş yoksa NULL.

otHistoryTrackerIterateMulticastAddressHistory

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

Bu işlev, çoklu yayın adres geçmişi listesindeki girişler üzerinde yineleme yapar.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği için bir işaretçi.
[in,out] aIterator
Yineleyiciye işaret eden bir işaret. Başlatılması ZORUNLU veya davranışın tanımlanmamış olması gerekir.
[out] aEntryAge
Girişin yaşını görüntülemek için bir değişkenin işaretçisi. BOŞ OLMAMALIDIR. Yaş, girişin kaydedildiği andan aIterator başlatma zamanına kadar geçen süre (milisaniye cinsinden) olarak belirtilir. Maksimum yaştan daha eski girişler için OT_HISTORY_TRACKER_MAX_AGE olarak ayarlanır.
İadeler
otHistoryTrackerMulticastAddressInfo girişinin veya listedeki başka giriş yoksa NULL öğesinin işaretçisi.

otHistoryTrackerIterateNeighborHistory

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

Bu işlev, komşu geçmiş listesindeki girişler için yineleme oluşturur.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği için bir işaretçi.
[in,out] aIterator
Yineleyiciye işaret eden bir işaret. Başlatılması ZORUNLU veya davranışın tanımlanmamış olması gerekir.
[out] aEntryAge
Girişin yaşını görüntülemek için bir değişkenin işaretçisi. BOŞ OLMAMALIDIR. Yaş, girişin kaydedildiği andan aIterator başlatma zamanına kadar geçen süre (milisaniye cinsinden) olarak belirtilir. Maksimum yaştan daha eski girişler için OT_HISTORY_TRACKER_MAX_AGE olarak ayarlanır.
İadeler
otHistoryTrackerNeighborInfo girişi veya listede başka giriş yoksa NULL.

otHistoryTrackerIterateNetInfoHistory

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

Bu işlev, ağ bilgileri geçmişi listesindeki girişler üzerinde yinelenir.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği için bir işaretçi.
[in,out] aIterator
Yineleyiciye işaret eden bir işaret. Başlatılması ZORUNLU veya davranışın tanımlanmamış olması gerekir.
[out] aEntryAge
Girişin yaşını görüntülemek için bir değişkenin işaretçisi. BOŞ OLMAMALIDIR. Yaş, girişin kaydedildiği andan aIterator başlatma zamanına kadar geçen süre (milisaniye cinsinden) olarak belirtilir. Maksimum yaştan daha eski girişler için OT_HISTORY_TRACKER_MAX_AGE olarak ayarlanır.
İadeler
otHistoryTrackerNetworkInfo girişinin veya listedeki başka giriş yoksa NULL öğesinin işaretçisi.

otHistoryTrackerIterateOnMeshPrefixHistory

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

Bu işlev, Örgü üzerinde ağ verisi giriş geçmişi listesindeki girişleri tekrarlar.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği için bir işaretçi.
[in,out] aIterator
Yineleyiciye işaret eden bir işaret. Başlatılması ZORUNLU veya davranışın tanımlanmamış olması gerekir.
[out] aEntryAge
Girişin yaşını görüntülemek için bir değişkenin işaretçisi. BOŞ OLMAMALIDIR. Yaş, girişin kaydedildiği andan aIterator başlatma zamanına kadar geçen süre (milisaniye cinsinden) olarak belirtilir. Maksimum yaştan daha eski girişler için OT_HISTORY_TRACKER_MAX_AGE olarak ayarlanır.
İadeler
otHistoryTrackerOnMeshPrefixInfo girişi veya listede başka giriş yoksa NULL.

IotHistoryTrackerIterateRxHistory

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

Bu işlev, RX ileti geçmişi listesindeki girişler üzerinde yinelenir.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği için bir işaretçi.
[in,out] aIterator
Yineleyiciye işaret eden bir işaret. Başlatılması ZORUNLU veya davranışın tanımlanmamış olması gerekir.
[out] aEntryAge
Girişin yaşını görüntülemek için bir değişkenin işaretçisi. BOŞ OLMAMALIDIR. Yaş, girişin kaydedildiği andan aIterator başlatma zamanına kadar geçen süre (milisaniye cinsinden) olarak belirtilir. Maksimum yaştan daha eski girişler için OT_HISTORY_TRACKER_MAX_AGE olarak ayarlanır.
İadeler
otHistoryTrackerMessageInfo girişi veya listede başka giriş yoksa NULL.

otGeçmiş İzleyici Tx Geçmişi

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

Bu işlev, TX ileti geçmişi listesindeki girişleri yineler.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği için bir işaretçi.
[in,out] aIterator
Yineleyiciye işaret eden bir işaret. Başlatılması ZORUNLU veya davranışın tanımlanmamış olması gerekir.
[out] aEntryAge
Girişin yaşını görüntülemek için bir değişkenin işaretçisi. BOŞ OLMAMALIDIR. Yaş, girişin kaydedildiği andan aIterator başlatma zamanına kadar geçen süre (milisaniye cinsinden) olarak belirtilir. Maksimum yaştan daha eski girişler için OT_HISTORY_TRACKER_MAX_AGE olarak ayarlanır.
İadeler
otHistoryTrackerMessageInfo girişi veya listede başka giriş yoksa NULL.

otHistoryTrackerIterateUnicastAddressHistory

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

Bu işlev, tek tip adres geçmişi listesindeki girişler üzerinde yineleme yapar.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği için bir işaretçi.
[in,out] aIterator
Yineleyiciye işaret eden bir işaret. Başlatılması ZORUNLU veya davranışın tanımlanmamış olması gerekir.
[out] aEntryAge
Girişin yaşını görüntülemek için bir değişkenin işaretçisi. BOŞ OLMAMALIDIR. Yaş, girişin kaydedildiği andan aIterator başlatma zamanına kadar geçen süre (milisaniye cinsinden) olarak belirtilir. Maksimum yaştan daha eski girişler için OT_HISTORY_TRACKER_MAX_AGE olarak ayarlanır.
İadeler
otHistoryTrackerUnicastAddressInfo girişinin veya listedeki başka giriş yoksa NULL öğesinin işaretçisi.

Makrolar

UD_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE

 OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21

Bir giriş yaşının dize gösterimi için önerilen boyut.

UD_HISTORY_TRACKER_MAX_AGE

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

Bu sabit, 49 günlük (milisaniye cinsinden) girişlerin maksimum yaşını belirtir.

Maksimum yaştan daha eski girişler bu değeri yaş olarak verir.

Kaynaklar

OpenThread API Referansı konuları, GitHub'da bulunan kaynak koddan gelmektedir. Daha fazla bilgi edinmek veya dokümanlarımıza katkıda bulunmak için Kaynaklar'a bakın.