Dane linków

Ten moduł zawiera funkcje sterujące protokołem wskaźników linków.

Podsumowanie

Wyliczenia
otLinkMetricsEnhAckFlags{
  OT_LINK_METRICS_ENH_ACK_CLEAR = 0,
  OT_LINK_METRICS_ENH_ACK_REGISTER = 1
} 		enum | typ wyliczeniowy
Flagi ulepszonego potwierdzenia.
otLinkMetricsStatus enum | typ wyliczeniowy
Wartości stanu linków.

Typedefs
otLinkMetricsEnhAckFlags typedef
Flagi ulepszonego potwierdzenia.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
Ten wskaźnik funkcji jest wywoływany po odebraniu energetycznego punktu końcowego Enh-ACK.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, uint8_t aStatus, void *aContext) typedef
void(*
Ten wskaźnik funkcji jest wywoływany po odebraniu odpowiedzi zarządzania danymi połączenia.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, uint8_t aStatus, void *aContext) typedef
void(*
Wskaźnik funkcji jest wywoływany po odebraniu raportu Statystyki linków.
otLinkMetricsSeriesFlags typedef
Ta struktura reprezentuje, które klatki są uwzględniane w serii Przekierowanie śledzenia.
otLinkMetricsStatus typedef
Wartości stanu linków.
otLinkMetricsValues typedef
Ta struktura reprezentuje wynik (wartość) dla zapytania dane linków.

Funkcje
otLinkMetricsConfigEnhAckProbing(otInstance *aInstance, const otIp6Address *aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)
Ta funkcja wysyła żądanie zarządzania wskaźnikami MLE Link do konfigurowania/czyszczenia Ulepszonego sondowania ACK.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
Ta funkcja wysyła żądanie zarządzania wskaźnikami MLE Link do skonfigurowania/czyszczenia serii śledzenia przekazywania.
otLinkMetricsQuery(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void *aCallbackContext)
Ta funkcja wysyła żądanie MLE danych do zapytania o wskaźniki linków.
otLinkMetricsSendLinkProbe(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)
Ta funkcja wysyła wiadomość sondy MLE Link.

Strugi
otLinkMetricsSeriesFlags,

Ta struktura reprezentuje, które klatki są uwzględniane w serii Przekierowanie śledzenia.

otLinkMetricsValues,

Ta struktura reprezentuje wynik (wartość) dla zapytania dane linków.

Wyliczenia

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Flagi ulepszonego potwierdzenia.

Są one używane w sondowaniu opartym na ulepszonym żądaniu potwierdzenia, aby określić, czy zarejestrować lub wyczyścić sondowanie.

Właściwości
OT_LINK_METRICS_ENH_ACK_CLEAR

Wyczyść.

OT_LINK_METRICS_ENH_ACK_REGISTER

Zarejestruj się.

otLinkMetricsStatus

 otLinkMetricsStatus

Wartości stanu linków.

Typedefs

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Flagi ulepszonego potwierdzenia.

Są one używane w sondowaniu opartym na ulepszonym żądaniu potwierdzenia, aby określić, czy zarejestrować lub wyczyścić sondowanie.

otLinkMetricsEnhAckProbingIeReportCallback

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

Ten wskaźnik funkcji jest wywoływany po odebraniu energetycznego punktu końcowego Enh-ACK.

Szczegóły
Parametry
[in] aShortAddress
Krótki adres macOS podmiotu wystawiającego sondowanie.
[in] aExtAddress
Wskaźnik ulepszonego adresu Mac OS X w systemie Mac.
[in] aMetricsValues
Wskaźnik wartości linków pochodzących z IE.
[in] aContext
Wskaźnik kontekstu aplikacji.

otLinkMetricsMgmtResponseCallback

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

Ten wskaźnik funkcji jest wywoływany po odebraniu odpowiedzi zarządzania danymi połączenia.

Szczegóły
Parametry
[in] aSource
Wskaźnik adresu źródłowego.
[in] aStatus
Kod stanu w odpowiedzi.
[in] aContext
Wskaźnik kontekstu aplikacji.

otLinkMetricsRaportWywołanie zwrotne

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

Wskaźnik funkcji jest wywoływany po odebraniu raportu Statystyki linków.

Szczegóły
Parametry
[in] aSource
Wskaźnik adresu źródłowego.
[in] aMetricsValues
Wskaźnik wartości danych linku (wyniku zapytania).
[in] aStatus
Kod stanu w raporcie (pomocny tylko wtedy, gdy aMetricsValues ma wartość NULL).
[in] aContext
Wskaźnik kontekstu aplikacji.

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

Ta struktura reprezentuje, które klatki są uwzględniane w serii Przekierowanie śledzenia.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Wartości stanu linków.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Ta struktura reprezentuje wynik (wartość) dla zapytania dane linków.

Funkcje

otLinkMetricsConfigEnhAckProbing

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

Ta funkcja wysyła żądanie zarządzania wskaźnikami MLE Link do konfigurowania/czyszczenia Ulepszonego sondowania ACK.

Ta funkcja wymaga włączenia funkcji OT_LINK_METRICS_INITIATOR.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aDestination
Wskaźnik adresu docelowego.
[in] aEnhAckFlags
Flagi Enh-ACK wskazujące, czy zarejestrować lub czyścić sondowanie. 0, by wyczyścić konto, lub 1, by się zarejestrować. Pozostałe wartości są zarezerwowane.
[in] aLinkMetricsFlags
Wskaźnik służący do określania wskaźników, których dotyczy zapytanie. Powinna być NULL, gdy aEnhAckFlags to 0.
[in] aCallback
Wskaźnik funkcji, która jest wywoływana po odebraniu wskaźnika ulepszonego potwierdzenia z linkami.
[in] aCallbackContext
Wskaźnik kontekstu aplikacji.
Zwracane wartości
OT_ERROR_NONE
Wysłano wiadomość z prośbą o zarządzanie danymi połączenia.
OT_ERROR_NO_BUFS
Niewystarczająca liczba buforów do wygenerowania wiadomości z prośbą o zarządzanie wskaźnikami MLE Link.
OT_ERROR_INVALID_ARGS
aEnhAckFlags nie jest prawidłową wartością lub aLinkMetricsFlags jest nieprawidłowa.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination nie jest linkiem lokalnym lub nie znaleziono sąsiada.
OT_ERROR_NOT_CAPABLE
Sąsiadem nie jest urządzenie Thread 1.2 i nie obsługuje wskaźników linków.

otLinkMetricsConfigForwardTrackingSeries

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

Ta funkcja wysyła żądanie zarządzania wskaźnikami MLE Link do skonfigurowania/czyszczenia serii śledzenia przekazywania.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aDestination
Wskaźnik adresu docelowego.
[in] aSeriesId
Identyfikator serii, z którym ma być wykonywany działanie.
[in] aSeriesFlags
Flagi serii określające, które ramki mają zostać uwzględnione.
[in] aLinkMetricsFlags
Wskaźnik służący do określania wskaźników, których dotyczy zapytanie. Powinna być NULL, gdy aSeriesFlags to 0.
[in] aCallback
Wskaźnik funkcji, która jest wywoływana po odebraniu odpowiedzi zarządzania wskaźnikami linków.
[in] aCallbackContext
Wskaźnik kontekstu aplikacji.
Zwracane wartości
OT_ERROR_NONE
Wysłano wiadomość z prośbą o zarządzanie danymi połączenia.
OT_ERROR_NO_BUFS
Niewystarczająca liczba buforów do wygenerowania wiadomości z prośbą o zarządzanie wskaźnikami MLE Link.
OT_ERROR_INVALID_ARGS
aSeriesId jest poza prawidłowym zakresem.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination nie jest linkiem lokalnym lub nie znaleziono sąsiada.
OT_ERROR_NOT_CAPABLE
Sąsiadem nie jest urządzenie Thread 1.2 i nie obsługuje wskaźników linków.

otLinkMetricsQuery,

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

Ta funkcja wysyła żądanie MLE danych do zapytania o wskaźniki linków.

Może to być jedna sonda śledzenia lub seria śledzenia od przodu.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aDestination
Wskaźnik adresu docelowego.
[in] aSeriesId
Identyfikator ciągu, którego dotyczy zapytanie, 0 dla pojedynczej sondy.
[in] aLinkMetricsFlags
Wskaźnik służący do określania wskaźników, których dotyczy zapytanie.
[in] aCallback
Wskaźnik funkcji, która jest wywoływana po odebraniu raportu Statystyki linków.
[in] aCallbackContext
Wskaźnik kontekstu aplikacji.
Zwracane wartości
OT_ERROR_NONE
Wysłano zapytanie o statystyki linków.
OT_ERROR_NO_BUFS
Niewystarczająca liczba buforów do wygenerowania wiadomości z żądaniem MLE Data.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination nie jest linkiem lokalnym lub nie znaleziono sąsiada.
OT_ERROR_NOT_CAPABLE
Sąsiadem nie jest urządzenie Thread 1.2 i nie obsługuje wskaźników linków.

otLinkMetricsSendLinkProbe

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

Ta funkcja wysyła wiadomość sondy MLE Link.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aDestination
Wskaźnik adresu docelowego.
[in] aSeriesId
Identyfikator serii [1, 254], na który jest kierowany komunikat sondy.
[in] aLength
Długość ładunku danych w protokole TLV linku Probe TLV (0, 64).
Zwracane wartości
OT_ERROR_NONE
Wysłano wiadomość z sondy linków.
OT_ERROR_NO_BUFS
Niewystarczająca liczba buforów do wygenerowania komunikatu sondy MLE Link.
OT_ERROR_INVALID_ARGS
aSeriesId lub aLength jest poza prawidłowym zakresem.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination nie jest linkiem lokalnym lub nie znaleziono sąsiada.
OT_ERROR_NOT_CAPABLE
Sąsiadem nie jest urządzenie Thread 1.2 i nie obsługuje wskaźników linków.

Zasoby

Tematy referencyjne interfejsu API OpenThread pochodzą z kodu źródłowego, który jest dostępny w GitHub. Jeśli chcesz dowiedzieć się więcej lub utworzyć dokumentację, zapoznaj się z materiałami.