Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Rastreador de historia

Resumen

Enumeraciones

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
}
enumeración
Constantes que representan la prioridad del mensaje usado en otHistoryTrackerMessageInfo struct.
otHistoryTrackerAddressEvent {
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0,
OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1
}
enumeración
Esta enumeración define los eventos para una información de dirección IPv6 (unidifusión o multidifusión) (es decir, si la dirección se agrega o se elimina).
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
}
enumeración
Esta enumeración define los eventos en la información de un vecino (es decir,

Typedefs

otHistoryTrackerIterator typedef
Este tipo representa un iterador para iterar a través de una lista histórica.
otHistoryTrackerMessageInfo typedef
Esta estructura representa la información de un mensaje RX / TX IPv6.
otHistoryTrackerMulticastAddressInfo typedef
Esta estructura representa una información de dirección de multidifusión IPv6.
otHistoryTrackerNeighborInfo typedef
Esta estructura representa la información de un vecino.
otHistoryTrackerNetworkInfo typedef
Esta estructura representa la información de la red Thread.
otHistoryTrackerUnicastAddressInfo typedef
Esta estructura representa una información de dirección IPv6 de unidifusión.

Funciones

otHistoryTrackerEntryAgeToString (uint32_t aEntryAge, char *aBuffer, uint16_t aSize)
void
Esta función convierte una edad de entrada determinada en una cadena legible por humanos.
otHistoryTrackerInitIterator ( otHistoryTrackerIterator *aIterator)
void
Esta función inicializa un otHistoryTrackerIterator .
otHistoryTrackerIterateMulticastAddressHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta función itera sobre las entradas en la lista del historial de direcciones de multidifusión.
otHistoryTrackerIterateNeighborHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta función itera sobre las entradas en la lista del historial de vecinos.
otHistoryTrackerIterateNetInfoHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta función itera sobre las entradas en la lista del historial de información de la red.
otHistoryTrackerIterateRxHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta función itera sobre las entradas en la lista del historial de mensajes RX.
otHistoryTrackerIterateTxHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta función itera sobre las entradas en la lista del historial de mensajes de TX.
otHistoryTrackerIterateUnicastAddressHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta función itera sobre las entradas en la lista del historial de direcciones de unidifusión.

Estructuras

otHistoryTrackerIterator

Este tipo representa un iterador para recorrer una lista histórica.

otHistoryTrackerMessageInfo

Esta estructura representa la información de un mensaje RX / TX IPv6.

otHistoryTrackerMulticastAddressInfo

Esta estructura representa una información de dirección de multidifusión IPv6.

otHistoryTrackerNeighborInfo

Esta estructura representa la información de un vecino.

otHistoryTrackerNetworkInfo

Esta estructura representa la información de la red Thread.

otHistoryTrackerUnicastAddressInfo

Esta estructura representa una información de dirección IPv6 de unidifusión.

Enumeraciones

enumeración anónima

 anonymous enum

Constantes que representan la prioridad del mensaje usado en otHistoryTrackerMessageInfo struct.

Propiedades
OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH

Nivel de alta prioridad.

OT_HISTORY_TRACKER_MSG_PRIORITY_LOW

Nivel de prioridad bajo.

OT_HISTORY_TRACKER_MSG_PRIORITY_NET

Nivel de prioridad de control de red.

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

Nivel de prioridad normal.

otHistoryTrackerAddressEvent

 otHistoryTrackerAddressEvent

Esta enumeración define los eventos para una información de dirección IPv6 (unidifusión o multidifusión) (es decir, si la dirección se agrega o se elimina).

Propiedades
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

Se agrega la dirección.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

Se elimina la dirección.

otHistoryTrackerNeighborEvent

 otHistoryTrackerNeighborEvent

Esta enumeración define los eventos en la información de un vecino (es decir,

si el vecino se agrega, quita o cambia).

Evento OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING es aplicable sólo a los vecinos del niño. Se activa después de que el dispositivo (re) inicia y cuando la lista de niños anterior se recupera de la configuración no volátil y el dispositivo intenta restaurar la conexión con ellos.

Propiedades
OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED

Se agrega vecino.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED

Vecino cambiado (por ejemplo, banderas de modo de dispositivo cambiadas).

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED

Vecino se elimina.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

Se está restaurando el vecino (solo para niños).

Typedefs

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

Este tipo representa un iterador para iterar a través de una lista histórica.

Los campos de este tipo son opacos (destinados a ser utilizados por el núcleo de OpenThread) y, por lo tanto, la persona que llama no debe acceder a ellos ni utilizarlos.

Antes de utilizar un iterador, que deberá ser inicializado usando otHistoryTrackerInitIterator() ,

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

Esta estructura representa la información de un mensaje RX / TX IPv6.

Algunos de los campos de esta estructura son aplicables a un mensaje RX o sólo un mensaje de TX, por ejemplo, mAveRxRss es el RSS promedio de todos los marcos de fragmentos que forman un mensaje recibido y sólo se aplica a un mensaje RX.

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

Esta estructura representa una información de dirección de multidifusión IPv6.

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

Esta estructura representa la información de un vecino.

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

Esta estructura representa la información de la red Thread.

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

Esta estructura representa una información de dirección IPv6 de unidifusión.

Funciones

otHistoryTrackerEntryAgeToString

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

Esta función convierte una edad de entrada determinada en una cadena legible por humanos.

La cadena de edad de la entrada sigue el formato " : : . "por horas, minutos, segundos y milisegundos (si es menos de un día) o"

dias : : . "(si es más de un día).

Si la cadena resultante no encaja en aBuffer (dentro de sus aSize caracteres), se truncará la cadena pero la cadena emite siempre es terminada en nulo.

Detalles
Parámetros
[in] aEntryAge
La edad de entrada (duración en mseg).
[out] aBuffer
Un puntero a una matriz de caracteres para generar la cadena (NO DEBE ser NULL).
[in] aSize
El tamaño de aBuffer . Recomienda el uso de OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE .

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

Esta función inicializa un otHistoryTrackerIterator .

Un iterador DEBE inicializarse antes de ser utilizado.

Un iterador se puede inicializar nuevamente para comenzar desde el principio de la lista.

Al iterar sobre las entradas en una lista, para garantizar que las edades de entrada sean consistentes, la edad se da en relación con el momento en que se inicializó el iterador, es decir, la edad de entrada se proporciona como la duración (en milisegundos) del evento (cuando la entrada fue registrado) al tiempo de inicialización del iterador.

Detalles
Parámetros
[in] aIterator
Un puntero al iterador para inicializar (NO DEBE ser NULO).

otHistoryTrackerIterateMulticastAddressHistory

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

Esta función itera sobre las entradas en la lista del historial de direcciones de multidifusión.

Detalles
Parámetros
[in] aInstance
Un puntero a la instancia de OpenThread.
[in,out] aIterator
Un puntero a un iterador. DEBE inicializarse o el comportamiento no está definido.
[out] aEntryAge
Un puntero a una variable para generar la edad de la entrada. No debe ser nulo. Edad se proporciona como la duración (en milisegundos) de cuando la entrada se registró a aIterator tiempo de inicialización. Se fija para OT_HISTORY_TRACKER_MAX_AGE para las entradas mayores de edad como máximo.
Devoluciones
Un puntero a otHistoryTrackerMulticastAddressInfo entrada o NULL si no hay más entradas en la lista.

otHistoryTrackerIterateNeighborHistory

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

Esta función itera sobre las entradas en la lista del historial de vecinos.

Detalles
Parámetros
[in] aInstance
Un puntero a la instancia de OpenThread.
[in,out] aIterator
Un puntero a un iterador. DEBE inicializarse o el comportamiento no está definido.
[out] aEntryAge
Un puntero a una variable para generar la edad de la entrada. No debe ser nulo. Edad se proporciona como la duración (en milisegundos) de cuando la entrada se registró a aIterator tiempo de inicialización. Se fija para OT_HISTORY_TRACKER_MAX_AGE para las entradas mayores de edad como máximo.
Devoluciones
El otHistoryTrackerNeighborInfo entrada o NULL si no hay más entradas en la lista.

otHistoryTrackerIterateNetInfoHistory

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

Esta función itera sobre las entradas en la lista del historial de información de la red.

Detalles
Parámetros
[in] aInstance
Un puntero a la instancia de OpenThread.
[in,out] aIterator
Un puntero a un iterador. DEBE inicializarse o el comportamiento no está definido.
[out] aEntryAge
Un puntero a una variable para generar la edad de la entrada. No debe ser nulo. Edad se proporciona como la duración (en milisegundos) de cuando la entrada se registró a aIterator tiempo de inicialización. Se fija para OT_HISTORY_TRACKER_MAX_AGE para las entradas mayores de edad como máximo.
Devoluciones
Un puntero a otHistoryTrackerNetworkInfo entrada o NULL si no hay más entradas en la lista.

otHistoryTrackerIterateRxHistory

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

Esta función itera sobre las entradas en la lista del historial de mensajes RX.

Detalles
Parámetros
[in] aInstance
Un puntero a la instancia de OpenThread.
[in,out] aIterator
Un puntero a un iterador. DEBE inicializarse o el comportamiento no está definido.
[out] aEntryAge
Un puntero a una variable para generar la edad de la entrada. No debe ser nulo. Edad se proporciona como la duración (en milisegundos) de cuando la entrada se registró a aIterator tiempo de inicialización. Se fija para OT_HISTORY_TRACKER_MAX_AGE para las entradas mayores de edad como máximo.
Devoluciones
El otHistoryTrackerMessageInfo entrada o NULL si no hay más entradas en la lista.

otHistoryTrackerIterateTxHistory

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

Esta función itera sobre las entradas en la lista del historial de mensajes de TX.

Detalles
Parámetros
[in] aInstance
Un puntero a la instancia de OpenThread.
[in,out] aIterator
Un puntero a un iterador. DEBE inicializarse o el comportamiento no está definido.
[out] aEntryAge
Un puntero a una variable para generar la edad de la entrada. No debe ser nulo. Edad se proporciona como la duración (en milisegundos) de cuando la entrada se registró a aIterator tiempo de inicialización. Se fija para OT_HISTORY_TRACKER_MAX_AGE para las entradas mayores de edad como máximo.
Devoluciones
El otHistoryTrackerMessageInfo entrada o NULL si no hay más entradas en la lista.

otHistoryTrackerIterateUnicastAddressHistory

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

Esta función itera sobre las entradas en la lista del historial de direcciones de unidifusión.

Detalles
Parámetros
[in] aInstance
Un puntero a la instancia de OpenThread.
[in,out] aIterator
Un puntero a un iterador. DEBE inicializarse o el comportamiento no está definido.
[out] aEntryAge
Un puntero a una variable para generar la edad de la entrada. No debe ser nulo. Edad se proporciona como la duración (en milisegundos) de cuando la entrada se registró a aIterator tiempo de inicialización. Se fija para OT_HISTORY_TRACKER_MAX_AGE para las entradas mayores de edad como máximo.
Devoluciones
Un puntero a otHistoryTrackerUnicastAddressInfo entrada o NULL si no hay más entradas en la lista.

Macros

OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE

 OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21

Tamaño recomendado para la representación de cadenas de una edad de entrada.

OT_HISTORY_TRACKER_MAX_AGE

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

Este encabezado define la API pública para History Tracker.

El módulo History Tracker registra el historial de diferentes eventos (por ejemplo, mensajes RX y TX o cambios en la información de la red, etc.) a medida que opera la red Thread. Todas las entradas rastreadas tienen una marca de tiempo.

Las funciones de este módulo están disponibles cuando OPENTHREAD_CONFIG_HISTOR_TRACKER_ENABLE está habilitado. Esta constante especifica la antigüedad máxima de las entradas, que es de 49 días (en ms).

Las entradas que superen la edad máxima darán este valor como su edad.