O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Rastreador de História

Resumo

Enumerações

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
Constantes que representam prioridade da mensagem usada em otHistoryTrackerMessageInfo struct.
otHistoryTrackerAddressEvent {
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0,
OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1
}
enum
Essa enumeração define os eventos para informações de endereço IPv6 (unicast ou multicast) (ou seja, se o endereço é adicionado ou removido).
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
Esta enumeração define os eventos em uma informação do vizinho (ou seja,

Typedefs

otHistoryTrackerIterator typedef
Este tipo representa um iterador para iterar por meio de uma lista de histórico.
otHistoryTrackerMessageInfo typedef
Esta estrutura representa uma informação de mensagem RX / TX IPv6.
otHistoryTrackerMulticastAddressInfo typedef
Esta estrutura representa uma informação de endereço multicast IPv6.
otHistoryTrackerNeighborInfo typedef
Esta estrutura representa uma informação do vizinho.
otHistoryTrackerNetworkInfo typedef
Esta estrutura representa informações da rede Thread.
otHistoryTrackerUnicastAddressInfo typedef
Esta estrutura representa uma informação de endereço IPv6 unicast.

Funções

otHistoryTrackerEntryAgeToString (uint32_t aEntryAge, char *aBuffer, uint16_t aSize)
void
Esta função converte uma determinada idade de entrada em uma string legível por humanos.
otHistoryTrackerInitIterator ( otHistoryTrackerIterator *aIterator)
void
Essa função inicializa um otHistoryTrackerIterator .
otHistoryTrackerIterateMulticastAddressHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta função itera sobre as entradas na lista do histórico de endereços multicast.
otHistoryTrackerIterateNeighborHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta função itera sobre as entradas na lista de histórico de vizinhos.
otHistoryTrackerIterateNetInfoHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta função itera sobre as entradas na lista do histórico de informações da rede.
otHistoryTrackerIterateRxHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta função itera sobre as entradas na lista de histórico de mensagens RX.
otHistoryTrackerIterateTxHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta função itera sobre as entradas na lista de histórico de mensagens TX.
otHistoryTrackerIterateUnicastAddressHistory ( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Esta função itera sobre as entradas na lista de histórico de endereços unicast.

Structs

otHistoryTrackerIterator

Este tipo representa um iterador para iterar por meio de uma lista de histórico.

otHistoryTrackerMessageInfo

Esta estrutura representa uma informação da mensagem RX / TX IPv6.

otHistoryTrackerMulticastAddressInfo

Esta estrutura representa uma informação de endereço multicast IPv6.

otHistoryTrackerNeighborInfo

Esta estrutura representa uma informação do vizinho.

otHistoryTrackerNetworkInfo

Esta estrutura representa informações da rede Thread.

otHistoryTrackerUnicastAddressInfo

Esta estrutura representa uma informação de endereço IPv6 unicast.

Enumerações

enum anônimo

 anonymous enum

Constantes que representam prioridade da mensagem usada em otHistoryTrackerMessageInfo struct.

Propriedades
OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH

Nível de alta prioridade.

OT_HISTORY_TRACKER_MSG_PRIORITY_LOW

Nível de baixa prioridade.

OT_HISTORY_TRACKER_MSG_PRIORITY_NET

Nível de prioridade do controle de rede.

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

Nível de prioridade normal.

otHistoryTrackerAddressEvent

 otHistoryTrackerAddressEvent

Essa enumeração define os eventos para informações de endereço IPv6 (unicast ou multicast) (ou seja, se o endereço é adicionado ou removido).

Propriedades
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

O endereço é adicionado.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

O endereço foi removido.

otHistoryTrackerNeighborEvent

 otHistoryTrackerNeighborEvent

Esta enumeração define os eventos em uma informação do vizinho (ou seja,

se vizinho é adicionado, removido ou alterado).

Evento OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING é aplicável apenas vizinhos criança. É acionado depois que o dispositivo (re) inicia e quando a lista de filhos anteriores é recuperada das configurações não voláteis e o dispositivo tenta restaurar a conexão com eles.

Propriedades
OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED

O vizinho é adicionado.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED

Vizinho alterado (por exemplo, sinalizadores de modo de dispositivo alterados).

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED

O vizinho é removido.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

O vizinho está sendo restaurado (aplicável apenas a crianças).

Typedefs

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

Este tipo representa um iterador para iterar por meio de uma lista de histórico.

Os campos neste tipo são opacos (destinados ao uso pelo núcleo OpenThread) e, portanto, não devem ser acessados ​​/ usados ​​pelo chamador.

Antes de usar um iterador, ele deve ser inicializado usando otHistoryTrackerInitIterator() ,

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

Esta estrutura representa uma informação de mensagem RX / TX IPv6.

Alguns dos campos nesta estrutura são aplicáveis a uma mensagem de RX ou apenas uma mensagem de TX, por exemplo, mAveRxRss é o RSS média de todos os quadros de fragmentos que formam uma mensagem recebida e só é aplicável para uma mensagem RX.

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

Esta estrutura representa uma informação de endereço multicast IPv6.

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

Esta estrutura representa uma informação do vizinho.

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

Esta estrutura representa informações da rede Thread.

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

Esta estrutura representa uma informação de endereço IPv6 unicast.

Funções

otHistoryTrackerEntryAgeToString

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

Esta função converte uma determinada idade de entrada em uma string legível por humanos.

A string de idade de entrada segue o formato " : : . "por horas, minutos, segundos e milissegundos (se inferior a um dia) ou"

dias : : . "(se mais de um dia).

Se a string resultante não se encaixa em aBuffer (dentro de seus aSize caracteres), o texto será truncado, mas a corda outputted é sempre terminada em null.

Detalhes
Parâmetros
[in] aEntryAge
A idade de entrada (duração em ms).
[out] aBuffer
Um ponteiro para uma matriz char para produzir a string (NÃO DEVE ser NULL).
[in] aSize
O tamanho do aBuffer . Recomendado o uso de OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE .

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

Essa função inicializa um otHistoryTrackerIterator .

Um iterador DEVE ser inicializado antes de ser usado.

Um iterador pode ser inicializado novamente para começar do início da lista.

Ao iterar sobre as entradas em uma lista, para garantir que as idades de entrada sejam consistentes, a idade é fornecida em relação à hora em que o iterador foi inicializado, ou seja, a idade de entrada é fornecida como a duração (em milissegundos) do evento (quando a entrada foi registrado) para o tempo de inicialização do iterador.

Detalhes
Parâmetros
[in] aIterator
Um ponteiro para o iterador a ser inicializado (NÃO DEVE ser NULL).

otHistoryTrackerIterateMulticastAddressHistory

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

Esta função itera sobre as entradas na lista do histórico de endereços multicast.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para a instância OpenThread.
[in,out] aIterator
Um ponteiro para um iterador. DEVE ser inicializado ou o comportamento é indefinido.
[out] aEntryAge
Um ponteiro para uma variável para produzir a idade da entrada. Não deve ser nulo. Idade é fornecida como o tempo (em milissegundos) de entrada quando foi registado para aIterator tempo de inicialização. Ela é definida como OT_HISTORY_TRACKER_MAX_AGE para entradas mais velhos do que a idade máxima.
Devoluções
Um ponteiro para otHistoryTrackerMulticastAddressInfo entrada ou NULL se há mais entradas na lista.

otHistoryTrackerIterateNeighborHistory

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

Esta função itera sobre as entradas na lista de histórico de vizinhos.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para a instância OpenThread.
[in,out] aIterator
Um ponteiro para um iterador. DEVE ser inicializado ou o comportamento é indefinido.
[out] aEntryAge
Um ponteiro para uma variável para produzir a idade da entrada. Não deve ser nulo. Idade é fornecida como o tempo (em milissegundos) de entrada quando foi registado para aIterator tempo de inicialização. Ela é definida como OT_HISTORY_TRACKER_MAX_AGE para entradas mais velhos do que a idade máxima.
Devoluções
O otHistoryTrackerNeighborInfo entrada ou NULL se há mais entradas na lista.

otHistoryTrackerIterateNetInfoHistory

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

Esta função itera sobre as entradas na lista do histórico de informações da rede.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para a instância OpenThread.
[in,out] aIterator
Um ponteiro para um iterador. DEVE ser inicializado ou o comportamento é indefinido.
[out] aEntryAge
Um ponteiro para uma variável para produzir a idade da entrada. Não deve ser nulo. Idade é fornecida como o tempo (em milissegundos) de entrada quando foi registado para aIterator tempo de inicialização. Ela é definida como OT_HISTORY_TRACKER_MAX_AGE para entradas mais velhos do que a idade máxima.
Devoluções
Um ponteiro para otHistoryTrackerNetworkInfo entrada ou NULL se há mais entradas na lista.

otHistoryTrackerIterateRxHistory

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

Esta função itera sobre as entradas na lista de histórico de mensagens RX.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para a instância OpenThread.
[in,out] aIterator
Um ponteiro para um iterador. DEVE ser inicializado ou o comportamento é indefinido.
[out] aEntryAge
Um ponteiro para uma variável para produzir a idade da entrada. Não deve ser nulo. Idade é fornecida como o tempo (em milissegundos) de entrada quando foi registado para aIterator tempo de inicialização. Ela é definida como OT_HISTORY_TRACKER_MAX_AGE para entradas mais velhos do que a idade máxima.
Devoluções
O otHistoryTrackerMessageInfo entrada ou NULL se há mais entradas na lista.

otHistoryTrackerIterateTxHistory

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

Esta função itera sobre as entradas na lista de histórico de mensagens TX.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para a instância OpenThread.
[in,out] aIterator
Um ponteiro para um iterador. DEVE ser inicializado ou o comportamento é indefinido.
[out] aEntryAge
Um ponteiro para uma variável para produzir a idade da entrada. Não deve ser nulo. Idade é fornecida como o tempo (em milissegundos) de entrada quando foi registado para aIterator tempo de inicialização. Ela é definida como OT_HISTORY_TRACKER_MAX_AGE para entradas mais velhos do que a idade máxima.
Devoluções
O otHistoryTrackerMessageInfo entrada ou NULL se há mais entradas na lista.

otHistoryTrackerIterateUnicastAddressHistory

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

Esta função itera sobre as entradas na lista de histórico de endereços unicast.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para a instância OpenThread.
[in,out] aIterator
Um ponteiro para um iterador. DEVE ser inicializado ou o comportamento é indefinido.
[out] aEntryAge
Um ponteiro para uma variável para produzir a idade da entrada. Não deve ser nulo. Idade é fornecida como o tempo (em milissegundos) de entrada quando foi registado para aIterator tempo de inicialização. Ela é definida como OT_HISTORY_TRACKER_MAX_AGE para entradas mais velhos do que a idade máxima.
Devoluções
Um ponteiro para otHistoryTrackerUnicastAddressInfo entrada ou NULL se há mais entradas na lista.

Macros

OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE

 OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21

Tamanho recomendado para representação de string de uma idade de entrada.

OT_HISTORY_TRACKER_MAX_AGE

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

Este cabeçalho define a API pública do History Tracker.

O módulo History Tracker registra o histórico de diferentes eventos (por exemplo, mensagens RX e TX ou alterações de informações da rede, etc.) conforme a rede Thread opera. Todas as entradas rastreadas são marcadas com data e hora.

As funções deste módulo estão disponíveis quando OPENTHREAD_CONFIG_HISTOR_TRACKER_ENABLE está habilitado. Esta constante especifica a idade máxima das entradas, que é 49 dias (em mseg).

As inscrições com mais de uma idade máxima darão esse valor como sua idade.