예

이 모듈에는 OpenThread 인스턴스를 제어하는 기능이 포함되어 있습니다.

요약

열거
anonymous enum { OT_CHANGED_IP6_ADDRESS_ADDED = 1 << 0, OT_CHANGED_IP6_ADDRESS_REMOVED = 1 << 1, OT_CHANGED_THREAD_ROLE = 1 << 2, OT_CHANGED_THREAD_LL_ADDR = 1 << 3, OT_CHANGED_THREAD_ML_ADDR = 1 << 4, OT_CHANGED_THREAD_RLOC_ADDED = 1 << 5, OT_CHANGED_THREAD_RLOC_REMOVED = 1 << 6, OT_CHANGED_THREAD_PARTITION_ID = 1 << 7, OT_CHANGED_THREAD_KEY_SEQUENCE_COUNTER = 1 << 8, OT_CHANGED_THREAD_NETDATA = 1 << 9, OT_CHANGED_THREAD_CHILD_ADDED = 1 << 10, OT_CHANGED_THREAD_CHILD_REMOVED = 1 << 11, OT_CHANGED_IP6_MULTICAST_SUBSCRIBED = 1 << 12, OT_CHANGED_IP6_MULTICAST_UNSUBSCRIBED = 1 << 13, OT_CHANGED_THREAD_CHANNEL = 1 << 14, OT_CHANGED_THREAD_PANID = 1 << 15, OT_CHANGED_THREAD_NETWORK_NAME = 1 << 16, OT_CHANGED_THREAD_EXT_PANID = 1 << 17, OT_CHANGED_MASTER_KEY = 1 << 18, OT_CHANGED_PSKC = 1 << 19, OT_CHANGED_SECURITY_POLICY = 1 << 20, OT_CHANGED_CHANNEL_MANAGER_NEW_CHANNEL = 1 << 21, OT_CHANGED_SUPPORTED_CHANNEL_MASK = 1 << 22, OT_CHANGED_COMMISSIONER_STATE = 1 << 23, OT_CHANGED_THREAD_NETIF_STATE = 1 << 24, OT_CHANGED_THREAD_BACKBONE_ROUTER_STATE = 1 << 25, OT_CHANGED_THREAD_BACKBONE_ROUTER_LOCAL = 1 << 26, OT_CHANGED_JOINER_STATE = 1 << 27 }	열거 형 이 열거는 `otStateChangedCallback` 일부로 전달되는 플래그를 정의합니다.

열거

anonymous enum { 
 OT_CHANGED_IP6_ADDRESS_ADDED = 1 << 0, 
 OT_CHANGED_IP6_ADDRESS_REMOVED = 1 << 1, 
 OT_CHANGED_THREAD_ROLE = 1 << 2, 
 OT_CHANGED_THREAD_LL_ADDR = 1 << 3, 
 OT_CHANGED_THREAD_ML_ADDR = 1 << 4, 
 OT_CHANGED_THREAD_RLOC_ADDED = 1 << 5, 
 OT_CHANGED_THREAD_RLOC_REMOVED = 1 << 6, 
 OT_CHANGED_THREAD_PARTITION_ID = 1 << 7, 
 OT_CHANGED_THREAD_KEY_SEQUENCE_COUNTER = 1 << 8, 
 OT_CHANGED_THREAD_NETDATA = 1 << 9, 
 OT_CHANGED_THREAD_CHILD_ADDED = 1 << 10, 
 OT_CHANGED_THREAD_CHILD_REMOVED = 1 << 11, 
 OT_CHANGED_IP6_MULTICAST_SUBSCRIBED = 1 << 12, 
 OT_CHANGED_IP6_MULTICAST_UNSUBSCRIBED = 1 << 13, 
 OT_CHANGED_THREAD_CHANNEL = 1 << 14, 
 OT_CHANGED_THREAD_PANID = 1 << 15, 
 OT_CHANGED_THREAD_NETWORK_NAME = 1 << 16, 
 OT_CHANGED_THREAD_EXT_PANID = 1 << 17, 
 OT_CHANGED_MASTER_KEY = 1 << 18, 
 OT_CHANGED_PSKC = 1 << 19, 
 OT_CHANGED_SECURITY_POLICY = 1 << 20, 
 OT_CHANGED_CHANNEL_MANAGER_NEW_CHANNEL = 1 << 21, 
 OT_CHANGED_SUPPORTED_CHANNEL_MASK = 1 << 22, 
 OT_CHANGED_COMMISSIONER_STATE = 1 << 23, 
 OT_CHANGED_THREAD_NETIF_STATE = 1 << 24, 
 OT_CHANGED_THREAD_BACKBONE_ROUTER_STATE = 1 << 25, 
 OT_CHANGED_THREAD_BACKBONE_ROUTER_LOCAL = 1 << 26, 
 OT_CHANGED_JOINER_STATE = 1 << 27 
 }

열거 형

이 열거는 otStateChangedCallback 일부로 전달되는 플래그를 정의합니다.

타입 정의
`otChangedFlags`	typedef `uint32_t` 이 유형은 변경된 특정 상태 / 구성을 나타내는 비트 필드를 나타냅니다.
`otInstance`	typedef `struct otInstance` 이 구조는 OpenThread 인스턴스 구조를 나타냅니다.
`otStateChangedCallback )(otChangedFlags aFlags, void *aContext)`	typedef `void(*` 이 함수 포인터는 OpenThread 내의 특정 구성 또는 상태 변경을 알리기 위해 호출됩니다.

기능
`otGetRadioVersionString ( otInstance *aInstance)`	`const char *` 이 함수는 OpenThread 라디오 버전 문자열을 가져옵니다.
`otGetVersionString (void)`	`const char *` 이 함수는 OpenThread 버전 문자열을 가져옵니다.
`otInstanceErasePersistentInfo ( otInstance *aInstance)`	`otError` 이 기능은 비 휘발성 메모리에 저장된 모든 OpenThread 영구 정보 (네트워크 설정)를 지 웁니다.
`otInstanceFactoryReset ( otInstance *aInstance)`	`void` 이 방법은 비 휘발성 메모리에 저장된 모든 설정을 삭제 한 다음 플랫폼 재설정을 트리거합니다.
`otInstanceFinalize ( otInstance *aInstance)`	`void` 이 기능은 OpenThread 라이브러리를 비활성화합니다.
`otInstanceInit (void aInstanceBuffer, size_t aInstanceBufferSize)`	`otInstance *` 이 함수는 OpenThread 라이브러리를 초기화합니다.
`otInstanceInitSingle (void)`	`otInstance *` 이 함수는 OpenThread 라이브러리의 정적 단일 인스턴스를 초기화합니다.
`otInstanceIsInitialized ( otInstance *aInstance)`	`bool` 이 함수는 인스턴스가 유효한 / 초기화되었는지 여부를 나타냅니다.
`otInstanceReset ( otInstance *aInstance)`	`void` 이 방법은 플랫폼 재설정을 트리거합니다.
`otRemoveStateChangeCallback ( otInstance aInstance, otStateChangedCallback aCallback, void aContext)`	`void` 이 기능은 OpenThread 내에서 특정 구성 또는 상태가 변경 될 때 표시하기 위해 콜백을 제거합니다.
`otSetStateChangedCallback ( otInstance aInstance, otStateChangedCallback aCallback, void aContext)`	`otError` 이 기능은 OpenThread 내에서 특정 구성 또는 상태가 변경 될 때 표시하기 위해 콜백을 등록합니다.

열거

익명 열거 형

 anonymous enum

이 열거는 otStateChangedCallback 일부로 전달되는 플래그를 정의합니다.

속성
`OT_CHANGED_CHANNEL_MANAGER_NEW_CHANNEL`	채널 관리자의 새로운 보류 스레드 채널이 변경되었습니다.
`OT_CHANGED_COMMISSIONER_STATE`	커미셔너 상태가 변경되었습니다.
`OT_CHANGED_IP6_ADDRESS_ADDED`	IPv6 주소가 추가되었습니다.
`OT_CHANGED_IP6_ADDRESS_REMOVED`	IPv6 주소가 제거되었습니다.
`OT_CHANGED_IP6_MULTICAST_SUBSCRIBED`	IPv6 멀티 캐스트 주소를 구독했습니다.
`OT_CHANGED_IP6_MULTICAST_UNSUBSCRIBED`	IPv6 멀티 캐스트 주소에서 탈퇴합니다.
`OT_CHANGED_JOINER_STATE`	결합 자 상태가 변경되었습니다.
`OT_CHANGED_MASTER_KEY`	마스터 키가 변경되었습니다.
`OT_CHANGED_PSKC`	PSKc가 변경되었습니다.
`OT_CHANGED_SECURITY_POLICY`	보안 정책이 변경되었습니다.
`OT_CHANGED_SUPPORTED_CHANNEL_MASK`	지원되는 채널 마스크가 변경되었습니다.
`OT_CHANGED_THREAD_BACKBONE_ROUTER_LOCAL`	로컬 백본 라우터 구성이 변경되었습니다.
`OT_CHANGED_THREAD_BACKBONE_ROUTER_STATE`	백본 라우터 상태가 변경되었습니다.
`OT_CHANGED_THREAD_CHANNEL`	스레드 네트워크 채널이 변경되었습니다.
`OT_CHANGED_THREAD_CHILD_ADDED`	아이가 추가되었습니다.
`OT_CHANGED_THREAD_CHILD_REMOVED`	아이가 제거되었습니다.
`OT_CHANGED_THREAD_EXT_PANID`	스레드 네트워크 확장 PAN ID가 변경되었습니다.
`OT_CHANGED_THREAD_KEY_SEQUENCE_COUNTER`	스레드 키 시퀀스가 변경되었습니다.
`OT_CHANGED_THREAD_LL_ADDR`	링크 로컬 주소가 변경되었습니다.
`OT_CHANGED_THREAD_ML_ADDR`	메시 로컬 주소가 변경되었습니다.
`OT_CHANGED_THREAD_NETDATA`	스레드 네트워크 데이터가 변경되었습니다.
`OT_CHANGED_THREAD_NETIF_STATE`	스레드 네트워크 인터페이스 상태가 변경되었습니다.
`OT_CHANGED_THREAD_NETWORK_NAME`	스레드 네트워크 이름이 변경되었습니다.
`OT_CHANGED_THREAD_PANID`	스레드 네트워크 PAN ID가 변경되었습니다.
`OT_CHANGED_THREAD_PARTITION_ID`	파티션 ID가 변경되었습니다.
`OT_CHANGED_THREAD_RLOC_ADDED`	RLOC가 추가되었습니다.
`OT_CHANGED_THREAD_RLOC_REMOVED`	RLOC가 제거되었습니다.
`OT_CHANGED_THREAD_ROLE`	역할 (비활성화, 분리, 하위, 라우터, 리더)이 변경되었습니다.

타입 정의

otChangedFlags

uint32_t otChangedFlags

이 유형은 변경된 특정 상태 / 구성을 나타내는 비트 필드를 나타냅니다.

OT_CHANGED_* 정의를 참조하십시오.

otInstance

struct otInstance otInstance

이 구조는 OpenThread 인스턴스 구조를 나타냅니다.

otStateChangedCallback

void(* otStateChangedCallback)(otChangedFlags aFlags, void *aContext)

이 함수 포인터는 OpenThread 내의 특정 구성 또는 상태 변경을 알리기 위해 호출됩니다.

세부

매개 변수

`[in] aFlags`	변경된 특정 상태를 나타내는 비트 필드입니다. `OT_CHANGED_*` 정의를 참조하십시오.
`[in] aContext`	응용 프로그램 별 컨텍스트에 대한 포인터

기능

otGetRadioVersionString

const char * otGetRadioVersionString(
  otInstance *aInstance
)

이 함수는 OpenThread 라디오 버전 문자열을 가져옵니다.

세부

매개 변수

[in] aInstance

OpenThread 인스턴스에 대한 포인터.

보고

OpenThread 라디오 버전을 가리키는 포인터.

otGetVersionString

const char * otGetVersionString(
  void
)

이 함수는 OpenThread 버전 문자열을 가져옵니다.

세부
보고	OpenThread 버전에 대한 포인터.

otInstanceErasePersistentInfo

 otError otInstanceErasePersistentInfo(
  otInstance *aInstance
)

이 기능은 비 휘발성 메모리에 저장된 모든 OpenThread 영구 정보 (네트워크 설정)를 지 웁니다.

장치가 disabled 상태 / 역할 인 경우에만 지우기가 성공합니다.

세부

매개 변수

[in] aInstance

OpenThread 인스턴스에 대한 포인터.

반환 값

`OT_ERROR_NONE`	모든 영구 정보 / 상태가 성공적으로 지워졌습니다.
`OT_ERROR_INVALID_STATE`	장치가 `disabled` 상태 / 역할이 아닙니다.

otInstanceFactoryReset

void otInstanceFactoryReset(
  otInstance *aInstance
)

이 방법은 비 휘발성 메모리에 저장된 모든 설정을 삭제 한 다음 플랫폼 재설정을 트리거합니다.

세부

매개 변수

[in] aInstance

OpenThread 인스턴스에 대한 포인터.

otInstanceFinalize

void otInstanceFinalize(
  otInstance *aInstance
)

이 기능은 OpenThread 라이브러리를 비활성화합니다.

OpenThread를 더 이상 사용하지 않을 때이 함수를 호출하십시오.

세부

매개 변수

[in] aInstance

OpenThread 인스턴스에 대한 포인터.

otInstanceInit

 otInstance * otInstanceInit(
  void *aInstanceBuffer,
  size_t *aInstanceBufferSize
)

이 함수는 OpenThread 라이브러리를 초기화합니다.

이 함수는 OpenThread를 초기화하고 후속 OpenThread API 호출을 위해 준비합니다. OpenThread를 호출하기 전에이 함수를 호출해야합니다.

이 기능은 여러 OpenThread 인스턴스에 대한 지원이 활성화 된 경우에만 사용할 수 있습니다.

세부

매개 변수

`[in] aInstanceBuffer`	otInstance 구조를 할당하는 데 사용할 OpenThread의 버퍼입니다.
`[in,out] aInstanceBufferSize`	입력시 aInstanceBuffer의 크기. 출력시, otInstance에 필요한 공간이 충분하지 않으면 otInstance에 필요한 바이트 수입니다.

보고

새로운 OpenThread 인스턴스에 대한 포인터.

또한보십시오:
otInstanceFinalize

otInstanceInitSingle

 otInstance * otInstanceInitSingle(
  void
)

이 함수는 OpenThread 라이브러리의 정적 단일 인스턴스를 초기화합니다.

이 함수는 OpenThread를 초기화하고 후속 OpenThread API 호출을 위해 준비합니다. OpenThread를 호출하기 전에이 함수를 호출해야합니다.

이 기능은 여러 OpenThread 인스턴스에 대한 지원이 비활성화 된 경우에만 사용할 수 있습니다.

세부
보고	단일 OpenThread 인스턴스에 대한 포인터.

otInstanceIsInitialized

bool otInstanceIsInitialized(
  otInstance *aInstance
)

이 함수는 인스턴스가 유효한 / 초기화되었는지 여부를 나타냅니다.

인스턴스는 otInstanceInitSingle() (단일 인스턴스의 경우) 또는 otInstanceInit() (다중 인스턴스의 경우)를 사용하여 획득 및 초기화 된 경우 유효한 것으로 간주됩니다. 이후 otInstanceFinalize() 호출하면 인스턴스가 초기화되지 않은 것으로 간주됩니다.

세부

매개 변수

[in] aInstance

OpenThread 인스턴스에 대한 포인터.

보고

주어진 인스턴스가 유효 / 초기화되면 TRUE, 그렇지 않으면 FALSE

otInstanceReset

void otInstanceReset(
  otInstance *aInstance
)

이 방법은 플랫폼 재설정을 트리거합니다.

재설정 프로세스는 모든 휘발성 메모리에 저장된 OpenThread 상태 / 정보가 지워지도록합니다. otPlatformReset 은 비 휘발성 메모리에 저장된 영구 상태 / 정보를 지우지 않습니다.

세부

매개 변수

[in] aInstance

OpenThread 인스턴스에 대한 포인터.

otRemoveStateChangeCallback

void otRemoveStateChangeCallback(
  otInstance *aInstance,
  otStateChangedCallback aCallback,
  void *aContext
)

이 기능은 OpenThread 내에서 특정 구성 또는 상태가 변경 될 때 표시하기 위해 콜백을 제거합니다.

세부

매개 변수

`[in] aInstance`	OpenThread 인스턴스에 대한 포인터.
`[in] aCallback`	특정 구성 또는 상태 변경으로 호출되는 함수에 대한 포인터.
`[in] aContext`	응용 프로그램 별 컨텍스트에 대한 포인터

otSetStateChangedCallback

 otError otSetStateChangedCallback(
  otInstance *aInstance,
  otStateChangedCallback aCallback,
  void *aContext
)

이 기능은 OpenThread 내에서 특정 구성 또는 상태가 변경 될 때 표시하기 위해 콜백을 등록합니다.

세부

매개 변수

`[in] aInstance`	OpenThread 인스턴스에 대한 포인터.
`[in] aCallback`	특정 구성 또는 상태 변경으로 호출되는 함수에 대한 포인터.
`[in] aContext`	응용 프로그램 별 컨텍스트에 대한 포인터

반환 값

`OT_ERROR_NONE`	콜백 목록에 콜백을 추가했습니다.
`OT_ERROR_ALREADY`	콜백이 이미 등록되었습니다.
`OT_ERROR_NO_BUFS`	리소스 제약으로 인해 콜백을 추가 할 수 없습니다.