Metriche dei link

Questo modulo include funzioni che controllano il protocollo Link Metrics.

Riepilogo

Enumerazioni
otLinkMetricsEnhAckFlags{   OT_LINK_METRICS_ENH_ACK_CLEAR = 0,   OT_LINK_METRICS_ENH_ACK_REGISTER = 1 }	enum Flag avanzati ACK.
otLinkMetricsStatus	enum Valori di stato delle metriche dei link.

Typedef
otLinkMetricsEnhAckFlags	typedef enum otLinkMetricsEnhAckFlags Flag avanzati ACK.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext)	typedef void(* Il puntatore viene chiamato alla ricezione di Enh-ACK Probing IE.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, otLinkMetricsStatus aStatus, void *aContext)	typedef void(* Il puntatore viene richiamato quando viene ricevuta una risposta di gestione delle metriche dei link.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, otLinkMetricsStatus aStatus, void *aContext)	typedef void(* Il puntatore viene richiamato quando viene ricevuto un report Metriche dei link.
otLinkMetricsSeriesFlags	typedef struct otLinkMetricsSeriesFlags Rappresenta i frame considerati in una serie di Forward Tracking.
otLinkMetricsStatus	typedef enum otLinkMetricsStatus Valori di stato delle metriche dei link.
otLinkMetricsValues	typedef struct otLinkMetricsValues Rappresenta il risultato (valore) per una query Metriche dei link.

Funzioni
otLinkMetricsConfigEnhAckProbing(otInstance *aInstance, const otIp6Address *aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)	otError Invia una richiesta di gestione delle metriche di link MLE per configurare/cancellare un probe basato su ACK avanzato.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)	otError Invia una richiesta di gestione delle metriche dei link MLE per configurare o cancellare una serie di tracciamento avanti.
otLinkMetricsManagerGetMetricsValueByExtAddr(otInstance *aInstance, const otExtAddress *aExtAddress, otLinkMetricsValues *aLinkMetricsValues)	otError Ottieni i dati delle metriche link di un vicino in base al suo indirizzo esteso.
otLinkMetricsManagerSetEnabled(otInstance *aInstance, bool aEnable)	void Abilita o disabilita Gestione metriche dei link.
otLinkMetricsQuery(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void *aCallbackContext)	otError Invia una richiesta di dati MLE per eseguire query sulle metriche di collegamento.
otLinkMetricsSendLinkProbe(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)	otError Invia un messaggio del probe di link MLE.

Strutture
otLinkMetricsSeriesFlags	Rappresenta i frame considerati in una serie di Forward Tracking.
otLinkMetricsValues	Rappresenta il risultato (valore) per una query Metriche dei link.

Enumerazioni

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Flag avanzati ACK.

Questi vengono utilizzati nei probe basati su ACK avanzato per indicare se registrare o cancellare il probe.

Proprietà
OT_LINK_METRICS_ENH_ACK_CLEAR	Chiaro.
OT_LINK_METRICS_ENH_ACK_REGISTER	Registrati.

otLinkMetricsStatus

 otLinkMetricsStatus

Valori di stato delle metriche dei link.

Typedef

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Flag avanzati ACK.

Questi vengono utilizzati nei probe basati su ACK avanzato per indicare se registrare o cancellare il probe.

otLinkMetricsEnhAckProbingIeReportCallback

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

Il puntatore viene chiamato alla ricezione di Enh-ACK Probing IE.

Dettagli
Parametri	[in] aShortAddress L'indirizzo breve Mac del soggetto esplorativo. [in] aExtAddress Un puntatore all'indirizzo esteso Mac del soggetto esplorativo. [in] aMetricsValues Un puntatore ai valori delle metriche dei link ottenuti da IE. [in] aContext Un puntatore al contesto specifico dell'applicazione.

otLinkMetricsMgmtResponseCallback

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

Il puntatore viene richiamato quando viene ricevuta una risposta di gestione delle metriche dei link.

Dettagli
Parametri	[in] aSource Un puntatore all'indirizzo di origine. [in] aStatus Il codice di stato nella risposta. [in] aContext Un puntatore al contesto specifico dell'applicazione.

otLinkMetricsReportCallback

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

Il puntatore viene richiamato quando viene ricevuto un report Metriche dei link.

Dettagli
Parametri	[in] aSource Un puntatore all'indirizzo di origine. [in] aMetricsValues Un puntatore ai valori Metriche dei link (il risultato della query). [in] aStatus Il codice di stato nel report (utile solo quando aMetricsValues è NULL). [in] aContext Un puntatore al contesto specifico dell'applicazione.

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

Rappresenta i frame considerati in una serie di Forward Tracking.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Valori di stato delle metriche dei link.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Rappresenta il risultato (valore) per una query Metriche dei link.

Funzioni

otLinkMetricsConfigEnhAckProbing

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

Invia una richiesta di gestione delle metriche di link MLE per configurare/cancellare un probe basato su ACK avanzato.

Questa funzionalità richiede l'attivazione della funzionalità OT_LINK_METRICS_INITIATOR.

Dettagli
Parametri	[in] aInstance Un puntatore a un'istanza OpenThread. [in] aDestination Un puntatore all'indirizzo di destinazione. [in] aEnhAckFlags Enh-ACK Flag per indicare se registrare o cancellare il probe. 0 per cancellare e 1 per registrarsi. Gli altri valori sono riservati. [in] aLinkMetricsFlags Un puntatore ai flag che specificano le metriche su cui eseguire la query. Deve essere NULL quando aEnhAckFlags è 0. [in] aCallback Un puntatore a una funzione che viene richiamata alla ricezione di un ACK avanzato con metriche sui link. [in] aCallbackContext Un puntatore al contesto specifico dell'applicazione.
Valori restituiti	OT_ERROR_NONE Messaggio di richiesta di gestione delle metriche dei link inviato correttamente. OT_ERROR_NO_BUFS Buffer insufficienti per generare il messaggio di richiesta di gestione delle metriche del link MLE. OT_ERROR_INVALID_ARGS aEnhAckFlags non è un valore valido o aLinkMetricsFlags non è corretto. OT_ERROR_UNKNOWN_NEIGHBOR aDestination non è locale rispetto al collegamento oppure il vicino non è stato trovato. OT_ERROR_NOT_CAPABLE Il vicino non è un dispositivo Thread 1.2 e non supporta le metriche dei link.

otLinkMetricsConfigForwardTrackingSeries

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

Invia una richiesta di gestione delle metriche dei link MLE per configurare o cancellare una serie di tracciamento avanti.

Dettagli
Parametri	[in] aInstance Un puntatore a un'istanza OpenThread. [in] aDestination Un puntatore all'indirizzo di destinazione. [in] aSeriesId L'ID serie con cui operare. [in] aSeriesFlags I flag serie che specificano i frame da considerare. [in] aLinkMetricsFlags Un puntatore ai flag che specificano le metriche su cui eseguire la query. Deve essere NULL quando aSeriesFlags è 0. [in] aCallback Un puntatore a una funzione che viene richiamata quando viene ricevuta la risposta della gestione delle metriche dei link. [in] aCallbackContext Un puntatore al contesto specifico dell'applicazione.
Valori restituiti	OT_ERROR_NONE Messaggio di richiesta di gestione delle metriche dei link inviato correttamente. OT_ERROR_NO_BUFS Buffer insufficienti per generare il messaggio di richiesta di gestione delle metriche del link MLE. OT_ERROR_INVALID_ARGS aSeriesId non è compreso nell'intervallo valido. OT_ERROR_UNKNOWN_NEIGHBOR aDestination non è locale rispetto al collegamento oppure il vicino non è stato trovato. OT_ERROR_NOT_CAPABLE Il vicino non è un dispositivo Thread 1.2 e non supporta le metriche dei link.

otLinkMetricsManagerGetMetricsValueByExtAddr

otError otLinkMetricsManagerGetMetricsValueByExtAddr(
  otInstance *aInstance,
  const otExtAddress *aExtAddress,
  otLinkMetricsValues *aLinkMetricsValues
)

Ottieni i dati delle metriche link di un vicino in base al suo indirizzo esteso.

Dettagli
Parametri	[in] aInstance Un puntatore a un'istanza OpenThread. [in] aExtAddress Un puntatore all'indirizzo esteso Mac del soggetto esplorativo. [out] aLinkMetricsValues Un puntatore ai valori Metriche dei link dell'oggetto.
Valori restituiti	OT_ERROR_NONE Dati delle metriche sui link recuperati correttamente. OT_ERROR_INVALID_ARGS Gli argomenti non sono validi. OT_ERROR_NOT_FOUND Non è stato trovato alcun vicino con l'indirizzo esteso specificato.

otLinkMetricsManagerSetEnabled

void otLinkMetricsManagerSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Abilita o disabilita Gestione metriche dei link.

Dettagli
Parametri	[in] aInstance Un puntatore a un'istanza OpenThread. [in] aEnable Un valore booleano che indica di attivare o disattivare.

otLinkMetricsQuery

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

Invia una richiesta di dati MLE per eseguire query sulle metriche di collegamento.

Può essere una serie di probe singolo o serie di tracciamento in avanti.

Dettagli
Parametri	[in] aInstance Un puntatore a un'istanza OpenThread. [in] aDestination Un puntatore all'indirizzo di destinazione. [in] aSeriesId L'ID serie su cui eseguire la query, 0 per singolo probe. [in] aLinkMetricsFlags Un puntatore ai flag che specificano le metriche su cui eseguire la query. [in] aCallback Un puntatore a una funzione che viene richiamata quando viene ricevuto il report Metriche dei link. [in] aCallbackContext Un puntatore al contesto specifico dell'applicazione.
Valori restituiti	OT_ERROR_NONE Messaggio della query relativo alle metriche dei link inviato correttamente. OT_ERROR_NO_BUFS Buffer insufficienti per generare il messaggio di richiesta dati MLE. OT_ERROR_UNKNOWN_NEIGHBOR aDestination non è locale rispetto al collegamento oppure il vicino non è stato trovato. OT_ERROR_NOT_CAPABLE Il vicino non è un dispositivo Thread 1.2 e non supporta le metriche dei link.

otLinkMetricsSendLinkProbe

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

Invia un messaggio del probe di link MLE.

Dettagli
Parametri	[in] aInstance Un puntatore a un'istanza OpenThread. [in] aDestination Un puntatore all'indirizzo di destinazione. [in] aSeriesId L'ID serie [1, 254] a cui mira il messaggio Probe. [in] aLength La lunghezza del payload dei dati in Link Probe TLV, 0, 64.
Valori restituiti	OT_ERROR_NONE Messaggio del probe di collegamento inviato correttamente. OT_ERROR_NO_BUFS Buffer insufficienti per generare il messaggio MLE Link Probe. OT_ERROR_INVALID_ARGS aSeriesId o aLength non è compreso nell'intervallo valido. OT_ERROR_UNKNOWN_NEIGHBOR aDestination non è locale rispetto al collegamento oppure il vicino non è stato trovato. OT_ERROR_NOT_CAPABLE Il vicino non è un dispositivo Thread 1.2 e non supporta le metriche dei link.

Risorse

Gli argomenti di riferimento dell'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per saperne di più o per contribuire alla nostra documentazione, consulta la sezione Risorse.