Linkmesswerte

Dieses Modul enthält Funktionen zur Steuerung des Protokolls für Linkmesswerte.

Zusammenfassung

Aufzählungen
otLinkMetricsEnhAckFlags{
  OT_LINK_METRICS_ENH_ACK_CLEAR = 0,
  OT_LINK_METRICS_ENH_ACK_REGISTER = 1
} 		enum
Optimierte ACK-Flags.
otLinkMetricsStatus enum
Werte für den Messwertstatus verknüpfen.

Typedefs
otLinkMetricsEnhAckFlags typedef
Optimierte ACK-Flags.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
Pointer wird aufgerufen, wenn Enh-ACK Probing IE empfangen wird.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, otLinkMetricsStatus aStatus, void *aContext) typedef
void(*
Der Pointer wird aufgerufen, wenn eine Antwort zur Verwaltung von Linkmesswerten empfangen wird.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, otLinkMetricsStatus aStatus, void *aContext) typedef
void(*
Der Mauszeiger wird beim Empfang eines Berichts zu Linkmesswerten aufgerufen.
otLinkMetricsSeriesFlags typedef
Gibt an, welche Frames in einer Forward-Tracking-Serie berücksichtigt werden.
otLinkMetricsStatus typedef
Werte für den Messwertstatus verknüpfen.
otLinkMetricsValues typedef
Stellt das Ergebnis (Wert) für eine Abfrage von Linkmesswerten dar.

Funktionen
otLinkMetricsConfigEnhAckProbing(otInstance *aInstance, const otIp6Address *aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)
Sendet eine MLE-Link-Messwertverwaltungsanfrage, um eine erweiterte ACK-basierte Prüfung zu konfigurieren/zu löschen.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
Sendet eine Anfrage zur MLE-Link-Messwertverwaltung, um eine Reihe von Vorwärtsverfolgungen zu konfigurieren oder zu löschen.
otLinkMetricsManagerGetMetricsValueByExtAddr(otInstance *aInstance, const otExtAddress *aExtAddress, otLinkMetricsValues *aLinkMetricsValues)
Linkmesswerte eines Nachbarn anhand seiner erweiterten Adresse abrufen.
otLinkMetricsManagerSetEnabled(otInstance *aInstance, bool aEnable)
void
Linkmesswert-Manager aktivieren oder deaktivieren.
otLinkMetricsQuery(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void *aCallbackContext)
Sendet eine MLE-Datenanfrage, um Linkmesswerte abzufragen.
otLinkMetricsSendLinkProbe(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)
Sendet eine MLE-Linkprüfung-Nachricht.

Strukturen
otLinkMetricsSeriesFlags

Gibt an, welche Frames in einer Forward-Tracking-Serie berücksichtigt werden.

otLinkMetricsValues

Stellt das Ergebnis (Wert) für eine Abfrage von Linkmesswerten dar.

Aufzählungen

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Optimierte ACK-Flags.

Diese werden in der erweiterten Bestätigungsprüfung verwendet, um anzugeben, ob die Prüfung registriert oder gelöscht werden soll.

Attribute
OT_LINK_METRICS_ENH_ACK_CLEAR

Gut verständlich.

OT_LINK_METRICS_ENH_ACK_REGISTER

Registrieren.

otLinkMetricsStatus

 otLinkMetricsStatus

Werte für den Messwertstatus verknüpfen.

Typedefs

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Optimierte ACK-Flags.

Diese werden in der erweiterten Bestätigungsprüfung 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)

Pointer wird aufgerufen, wenn Enh-ACK Probing IE empfangen wird.

Details
Parameter
[in] aShortAddress
Die Mac-Kurzadresse des Prüfungssubjekts.
[in] aExtAddress
Ein Zeiger auf die erweiterte Mac-Adresse des Prüfungssubjekts.
[in] aMetricsValues
Ein Zeiger auf die Link-Messwerte, die aus dem IE abgerufen wurden.
[in] aContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.

otLinkMetricsMgmtResponseCallback

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

Der Pointer wird aufgerufen, wenn eine Antwort zur Verwaltung von Linkmesswerten empfangen wird.

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

otLinkMetricsReportCallback

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

Der Mauszeiger wird beim Empfang eines Berichts zu Linkmesswerten aufgerufen.

Details
Parameter
[in] aSource
Ein Zeiger auf die Quelladresse.
[in] aMetricsValues
Ein Zeiger auf die Linkmesswerte (das Abfrageergebnis).
[in] aStatus
Statuscode im Bericht (nur hilfreich, wenn aMetricsValues NULL ist)
[in] aContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

Gibt an, welche Frames in einer Forward-Tracking-Serie berücksichtigt werden.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Werte für den Messwertstatus verknüpfen.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Stellt das Ergebnis (Wert) für eine Abfrage von Linkmesswerten dar.

Funktionen

otLinkMetricsConfigEnhAckProbing

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

Sendet eine MLE-Link-Messwertverwaltungsanfrage, um eine erweiterte ACK-basierte Prüfung zu konfigurieren/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 gelöscht werden soll. 0 zum Löschen und 1 zum Registrieren. Andere Werte sind reserviert.
[in] aLinkMetricsFlags
Ein Zeiger auf Flags, die angeben, welche Messwerte abgefragt werden sollen. Sollte NULL sein, wenn aEnhAckFlags gleich 0 ist.
[in] aCallback
Ein Zeiger auf eine Funktion, die aufgerufen wird, wenn eine erweiterte Bestätigung mit Linkmesswerten empfangen wird.
[in] aCallbackContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.
Rückgabewerte
OT_ERROR_NONE
Eine Anfragenachricht zur Verwaltung von Linkmesswerten wurde gesendet.
OT_ERROR_NO_BUFS
Nicht genügend Puffer, um die Anfragenachricht zur MLE-Link-Messwertverwaltung 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
)

Sendet eine Anfrage zur MLE-Link-Messwertverwaltung, um eine Reihe von Vorwärtsverfolgungen 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 Serien-Flags, die angeben, welche Frames berücksichtigt werden sollen.
[in] aLinkMetricsFlags
Ein Zeiger auf Flags, die angeben, welche Messwerte abgefragt werden sollen. Sollte NULL sein, wenn aSeriesFlags gleich 0 ist.
[in] aCallback
Ein Zeiger auf eine Funktion, die aufgerufen wird, wenn die Antwort zur Link-Messwertverwaltung empfangen wird.
[in] aCallbackContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.
Rückgabewerte
OT_ERROR_NONE
Eine Anfragenachricht zur Verwaltung von Linkmesswerten wurde gesendet.
OT_ERROR_NO_BUFS
Nicht genügend Puffer, um die Anfragenachricht zur MLE-Link-Messwertverwaltung 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.

otLinkMetricsManagerGetMetricsValueByExtAddr

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

Linkmesswerte eines Nachbarn anhand seiner erweiterten Adresse abrufen.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aExtAddress
Ein Zeiger auf die erweiterte Mac-Adresse des Prüfungssubjekts.
[out] aLinkMetricsValues
Ein Zeiger auf die Linkmesswerte des Themas.
Rückgabewerte
OT_ERROR_NONE
Die Link-Messwerte wurden abgerufen.
OT_ERROR_INVALID_ARGS
Die Argumente sind ungültig.
OT_ERROR_NOT_FOUND
Es wurde kein Nachbar mit der angegebenen erweiterten Adresse gefunden.

otLinkMetricsManagerSetEnabled

void otLinkMetricsManagerSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Linkmesswert-Manager aktivieren oder deaktivieren.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aEnable
Ein boolescher Wert, der zum Aktivieren oder Deaktivieren angibt.

otLinkMetricsQuery

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

Sendet eine MLE-Datenanfrage, um Linkmesswerte abzufragen.

Es kann sich entweder um eine einzelne Sonde oder um eine Vorwärtsverfolgungsreihe handeln.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aDestination
Ein Zeiger auf die Zieladresse.
[in] aSeriesId
Die Serien-ID, die abgefragt werden soll, 0 für eine Sonde.
[in] aLinkMetricsFlags
Ein Zeiger auf Flags, die angeben, welche Messwerte abgefragt werden sollen.
[in] aCallback
Ein Zeiger auf eine Funktion, die beim Empfang des Berichts zu Linkmesswerten aufgerufen wird.
[in] aCallbackContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.
Rückgabewerte
OT_ERROR_NONE
Eine Abfragenachricht für Linkmesswerte wurde gesendet.
OT_ERROR_NO_BUFS
Nicht genügend 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
)

Sendet eine MLE-Linkprüfung-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 sich die Sondenmeldung richtet.
[in] aLength
Die Länge der Datennutzlast in Link Probe TLV, 0, 64.
Rückgabewerte
OT_ERROR_NONE
Eine Linkprüfungsnachricht wurde gesendet.
OT_ERROR_NO_BUFS
Nicht genügend Puffer zum Generieren der MLE-Linkprüfungsnachricht.
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

OpenThread API-Referenzthemen stammen aus dem Quellcode, der auf GitHub verfügbar ist. Weitere Informationen finden Sie unter Ressourcen. Dort können Sie auch einen Beitrag zu unserer Dokumentation leisten.