Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Metriche link

Questo modulo include funzioni che controllano il protocollo delle metriche link.

Riepilogo

Enumerazioni
otLinkMetricsEnhAckFlags{
  OT_LINK_METRICS_ENH_ACK_CLEAR = 0,
  OT_LINK_METRICS_ENH_ACK_REGISTER = 1
} 		enum
Flag ACK ottimizzato.
otLinkMetricsStatus enum
Valori dello stato delle metriche del link.

Defin
otLinkMetricsEnhAckFlags Typedef
Flag ACK ottimizzato.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) Typedef
void(*
Il puntatore della funzione viene richiamato alla ricezione di Enh-ACK Probing IE.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, uint8_t aStatus, void *aContext) Typedef
void(*
Il puntatore di questa funzione viene richiamato quando si riceve una risposta di gestione delle metriche del link.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, uint8_t aStatus, void *aContext) Typedef
void(*
Il puntatore della funzione viene richiamato alla ricezione di un report Metriche link.
otLinkMetricsSeriesFlags Typedef
Questa struttura rappresenta i frame inclusi in una serie di forwarding.
otLinkMetricsStatus Typedef
Valori dello stato delle metriche del link.
otLinkMetricsValues Typedef
Questa struttura rappresenta il risultato (valore) di una query sulle metriche link.

Functions
otLinkMetricsConfigEnhAckProbing(otInstance *aInstance, const otIp6Address *aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)
Questa funzione invia una richiesta di gestione delle metriche del link MLE per configurare/cancellare un probing basato su ACK avanzato.
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 del link MLE per configurare o cancellare una serie di forwarding.
otLinkMetricsQuery(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void *aCallbackContext)
Questa funzione invia una richiesta di dati MLE per eseguire query sulle metriche link.
otLinkMetricsSendLinkProbe(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)
Invia un messaggio del probe di MLE.

Struttura
OtLinkMetricsSeriesFlags

Questa struttura rappresenta i frame inclusi in una serie di forwarding.

otLinkMetricsValues

Questa struttura rappresenta il risultato (valore) di una query sulle metriche link.

Enumerazioni

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Flag ACK ottimizzato.

che vengono utilizzati nel probing basato 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 dello stato delle metriche del link.

Defin

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Flag ACK ottimizzato.

che vengono utilizzati nel probing basato 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 della funzione viene richiamato alla ricezione di Enh-ACK Probing IE.

Dettagli
Parametri
[in] aShortAddress
L'indirizzo breve Mac dell'oggetto del probing.
[in] aExtAddress
Un puntatore all'indirizzo esteso Mac dell'oggetto del probing.
[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, uint8_t aStatus, void *aContext)

Il puntatore di questa funzione viene richiamato quando si riceve una risposta di gestione delle metriche del 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.

otLinkMetricsReportRichiama

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

Il puntatore della funzione viene richiamato alla ricezione di un report Metriche link.

Dettagli
Parametri
[in] aSource
Un puntatore all'indirizzo di origine.
[in] aMetricsValues
Un puntatore ai valori delle metriche 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.

otLinkMetricsSeriesFlag

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

Questa struttura rappresenta i frame inclusi in una serie di forwarding.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Valori dello stato delle metriche del link.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Questa struttura rappresenta il risultato (valore) di una query sulle metriche link.

Functions

otLinkMetricsConfigEnhAckProbing

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

Questa funzione invia una richiesta di gestione delle metriche del link MLE per configurare/cancellare un probing 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
Flag Enh-ACK per indicare se registrare o cancellare il probe. 0 per cancellare e 1 per la registrazione. Gli altri valori sono riservati.
[in] aLinkMetricsFlags
Un puntatore a flag che specificano quali metriche eseguire la query. Deve essere NULL quando aEnhAckFlags è 0.
[in] aCallback
Un puntatore a una funzione chiamata quando si riceve un Ack ottimizzato 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 del link inviato correttamente.
OT_ERROR_NO_BUFS
Buffer insufficienti per generare il messaggio relativo alla richiesta di gestione delle metriche del link MLE.
OT_ERROR_INVALID_ARGS
aEnhAckFlags non è un valore valido oppure aLinkMetricsFlags non è corretto.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination non è locale nel link o 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 del link MLE per configurare o cancellare una serie di forwarding.

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 delle serie che specificano quali frame devono essere considerati.
[in] aLinkMetricsFlags
Un puntatore a flag che specificano quali metriche eseguire la query. Deve essere NULL quando aSeriesFlags è 0.
[in] aCallback
Un puntatore a una funzione denominata quando viene ricevuta la risposta Link Metrics Management.
[in] aCallbackContext
Un puntatore al contesto specifico dell'applicazione.
Valori restituiti
OT_ERROR_NONE
Messaggio di richiesta di gestione delle metriche del link inviato correttamente.
OT_ERROR_NO_BUFS
Buffer insufficienti per generare il messaggio relativo alla richiesta di gestione delle metriche del link MLE.
OT_ERROR_INVALID_ARGS
aSeriesId non rientra nell'intervallo valido.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination non è locale nel link o il vicino non è stato trovato.
OT_ERROR_NOT_CAPABLE
Il vicino non è un dispositivo Thread 1.2 e non supporta le metriche dei link.

Query otLinkMetrics

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

Questa funzione invia una richiesta di dati MLE per eseguire query sulle metriche link.

Può essere la serie di probe single o Forward Tracking Series.

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 probe singolo.
[in] aLinkMetricsFlags
Un puntatore a flag che specificano quali metriche eseguire la query.
[in] aCallback
Un puntatore a una funzione che viene chiamata alla ricezione del report Metriche link.
[in] aCallbackContext
Un puntatore al contesto specifico dell'applicazione.
Valori restituiti
OT_ERROR_NONE
Un messaggio di query sulle metriche link è stato inviato.
OT_ERROR_NO_BUFS
Buffer insufficienti per generare il messaggio Richiesta di dati MLE.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination non è locale nel link o 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 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 punta il messaggio del probe.
[in] aLength
La lunghezza del payload di dati in Link Probe TLV, 0, 64.
Valori restituiti
OT_ERROR_NONE
Il messaggio del probe di collegamento è stato inviato.
OT_ERROR_NO_BUFS
Buffer insufficienti per generare il messaggio del probe di MLE.
OT_ERROR_INVALID_ARGS
aSeriesId o aLength non è compreso nell'intervallo valido.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination non è locale nel link o 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 scoprire di più o per contribuire alla nostra documentazione, consulta le Risorse.