Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Tracker cronologia

Registra la cronologia di diversi eventi, ad esempio messaggi RX e TX o modifiche alle informazioni di rete.

Riepilogo

Tutte le voci monitorate hanno un timestamp.

Le funzioni in questo modulo sono disponibili quando OPENTHREAD_CONFIG_HISTOR_TRACKER_ENABLE è abilitato.

Enumerazioni

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
Costanti che rappresentano la priorità dei messaggi utilizzate nello schema otHistoryTrackerMessageInfo.
otHistoryTrackerAddressEvent{
  OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1
}
enum
Questa enumerazione definisce gli eventi per le informazioni di un indirizzo IPv6 (comunicatore o multicast), ovvero se l'indirizzo viene aggiunto o rimosso.
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
Questa enumerazione definisce gli eventi in un'informazione relativa al vicino, ovvero
otHistoryTrackerNetDataEvent{
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED = 0,
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED = 1
}
enum
Questa enumerazione definisce gli eventi per una voce di dati di rete, ad esempio se viene aggiunta o rimossa una voce.

Defdef

otHistoryTrackerExternalRouteInfo tipodef
Questa struttura rappresenta un dato di rete esterno dei dati di rete.
otHistoryTrackerIterator tipodef
Questo tipo rappresenta un iteratore per eseguire l'iterazione tramite un elenco della cronologia.
otHistoryTrackerMessageInfo tipodef
Questa struttura rappresenta un'informazione RX/TX IPv6 del messaggio.
otHistoryTrackerMulticastAddressInfo tipodef
Questa struttura rappresenta un indirizzo multicast IPv6.
otHistoryTrackerNeighborInfo tipodef
Questa struttura rappresenta un'informazione vicina.
otHistoryTrackerNetworkInfo tipodef
Questa struttura rappresenta le informazioni di rete di Thread.
otHistoryTrackerOnMeshPrefixInfo tipodef
Questa struttura rappresenta un dato di rete relativo alle informazioni del prefisso di mesh.
otHistoryTrackerUnicastAddressInfo tipodef
Questa struttura rappresenta un indirizzo unicast IPv6 dell'indirizzo.

Functions

otHistoryTrackerEntryAgeToString(uint32_t aEntryAge, char *aBuffer, uint16_t aSize)
void
Questa funzione converte una determinata età in una stringa leggibile.
otHistoryTrackerInitIterator(otHistoryTrackerIterator *aIterator)
void
Questa funzione inizializza un otHistoryTrackerIterator.
otHistoryTrackerIterateExternalRouteHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Questa funzione esegue l'iterazione delle voci nell'elenco di dati storici delle route esterne della rete.
otHistoryTrackerIterateMulticastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Questa funzione esegue l'iterazione delle voci nell'elenco della cronologia degli indirizzi multicast.
otHistoryTrackerIterateNeighborHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Questa funzione esegue l'iterazione delle voci nell'elenco della cronologia adiacente.
otHistoryTrackerIterateNetInfoHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Questa funzione esegue il iterazione delle voci nell'elenco della cronologia delle informazioni di rete.
otHistoryTrackerIterateOnMeshPrefixHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Questa funzione esegue un'iterazione delle voci nell'elenco Cronologia delle voci di dati di rete sul prefisso mesh.
otHistoryTrackerIterateRxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Questa funzione esegue un'iterazione sulle voci nell'elenco della cronologia dei messaggi RX.
otHistoryTrackerIterateTxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Questa funzione esegue un'iterazione sulle voci nell'elenco della cronologia dei messaggi TX.
otHistoryTrackerIterateUnicastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Questa funzione esegue un'iterazione delle voci nell'elenco della cronologia degli indirizzi unicast.

Strutture

otHistoryTrackerExternalRouteInfo

Questa struttura rappresenta un dato di rete esterno dei dati di rete.

otHistoryTrackerIterator

Questo tipo rappresenta un iteratore per eseguire l'iterazione tramite un elenco della cronologia.

otHistoryTrackerMessageInfo

Questa struttura rappresenta un'informazione RX/TX IPv6 del messaggio.

otHistoryTrackerMulticastAddressInfo

Questa struttura rappresenta un indirizzo multicast IPv6.

otHistoryTrackerNeighborInfo

Questa struttura rappresenta un'informazione vicina.

otHistoryTrackerNetworkInfo

Questa struttura rappresenta le informazioni di rete di Thread.

otHistoryTrackerOnMeshPrefixInfo

Questa struttura rappresenta un dato di rete relativo alle informazioni del prefisso di mesh.

otHistoryTrackerUnicastAddressInfo

Questa struttura rappresenta un indirizzo unicast IPv6 dell'indirizzo.

Enumerazioni

enumerazione anonima

 anonymous enum

Costanti che rappresentano la priorità dei messaggi utilizzate nello schema otHistoryTrackerMessageInfo.

Proprietà
OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH

Livello di priorità alto.

OT_HISTORY_TRACKER_MSG_PRIORITY_LOW

Livello di priorità basso.

OT_HISTORY_TRACKER_MSG_PRIORITY_NET

Livello di priorità del controllo di rete.

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

Livello di priorità normale.

otHistoryTrackerAddressEvent

 otHistoryTrackerAddressEvent

Questa enumerazione definisce gli eventi per le informazioni di un indirizzo IPv6 (comunicatore o multicast), ovvero se l'indirizzo viene aggiunto o rimosso.

Proprietà
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

Indirizzo aggiunto.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

L'indirizzo è stato rimosso.

otHistoryTrackerNeighborEvent

 otHistoryTrackerNeighborEvent

Questa enumerazione definisce gli eventi in un'informazione relativa al vicino, ovvero

se il vicino viene aggiunto, rimosso o modificato).

L'evento OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING è applicabile solo ai vicini di bambini. Viene attivato dopo che il dispositivo si è riavviato e quando l'elenco di bambini secondario precedente viene recuperato da impostazioni non volatili e il dispositivo prova a ripristinare la connessione.

Proprietà
OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED

Il vicino è stato aggiunto.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED

Vicino, invece (ad es. flag modalità dispositivo modificati).

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED

Il vicino è stato rimosso.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

È in corso il ripristino del vicino (applicabile solo ai bambini).

otHistoryTrackerNetDataEvent

 otHistoryTrackerNetDataEvent

Questa enumerazione definisce gli eventi per una voce di dati di rete, ad esempio se viene aggiunta o rimossa una voce.

Proprietà
OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED

Aggiunta voce di dati di rete.

OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED

Inserimento dati di rete rimosso.

Defdef

otHistoryTrackerExternalRouteInfo

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

Questa struttura rappresenta un dato di rete esterno dei dati di rete.

OtHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

Questo tipo rappresenta un iteratore per eseguire l'iterazione tramite un elenco della cronologia.

I campi di questo tipo sono opachi (il cui scopo è utilizzare il core OpenThread) pertanto il campo non deve essere accessibile o utilizzato dal chiamante.

Prima di utilizzare un iteratore, DEVE essere inizializzato utilizzando otHistoryTrackerInitIterator(),

Informazioni OtHistoryTrackerMessage

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

Questa struttura rappresenta un'informazione RX/TX IPv6 del messaggio.

Alcuni dei campi di questa struttura sono applicabili solo a un messaggio RX o a un messaggio TX, ad esempio mAveRxRss è il RSS medio di tutti i frame con frammenti che formano un messaggio ricevuto ed è applicabile solo per un messaggio RX.

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

Questa struttura rappresenta un indirizzo multicast IPv6.

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

Questa struttura rappresenta un'informazione vicina.

Informazioni OtHistoryTrackerNetwork

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

Questa struttura rappresenta le informazioni di rete di Thread.

otHistoryTrackerOnMeshPrefixInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

Questa struttura rappresenta un dato di rete relativo alle informazioni del prefisso di mesh.

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

Questa struttura rappresenta un indirizzo unicast IPv6 dell'indirizzo.

Functions

otHistoryTrackerEntryAgeToString

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

Questa funzione converte una determinata età in una stringa leggibile.

La stringa dell'età della voce segue il formato "::." per ore, minuti, secondi e millisecondi (se inferiore a un giorno) o "

giorni ::." (se superiore a un giorno).

Se la stringa risultante non rientra in aBuffer (entro i suoi caratteri aSize), la stringa viene troncata, ma la stringa restituita è sempre null-terminata.

Dettagli
Parametri
[in] aEntryAge
L'età della voce (durata in msec).
[out] aBuffer
Un puntatore a un array di caratteri per generare la stringa (DEVE NON essere NULL).
[in] aSize
La dimensione di aBuffer. Opzione consigliata di utilizzare OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE.

OtHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

Questa funzione inizializza un otHistoryTrackerIterator.

Un iteratore DEVE essere inizializzato prima di essere utilizzato.

Puoi ricominciare l'inizializzazione di un iteratore per ricominciare dall'inizio.

Durante l'iterazione delle voci di un elenco, per garantire che le voci siano coerenti, l'età viene fornita in relazione al momento in cui l'iteratore è stato inizializzato, ovvero l'età viene fornita come durata (in millisecondi) dall'evento (quando è stata registrata) all'ora di inizializzazione dell'iteratore.

Dettagli
Parametri
[in] aIterator
Un puntatore all'iteratore per inizializzare (NON DEVE essere NULL).

otHistoryTrackerIterateExternalRouteHistory

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

Questa funzione esegue l'iterazione delle voci nell'elenco di dati storici delle route esterne della rete.

Dettagli
Parametri
[in] aInstance
Un puntatore sull'istanza di OpenThread.
[in,out] aIterator
Un puntatore su un iteratore. DEVE essere inizializzato o il comportamento non è definito.
[out] aEntryAge
Un puntatore su una variabile per generare l'età della voce. NON DEVE essere NULL. L'età viene fornita come durata (in millisecondi) dalla data di registrazione della voce fino all'ora di inizializzazione di aIterator. È impostato su OT_HISTORY_TRACKER_MAX_AGE per le voci più vecchie dell'età massima.
Restituisce
La voce otHistoryTrackerExternalRouteInfo o NULL se non ci sono altre voci nell'elenco.

otHistoryTrackerIterateMulticastAddressHistory

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

Questa funzione esegue l'iterazione delle voci nell'elenco della cronologia degli indirizzi multicast.

Dettagli
Parametri
[in] aInstance
Un puntatore sull'istanza di OpenThread.
[in,out] aIterator
Un puntatore su un iteratore. DEVE essere inizializzato o il comportamento non è definito.
[out] aEntryAge
Un puntatore su una variabile per generare l'età della voce. NON DEVE essere NULL. L'età viene fornita come durata (in millisecondi) dalla data di registrazione della voce fino all'ora di inizializzazione di aIterator. È impostato su OT_HISTORY_TRACKER_MAX_AGE per le voci più vecchie dell'età massima.
Restituisce
Un puntatore su otHistoryTrackerMulticastAddressInfo voce o NULL se non sono presenti altre voci nell'elenco.

otHistoryTrackerIterateNeighborHistory

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

Questa funzione esegue l'iterazione delle voci nell'elenco della cronologia adiacente.

Dettagli
Parametri
[in] aInstance
Un puntatore sull'istanza di OpenThread.
[in,out] aIterator
Un puntatore su un iteratore. DEVE essere inizializzato o il comportamento non è definito.
[out] aEntryAge
Un puntatore su una variabile per generare l'età della voce. NON DEVE essere NULL. L'età viene fornita come durata (in millisecondi) dalla data di registrazione della voce fino all'ora di inizializzazione di aIterator. È impostato su OT_HISTORY_TRACKER_MAX_AGE per le voci più vecchie dell'età massima.
Restituisce
La voce otHistoryTrackerNeighborInfo o NULL se non ci sono altre voci nell'elenco.

otHistoryTrackerIterateNetInfoHistory

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

Questa funzione esegue il iterazione delle voci nell'elenco della cronologia delle informazioni di rete.

Dettagli
Parametri
[in] aInstance
Un puntatore sull'istanza di OpenThread.
[in,out] aIterator
Un puntatore su un iteratore. DEVE essere inizializzato o il comportamento non è definito.
[out] aEntryAge
Un puntatore su una variabile per generare l'età della voce. NON DEVE essere NULL. L'età viene fornita come durata (in millisecondi) dalla data di registrazione della voce fino all'ora di inizializzazione di aIterator. È impostato su OT_HISTORY_TRACKER_MAX_AGE per le voci più vecchie dell'età massima.
Restituisce
Un puntatore su otHistoryTrackerNetworkInfo voce o NULL se non sono presenti altre voci nell'elenco.

otHistoryTrackerIterateOnMeshPrefixHistory

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

Questa funzione esegue un'iterazione delle voci nell'elenco Cronologia delle voci di dati di rete sul prefisso mesh.

Dettagli
Parametri
[in] aInstance
Un puntatore sull'istanza di OpenThread.
[in,out] aIterator
Un puntatore su un iteratore. DEVE essere inizializzato o il comportamento non è definito.
[out] aEntryAge
Un puntatore su una variabile per generare l'età della voce. NON DEVE essere NULL. L'età viene fornita come durata (in millisecondi) dalla data di registrazione della voce fino all'ora di inizializzazione di aIterator. È impostato su OT_HISTORY_TRACKER_MAX_AGE per le voci più vecchie dell'età massima.
Restituisce
La voce otHistoryTrackerOnMeshPrefixInfo o NULL se non ci sono altre voci nell'elenco.

OtHistoryTrackerIterateRxCronologia

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

Questa funzione esegue un'iterazione sulle voci nell'elenco della cronologia dei messaggi RX.

Dettagli
Parametri
[in] aInstance
Un puntatore sull'istanza di OpenThread.
[in,out] aIterator
Un puntatore su un iteratore. DEVE essere inizializzato o il comportamento non è definito.
[out] aEntryAge
Un puntatore su una variabile per generare l'età della voce. NON DEVE essere NULL. L'età viene fornita come durata (in millisecondi) dalla data di registrazione della voce fino all'ora di inizializzazione di aIterator. È impostato su OT_HISTORY_TRACKER_MAX_AGE per le voci più vecchie dell'età massima.
Restituisce
La voce otHistoryTrackerMessageInfo o NULL se non ci sono altre voci nell'elenco.

OtHistoryTrackerIterateTxCronologia

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

Questa funzione esegue un'iterazione sulle voci nell'elenco della cronologia dei messaggi TX.

Dettagli
Parametri
[in] aInstance
Un puntatore sull'istanza di OpenThread.
[in,out] aIterator
Un puntatore su un iteratore. DEVE essere inizializzato o il comportamento non è definito.
[out] aEntryAge
Un puntatore su una variabile per generare l'età della voce. NON DEVE essere NULL. L'età viene fornita come durata (in millisecondi) dalla data di registrazione della voce fino all'ora di inizializzazione di aIterator. È impostato su OT_HISTORY_TRACKER_MAX_AGE per le voci più vecchie dell'età massima.
Restituisce
La voce otHistoryTrackerMessageInfo o NULL se non ci sono altre voci nell'elenco.

otHistoryTrackerIterateUnicastAddressHistory

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

Questa funzione esegue un'iterazione delle voci nell'elenco della cronologia degli indirizzi unicast.

Dettagli
Parametri
[in] aInstance
Un puntatore sull'istanza di OpenThread.
[in,out] aIterator
Un puntatore su un iteratore. DEVE essere inizializzato o il comportamento non è definito.
[out] aEntryAge
Un puntatore su una variabile per generare l'età della voce. NON DEVE essere NULL. L'età viene fornita come durata (in millisecondi) dalla data di registrazione della voce fino all'ora di inizializzazione di aIterator. È impostato su OT_HISTORY_TRACKER_MAX_AGE per le voci più vecchie dell'età massima.
Restituisce
Un puntatore su otHistoryTrackerUnicastAddressInfo voce o NULL se non sono presenti altre voci nell'elenco.

Macro

OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE

 OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21

Dimensioni consigliate per la rappresentazione della stringa di un'età della voce.

OT_HISTORY_TRACKER_MAX_AGE

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

Questa costante specifica l'età massima delle voci, pari a 49 giorni (in msec).

Le voci più grandi dell'età massima restituiranno questo valore come età.

Risorse

Gli argomenti di riferimento per l'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per ulteriori informazioni o per contribuire alla nostra documentazione, consulta la sezione Risorse.