Joiner

이 모듈에는 스레드 조인자 역할을 위한 함수가 포함되어 있습니다.

요약

열거형
otJoinerState enum
연결자 상태를 정의합니다.

Typedef
otJoinerCallback)(otError aError, void *aContext) typedef
void(*
조인 작업의 완료를 알리기 위해 포인터가 호출됩니다.
otJoinerDiscerner typedef
조이너 감지기를 나타냅니다.
otJoinerState typedef
연결자 상태를 정의합니다.

함수
otJoinerGetDiscerner(otInstance *aInstance)
조이너 디서너를 가져옵니다.
otJoinerGetId(otInstance *aInstance)
const otExtAddress *
연결자 ID를 가져옵니다.
otJoinerGetState(otInstance *aInstance)
연결자 상태를 가져옵니다.
otJoinerSetDiscerner(otInstance *aInstance, otJoinerDiscerner *aDiscerner)
연결자 Discerner를 설정합니다.
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)
스레드 조인자 역할을 사용 설정합니다.
otJoinerStateToString(otJoinerState aState)
const char *
지정된 조인자 상태 열거형 값을 사람이 읽을 수 있는 문자열로 변환합니다.
otJoinerStop(otInstance *aInstance)
void
스레드 조인자 역할을 사용 중지합니다.

구조체
otJoinerDiscerner

조이너 감지기를 나타냅니다.

열거형

otJoinerState

 otJoinerState

연결자 상태를 정의합니다.

Typedef

otJoinerCallback

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

조인 작업의 완료를 알리기 위해 포인터가 호출됩니다.

세부정보
매개변수
[in] aError
조인 프로세스가 성공한 경우 OT_ERROR_NONE입니다. 보안 사용자 인증 정보로 인해 조인 프로세스가 실패한 경우 OT_ERROR_SECURITY입니다. 연결 가능한 네트워크가 발견되지 않은 경우 OT_ERROR_NOT_FOUND입니다. 응답 시간이 초과된 경우 OT_ERROR_ADMIN_TIMEOUT을 반환합니다.
[in] aContext
애플리케이션별 컨텍스트에 대한 포인터입니다.

otJoinerDiscerner

struct otJoinerDiscerner otJoinerDiscerner

조이너 감지기를 나타냅니다.

otJoinerState

enum otJoinerState otJoinerState

연결자 상태를 정의합니다.

함수

otJoinerGetDiscerner

const otJoinerDiscerner * otJoinerGetDiscerner(
  otInstance *aInstance
)

조이너 디서너를 가져옵니다.

자세한 내용은 otJoinerSetDiscerner를 참고하세요.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
Joiner Discerner에 대한 포인터이거나 아무것도 설정되지 않은 경우 NULL입니다.

otJoinerGetId

const otExtAddress * otJoinerGetId(
  otInstance *aInstance
)

연결자 ID를 가져옵니다.

연결자 ID가 설정되지 않은 경우 연결자 ID는 공장 출고 시 할당된 IEEE EUI-64에 대해 SHA-256을 계산한 결과의 처음 64비트입니다. 그렇지 않으면 Joiner Discerner 값에서 조인자 ID가 계산됩니다.

연결자 ID는 커미셔닝 프로세스 중에 기기의 IEEE 802.15.4 확장 주소로도 사용됩니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
연결자 ID에 대한 포인터입니다.

otJoinerGetState

otJoinerState otJoinerGetState(
  otInstance *aInstance
)

연결자 상태를 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
연결자 상태입니다.

otJoinerSetDiscerner

otError otJoinerSetDiscerner(
  otInstance *aInstance,
  otJoinerDiscerner *aDiscerner
)

연결자 Discerner를 설정합니다.

연결자 Discerner는 스레드 커미셔닝 프로세스 중에 연결자 ID를 계산하는 데 사용됩니다. 자세한 내용은 otJoinerGetId를 참고하세요.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aDiscerner
소목 장인을 가리키는 포인터입니다. NULL이 이전에 설정된 모든 것을 지우는 경우.
반환 값
OT_ERROR_NONE
연결자 Discerner가 업데이트되었습니다.
OT_ERROR_INVALID_ARGS
aDiscerner이(가) 잘못되었습니다(지정된 길이가 유효한 범위 내에 없음).
OT_ERROR_INVALID_STATE
가입 프로세스가 진행 중이므로 Joiner Discerner를 변경할 수 없습니다.

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
)

스레드 조인자 역할을 사용 설정합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aPskd
PSKd를 가리키는 포인터입니다.
[in] aProvisioningUrl
프로비저닝 URL에 대한 포인터입니다 (NULL일 수 있음).
[in] aVendorName
공급업체 이름에 대한 포인터입니다 (NULL일 수 있음).
[in] aVendorModel
공급업체 모델에 대한 포인터입니다 (NULL일 수 있음).
[in] aVendorSwVersion
공급업체 SW 버전에 대한 포인터입니다 (NULL일 수 있음).
[in] aVendorData
공급업체 데이터에 대한 포인터입니다 (NULL일 수 있음).
[in] aCallback
조인 작업이 완료될 때 호출되는 함수에 대한 포인터입니다.
[in] aContext
애플리케이션별 컨텍스트에 대한 포인터입니다.
반환 값
OT_ERROR_NONE
연결자 역할을 시작했습니다.
OT_ERROR_BUSY
이전 시도가 아직 진행 중입니다.
OT_ERROR_INVALID_ARGS
aPskd 또는 aProvisioningUrl이(가) 잘못되었습니다.
OT_ERROR_INVALID_STATE
IPv6 스택이 사용 설정되지 않았거나 스레드 스택이 완전히 사용 설정되었습니다.

otJoinerStateToString

const char * otJoinerStateToString(
  otJoinerState aState
)

지정된 조인자 상태 열거형 값을 사람이 읽을 수 있는 문자열로 변환합니다.

세부정보
매개변수
[in] aState
연결자 상태입니다.
반환
사람이 읽을 수 있는 aState의 문자열 표현입니다.

otJoinerStop

void otJoinerStop(
  otInstance *aInstance
)

스레드 조인자 역할을 사용 중지합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.

매크로

OT_JOINER_MAX_DISCERNER_LENGTH

 OT_JOINER_MAX_DISCERNER_LENGTH 64

조인자 디서너의 최대 길이(비트).

자료

OpenThread API 참조 주제는 GitHub에서 제공되는 소스 코드에서 비롯됩니다. 자세한 내용을 알아보거나 문서에 참여하려면 리소스를 참고하세요.