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

Métricas de enlaces

Este módulo incluye funciones que controlan el protocolo Link Metrics.

Resumen

Enumeraciones
`otLinkMetricsEnhAckFlags { OT_LINK_METRICS_ENH_ACK_CLEAR = 0, OT_LINK_METRICS_ENH_ACK_REGISTER = 1 }`	enumeración Banderas de ACK mejorado.
`otLinkMetricsStatus`	enumeración Valores de estado de métricas de enlace.

Typedefs
`otLinkMetricsEnhAckFlags`	typedef `enum otLinkMetricsEnhAckFlags` Banderas de ACK mejorado.
`otLinkMetricsEnhAckProbingIeReportCallback )(otShortAddress aShortAddress, const otExtAddress aExtAddress, const otLinkMetricsValues aMetricsValues, void *aContext)`	typedef `void(*` Este puntero de función se llama cuando se recibe Enh-ACK Probing IE.
`otLinkMetricsMgmtResponseCallback )(const otIp6Address aSource, uint8_t aStatus, void aContext)`	typedef `void(*` Este puntero de función se llama cuando se recibe una respuesta de gestión de métricas de enlace.
`otLinkMetricsReportCallback )(const otIp6Address aSource, const otLinkMetricsValues aMetricsValues, uint8_t aStatus, void *aContext)`	typedef `void(*` Este puntero de función se llama cuando se recibe un informe de métricas de enlace.
`otLinkMetricsSeriesFlags`	typedef `struct otLinkMetricsSeriesFlags` Esta estructura representa qué tramas se contabilizan en una serie de seguimiento hacia adelante.
`otLinkMetricsStatus`	typedef `enum otLinkMetricsStatus` Valores de estado de métricas de enlace.
`otLinkMetricsValues`	typedef `struct otLinkMetricsValues` Esta estructura representa el resultado (valor) de una consulta de métricas de enlace.

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 gestión de métricas de enlace MLE para configurar / 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` Esta función envía una solicitud de gestión de métricas de enlace MLE para configurar / borrar una serie de seguimiento hacia adelante.
`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 MLE para consultar métricas de enlace.
`otLinkMetricsSendLinkProbe ( otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, uint8_t aLength)`	`otError` Esta función envía un mensaje de sonda de enlace MLE.

Estructuras
otLinkMetricsSeriesFlags	Esta estructura representa qué tramas se contabilizan en una serie de seguimiento hacia adelante.
otLinkMetricsValues	Esta estructura representa el resultado (valor) de una consulta de métricas de enlace.

Enumeraciones

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Banderas de ACK mejorado.

Se utilizan 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

Valores de estado de métricas de enlace.

Typedefs

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Banderas de ACK mejorado.

Se utilizan 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)

Este puntero de función se llama cuando se recibe Enh-ACK Probing IE.

Detalles

Parámetros

`[in] aShortAddress`	La dirección abreviada de Mac del sujeto de sondeo.
`[in] aExtAddress`	Un puntero a la dirección extendida de Mac del sujeto de sondeo.
`[in] aMetricsValues`	Un puntero a los valores de las métricas de enlace obtenidos del IE.
`[in] aContext`	Un puntero al contexto específico de la aplicación.

otLinkMetricsMgmtResponseCallback

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

Este puntero de función se llama cuando se recibe una respuesta de gestión de métricas de enlace.

Detalles

Parámetros

`[in] aSource`	Un puntero a 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)

Este puntero de función se llama cuando se recibe un informe de métricas de enlace.

Detalles

Parámetros

`[in] aSource`	Un puntero a la dirección de origen.
`[in] aMetricsValues`	Un puntero a los valores de las métricas de enlace (el resultado de la consulta).
`[in] aStatus`	El código de estado en el informe (sólo es útil cuando `aMetricsValues` es nulo).
`[in] aContext`	Un puntero al contexto específico de la aplicación.

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

Esta estructura representa qué tramas se contabilizan en una serie de seguimiento hacia adelante.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Valores de estado de métricas de enlace.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Esta estructura representa el resultado (valor) de una consulta de métricas de enlace.

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 gestión de métricas de enlace MLE para configurar / borrar un sondeo basado en ACK mejorado.

Esta funcionalidad requiere la función OT_LINK_METRICS_INITIATOR habilitada.

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aDestination`	Un puntero a la dirección de destino.
`[in] aEnhAckFlags`	Indicadores Enh-ACK para indicar si se registra o se borra el sondeo. `0` para borrar y `1` para registrarse. Otros valores están reservados.
`[in] aLinkMetricsFlags`	Un puntero a banderas que especifican qué métricas consultar. En caso de ser `NULL` cuando `aEnhAckFlags` es `0` .
`[in] aCallback`	Un puntero a una función que se llama cuando se recibe un reconocimiento mejorado con métricas de enlace.
`[in] aCallbackContext`	Un puntero al contexto específico de la aplicación.

Valores devueltos

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

otLinkMetricsConfigForwardTrackingSeries

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

Esta función envía una solicitud de gestión de métricas de enlace MLE para configurar / borrar una serie de seguimiento de reenvío.

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aDestination`	Un puntero a la dirección de destino.
`[in] aSeriesId`	El ID de serie con el que operar.
`[in] aSeriesFlags`	Las banderas de serie que especifican qué tramas deben contabilizarse.
`[in] aLinkMetricsFlags`	Un puntero a banderas que especifican qué métricas consultar. En caso de ser `NULL` cuando `aSeriesFlags` es `0` .
`[in] aCallback`	Un puntero a una función que se llama cuando se recibe la respuesta de gestión de métricas de enlace.
`[in] aCallbackContext`	Un puntero al contexto específico de la aplicación.

Valores devueltos

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

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 MLE para consultar métricas de enlace.

Puede ser una sola sonda o una serie de seguimiento hacia adelante.

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aDestination`	Un puntero a la dirección de destino.
`[in] aSeriesId`	El ID de serie sobre el que consultar, 0 para sonda única.
`[in] aLinkMetricsFlags`	Un puntero a banderas que especifican qué métricas consultar.
`[in] aCallback`	Un puntero a una función que se llama cuando se recibe el informe de métricas de enlace.
`[in] aCallbackContext`	Un puntero al contexto específico de la aplicación.

Valores devueltos

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

otLinkMetricsSendLinkProbe

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

Esta función envía un mensaje de sonda de enlace MLE.

Detalles

Parámetros

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

Valores devueltos

`OT_ERROR_NONE`	Se envió correctamente un mensaje de sonda de enlace.
`OT_ERROR_NO_BUFS`	Buffers insuficientes para generar el mensaje MLE Link Probe.
`OT_ERROR_INVALID_ARGS`	`aSeriesId` o `aLength` no está dentro del rango válido.
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination` no es local de enlace o no se encuentra el vecino.
`OT_ERROR_NOT_CAPABLE`	El vecino no es un dispositivo Thread 1.2 y no es compatible con las métricas de enlace.

Métricas de enlaces

Resumen

Enumeraciones

Typedefs

Funciones

Estructuras

Enumeraciones

otLinkMetricsEnhAckFlags

otLinkMetricsStatus

Typedefs

otLinkMetricsEnhAckFlags

otLinkMetricsEnhAckProbingIeReportCallback

otLinkMetricsMgmtResponseCallback

otLinkMetricsReportCallback

otLinkMetricsSeriesFlags

otLinkMetricsStatus

otLinkMetricsValues

Funciones

otLinkMetricsConfigEnhAckProbing

otLinkMetricsConfigForwardTrackingSeries

otLinkMetricsQuery

otLinkMetricsSendLinkProbe