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

Métricas de link

Este módulo inclui funções que controlam o protocolo de métricas de links.

Resumo

Enumerações
otLinkMetricsEnhAckFlags{
  OT_LINK_METRICS_ENH_ACK_CLEAR = 0,
  OT_LINK_METRICS_ENH_ACK_REGISTER = 1
} 		tipo enumerado
Sinalizações ACK.
otLinkMetricsStatus tipo enumerado
Vincule os valores de status das métricas.

Typedefs
otLinkMetricsEnhAckFlags typedef
Sinalizações ACK.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
Esse ponteiro de função é chamado quando o Eh-ACK Probing IE é recebido.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, uint8_t aStatus, void *aContext) typedef
void(*
Esse ponteiro de função é chamado quando uma resposta de gerenciamento de métricas de links é recebida.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, uint8_t aStatus, void *aContext) typedef
void(*
Esse ponteiro de função é chamado quando um relatório de métricas de link é recebido.
otLinkMetricsSeriesFlags typedef
Essa estrutura representa quais frames são contabilizados em uma série de acompanhamento de encaminhamento.
otLinkMetricsStatus typedef
Vincule os valores de status das métricas.
otLinkMetricsValues typedef
Essa estrutura representa o resultado (valor) de uma consulta de métricas de links.

Functions
otLinkMetricsConfigEnhAckProbing(otInstance *aInstance, const otIp6Address *aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)
Essa função envia uma solicitação de gerenciamento de métricas do link do MLE para configurar/limpar uma sondagem baseada em ACK.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
Esta função envia uma solicitação de gerenciamento de métricas do link de MLE para configurar/limpar uma série de acompanhamento de encaminhamento.
otLinkMetricsQuery(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void *aCallbackContext)
Essa função envia uma solicitação de dados MLE para consultar as métricas de links.
otLinkMetricsSendLinkProbe(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)
Essa função envia uma mensagem de MLE Link Probe.

Estruturas
otLinkMetricsSeriesFlags (em inglês)

Essa estrutura representa quais frames são contabilizados em uma série de acompanhamento de encaminhamento.

otLinkMetricsValues (em inglês)

Essa estrutura representa o resultado (valor) de uma consulta de métricas de links.

Enumerações

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Sinalizações ACK.

Eles são usados na sondagem baseada em ACK aprimorada para indicar se precisam registrar ou limpar a sondagem.

Propriedades
OT_LINK_METRICS_ENH_ACK_CLEAR

Limpar.

OT_LINK_METRICS_ENH_ACK_REGISTER

Faça sua inscrição.

OtLinkMetricsStatus

 otLinkMetricsStatus

Vincule os valores de status das métricas.

Typedefs

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Sinalizações ACK.

Eles são usados na sondagem baseada em ACK aprimorada para indicar se precisam registrar ou limpar a sondagem.

OtLinkMetricsEnhAckProbingIeReportCallback

void(* otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext)

Esse ponteiro de função é chamado quando o Eh-ACK Probing IE é recebido.

Detalhes
Parâmetros
[in] aShortAddress
É o endereço curto do Mac do assunto de sondagem.
[in] aExtAddress
Um ponteiro para o endereço estendido do Mac do assunto da sondagem.
[in] aMetricsValues
Um ponteiro para os valores de métricas de links recebidos do IE.
[in] aContext
Um ponteiro para contexto específico do aplicativo.

OtLinkMetricsMgmtResponseCallback

void(* otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, uint8_t aStatus, void *aContext)

Esse ponteiro de função é chamado quando uma resposta de gerenciamento de métricas de links é recebida.

Detalhes
Parâmetros
[in] aSource
Um ponteiro para o endereço de origem.
[in] aStatus
Código de status na resposta.
[in] aContext
Um ponteiro para contexto específico do aplicativo.

OtLinkMetricsReportCallback

void(* otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, uint8_t aStatus, void *aContext)

Esse ponteiro de função é chamado quando um relatório de métricas de link é recebido.

Detalhes
Parâmetros
[in] aSource
Um ponteiro para o endereço de origem.
[in] aMetricsValues
Um ponteiro para os valores das métricas de links (o resultado da consulta).
[in] aStatus
O código de status no relatório (útil apenas quando aMetricsValues é NULL).
[in] aContext
Um ponteiro para contexto específico do aplicativo.

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

Essa estrutura representa quais frames são contabilizados em uma série de acompanhamento de encaminhamento.

OtLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Vincule os valores de status das métricas.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Essa estrutura representa o resultado (valor) de uma consulta de métricas de links.

Functions

OtLinkMetricsConfigEnhAckProbing

otError otLinkMetricsConfigEnhAckProbing(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  otLinkMetricsEnhAckFlags aEnhAckFlags,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsMgmtResponseCallback aCallback,
  void *aCallbackContext,
  otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback,
  void *aEnhAckCallbackContext
)

Essa função envia uma solicitação de gerenciamento de métricas do link do MLE para configurar/limpar uma sondagem baseada em ACK.

Esta funcionalidade requer o recurso OT_LINK_METRICS_INITIATOR ativado.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aDestination
Um ponteiro para o endereço de destino.
[in] aEnhAckFlags
Sinalizações de Enh-ACK que indicam se você quer registrar ou limpar a sondagem. 0 para limpar e 1 para se registrar. Outros valores são reservados.
[in] aLinkMetricsFlags
Um ponteiro para sinalizações que especificam quais métricas precisam ser consultadas. Precisa ser NULL quando aEnhAckFlags for 0.
[in] aCallback
Um ponteiro para uma função chamada quando uma confirmação otimizada com métricas de links é recebida.
[in] aCallbackContext
Um ponteiro para contexto específico do aplicativo.
Valores de retorno
OT_ERROR_NONE
A mensagem de solicitação de gerenciamento de métricas de links foi enviada.
OT_ERROR_NO_BUFS
Buffers insuficientes para gerar a mensagem de solicitação do gerenciamento de métricas da vinculação do MLE.
OT_ERROR_INVALID_ARGS
aEnhAckFlags não é um valor válido ou aLinkMetricsFlags está incorreto.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination não é link-local ou o vizinho não é encontrado.
OT_ERROR_NOT_CAPABLE
O vizinho não é um dispositivo Thread 1.2 e não é compatível com métricas de link.

OtLinkMetricsConfigForwardTrackingSeries

otError otLinkMetricsConfigForwardTrackingSeries(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  otLinkMetricsSeriesFlags aSeriesFlags,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsMgmtResponseCallback aCallback,
  void *aCallbackContext
)

Esta função envia uma solicitação de gerenciamento de métricas do link de MLE para configurar/limpar uma série de acompanhamento de encaminhamento.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aDestination
Um ponteiro para o endereço de destino.
[in] aSeriesId
O código da série com que operar.
[in] aSeriesFlags
Os sinalizadores de série que especificam quais frames devem ser contabilizados.
[in] aLinkMetricsFlags
Um ponteiro para sinalizações que especificam quais métricas precisam ser consultadas. Precisa ser NULL quando aSeriesFlags for 0.
[in] aCallback
Um ponteiro para uma função chamada quando a resposta de gerenciamento de métricas de links é recebida.
[in] aCallbackContext
Um ponteiro para contexto específico do aplicativo.
Valores de retorno
OT_ERROR_NONE
A mensagem de solicitação de gerenciamento de métricas de links foi enviada.
OT_ERROR_NO_BUFS
Buffers insuficientes para gerar a mensagem de solicitação do gerenciamento de métricas da vinculação do MLE.
OT_ERROR_INVALID_ARGS
aSeriesId não está dentro do intervalo válido.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination não é link-local ou o vizinho não é encontrado.
OT_ERROR_NOT_CAPABLE
O vizinho não é um dispositivo Thread 1.2 e não é compatível com métricas de link.

OtLinkMetricsQuery

otError otLinkMetricsQuery(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsReportCallback aCallback,
  void *aCallbackContext
)

Essa função envia uma solicitação de dados MLE para consultar as métricas de links.

Pode ser uma série de acompanhamento único ou de encaminhamento.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aDestination
Um ponteiro para o endereço de destino.
[in] aSeriesId
O ID da série a ser consultado, 0 para uma sondagem única.
[in] aLinkMetricsFlags
Um ponteiro para sinalizações que especificam quais métricas precisam ser consultadas.
[in] aCallback
Um ponteiro para uma função chamada quando o relatório de métricas de link é recebido.
[in] aCallbackContext
Um ponteiro para contexto específico do aplicativo.
Valores de retorno
OT_ERROR_NONE
Uma mensagem de consulta de métricas de link foi enviada.
OT_ERROR_NO_BUFS
Buffers insuficientes para gerar a mensagem de solicitação de dados MLE.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination não é link-local ou o vizinho não é encontrado.
OT_ERROR_NOT_CAPABLE
O vizinho não é um dispositivo Thread 1.2 e não é compatível com métricas de link.

OtLinkMetricsSendLinkProbe

otError otLinkMetricsSendLinkProbe(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  uint8_t aLength
)

Essa função envia uma mensagem de MLE Link Probe.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aDestination
Um ponteiro para o endereço de destino.
[in] aSeriesId
O código da série [1, 254] que a mensagem da Sonda aponta.
[in] aLength
O comprimento do payload de dados no TLV do Link Probe, 0, 64.
Valores de retorno
OT_ERROR_NONE
Uma mensagem de sondagem de link foi enviada.
OT_ERROR_NO_BUFS
Buffers insuficientes para gerar a mensagem de sondagem de link no MLE.
OT_ERROR_INVALID_ARGS
aSeriesId ou aLength não está dentro do intervalo válido.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination não é link-local ou o vizinho não é encontrado.
OT_ERROR_NOT_CAPABLE
O vizinho não é um dispositivo Thread 1.2 e não é compatível com métricas de link.

Recursos

Os tópicos de referência da API OpenThread são originados do código-fonte, disponível no GitHub. Para saber mais ou contribuir com nossa documentação, consulte Recursos.