Se usó la API de Cloud Translation para traducir esta página.

Métricas del vínculo

Este módulo incluye funciones que controlan el protocolo de métricas de vínculos.

Resumen

Enumeraciones
`otLinkMetricsEnhAckFlags{ OT_LINK_METRICS_ENH_ACK_CLEAR = 0, OT_LINK_METRICS_ENH_ACK_REGISTER = 1 }`	Enum Marcas de ACK mejorado.
`otLinkMetricsStatus`	Enum Vincule los valores de estado de las métricas.

Typedefs
`otLinkMetricsEnhAckFlags`	typedef `enum otLinkMetricsEnhAckFlags` Marcas de ACK mejorado.
`otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress aExtAddress, const otLinkMetricsValues aMetricsValues, void *aContext)`	typedef `void(*` Se llama a este puntero de función cuando se recibe IE de sondeo de Enh.
`otLinkMetricsMgmtResponseCallback)(const otIp6Address aSource, uint8_t aStatus, void aContext)`	typedef `void(*` Se llama a este puntero de función cuando se recibe una respuesta de administración de métricas de vínculos.
`otLinkMetricsReportCallback)(const otIp6Address aSource, const otLinkMetricsValues aMetricsValues, uint8_t aStatus, void *aContext)`	typedef `void(*` Se llama a este puntero de función cuando se recibe un informe de métricas de vínculos.
`otLinkMetricsSeriesFlags`	typedef `struct otLinkMetricsSeriesFlags` Esta estructura representa los fotogramas que se incluyen en una serie Forward Tracking.
`otLinkMetricsStatus`	typedef `enum otLinkMetricsStatus` Vincule los valores de estado de las métricas.
`otLinkMetricsValues`	typedef `struct otLinkMetricsValues` Esta estructura representa el resultado (valor) para una consulta de métricas de vínculos.

Funciones
`otLinkMetricsConfigEnhAckProbing(otInstance aInstance, const otIp6Address aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)`	`otError` Esta función envía una solicitud de administración de métricas de vínculos de MLE para configurar o borrar un sondeo basado en ACK mejorado.
`otLinkMetricsConfigForwardTrackingSeries(otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void aCallbackContext)`	`otError` Envía una solicitud de administración de métricas de vínculo de MLE para configurar o borrar una serie de seguimiento de reenvío.
`otLinkMetricsQuery(otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, const otLinkMetrics aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void aCallbackContext)`	`otError` Esta función envía una solicitud de datos de MLE para consultar las métricas del vínculo.
`otLinkMetricsSendLinkProbe(otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, uint8_t aLength)`	`otError` Envía un mensaje del sondeo de vínculo de MLE.

Structs
otLinkMetricsSeriesFlags	Esta estructura representa los fotogramas que se incluyen en una serie Forward Tracking.
otLinkMetricsValues	Esta estructura representa el resultado (valor) para una consulta de métricas de vínculos.

Enumeraciones

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Marcas de ACK mejorado.

Estos se usan en el sondeo basado en ACK mejorado para indicar si se debe registrar o borrar el sondeo.

Propiedades
`OT_LINK_METRICS_ENH_ACK_CLEAR`	claro
`OT_LINK_METRICS_ENH_ACK_REGISTER`	Registrarse.

otLinkMetricsStatus

 otLinkMetricsStatus

Vincule los valores de estado de las métricas.

Typedefs

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Marcas de ACK mejorado.

Estos se usan en el sondeo basado en ACK mejorado para indicar si se debe registrar o borrar el sondeo.

otLinkMetricsEnhAckProbingIeReportCallback

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

Se llama a este puntero de función cuando se recibe IE de sondeo de Enh.

Detalles

Parámetros

`[in] aShortAddress`	La dirección corta del asunto del sondeo en Mac.
`[in] aExtAddress`	Un puntero para la dirección extendida de Mac del sujeto de sondeo.
`[in] aMetricsValues`	Un puntero para los valores de Métricas de vínculos obtenidos de IE.
`[in] aContext`	Un puntero al contexto específico de la aplicación.

otLinkMetricsMgmtResponseCallback

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

Se llama a este puntero de función cuando se recibe una respuesta de administración de métricas de vínculos.

Detalles

Parámetros

`[in] aSource`	Un puntero para la dirección de origen.
`[in] aStatus`	El código de estado en la respuesta
`[in] aContext`	Un puntero al contexto específico de la aplicación.

otLinkMetricsReportCallback

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

Se llama a este puntero de función cuando se recibe un informe de métricas de vínculos.

Detalles

Parámetros

`[in] aSource`	Un puntero para la dirección de origen.
`[in] aMetricsValues`	Un puntero para los valores de Métricas de vínculos (el resultado de la consulta).
`[in] aStatus`	El código de estado en el informe (solo es útil cuando `aMetricsValues` es NULO)
`[in] aContext`	Un puntero al contexto específico de la aplicación.

otLinkMetricsSeriesSeries

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

Esta estructura representa los fotogramas que se incluyen en una serie Forward Tracking.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Vincule los valores de estado de las métricas.

Valores otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Esta estructura representa el resultado (valor) para una consulta de métricas de vínculos.

Funciones

otLinkMetricsConfigEnhAckProbing

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

Esta función envía una solicitud de administración de métricas de vínculos de MLE para configurar o borrar un sondeo basado en ACK mejorado.

Esta funcionalidad requiere que la función OT_LINK_METRICS_INITIATOR esté habilitada.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aDestination`	Un puntero para la dirección de destino.
`[in] aEnhAckFlags`	Marcas de Enh-ACK para indicar si se debe registrar o borrar el sondeo. `0` para borrar y `1` para registrar. Otros valores están reservados.
`[in] aLinkMetricsFlags`	Un puntero para marcas que especifica qué métricas consultar. Debe ser `NULL` cuando `aEnhAckFlags` sea `0`.
`[in] aCallback`	Es un puntero a una función que se llama cuando se recibe una confirmación mejorada con métricas de vínculo.
`[in] aCallbackContext`	Un puntero al contexto específico de la aplicación.

Valores de retorno

`OT_ERROR_NONE`	Se envió correctamente un mensaje de solicitud de administración de métricas de vínculos.
`OT_ERROR_NO_BUFS`	Búferes insuficientes para generar el mensaje de solicitud de administración de métricas de vínculos de MLE.
`OT_ERROR_INVALID_ARGS`	`aEnhAckFlags` no es un valor válido o `aLinkMetricsFlags` no es correcto.
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination` no es un vínculo local o no se encuentra al vecino.
`OT_ERROR_NOT_CAPABLE`	El vecino no es un dispositivo Thread 1.2 y no admite métricas de vínculos.

otLinkMetricsConfigForwardTrackingSeries

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

Envía una solicitud de administración de métricas de vínculo de MLE para configurar o borrar una serie de seguimiento de reenvío.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aDestination`	Un puntero para la dirección de destino.
`[in] aSeriesId`	El ID de serie con el que se operará.
`[in] aSeriesFlags`	Las marcas de serie que especifican los marcos que se deben considerar.
`[in] aLinkMetricsFlags`	Un puntero para marcas que especifica qué métricas consultar. Debe ser `NULL` cuando `aSeriesFlags` sea `0`.
`[in] aCallback`	Un puntero para una función que se llama cuando se recibe la respuesta de administración de métricas de vínculos.
`[in] aCallbackContext`	Un puntero al contexto específico de la aplicación.

Valores de retorno

`OT_ERROR_NONE`	Se envió correctamente un mensaje de solicitud de administración de métricas de vínculos.
`OT_ERROR_NO_BUFS`	Búferes insuficientes para generar el mensaje de solicitud de administración de métricas de vínculos de MLE.
`OT_ERROR_INVALID_ARGS`	`aSeriesId` no está dentro del rango válido.
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination` no es un vínculo local o no se encuentra al vecino.
`OT_ERROR_NOT_CAPABLE`	El vecino no es un dispositivo Thread 1.2 y no admite métricas de vínculos.

otLinkMetricsQuery

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

Esta función envía una solicitud de datos de MLE para consultar las métricas del vínculo.

Podría ser una sola sonda o la serie de seguimiento de reenvío.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aDestination`	Un puntero para la dirección de destino.
`[in] aSeriesId`	El ID de serie sobre el que se debe consultar, 0 para un solo sondeo.
`[in] aLinkMetricsFlags`	Un puntero para marcas que especifica qué métricas consultar.
`[in] aCallback`	Un puntero para una función que se llama cuando se recibe el informe de métricas de vínculos.
`[in] aCallbackContext`	Un puntero al contexto específico de la aplicación.

Valores de retorno

`OT_ERROR_NONE`	Se envió correctamente un mensaje de consulta de las métricas del vínculo.
`OT_ERROR_NO_BUFS`	Búferes insuficientes para generar el mensaje de solicitud de datos de MLE.
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination` no es un vínculo local o no se encuentra al vecino.
`OT_ERROR_NOT_CAPABLE`	El vecino no es un dispositivo Thread 1.2 y no admite métricas de vínculos.

otLinkMetricsSendLinkProbe

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

Envía un mensaje del sondeo de vínculo de MLE.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aDestination`	Un puntero para la dirección de destino.
`[in] aSeriesId`	El ID de serie [1, 254] al que apunta el mensaje del sondeo.
`[in] aLength`	La longitud de la carga útil de datos en el TLV del sondeo de vínculo, 0, 64.

Valores de retorno

`OT_ERROR_NONE`	Se envió correctamente un mensaje de sondeo del vínculo.
`OT_ERROR_NO_BUFS`	Búferes insuficientes para generar el mensaje del sondeo del vínculo de MLE.
`OT_ERROR_INVALID_ARGS`	`aSeriesId` o `aLength` no se encuentran dentro del rango válido.
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination` no es un vínculo local o no se encuentra al vecino.
`OT_ERROR_NOT_CAPABLE`	El vecino no es un dispositivo Thread 1.2 y no admite métricas de vínculos.

Recursos

Los temas de referencia de la API de OpenThread se originan a partir del código fuente, disponible en GitHub. Para obtener más información o contribuir con nuestra documentación, consulta Recursos.

Métricas del vínculo

Resumen

Enumeraciones

Typedefs

Funciones

Structs

Enumeraciones

otLinkMetricsEnhAckFlags

otLinkMetricsStatus

Typedefs

otLinkMetricsEnhAckFlags

otLinkMetricsEnhAckProbingIeReportCallback

otLinkMetricsMgmtResponseCallback

otLinkMetricsReportCallback

otLinkMetricsSeriesSeries

otLinkMetricsStatus

Valores otLinkMetricsValues

Funciones

otLinkMetricsConfigEnhAckProbing

otLinkMetricsConfigForwardTrackingSeries

otLinkMetricsQuery

otLinkMetricsSendLinkProbe

Recursos