예

이 모듈에는 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, OT_CHANGED_ACTIVE_DATASET = 1 << 28, OT_CHANGED_PENDING_DATASET = 1 << 29 }	열거 형 이 열거 형은 `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,
 OT_CHANGED_ACTIVE_DATASET = 1 << 28,
 OT_CHANGED_PENDING_DATASET = 1 << 29
 }

열거 형

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

Typedef
`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_ACTIVE_DATASET`	활성 운영 데이터 세트가 변경되었습니다.
`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_PENDING_DATASET`	보류중인 운영 데이터 세트가 변경되었습니다.
`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`	역할 (비활성화 됨, 분리됨, 하위, 라우터, 리더)이 변경되었습니다.

Typedef

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`	리소스 제약으로 인해 콜백을 추가 할 수 없습니다.