Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Metriche di collegamento

Questo modulo include funzioni che controllano il protocollo Link Metrics.

Sommario

Enumerazioni

otLinkMetricsEnhAckFlags {
OT_LINK_METRICS_ENH_ACK_CLEAR = 0,
OT_LINK_METRICS_ENH_ACK_REGISTER = 1
}		 enum
Flag di ACK migliorato.
otLinkMetricsStatus enum
Valori di stato delle metriche di collegamento.

Typedef

otLinkMetricsEnhAckFlags typedef
Flag di ACK migliorato.
otLinkMetricsEnhAckProbingIeReportCallback )(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
Questo puntatore a funzione viene chiamato quando viene ricevuto Enh-ACK Probing IE.
otLinkMetricsMgmtResponseCallback )(const otIp6Address *aSource, uint8_t aStatus, void *aContext) typedef
void(*
Questo puntatore a funzione viene chiamato quando viene ricevuta una risposta di gestione delle metriche di collegamento.
otLinkMetricsReportCallback )(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, uint8_t aStatus, void *aContext) typedef
void(*
Questo puntatore a funzione viene chiamato quando viene ricevuto un rapporto sulle metriche di collegamento.
otLinkMetricsSeriesFlags typedef
Questa struttura rappresenta quali frame sono contabilizzati in una Forward Tracking Series.
otLinkMetricsStatus typedef
Valori di stato delle metriche di collegamento.
otLinkMetricsValues typedef
Questa struttura rappresenta il risultato (valore) per una query Link Metrics.

Funzioni

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 di collegamento MLE per configurare / cancellare un rilevamento basato su ACK avanzato.
otLinkMetricsConfigForwardTrackingSeries ( otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
Questa funzione invia una richiesta di gestione delle metriche di collegamento MLE per configurare / cancellare una serie di Forward Tracking.
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 interrogare le metriche di collegamento.
otLinkMetricsSendLinkProbe ( otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)
Questa funzione invia un messaggio MLE Link Probe.

Structs

otLinkMetricsSeriesFlags

Questa struttura rappresenta quali frame sono contabilizzati in una Forward Tracking Series.

otLinkMetricsValues

Questa struttura rappresenta il risultato (valore) per una query Link Metrics.

Enumerazioni

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Flag di ACK migliorato.

Questi vengono utilizzati nel rilevamento basato su ACK avanzato per indicare se registrare o cancellare il sondaggio.

Proprietà
OT_LINK_METRICS_ENH_ACK_CLEAR

Chiaro.

OT_LINK_METRICS_ENH_ACK_REGISTER

Registrati.

otLinkMetricsStatus

 otLinkMetricsStatus

Valori di stato delle metriche di collegamento.

Typedef

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Flag di ACK migliorato.

Questi vengono utilizzati nel rilevamento basato su ACK avanzato per indicare se registrare o cancellare il sondaggio.

otLinkMetricsEnhAckProbingIeReportCallback

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

Questo puntatore a funzione viene chiamato quando viene ricevuto Enh-ACK Probing IE.

Dettagli
Parametri
[in] aShortAddress
L'indirizzo breve Mac del soggetto indagato.
[in] aExtAddress
Un puntatore all'indirizzo esteso Mac del Soggetto in esame.
[in] aMetricsValues
Un puntatore ai valori Link Metrics ottenuti da IE.
[in] aContext
Un puntatore al contesto specifico dell'applicazione.

otLinkMetricsMgmtResponseCallback

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

Questo puntatore a funzione viene chiamato quando viene ricevuta una risposta di gestione delle metriche di collegamento.

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, uint8_t aStatus, void *aContext)

Questo puntatore a funzione viene chiamato quando viene ricevuto un rapporto sulle metriche di collegamento.

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

Questa struttura rappresenta quali frame sono contabilizzati in una Forward Tracking Series.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Valori di stato delle metriche di collegamento.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Questa struttura rappresenta il risultato (valore) per una query Link Metrics.

Funzioni

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 di collegamento MLE per configurare / cancellare un rilevamento basato su ACK avanzato.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aDestination
Un puntatore all'indirizzo di destinazione.
[in] aEnhAckFlags
Enh-ACK Flag per indicare se registrare o cancellare il sondaggio. 0 per cancellare e 1 per registrare. Altri valori sono riservati.
[in] aLinkMetricsFlags
Un puntatore a flag che specificano quali metriche interrogare. Dovrebbe essere NULL quando aEnhAckFlags è 0 .
[in] aCallback
Puntatore a una funzione che viene chiamata quando viene ricevuto un riconoscimento avanzato con metriche di collegamento.
[in] aCallbackContext
Un puntatore al contesto specifico dell'applicazione.
Valori restituiti
OT_ERROR_NONE
Messaggio di richiesta di gestione delle metriche di collegamento inviato con successo.
OT_ERROR_NO_BUFS
Buffer insufficienti per generare il messaggio MLE Link Metrics Management Request.
OT_ERROR_INVALID_ARGS
aEnhAckFlags non è un valore valido o aLinkMetricsFlags non è corretto.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination non è link-local o il prossimo non è stato trovato.
OT_ERROR_NOT_CAPABLE
Il prossimo non è un dispositivo Thread 1.2 e non supporta le metriche di collegamento.

otLinkMetricsConfigForwardTrackingSeries

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

Questa funzione invia una richiesta di gestione delle metriche di collegamento MLE per configurare / cancellare una serie di Forward Tracking.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aDestination
Un puntatore all'indirizzo di destinazione.
[in] aSeriesId
L'ID della serie con cui operare.
[in] aSeriesFlags
I flag di serie che specificano quali frame devono essere contabilizzati.
[in] aLinkMetricsFlags
Un puntatore a flag che specificano quali metriche interrogare. Dovrebbe essere NULL quando aSeriesFlags è 0 .
[in] aCallback
Puntatore a una funzione che viene chiamata quando viene ricevuta la risposta di Gestione metriche di collegamento.
[in] aCallbackContext
Un puntatore al contesto specifico dell'applicazione.
Valori restituiti
OT_ERROR_NONE
Inviato con successo un messaggio di richiesta di gestione delle metriche di collegamento.
OT_ERROR_NO_BUFS
Buffer insufficienti per generare il messaggio MLE Link Metrics Management Request.
OT_ERROR_INVALID_ARGS
aSeriesId non è compreso nell'intervallo valido.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination non è link-local o il prossimo non è stato trovato.
OT_ERROR_NOT_CAPABLE
Il prossimo non è un dispositivo Thread 1.2 e non supporta le metriche di collegamento.

otLinkMetricsQuery

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 interrogare le metriche di collegamento.

Potrebbe essere Single Probe o Forward Tracking Series.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aDestination
Un puntatore all'indirizzo di destinazione.
[in] aSeriesId
L'ID della serie su cui eseguire la query, 0 per Single Probe.
[in] aLinkMetricsFlags
Un puntatore a flag che specificano quali metriche interrogare.
[in] aCallback
Puntatore a una funzione che viene chiamata quando viene ricevuto il report Link Metrics.
[in] aCallbackContext
Un puntatore al contesto specifico dell'applicazione.
Valori restituiti
OT_ERROR_NONE
Inviato correttamente un messaggio di query sulle metriche di collegamento.
OT_ERROR_NO_BUFS
Buffer insufficienti per generare il messaggio di richiesta dati MLE.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination non è link-local o il prossimo non è stato trovato.
OT_ERROR_NOT_CAPABLE
Il prossimo non è un dispositivo Thread 1.2 e non supporta le metriche di collegamento.

otLinkMetricsSendLinkProbe

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

Questa funzione invia un messaggio MLE Link Probe.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aDestination
Un puntatore all'indirizzo di destinazione.
[in] aSeriesId
La serie ID [1, 254] a cui mira il messaggio di Probe.
[in] aLength
La lunghezza del payload dei dati in Link Probe TLV, 0, 64 .
Valori restituiti
OT_ERROR_NONE
Inviato con successo un messaggio Link Probe.
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 è link-local o il prossimo non è stato trovato.
OT_ERROR_NOT_CAPABLE
Il prossimo non è un dispositivo Thread 1.2 e non supporta le metriche di collegamento.