운영 데이터 세트

Operational Dataset API를 위한 함수가 포함됩니다.

요약

FTD 빌드에만 해당하는 데이터 세트 업데이터에는 데이터 세트 업데이트를 관리하는 함수가 포함되어 있습니다.

FTD 및 MTD 빌드의 경우 Operational Dataset API에는 활성 및 대기 중인 데이터 세트와 데이터 세트 TLV를 관리하는 함수가 포함되어 있습니다.

열거형
otMeshcopTlvType{
  OT_MESHCOP_TLV_CHANNEL = 0,
  OT_MESHCOP_TLV_PANID = 1,
  OT_MESHCOP_TLV_EXTPANID = 2,
  OT_MESHCOP_TLV_NETWORKNAME = 3,
  OT_MESHCOP_TLV_PSKC = 4,
  OT_MESHCOP_TLV_NETWORKKEY = 5,
  OT_MESHCOP_TLV_NETWORK_KEY_SEQUENCE = 6,
  OT_MESHCOP_TLV_MESHLOCALPREFIX = 7,
  OT_MESHCOP_TLV_STEERING_DATA = 8,
  OT_MESHCOP_TLV_BORDER_AGENT_RLOC = 9,
  OT_MESHCOP_TLV_COMMISSIONER_ID = 10,
  OT_MESHCOP_TLV_COMM_SESSION_ID = 11,
  OT_MESHCOP_TLV_SECURITYPOLICY = 12,
  OT_MESHCOP_TLV_GET = 13,
  OT_MESHCOP_TLV_ACTIVETIMESTAMP = 14,
  OT_MESHCOP_TLV_COMMISSIONER_UDP_PORT = 15,
  OT_MESHCOP_TLV_STATE = 16,
  OT_MESHCOP_TLV_JOINER_DTLS = 17,
  OT_MESHCOP_TLV_JOINER_UDP_PORT = 18,
  OT_MESHCOP_TLV_JOINER_IID = 19,
  OT_MESHCOP_TLV_JOINER_RLOC = 20,
  OT_MESHCOP_TLV_JOINER_ROUTER_KEK = 21,
  OT_MESHCOP_TLV_PROVISIONING_URL = 32,
  OT_MESHCOP_TLV_VENDOR_NAME_TLV = 33,
  OT_MESHCOP_TLV_VENDOR_MODEL_TLV = 34,
  OT_MESHCOP_TLV_VENDOR_SW_VERSION_TLV = 35,
  OT_MESHCOP_TLV_VENDOR_DATA_TLV = 36,
  OT_MESHCOP_TLV_VENDOR_STACK_VERSION_TLV = 37,
  OT_MESHCOP_TLV_UDP_ENCAPSULATION_TLV = 48,
  OT_MESHCOP_TLV_IPV6_ADDRESS_TLV = 49,
  OT_MESHCOP_TLV_PENDINGTIMESTAMP = 51,
  OT_MESHCOP_TLV_DELAYTIMER = 52,
  OT_MESHCOP_TLV_CHANNELMASK = 53,
  OT_MESHCOP_TLV_COUNT = 54,
  OT_MESHCOP_TLV_PERIOD = 55,
  OT_MESHCOP_TLV_SCAN_DURATION = 56,
  OT_MESHCOP_TLV_ENERGY_LIST = 57,
  OT_MESHCOP_TLV_DISCOVERYREQUEST = 128,
  OT_MESHCOP_TLV_DISCOVERYRESPONSE = 129,
  OT_MESHCOP_TLV_JOINERADVERTISEMENT = 241
} 		enum
Meshcop TLV 유형을 나타냅니다.

Typedef
otChannelMask typedef
uint32_t
채널 마스크를 나타냅니다.
otDatasetMgmtSetCallback)(otError aResult, void *aContext) typedef
void(*
포인터는 MGMT_SET 요청에 대한 응답이 수신되거나 시간 초과될 때 호출됩니다.
otDatasetUpdaterCallback)(otError aError, void *aContext) typedef
void(*
이 콜백 함수 포인터는 데이터 세트 업데이트 요청이 완료되면 호출되어 데이터 세트 업데이트 요청의 성공 또는 실패 상태를 보고합니다.
otExtendedPanId typedef
확장 PAN ID를 나타냅니다.
otMeshLocalPrefix typedef
메시 로컬 프리픽스를 나타냅니다.
otMeshcopTlvType typedef
Meshcop TLV 유형을 나타냅니다.
otNetworkKey typedef
struct otNetworkKey
스레드 네트워크 키를 나타냅니다.
otNetworkKeyRef typedef
이 데이터 유형은 NetworkKey의 KeyRef를 나타냅니다.
otNetworkName typedef
struct otNetworkName
네트워크 이름을 나타냅니다.
otOperationalDataset typedef
활성 또는 대기 중인 운영 데이터 세트를 나타냅니다.
otOperationalDatasetComponents typedef
활성 또는 대기 중인 운영 데이터 세트에 여러 구성요소가 있음을 나타냅니다.
otOperationalDatasetTlvs typedef
활성 또는 대기 중인 운영 데이터 세트를 나타냅니다.
otPskc typedef
struct otPskc
PSKc를 나타냅니다.
otPskcRef typedef
이 데이터 유형은 PSKc에 대한 KeyRef를 나타냅니다.
otSecurityPolicy typedef
보안 정책을 나타냅니다.
otTimestamp typedef
struct otTimestamp
스레드 데이터 세트 타임스탬프 구성요소를 나타냅니다.

변수
OT_TOOL_PACKED_END

함수
otDatasetConvertToTlvs(const otOperationalDataset *aDataset, otOperationalDatasetTlvs *aDatasetTlvs)
지정된 운영 데이터 세트를 otOperationalDatasetTlvs로 변환합니다.
otDatasetCreateNewNetwork(otInstance *aInstance, otOperationalDataset *aDataset)
FTD에만 해당되며 새 네트워크를 구성할 때 사용할 새 운영 데이터 세트를 만듭니다.
otDatasetGeneratePskc(const char *aPassPhrase, const otNetworkName *aNetworkName, const otExtendedPanId *aExtPanId, otPskc *aPskc)
지정된 암호, 네트워크 이름, 확장된 PAN ID에서 PSKc를 생성합니다.
otDatasetGetActive(otInstance *aInstance, otOperationalDataset *aDataset)
활성 작업 데이터 세트를 가져옵니다.
otDatasetGetActiveTlvs(otInstance *aInstance, otOperationalDatasetTlvs *aDataset)
활성 작업 데이터 세트를 가져옵니다.
otDatasetGetDelayTimerMinimal(otInstance *aInstance)
uint32_t
FTD에만 최소 지연 타이머를 가져옵니다.
otDatasetGetPending(otInstance *aInstance, otOperationalDataset *aDataset)
대기 중인 작업 데이터 세트를 가져옵니다.
otDatasetGetPendingTlvs(otInstance *aInstance, otOperationalDatasetTlvs *aDataset)
대기 중인 작업 데이터 세트를 가져옵니다.
otDatasetIsCommissioned(otInstance *aInstance)
bool
활성 운영 데이터 세트에 유효한 네트워크가 있는지 여부를 나타냅니다.
otDatasetParseTlvs(const otOperationalDatasetTlvs *aDatasetTlvs, otOperationalDataset *aDataset)
지정된 otOperationalDatasetTlvs에서 운영 데이터 세트를 파싱합니다.
otDatasetSendMgmtActiveGet(otInstance *aInstance, const otOperationalDatasetComponents *aDatasetComponents, const uint8_t *aTlvTypes, uint8_t aLength, const otIp6Address *aAddress)
MGMT_ACTIVE_GET을 전송합니다.
otDatasetSendMgmtActiveSet(otInstance *aInstance, const otOperationalDataset *aDataset, const uint8_t *aTlvs, uint8_t aLength, otDatasetMgmtSetCallback aCallback, void *aContext)
MGMT_ACTIVE_SET을 전송합니다.
otDatasetSendMgmtPendingGet(otInstance *aInstance, const otOperationalDatasetComponents *aDatasetComponents, const uint8_t *aTlvTypes, uint8_t aLength, const otIp6Address *aAddress)
MGMT_PENDING_GET을 전송합니다.
otDatasetSendMgmtPendingSet(otInstance *aInstance, const otOperationalDataset *aDataset, const uint8_t *aTlvs, uint8_t aLength, otDatasetMgmtSetCallback aCallback, void *aContext)
MGMT_PENDING_SET을 전송합니다.
otDatasetSetActive(otInstance *aInstance, const otOperationalDataset *aDataset)
활성 운영 데이터 세트를 설정합니다.
otDatasetSetActiveTlvs(otInstance *aInstance, const otOperationalDatasetTlvs *aDataset)
활성 운영 데이터 세트를 설정합니다.
otDatasetSetDelayTimerMinimal(otInstance *aInstance, uint32_t aDelayTimerMinimal)
FTD에만 최소 지연 타이머를 설정합니다.
otDatasetSetPending(otInstance *aInstance, const otOperationalDataset *aDataset)
대기 중인 운영 데이터 세트를 설정합니다.
otDatasetSetPendingTlvs(otInstance *aInstance, const otOperationalDatasetTlvs *aDataset)
대기 중인 운영 데이터 세트를 설정합니다.
otDatasetUpdateTlvs(const otOperationalDataset *aDataset, otOperationalDatasetTlvs *aDatasetTlvs)
지정된 운영 데이터 세트를 업데이트합니다.
otDatasetUpdaterCancelUpdate(otInstance *aInstance)
void
진행 중인 운영 데이터 세트 업데이트 요청을 취소합니다 (있는 경우).
otDatasetUpdaterIsUpdateOngoing(otInstance *aInstance)
bool
진행 중인 작업 데이터 세트 업데이트 요청이 있는지 여부를 나타냅니다.
otDatasetUpdaterRequestUpdate(otInstance *aInstance, const otOperationalDataset *aDataset, otDatasetUpdaterCallback aCallback, void *aContext)
운영 데이터 세트 업데이트를 요청합니다.
otNetworkNameFromString(otNetworkName *aNetworkName, const char *aNameString)
null로 종료된 지정된 C 문자열에서 otNetworkName 인스턴스를 설정합니다.

구조체
otExtendedPanId

확장 PAN ID를 나타냅니다.

otNetworkKey

스레드 네트워크 키를 나타냅니다.

otNetworkName

네트워크 이름을 나타냅니다.

otOperationalDataset

활성 또는 대기 중인 운영 데이터 세트를 나타냅니다.

otOperationalDatasetComponents

활성 또는 대기 중인 운영 데이터 세트에 여러 구성요소가 있음을 나타냅니다.

otOperationalDatasetTlvs

활성 또는 대기 중인 운영 데이터 세트를 나타냅니다.

otPskc

PSKc를 나타냅니다.

otSecurityPolicy

보안 정책을 나타냅니다.

otTimestamp

스레드 데이터 세트 타임스탬프 구성요소를 나타냅니다.

열거형

otMeshcopTlvType

 otMeshcopTlvType

Meshcop TLV 유형을 나타냅니다.

속성
OT_MESHCOP_TLV_ACTIVETIMESTAMP

Meshcop 활성 타임스탬프 TLV

OT_MESHCOP_TLV_BORDER_AGENT_RLOC

Meshcop Border Agent Locator TLV

OT_MESHCOP_TLV_CHANNEL

Meshcop 채널 TLV

OT_MESHCOP_TLV_CHANNELMASK

Meshcop 채널 마스크 TLV

OT_MESHCOP_TLV_COMMISSIONER_ID

Meshcop 커미셔너 ID TLV

OT_MESHCOP_TLV_COMMISSIONER_UDP_PORT

Meshcop 커미셔너 UDP 포트 TLV

OT_MESHCOP_TLV_COMM_SESSION_ID

Meshcop 커미셔너 세션 ID TLV

OT_MESHCOP_TLV_COUNT

Meshcop 개수 TLV

OT_MESHCOP_TLV_DELAYTIMER

Meshcop 지연 타이머 TLV

OT_MESHCOP_TLV_DISCOVERYREQUEST

Meshcop 탐색 요청 TLV

OT_MESHCOP_TLV_DISCOVERYRESPONSE

Meshcop 디스커버리 응답 TLV

OT_MESHCOP_TLV_ENERGY_LIST

Meshcop 에너지 목록 TLV

OT_MESHCOP_TLV_EXTPANID

Meshcop 확장 팬 ID TLV

OT_MESHCOP_TLV_GET

Meshcop TLV 가져오기

OT_MESHCOP_TLV_IPV6_ADDRESS_TLV

Meshcop IPv6 주소 TLV

OT_MESHCOP_TLV_JOINERADVERTISEMENT

Meshcop Joiner 광고 TLV

OT_MESHCOP_TLV_JOINER_DTLS

메시cop 연결자 DTLS 캡슐화 TLV

OT_MESHCOP_TLV_JOINER_IID

Meshcop 연결자 IID TLV

OT_MESHCOP_TLV_JOINER_RLOC

Meshcop 연결자 라우터 로케이터 TLV

OT_MESHCOP_TLV_JOINER_ROUTER_KEK

Meshcop 연결자 라우터 KEK TLV

OT_MESHCOP_TLV_JOINER_UDP_PORT

Meshcop 연결자 UDP 포트 TLV

OT_MESHCOP_TLV_MESHLOCALPREFIX

Meshcop 메시 로컬 프리픽스 TLV

OT_MESHCOP_TLV_NETWORKKEY

Meshcop 네트워크 키 TLV

OT_MESHCOP_TLV_NETWORKNAME

Meshcop 네트워크 이름 TLV

OT_MESHCOP_TLV_NETWORK_KEY_SEQUENCE

Meshcop 네트워크 키 시퀀스 TLV

OT_MESHCOP_TLV_PANID

Meshcop 팬 ID TLV

OT_MESHCOP_TLV_PENDINGTIMESTAMP

Meshcop 대기 중인 타임스탬프 TLV

OT_MESHCOP_TLV_PERIOD

메시코프 기간 TLV

OT_MESHCOP_TLV_PROVISIONING_URL

Meshcop 프로비저닝 URL TLV

OT_MESHCOP_TLV_PSKC

Meshcop PSKc TLV

OT_MESHCOP_TLV_SCAN_DURATION

Meshcop 스캔 시간 TLV

OT_MESHCOP_TLV_SECURITYPOLICY

Meshcop 보안 정책 TLV

OT_MESHCOP_TLV_STATE

Meshcop 상태 TLV

OT_MESHCOP_TLV_STEERING_DATA

Meshcop 스티어링 데이터 TLV

OT_MESHCOP_TLV_UDP_ENCAPSULATION_TLV

메시cop UDP 캡슐화 TLV

OT_MESHCOP_TLV_VENDOR_DATA_TLV

Meshcop 공급업체 데이터 TLV

OT_MESHCOP_TLV_VENDOR_MODEL_TLV

Meshcop 공급업체 모델 TLV

OT_MESHCOP_TLV_VENDOR_NAME_TLV

Meshcop 공급업체 이름 TLV

OT_MESHCOP_TLV_VENDOR_STACK_VERSION_TLV

Meshcop 공급업체 스택 버전 TLV

OT_MESHCOP_TLV_VENDOR_SW_VERSION_TLV

Meshcop 공급업체 SW 버전 TLV

Typedef

otChannelMask

uint32_t otChannelMask

채널 마스크를 나타냅니다.

otDatasetMgmtSetCallback

void(* otDatasetMgmtSetCallback)(otError aResult, void *aContext)

포인터는 MGMT_SET 요청에 대한 응답이 수신되거나 시간 초과될 때 호출됩니다.

세부정보
매개변수
[in] aResult
작업 결과입니다.
[in] aContext
애플리케이션별 컨텍스트에 대한 포인터입니다.
반환 값
OT_ERROR_NONE
리더가 요청을 수락했습니다.
OT_ERROR_REJECTED
리더가 요청을 거부했습니다.
OT_ERROR_PARSE
응답을 파싱하는 중에 오류가 발생했습니다.
OT_ERROR_ABORT
피어에서 요청을 재설정했습니다.
OT_ERROR_RESPONSE_TIMEOUT
제한 시간 동안 수신된 응답이나 확인이 없습니다.

otDatasetUpdaterCallback

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

이 콜백 함수 포인터는 데이터 세트 업데이트 요청이 완료되면 호출되어 데이터 세트 업데이트 요청의 성공 또는 실패 상태를 보고합니다.

OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE가 사용 설정된 경우 사용 가능합니다.

세부정보
매개변수
[in] aError
오류 상태입니다. OT_ERROR_NONE은 데이터 세트 업데이트가 성공했음을 나타냅니다. OT_ERROR_INVALID_STATE는 잘못된 상태 (MLE가 사용 중지됨)로 인해 실패했음을 나타냅니다. OT_ERROR_ALREADY는 충돌하는 데이터 세트 업데이트를 요청하는 네트워크 내 다른 기기로 인한 실패를 나타냅니다.
[in] aContext
임의 컨텍스트의 포인터입니다 (사용자가 otDatasetUpdaterRequestUpdate()에서 제공).

otExtendedPanId

struct otExtendedPanId otExtendedPanId

확장 PAN ID를 나타냅니다.

otMeshLocalPrefix

otIp6NetworkPrefix otMeshLocalPrefix

메시 로컬 프리픽스를 나타냅니다.

otMeshcopTlvType

enum otMeshcopTlvType otMeshcopTlvType

Meshcop TLV 유형을 나타냅니다.

otNetworkKey

struct otNetworkKey otNetworkKey

스레드 네트워크 키를 나타냅니다.

otNetworkKeyRef

otCryptoKeyRef otNetworkKeyRef

이 데이터 유형은 NetworkKey의 KeyRef를 나타냅니다.

키에 대한 참조

otNetworkName

struct otNetworkName otNetworkName

네트워크 이름을 나타냅니다.

otNetworkName는 null로 종료된 C 문자열 (즉, m8 문자 배열은 null 문자 \0로 끝나야 합니다.

otOperationalDataset

struct otOperationalDataset otOperationalDataset

활성 또는 대기 중인 운영 데이터 세트를 나타냅니다.

데이터 세트의 구성요소는 선택사항입니다. mComponents 구조는 데이터 세트에 있는 구성요소를 지정합니다.

otOperationalDatasetComponents

struct otOperationalDatasetComponents otOperationalDatasetComponents

활성 또는 대기 중인 운영 데이터 세트에 여러 구성요소가 있음을 나타냅니다.

otOperationalDatasetTlvs

struct otOperationalDatasetTlvs otOperationalDatasetTlvs

활성 또는 대기 중인 운영 데이터 세트를 나타냅니다.

운영 데이터 세트는 스레드에 지정된 대로 TLV로 인코딩됩니다.

otPskc

struct otPskc otPskc

PSKc를 나타냅니다.

otPskcRef

otCryptoKeyRef otPskcRef

이 데이터 유형은 PSKc에 대한 KeyRef를 나타냅니다.

키에 대한 참조

otSecurityPolicy

struct otSecurityPolicy otSecurityPolicy

보안 정책을 나타냅니다.

otTimestamp

struct otTimestamp otTimestamp

스레드 데이터 세트 타임스탬프 구성요소를 나타냅니다.

변수

OT_TOOL_PACKED_END

OT_TOOL_PACKED_BEGIN struct otNetworkKey OT_TOOL_PACKED_END

함수

otDatasetConvertToTlvs

otError otDatasetConvertToTlvs(
  const otOperationalDataset *aDataset,
  otOperationalDatasetTlvs *aDatasetTlvs
)

지정된 운영 데이터 세트를 otOperationalDatasetTlvs로 변환합니다.

세부정보
매개변수
[in] aDataset
TLV로 변환할 운영 데이터 세트입니다.
[out] aDatasetTlvs
결과를 반환할 데이터 세트 TLV를 가리키는 포인터입니다.
반환 값
OT_ERROR_NONE
aDataset가 변환되고 aDatasetTlvs가 업데이트되었습니다.
OT_ERROR_INVALID_ARGS
aDataset이(가) 잘못되었습니다. 활성 또는 대기 중인 타임스탬프가 없습니다.

otDatasetCreateNewNetwork

otError otDatasetCreateNewNetwork(
  otInstance *aInstance,
  otOperationalDataset *aDataset
)

FTD에만 해당되며 새 네트워크를 구성할 때 사용할 새 운영 데이터 세트를 만듭니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[out] aDataset
운영 데이터 세트
반환 값
OT_ERROR_NONE
새 운영 데이터 세트를 만들었습니다.
OT_ERROR_FAILED
새 매개변수의 임의 값을 생성할 수 없습니다.

otDatasetGeneratePskc

otError otDatasetGeneratePskc(
  const char *aPassPhrase,
  const otNetworkName *aNetworkName,
  const otExtendedPanId *aExtPanId,
  otPskc *aPskc
)

지정된 암호, 네트워크 이름, 확장된 PAN ID에서 PSKc를 생성합니다.

PSKc는 커미셔닝 세션을 설정하는 데 사용됩니다.

세부정보
매개변수
[in] aPassPhrase
커미셔닝 암호입니다.
[in] aNetworkName
PSKc 계산을 위한 네트워크 이름입니다.
[in] aExtPanId
PSKc 계산을 위한 확장된 PAN ID입니다.
[out] aPskc
생성된 PSKc를 출력할 변수에 대한 포인터입니다.
반환 값
OT_ERROR_NONE
PSKc를 생성했습니다.
OT_ERROR_INVALID_ARGS
입력 인수 중 잘못된 것이 있는 경우

otDatasetGetActive

otError otDatasetGetActive(
  otInstance *aInstance,
  otOperationalDataset *aDataset
)

활성 작업 데이터 세트를 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[out] aDataset
활성 운영 데이터 세트를 배치할 포인터입니다.
반환 값
OT_ERROR_NONE
활성 운영 데이터 세트를 가져왔습니다.
OT_ERROR_NOT_FOUND
설정 저장소에 해당하는 값이 없습니다.

otDatasetGetActiveTlvs

otError otDatasetGetActiveTlvs(
  otInstance *aInstance,
  otOperationalDatasetTlvs *aDataset
)

활성 작업 데이터 세트를 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[out] aDataset
활성 운영 데이터 세트를 배치할 포인터입니다.
반환 값
OT_ERROR_NONE
활성 운영 데이터 세트를 가져왔습니다.
OT_ERROR_NOT_FOUND
설정 저장소에 해당하는 값이 없습니다.

otDatasetGetDelayTimerMinimal

uint32_t otDatasetGetDelayTimerMinimal(
  otInstance *aInstance
)

FTD에만 최소 지연 타이머를 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환 값
the
최소 지연 타이머의 값 (밀리초)입니다.

otDatasetGetPending

otError otDatasetGetPending(
  otInstance *aInstance,
  otOperationalDataset *aDataset
)

대기 중인 작업 데이터 세트를 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[out] aDataset
운영 대기 중인 데이터 세트가 배치될 위치를 가리키는 포인터입니다.
반환 값
OT_ERROR_NONE
대기 중인 작업 데이터 세트를 가져왔습니다.
OT_ERROR_NOT_FOUND
설정 저장소에 해당하는 값이 없습니다.

otDatasetGetPendingTlvs

otError otDatasetGetPendingTlvs(
  otInstance *aInstance,
  otOperationalDatasetTlvs *aDataset
)

대기 중인 작업 데이터 세트를 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[out] aDataset
운영 대기 중인 데이터 세트가 배치될 위치를 가리키는 포인터입니다.
반환 값
OT_ERROR_NONE
대기 중인 작업 데이터 세트를 가져왔습니다.
OT_ERROR_NOT_FOUND
설정 저장소에 해당하는 값이 없습니다.

otDatasetIsCommissioned

bool otDatasetIsCommissioned(
  otInstance *aInstance
)

활성 운영 데이터 세트에 유효한 네트워크가 있는지 여부를 나타냅니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
활성 운영 데이터 세트에 유효한 네트워크가 있으면 TRUE, 그렇지 않으면 FALSE입니다.

otDatasetParseTlvs

otError otDatasetParseTlvs(
  const otOperationalDatasetTlvs *aDatasetTlvs,
  otOperationalDataset *aDataset
)

지정된 otOperationalDatasetTlvs에서 운영 데이터 세트를 파싱합니다.

세부정보
매개변수
[in] aDatasetTlvs
데이터 세트 TLV를 가리키는 포인터입니다.
[out] aDataset
데이터 세트가 배치될 위치를 가리키는 포인터입니다.
반환 값
OT_ERROR_NONE
aDatasetTlvs에서 aDataset을(를) 설정했습니다.
OT_ERROR_INVALID_ARGS
aDatasetTlvs의 형식이 잘못되었습니다.

otDatasetSendMgmtActiveGet

otError otDatasetSendMgmtActiveGet(
  otInstance *aInstance,
  const otOperationalDatasetComponents *aDatasetComponents,
  const uint8_t *aTlvTypes,
  uint8_t aLength,
  const otIp6Address *aAddress
)

MGMT_ACTIVE_GET을 전송합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aDatasetComponents
요청할 구성요소를 지정하는 데이터 세트 구성요소 구조에 대한 포인터입니다.
[in] aTlvTypes
요청할 추가 원시 TLV 유형이 포함된 배열에 대한 포인터입니다.
[in] aLength
aTlvTypes의 길이입니다.
[in] aAddress
IPv6 대상에 대한 포인터가 NULL인 경우 리더 ALOC를 기본값으로 사용합니다.
반환 값
OT_ERROR_NONE
Meshcop 데이터 세트 명령어를 전송했습니다.
OT_ERROR_NO_BUFS
전송할 버퍼 공간이 부족합니다.

otDatasetSendMgmtActiveSet

otError otDatasetSendMgmtActiveSet(
  otInstance *aInstance,
  const otOperationalDataset *aDataset,
  const uint8_t *aTlvs,
  uint8_t aLength,
  otDatasetMgmtSetCallback aCallback,
  void *aContext
)

MGMT_ACTIVE_SET을 전송합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aDataset
운영 데이터 세트를 가리키는 포인터입니다.
[in] aTlvs
TLV를 가리키는 포인터입니다.
[in] aLength
TLV의 길이입니다.
[in] aCallback
응답 수신 또는 시간 초과 시 호출되는 함수에 대한 포인터입니다.
[in] aContext
aCallback의 애플리케이션별 컨텍스트에 대한 포인터입니다.
반환 값
OT_ERROR_NONE
Meshcop 데이터 세트 명령어를 전송했습니다.
OT_ERROR_NO_BUFS
전송할 버퍼 공간이 부족합니다.
OT_ERROR_BUSY
이전 요청이 진행 중입니다.

otDatasetSendMgmtPendingGet

otError otDatasetSendMgmtPendingGet(
  otInstance *aInstance,
  const otOperationalDatasetComponents *aDatasetComponents,
  const uint8_t *aTlvTypes,
  uint8_t aLength,
  const otIp6Address *aAddress
)

MGMT_PENDING_GET을 전송합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aDatasetComponents
요청할 구성요소를 지정하는 데이터 세트 구성요소 구조에 대한 포인터입니다.
[in] aTlvTypes
요청할 추가 원시 TLV 유형이 포함된 배열에 대한 포인터입니다.
[in] aLength
aTlvTypes의 길이입니다.
[in] aAddress
IPv6 대상에 대한 포인터가 NULL인 경우 리더 ALOC를 기본값으로 사용합니다.
반환 값
OT_ERROR_NONE
Meshcop 데이터 세트 명령어를 전송했습니다.
OT_ERROR_NO_BUFS
전송할 버퍼 공간이 부족합니다.

otDatasetSendMgmtPendingSet

otError otDatasetSendMgmtPendingSet(
  otInstance *aInstance,
  const otOperationalDataset *aDataset,
  const uint8_t *aTlvs,
  uint8_t aLength,
  otDatasetMgmtSetCallback aCallback,
  void *aContext
)

MGMT_PENDING_SET을 전송합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aDataset
운영 데이터 세트를 가리키는 포인터입니다.
[in] aTlvs
TLV를 가리키는 포인터입니다.
[in] aLength
TLV의 길이입니다.
[in] aCallback
응답 수신 또는 시간 초과 시 호출되는 함수에 대한 포인터입니다.
[in] aContext
aCallback의 애플리케이션별 컨텍스트에 대한 포인터입니다.
반환 값
OT_ERROR_NONE
Meshcop 데이터 세트 명령어를 전송했습니다.
OT_ERROR_NO_BUFS
전송할 버퍼 공간이 부족합니다.
OT_ERROR_BUSY
이전 요청이 진행 중입니다.

otDatasetSetActive

otError otDatasetSetActive(
  otInstance *aInstance,
  const otOperationalDataset *aDataset
)

활성 운영 데이터 세트를 설정합니다.

데이터 세트에 활성 타임스탬프가 포함되어 있지 않으면 데이터 세트는 부분적으로만 완료된 것입니다.

부분적으로 완전한 활성 데이터 세트가 있는 기기에서 스레드를 사용 설정하면 기기는 데이터 세트의 기존 정보를 사용하여 기존 스레드 네트워크에 연결하려고 시도합니다. 네트워크에 연결하려면 스레드 네트워크 키만 있으면 됩니다.

데이터 세트에 채널이 포함되지 않은 경우 기기는 여러 채널에서 MLE Announce 메시지를 보내 다른 채널에서 이웃을 찾습니다.

기기가 스레드 네트워크에 성공적으로 연결되면 상위 항목에서 전체 활성 데이터 세트를 검색합니다. 라우터 지원 기기는 완전한 활성 데이터 세트가 갖춰질 때까지 라우터 또는 리더 역할로 전환되지 않습니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aDataset
활성 운영 데이터 세트를 가리키는 포인터입니다.
반환 값
OT_ERROR_NONE
활성 운영 데이터 세트를 설정했습니다.
OT_ERROR_NO_BUFS
활성 운영 데이터 세트를 설정할 버퍼 공간이 부족합니다.
OT_ERROR_NOT_IMPLEMENTED
플랫폼이 설정 기능을 구현하지 않습니다.

otDatasetSetActiveTlvs

otError otDatasetSetActiveTlvs(
  otInstance *aInstance,
  const otOperationalDatasetTlvs *aDataset
)

활성 운영 데이터 세트를 설정합니다.

데이터 세트에 활성 타임스탬프가 포함되어 있지 않으면 데이터 세트는 부분적으로만 완료된 것입니다.

부분적으로 완전한 활성 데이터 세트가 있는 기기에서 스레드를 사용 설정하면 기기는 데이터 세트의 기존 정보를 사용하여 기존 스레드 네트워크에 연결하려고 시도합니다. 네트워크에 연결하려면 스레드 네트워크 키만 있으면 됩니다.

데이터 세트에 채널이 포함되지 않은 경우 기기는 여러 채널에서 MLE Announce 메시지를 보내 다른 채널에서 이웃을 찾습니다.

기기가 스레드 네트워크에 성공적으로 연결되면 상위 항목에서 전체 활성 데이터 세트를 검색합니다. 라우터 지원 기기는 완전한 활성 데이터 세트가 갖춰질 때까지 라우터 또는 리더 역할로 전환되지 않습니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aDataset
활성 운영 데이터 세트를 가리키는 포인터입니다.
반환 값
OT_ERROR_NONE
활성 운영 데이터 세트를 설정했습니다.
OT_ERROR_NO_BUFS
활성 운영 데이터 세트를 설정할 버퍼 공간이 부족합니다.
OT_ERROR_NOT_IMPLEMENTED
플랫폼이 설정 기능을 구현하지 않습니다.

otDatasetSetDelayTimerMinimal

otError otDatasetSetDelayTimerMinimal(
  otInstance *aInstance,
  uint32_t aDelayTimerMinimal
)

FTD에만 최소 지연 타이머를 설정합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aDelayTimerMinimal
최소 지연 타이머의 값 (밀리초)입니다.
반환 값
OT_ERROR_NONE
최소 지연 타이머를 설정했습니다.
OT_ERROR_INVALID_ARGS
aDelayTimerMinimal가 유효하지 않은 경우

otDatasetSetPending

otError otDatasetSetPending(
  otInstance *aInstance,
  const otOperationalDataset *aDataset
)

대기 중인 운영 데이터 세트를 설정합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aDataset
운영 대기 중인 데이터 세트에 대한 포인터입니다.
반환 값
OT_ERROR_NONE
대기 중인 작업 데이터 세트를 설정했습니다.
OT_ERROR_NO_BUFS
대기 중인 운영 데이터 세트를 설정하기에 버퍼 공간이 부족합니다.
OT_ERROR_NOT_IMPLEMENTED
플랫폼이 설정 기능을 구현하지 않습니다.

otDatasetSetPendingTlvs

otError otDatasetSetPendingTlvs(
  otInstance *aInstance,
  const otOperationalDatasetTlvs *aDataset
)

대기 중인 운영 데이터 세트를 설정합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aDataset
운영 대기 중인 데이터 세트에 대한 포인터입니다.
반환 값
OT_ERROR_NONE
대기 중인 작업 데이터 세트를 설정했습니다.
OT_ERROR_NO_BUFS
대기 중인 운영 데이터 세트를 설정하기에 버퍼 공간이 부족합니다.
OT_ERROR_NOT_IMPLEMENTED
플랫폼이 설정 기능을 구현하지 않습니다.

otDatasetUpdateTlvs

otError otDatasetUpdateTlvs(
  const otOperationalDataset *aDataset,
  otOperationalDatasetTlvs *aDatasetTlvs
)

지정된 운영 데이터 세트를 업데이트합니다.

aDataset에는 업데이트할 필드와 새 값이 포함됩니다.

세부정보
매개변수
[in] aDataset
업데이트할 유형과 값의 집합을 지정합니다.
[in,out] aDatasetTlvs
업데이트할 데이터 세트 TLV에 대한 포인터입니다.
반환 값
OT_ERROR_NONE
aDatasetTlvs 업데이트가 완료되었습니다.
OT_ERROR_INVALID_ARGS
aDataset에 잘못된 값이 포함되어 있습니다.
OT_ERROR_NO_BUFS
aDatasetTlvs에 업데이트를 적용할 공간이 부족합니다.

otDatasetUpdaterCancelUpdate

void otDatasetUpdaterCancelUpdate(
  otInstance *aInstance
)

진행 중인 운영 데이터 세트 업데이트 요청을 취소합니다 (있는 경우).

OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE가 사용 설정된 경우 사용 가능합니다.

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

otDatasetUpdaterIsUpdateOngoing

bool otDatasetUpdaterIsUpdateOngoing(
  otInstance *aInstance
)

진행 중인 작업 데이터 세트 업데이트 요청이 있는지 여부를 나타냅니다.

OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE가 사용 설정된 경우 사용 가능합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환 값
TRUE
진행 중인 업데이트가 있습니다.
FALSE
진행 중인 업데이트가 없습니다.

otDatasetUpdaterRequestUpdate

otError otDatasetUpdaterRequestUpdate(
  otInstance *aInstance,
  const otOperationalDataset *aDataset,
  otDatasetUpdaterCallback aCallback,
  void *aContext
)

운영 데이터 세트 업데이트를 요청합니다.

OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE가 사용 설정된 경우 사용 가능합니다.

aDataset에는 업데이트할 필드와 새 값이 포함되어야 합니다. 활성 또는 보류 타임스탬프 필드를 포함해서는 안 됩니다. 지연 필드는 선택사항이며, 입력하지 않으면 기본값 (1000ms)이 사용됩니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aDataset
변경할 필드가 포함된 데이터 세트에 대한 포인터입니다.
[in] aCallback
데이터 세트 업데이트 요청이 완료되는 시점을 나타내는 콜백입니다.
[in] aContext
콜백에 전달되는 임의 컨텍스트입니다.
반환 값
OT_ERROR_NONE
데이터 세트 업데이트가 시작되었습니다 (완료 시 aCallback가 호출됩니다).
OT_ERROR_INVALID_STATE
기기가 사용 중지되었습니다 (MLE가 사용 중지됨).
OT_ERROR_INVALID_ARGS
aDataset이(가) 유효하지 않습니다(활성 또는 대기 중인 타임스탬프 포함).
OT_ERROR_BUSY
이전 업데이트가 진행 중이므로 업데이트를 시작할 수 없습니다.
OT_ERROR_NO_BUFS
데이터 세트를 저장할 버퍼를 할당할 수 없습니다.

otNetworkNameFromString

otError otNetworkNameFromString(
  otNetworkName *aNetworkName,
  const char *aNameString
)

null로 종료된 지정된 C 문자열에서 otNetworkName 인스턴스를 설정합니다.

aNameString은(는) UTF-8 인코딩을 따라야 하며 네트워크 이름 길이는 OT_NETWORK_NAME_MAX_SIZE 이하여야 합니다.

세부정보
매개변수
[out] aNetworkName
설정할 otNetworkName의 포인터입니다.
[in] aNameString
이름 C 문자열.
반환 값
OT_ERROR_NONE
aNameString에서 aNetworkName을(를) 설정했습니다.
OT_ERROR_INVALID_ARGS
aNameStrng은(는) 유효하지 않습니다(너무 길거나 UTF-8 인코딩을 따르지 않음).

매크로

OT_CHANNEL_10_MASK

 OT_CHANNEL_10_MASK (1 << 10)

채널 10

OT_CHANNEL_11_MASK

 OT_CHANNEL_11_MASK (1 << 11)

채널 11.

OT_CHANNEL_12_MASK

 OT_CHANNEL_12_MASK (1 << 12)

채널 12.

OT_CHANNEL_13_MASK

 OT_CHANNEL_13_MASK (1 << 13)

채널 13.

OT_CHANNEL_14_MASK

 OT_CHANNEL_14_MASK (1 << 14)

채널 14.

OT_CHANNEL_15_MASK

 OT_CHANNEL_15_MASK (1 << 15)

채널 15.

OT_CHANNEL_16_MASK

 OT_CHANNEL_16_MASK (1 << 16)

채널 16.

OT_CHANNEL_17_MASK

 OT_CHANNEL_17_MASK (1 << 17)

채널 17.

OT_CHANNEL_18_MASK

 OT_CHANNEL_18_MASK (1 << 18)

채널 18.

OT_CHANNEL_19_MASK

 OT_CHANNEL_19_MASK (1 << 19)

채널 19.

OT_CHANNEL_1_MASK

 OT_CHANNEL_1_MASK (1 << 1)

채널 1.

OT_CHANNEL_20_MASK

 OT_CHANNEL_20_MASK (1 << 20)

채널 20

OT_CHANNEL_21_MASK

 OT_CHANNEL_21_MASK (1 << 21)

채널 21.

OT_CHANNEL_22_MASK

 OT_CHANNEL_22_MASK (1 << 22)

채널 22.

OT_CHANNEL_23_MASK

 OT_CHANNEL_23_MASK (1 << 23)

채널 23.

OT_CHANNEL_24_MASK

 OT_CHANNEL_24_MASK (1 << 24)

채널 24

OT_CHANNEL_25_MASK

 OT_CHANNEL_25_MASK (1 << 25)

채널 25.

OT_CHANNEL_26_MASK

 OT_CHANNEL_26_MASK (1 << 26)

채널 26.

OT_CHANNEL_2_MASK

 OT_CHANNEL_2_MASK (1 << 2)

채널 2.

OT_CHANNEL_3_MASK

 OT_CHANNEL_3_MASK (1 << 3)

채널 3.

OT_CHANNEL_4_MASK

 OT_CHANNEL_4_MASK (1 << 4)

채널 4.

OT_CHANNEL_5_MASK

 OT_CHANNEL_5_MASK (1 << 5)

채널 5.

OT_CHANNEL_6_MASK

 OT_CHANNEL_6_MASK (1 << 6)

채널 6.

OT_CHANNEL_7_MASK

 OT_CHANNEL_7_MASK (1 << 7)

채널 7.

OT_CHANNEL_8_MASK

 OT_CHANNEL_8_MASK (1 << 8)

채널 8.

OT_CHANNEL_9_MASK

 OT_CHANNEL_9_MASK (1 << 9)

채널 9.

OT_EXT_PAN_ID_SIZE

 OT_EXT_PAN_ID_SIZE 8

스레드 PAN ID의 크기 (바이트)

OT_MESH_LOCAL_PREFIX_SIZE

 OT_MESH_LOCAL_PREFIX_SIZE OT_IP6_PREFIX_SIZE

메시 로컬 프리픽스의 크기 (바이트)

OT_NETWORK_KEY_SIZE

 OT_NETWORK_KEY_SIZE 16

스레드 네트워크 키의 크기 (바이트)

OT_NETWORK_NAME_MAX_SIZE

 OT_NETWORK_NAME_MAX_SIZE 16

스레드 네트워크 이름 필드의 최대 크기 (바이트)

OT_OPERATIONAL_DATASET_MAX_LENGTH

 OT_OPERATIONAL_DATASET_MAX_LENGTH 254

운영 데이터 세트의 최대 길이(바이트)입니다.

OT_PSKC_MAX_SIZE

 OT_PSKC_MAX_SIZE 16

PSKc의 최대 크기 (바이트)

자료

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