Stolarz

Ten moduł zawiera funkcje przypisane do roli łączącej wątki.

Podsumowanie

Wyliczenia

otJoinerState enum | typ wyliczeniowy
Wyliczenie to określa stan połączenia.

Typedefs

otJoinerCallback)(otError aError, void *aContext) typedef
void(*
Wskaźnik ten jest wywoływany w celu powiadomienia o zakończeniu operacji połączenia.
otJoinerDiscerner typedef
Ta struktura to narzędzie do rozróżniania zdarzeń.
otJoinerState typedef
Wyliczenie to określa stan połączenia.

Funkcje

otJoinerGetDiscerner(otInstance *aInstance)
Ta funkcja określa narzędzie do rozróżniania zdarzeń.
otJoinerGetId(otInstance *aInstance)
const otExtAddress *
Ta funkcja pobiera identyfikator uczestnika.
otJoinerGetState(otInstance *aInstance)
Ta funkcja zwraca stan złączenia.
otJoinerSetDiscerner(otInstance *aInstance, otJoinerDiscerner *aDiscerner)
Ta funkcja ustawia narzędzie do rozróżniania.
otJoinerStart(otInstance *aInstance, const char *aPskd, const char *aProvisioningUrl, const char *aVendorName, const char *aVendorModel, const char *aVendorSwVersion, const char *aVendorData, otJoinerCallback aCallback, void *aContext)
Ta funkcja umożliwia włączenie roli łączącej wątki.
otJoinerStateToString(otJoinerState aState)
const char *
Ta funkcja konwertuje daną wartość wyliczeniową stanu złączenia na ciąg zrozumiały dla człowieka.
otJoinerStop(otInstance *aInstance)
void
Ta funkcja powoduje wyłączenie roli łączącej wątki.

Strugi

otJoinerDiscerner

Ta struktura to narzędzie do rozróżniania zdarzeń.

Wyliczenia

tJoinerState

 otJoinerState

Wyliczenie to określa stan połączenia.

Typedefs

tJoinerCallback

void(* otJoinerCallback)(otError aError, void *aContext)

Wskaźnik ten jest wywoływany w celu powiadomienia o zakończeniu operacji połączenia.

Szczegóły
Parametry
[in] aError
OT_ERROR_NONE, jeśli proces dołączania zakończył się powodzeniem. OT_ERROR_security, jeśli proces dołączania nie powiódł się z powodu danych uwierzytelniających zabezpieczeń. OT_ERROR_NOT_FOUND, jeśli nie znaleziono żadnej połączonej sieci. OT_ERROR_RESPONSE_TIMEOUT w przypadku przekroczenia limitu czasu odpowiedzi.
[in] aContext
Wskaźnik kontekstu aplikacji.

tJoinerDiscerner

struct otJoinerDiscerner otJoinerDiscerner

Ta struktura to narzędzie do rozróżniania zdarzeń.

tJoinerState

enum otJoinerState otJoinerState

Wyliczenie to określa stan połączenia.

Funkcje

tJoinerGetDiscerner

const otJoinerDiscerner * otJoinerGetDiscerner(
  otInstance *aInstance
)

Ta funkcja określa narzędzie do rozróżniania zdarzeń.

Szczegóły
Parametry
[in] aInstance
Wskaźnik instancji OpenThread.
Zwroty
Jeśli nie został ustawiony żaden wskaźnik, jest to wskaźnik połączenia lub wartość NULL.

tJoinerGetId

const otExtAddress * otJoinerGetId(
  otInstance *aInstance
)

Ta funkcja pobiera identyfikator uczestnika.

Jeśli utworzone przez Ciebie narzędzie do łączenia plików nie jest ustawione, identyfikator złącza jest pierwszym 64 bitami wyniku przetwarzania SHA-256 w odniesieniu do przypisanego do fabryki narzędzia IEEE EUI-64. W przeciwnym razie identyfikator złącza jest obliczany na podstawie wartości złącza.

Identyfikator złącza jest też używany jako rozszerzony adres IEEE 802.15.4 na potrzeby procesu uruchamiania.

Szczegóły
Parametry
[in] aInstance
Wskaźnik instancji OpenThread.
Zwroty
Wskaźnik identyfikatora uczestnika złącza.

tJoinerGetState

otJoinerState otJoinerGetState(
  otInstance *aInstance
)

Ta funkcja zwraca stan złączenia.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwracane wartości
OT_JOINER_STATE_IDLE
OT_JOINER_STATE_DISCOVER
OT_JOINER_STATE_CONNECT
OT_JOINER_STATE_CONNECTED
OT_JOINER_STATE_ENTRUST
OT_JOINER_STATE_JOINED

Odwołujący sięDiscerner

otError otJoinerSetDiscerner(
  otInstance *aInstance,
  otJoinerDiscerner *aDiscerner
)

Ta funkcja ustawia narzędzie do rozróżniania.

Złącznik łączący dane jest używany do obliczania identyfikatora opracowanego przez uczestnika podczas procesu uruchamiania lub dołączania do niego.

Domyślnie (jeśli analizator nie jest podany lub ma wartość NULL), identyfikator Joiner jest traktowany jako pierwsze 64 bity wyniku przetwarzania SHA-256 w przydzielonym fabrycznie standardzie IEEE EUI-64. Jest to główne zachowanie oczekiwane w specyfikacji wątki.

Szczegóły
Parametry
[in] aInstance
Wskaźnik instancji OpenThread.
[in] aDiscerner
Wskaźnik do rozróżniania. Jeśli wartość NULL zostanie wyczyszczona, wcześniej zostanie rozpoznana.
Zwracane wartości
OT_ERROR_NONE
Narzędzie do rozróżniania zostało zaktualizowane.
OT_ERROR_INVALID_ARGS
Adres aDiscerner jest nieprawidłowy (określona długość nie mieści się w prawidłowym zakresie).
OT_ERROR_INVALID_STATE
Trwa proces dołączania, dlatego nie można zmienić programu do rozróżniania zdarzeń.

otJoinerStart,

otError otJoinerStart(
  otInstance *aInstance,
  const char *aPskd,
  const char *aProvisioningUrl,
  const char *aVendorName,
  const char *aVendorModel,
  const char *aVendorSwVersion,
  const char *aVendorData,
  otJoinerCallback aCallback,
  void *aContext
)

Ta funkcja umożliwia włączenie roli łączącej wątki.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aPskd
Wskaźnik PSKd.
[in] aProvisioningUrl
Wskaźnik adresu URL obsługi administracyjnej (może mieć wartość NULL).
[in] aVendorName
Wskaźnik nazwy dostawcy (może mieć wartość NULL).
[in] aVendorModel
Wskaźnik modelu dostawcy (może mieć wartość NULL).
[in] aVendorSwVersion
Wskazuje wersję funkcji dostawcy usług (może mieć wartość NULL).
[in] aVendorData
Wskaźnik danych dostawcy (może mieć wartość NULL).
[in] aCallback
Wskaźnik funkcji, która jest wywoływana po zakończeniu łączenia.
[in] aContext
Wskaźnik kontekstu aplikacji.
Zwracane wartości
OT_ERROR_NONE
Rola członka grupy została uruchomiona.
OT_ERROR_BUSY
Poprzednia próba jest nadal wykonywana.
OT_ERROR_INVALID_ARGS
Wartość aPskd lub aProvisioningUrl jest nieprawidłowa.
OT_ERROR_INVALID_STATE
Stos IPv6 nie jest włączony lub stos wątków jest w pełni włączony.

otJoinerStateToString

const char * otJoinerStateToString(
  otJoinerState aState
)

Ta funkcja konwertuje daną wartość wyliczeniową stanu złączenia na ciąg zrozumiały dla człowieka.

Szczegóły
Parametry
[in] aState
Stan dołączenia.
Zwroty
Czytelna dla człowieka reprezentacja ciągu aState.

tJoinerStop

void otJoinerStop(
  otInstance *aInstance
)

Ta funkcja powoduje wyłączenie roli łączącej wątki.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.

Makra

OT_JOINER_MAX_DISCERNER_LENGTH

 OT_JOINER_MAX_DISCERNER_LENGTH 64

Maksymalna długość separatora łączącego w bitach.

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.