Linkmesswerte

Dieses Modul enthält Funktionen, die das Link Metrics-Protokoll steuern.

Zusammenfassung

Aufzählungen
otLinkMetricsEnhAckFlags{
  OT_LINK_METRICS_ENH_ACK_CLEAR = 0,
  OT_LINK_METRICS_ENH_ACK_REGISTER = 1
} 		enum
Erweiterte-ACK-Flags.
otLinkMetricsStatus enum
Statuswerte von Linkmesswerten.

Typdefekt
otLinkMetricsEnhAckFlags typedef
Erweiterte-ACK-Flags.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
Dieser Funktionszeiger wird aufgerufen, wenn Enh-ACK Probing IE empfangen wird.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, uint8_t aStatus, void *aContext) typedef
void(*
Dieser Funktionszeiger wird aufgerufen, wenn eine Link Metrics Management-Antwort empfangen wird.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, uint8_t aStatus, void *aContext) typedef
void(*
Dieser Funktionszeiger wird aufgerufen, wenn ein Bericht zu Linkmesswerten empfangen wird.
otLinkMetricsSeriesFlags typedef
Diese Struktur stellt dar, welche Frames in einer Forward Tracking Series berücksichtigt werden.
otLinkMetricsStatus typedef
Statuswerte von Linkmesswerten.
otLinkMetricsValues typedef
Diese Struktur stellt das Ergebnis (Wert) für eine Linkmesswert-Abfrage dar.

Funktionen
otLinkMetricsConfigEnhAckProbing(otInstance *aInstance, const otIp6Address *aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)
Diese Funktion sendet eine Anfrage zur Verwaltung der MLE-Linkmesswerte, um ein erweitertes Bestätigungs-Probing zu konfigurieren oder zu löschen.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
Mit dieser Funktion wird eine Anfrage zur Verwaltung der MLE-Link-Messwerte gesendet, um eine Forward Tracking Series zu konfigurieren oder zu löschen.
otLinkMetricsQuery(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void *aCallbackContext)
Diese Funktion sendet eine MLE-Datenanfrage zum Abfragen von Linkmesswerten.
otLinkMetricsSendLinkProbe(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)
Diese Funktion sendet eine MLE-Link-Prüfungs-Nachricht.

Bauwerke
otLinkMetricsSeriesFlags

Diese Struktur stellt dar, welche Frames in einer Forward Tracking Series berücksichtigt werden.

otLinkMetricsValues

Diese Struktur stellt das Ergebnis (Wert) für eine Linkmesswert-Abfrage dar.

Aufzählungen

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Erweiterte-ACK-Flags.

Sie werden für erweitertes Bestätigungs-Probing verwendet, um anzugeben, ob die Prüfung registriert oder gelöscht werden soll.

Attribute
OT_LINK_METRICS_ENH_ACK_CLEAR

Löschen.

OT_LINK_METRICS_ENH_ACK_REGISTER

Registrieren.

otLinkMetricsStatus

 otLinkMetricsStatus

Statuswerte von Linkmesswerten.

Typdefekt

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Erweiterte-ACK-Flags.

Sie werden für erweitertes Bestätigungs-Probing verwendet, um anzugeben, ob die Prüfung registriert oder gelöscht werden soll.

otLinkMetricsEnhAckProbingIeReportCallback

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

Dieser Funktionszeiger wird aufgerufen, wenn Enh-ACK Probing IE empfangen wird.

Details
Parameter
[in] aShortAddress
Die Mac-Kurzadresse des Prüfungsteilnehmers.
[in] aExtAddress
Ein Zeiger auf die erweiterte Adresse des Mac-Prüfungsgegenstands für Mac.
[in] aMetricsValues
Ein Zeiger auf die Link Metrics-Werte, die aus dem IE abgerufen wurden.
[in] aContext
Ein Zeiger auf anwendungsspezifischen Kontext.

otLinkMetricsMgmtResponseCallback

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

Dieser Funktionszeiger wird aufgerufen, wenn eine Link Metrics Management-Antwort empfangen wird.

Details
Parameter
[in] aSource
Ein Zeiger auf die Quelladresse.
[in] aStatus
Der Statuscode in der Antwort.
[in] aContext
Ein Zeiger auf anwendungsspezifischen Kontext.

otLinkMetricsReportCallback

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

Dieser Funktionszeiger wird aufgerufen, wenn ein Bericht zu Linkmesswerten empfangen wird.

Details
Parameter
[in] aSource
Ein Zeiger auf die Quelladresse.
[in] aMetricsValues
Ein Zeiger auf die Link-Messwertwerte (das Abfrageergebnis).
[in] aStatus
Der Statuscode im Bericht (nur nützlich, wenn aMetricsValues NULL ist).
[in] aContext
Ein Zeiger auf anwendungsspezifischen Kontext.

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

Diese Struktur stellt dar, welche Frames in einer Forward Tracking Series berücksichtigt werden.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Statuswerte von Linkmesswerten.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Diese Struktur stellt das Ergebnis (Wert) für eine Linkmesswert-Abfrage dar.

Funktionen

otLinkMetricsConfigEnhAckProbing

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

Diese Funktion sendet eine Anfrage zur Verwaltung der MLE-Linkmesswerte, um ein erweitertes Bestätigungs-Probing zu konfigurieren oder zu löschen.

Für diese Funktion muss die Funktion OT_LINK_METRICS_INITIATOR aktiviert sein.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aDestination
Ein Zeiger auf die Zieladresse.
[in] aEnhAckFlags
Enh-ACK-Flags, die angeben, ob die Prüfung registriert oder die Prüfung gelöscht werden soll 0 zum Löschen und 1 für die Registrierung. Andere Werte sind reserviert.
[in] aLinkMetricsFlags
Ein Zeiger auf Flags zur Angabe, welche Messwerte abgefragt werden sollen. Muss NULL sein, wenn aEnhAckFlags 0 ist.
[in] aCallback
Ein Zeiger auf eine Funktion, die aufgerufen wird, wenn eine erweiterte Anfrage mit Link-Messwerten empfangen wird.
[in] aCallbackContext
Ein Zeiger auf anwendungsspezifischen Kontext.
Rückgabewerte
OT_ERROR_NONE
Eine Nachricht zur Verwaltung der Verknüpfungsmesswerte wurde gesendet.
OT_ERROR_NO_BUFS
Unzureichende Puffer, um die Nachricht zur Anfrage zur Verwaltung der MLE-Linkmesswerte zu generieren.
OT_ERROR_INVALID_ARGS
aEnhAckFlags ist kein gültiger Wert oder aLinkMetricsFlags ist nicht korrekt.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination ist kein Link-Local oder der Nachbar wurde nicht gefunden.
OT_ERROR_NOT_CAPABLE
Der Nachbar ist kein Thread 1.2-Gerät und unterstützt keine Linkmesswerte.

otLinkMetricsConfigForwardTrackingSeries

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

Mit dieser Funktion wird eine Anfrage zur Verwaltung der MLE-Link-Messwerte gesendet, um eine Forward Tracking Series zu konfigurieren oder zu löschen.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aDestination
Ein Zeiger auf die Zieladresse.
[in] aSeriesId
Die Serien-ID, mit der gearbeitet werden soll.
[in] aSeriesFlags
Die Zeitachsen-Flags, die angeben, welche Frames berücksichtigt werden sollen.
[in] aLinkMetricsFlags
Ein Zeiger auf Flags zur Angabe, welche Messwerte abgefragt werden sollen. Muss NULL sein, wenn aSeriesFlags 0 ist.
[in] aCallback
Ein Zeiger auf eine Funktion, die beim Empfang von Link-Messwert-Verwaltungsantworten aufgerufen wird.
[in] aCallbackContext
Ein Zeiger auf anwendungsspezifischen Kontext.
Rückgabewerte
OT_ERROR_NONE
Eine Nachricht zur Verwaltung der Verknüpfungsmesswerte wurde gesendet.
OT_ERROR_NO_BUFS
Unzureichende Puffer, um die Nachricht zur Anfrage zur Verwaltung der MLE-Linkmesswerte zu generieren.
OT_ERROR_INVALID_ARGS
aSeriesId liegt nicht im gültigen Bereich.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination ist kein Link-Local oder der Nachbar wurde nicht gefunden.
OT_ERROR_NOT_CAPABLE
Der Nachbar ist kein Thread 1.2-Gerät und unterstützt keine Linkmesswerte.

otLinkMetricsQuery

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

Diese Funktion sendet eine MLE-Datenanfrage zum Abfragen von Linkmesswerten.

Es kann sich dabei um eine einzelne Sonde oder eine Forward Tracking-Serie handeln.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aDestination
Ein Zeiger auf die Zieladresse.
[in] aSeriesId
Die Serien-ID, für die eine Abfrage durchgeführt werden soll: 0 für eine Prüfung
[in] aLinkMetricsFlags
Ein Zeiger auf Flags zur Angabe, welche Messwerte abgefragt werden sollen.
[in] aCallback
Ein Zeiger auf eine Funktion, die beim Empfang des Berichts "Linkmesswerte" aufgerufen wird.
[in] aCallbackContext
Ein Zeiger auf anwendungsspezifischen Kontext.
Rückgabewerte
OT_ERROR_NONE
Eine Abfragenachricht für Linkmesswerte wurde gesendet.
OT_ERROR_NO_BUFS
Unzureichende Puffer, um die MLE-Datenanfragenachricht zu generieren.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination ist kein Link-Local oder der Nachbar wurde nicht gefunden.
OT_ERROR_NOT_CAPABLE
Der Nachbar ist kein Thread 1.2-Gerät und unterstützt keine Linkmesswerte.

otLinkMetricsSendLinkProbe

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

Diese Funktion sendet eine MLE-Link-Prüfungs-Nachricht.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aDestination
Ein Zeiger auf die Zieladresse.
[in] aSeriesId
Die Serien-ID [1, 254], auf die die Probenachricht ausgerichtet ist.
[in] aLength
Länge der Datennutzlast in Link Probe TLV, 0, 64.
Rückgabewerte
OT_ERROR_NONE
Eine Nachricht zur Prüfung des Links wurde gesendet.
OT_ERROR_NO_BUFS
Unzureichende Puffer, um die Prüfung für die MLE-Linkprüfung zu generieren.
OT_ERROR_INVALID_ARGS
aSeriesId oder aLength liegt nicht im gültigen Bereich.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination ist kein Link-Local oder der Nachbar wurde nicht gefunden.
OT_ERROR_NOT_CAPABLE
Der Nachbar ist kein Thread 1.2-Gerät und unterstützt keine Linkmesswerte.

Ressourcen

Die OpenThread API-Referenzthemen stammen aus dem Quellcode, der auf GitHub verfügbar ist. Weitere Informationen und einen Beitrag zu unserer Dokumentation finden Sie unter Ressourcen.