운영 데이터 세트
이 모듈에는 Dataset Updater의 기능이 포함되어 있습니다.
요약
이 모듈의 기능은 Dataset Updater 기능이 활성화 된 경우에 사용할 수 있습니다 (예 : OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
이 1로 설정 됨). 또한이 기능은 FTD 빌드에서만 사용할 수 있습니다.
Typedef | |
---|---|
otChannelMask | typedefuint32_t 이 유형은 채널 마스크를 나타냅니다. |
otDatasetUpdaterCallback )(otError aError, void *aContext) | typedefvoid(* 이 콜백 함수 포인터는 데이터 세트 업데이트 요청이 완료되면 호출되어 데이터 세트 업데이트 요청의 성공 또는 실패 상태를보고합니다. |
otExtendedPanId | typedefstruct otExtendedPanId 이 구조는 확장 PAN ID를 나타냅니다. |
otMasterKey | typedefstruct otMasterKey 이 구조는 스레드 마스터 키를 나타냅니다. |
otMeshLocalPrefix | typedef 이 구조는 Mesh Local Prefix를 나타냅니다. |
otMeshcopTlvType | typedefenum otMeshcopTlvType 이 열거 형은 meshcop TLV 유형을 나타냅니다. |
otNetworkName | typedefstruct otNetworkName 이 구조는 네트워크 이름을 나타냅니다. |
otOperationalDataset | typedefstruct otOperationalDataset 이 구조는 활성 또는 보류중인 운영 데이터 세트를 나타냅니다. |
otOperationalDatasetComponents | typedef 이 구조는 Active 또는 Pending Operational Dataset에 다른 구성 요소가 있음을 나타냅니다. |
otOperationalDatasetTlvs | typedefstruct otOperationalDatasetTlvs 이 구조는 활성 또는 보류중인 운영 데이터 세트를 나타냅니다. |
otPskc | typedefstruct otPskc 이 구조는 PSKc를 나타냅니다. |
otSecurityPolicy | typedefstruct otSecurityPolicy 이 구조는 보안 정책을 나타냅니다. |
변수 | |
---|---|
OT_TOOL_PACKED_END | OT_TOOL_PACKED_BEGIN struct otMasterKey |
기능 | |
---|---|
otDatasetCreateNewNetwork ( otInstance *aInstance, otOperationalDataset *aDataset) | 이 메서드는 새 네트워크를 구성 할 때 사용할 새 운영 데이터 세트를 만듭니다. |
otDatasetGeneratePskc (const char *aPassPhrase, const otNetworkName *aNetworkName, const otExtendedPanId *aExtPanId, otPskc *aPskc) | 이 함수는 주어진 암호, 네트워크 이름 및 확장 PAN ID에서 PSKc를 생성합니다. |
otDatasetGetActive ( otInstance *aInstance, otOperationalDataset *aDataset) | 이 함수는 Active Operational Dataset을 가져옵니다. |
otDatasetGetActiveTlvs ( otInstance *aInstance, otOperationalDatasetTlvs *aDataset) | 이 함수는 Active Operational Dataset을 가져옵니다. |
otDatasetGetDelayTimerMinimal ( otInstance *aInstance) | uint32_t 최소 지연 타이머를 가져옵니다. |
otDatasetGetPending ( otInstance *aInstance, otOperationalDataset *aDataset) | 이 함수는 Pending Operational Dataset을 가져옵니다. |
otDatasetGetPendingTlvs ( otInstance *aInstance, otOperationalDatasetTlvs *aDataset) | 이 함수는 Pending Operational Dataset을 가져옵니다. |
otDatasetIsCommissioned ( otInstance *aInstance) | bool 이 기능은 유효한 네트워크가 Active Operational Dataset에 있는지 여부를 나타냅니다. |
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) | 이 함수는 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) | 이 함수는 MGMT_PENDING_SET을 보냅니다. |
otDatasetSetActive ( otInstance *aInstance, const otOperationalDataset *aDataset) | 이 기능은 Active Operational Dataset을 설정합니다. |
otDatasetSetActiveTlvs ( otInstance *aInstance, const otOperationalDatasetTlvs *aDataset) | 이 기능은 Active Operational Dataset을 설정합니다. |
otDatasetSetDelayTimerMinimal ( otInstance *aInstance, uint32_t aDelayTimerMinimal) | 최소 지연 타이머를 설정합니다. |
otDatasetSetPending ( otInstance *aInstance, const otOperationalDataset *aDataset) | 이 함수는 Pending Operational Dataset을 설정합니다. |
otDatasetSetPendingTlvs ( otInstance *aInstance, const otOperationalDatasetTlvs *aDataset) | 이 함수는 Pending Operational Dataset을 설정합니다. |
otDatasetUpdaterCancelUpdate ( otInstance *aInstance) | void 이 함수는 진행중인 (있는 경우) 운영 데이터 세트 업데이트 요청을 취소합니다. |
otDatasetUpdaterIsUpdateOngoing ( otInstance *aInstance) | bool 이 함수는 진행중인 Operation Dataset 업데이트 요청이 있는지 여부를 나타냅니다. |
otDatasetUpdaterRequestUpdate ( otInstance *aInstance, const otOperationalDataset *aDataset, otDatasetUpdaterCallback aCallback, void *aContext, uint32_t aReryWaitInterval) | 이 함수는 Operational Dataset에 대한 업데이트를 요청합니다. |
구조체 | |
---|---|
otExtendedPanId | 이 구조는 확장 PAN ID를 나타냅니다. |
otMasterKey | 이 구조는 스레드 마스터 키를 나타냅니다. |
otNetworkName | 이 구조는 네트워크 이름을 나타냅니다. |
otOperationalDataset | 이 구조는 활성 또는 보류중인 운영 데이터 세트를 나타냅니다. |
otOperationalDatasetComponents | 이 구조는 Active 또는 Pending Operational Dataset에 다른 구성 요소가 있음을 나타냅니다. |
otOperationalDatasetTlvs | 이 구조는 활성 또는 보류중인 운영 데이터 세트를 나타냅니다. |
otPskc | 이 구조는 PSKc를 나타냅니다. |
otSecurityPolicy | 이 구조는 보안 정책을 나타냅니다. |
열거 형
익명 열거 형
anonymous enum
otMeshcopTlvType
otMeshcopTlvType
이 열거 형은 meshcop TLV 유형을 나타냅니다.
Typedef
otChannelMask
uint32_t otChannelMask
이 유형은 채널 마스크를 나타냅니다.
otDatasetUpdaterCallback
void(* otDatasetUpdaterCallback)(otError aError, void *aContext)
이 콜백 함수 포인터는 데이터 세트 업데이트 요청이 완료되면 호출되어 데이터 세트 업데이트 요청의 성공 또는 실패 상태를보고합니다.
세부 | |||||
---|---|---|---|---|---|
매개 변수 |
|
otOperationalDataset
struct otOperationalDataset otOperationalDataset
이 구조는 활성 또는 보류중인 운영 데이터 세트를 나타냅니다.
데이터 세트의 구성 요소는 선택 사항입니다. mComponets
구조는 데이터 세트에 어떤 구성 요소가 있는지 지정합니다.
otOperationalDatasetComponents
struct otOperationalDatasetComponents otOperationalDatasetComponents
이 구조는 Active 또는 Pending Operational Dataset에 다른 구성 요소가 있음을 나타냅니다.
otOperationalDatasetTlvs
struct otOperationalDatasetTlvs otOperationalDatasetTlvs
이 구조는 활성 또는 보류중인 운영 데이터 세트를 나타냅니다.
운영 데이터 세트는 Thread에서 지정한대로 TLV로 인코딩됩니다.
변수
OT_TOOL_PACKED_END
OT_TOOL_PACKED_BEGIN struct otMasterKey OT_TOOL_PACKED_END
기능
otDatasetCreateNewNetwork
otError otDatasetCreateNewNetwork( otInstance *aInstance, otOperationalDataset *aDataset )
이 메서드는 새 네트워크를 구성 할 때 사용할 새 운영 데이터 세트를 만듭니다.
세부 | |||||
---|---|---|---|---|---|
매개 변수 |
| ||||
반환 값 |
|
otDatasetGeneratePskc
otError otDatasetGeneratePskc( const char *aPassPhrase, const otNetworkName *aNetworkName, const otExtendedPanId *aExtPanId, otPskc *aPskc )
이 함수는 주어진 암호, 네트워크 이름 및 확장 PAN ID에서 PSKc를 생성합니다.
PSKc는 커미셔너 세션을 설정하는 데 사용됩니다.
세부 | |||||||||
---|---|---|---|---|---|---|---|---|---|
매개 변수 |
| ||||||||
반환 값 |
|
otDatasetGetActive
otError otDatasetGetActive( otInstance *aInstance, otOperationalDataset *aDataset )
이 함수는 Active Operational Dataset을 가져옵니다.
세부 | |||||
---|---|---|---|---|---|
매개 변수 |
| ||||
반환 값 |
|
otDatasetGetActiveTlvs
otError otDatasetGetActiveTlvs( otInstance *aInstance, otOperationalDatasetTlvs *aDataset )
이 함수는 Active Operational Dataset을 가져옵니다.
세부 | |||||
---|---|---|---|---|---|
매개 변수 |
| ||||
반환 값 |
|
otDatasetGetDelayTimerMinimal
uint32_t otDatasetGetDelayTimerMinimal( otInstance *aInstance )
최소 지연 타이머를 가져옵니다.
세부 | |||
---|---|---|---|
매개 변수 |
| ||
반환 값 |
|
otDatasetGetPending
otError otDatasetGetPending( otInstance *aInstance, otOperationalDataset *aDataset )
이 함수는 Pending Operational Dataset을 가져옵니다.
세부 | |||||
---|---|---|---|---|---|
매개 변수 |
| ||||
반환 값 |
|
otDatasetGetPendingTlvs
otError otDatasetGetPendingTlvs( otInstance *aInstance, otOperationalDatasetTlvs *aDataset )
이 함수는 Pending Operational Dataset을 가져옵니다.
세부 | |||||
---|---|---|---|---|---|
매개 변수 |
| ||||
반환 값 |
|
otDatasetIsCommissioned
bool otDatasetIsCommissioned( otInstance *aInstance )
이 기능은 유효한 네트워크가 Active Operational Dataset에 있는지 여부를 나타냅니다.
세부 | |||
---|---|---|---|
매개 변수 |
| ||
보고 | 유효한 네트워크가 Active Operational Dataset에 있으면 TRUE, 그렇지 않으면 FALSE입니다. |
otDatasetSendMgmtActiveGet
otError otDatasetSendMgmtActiveGet( otInstance *aInstance, const otOperationalDatasetComponents *aDatasetComponents, const uint8_t *aTlvTypes, uint8_t aLength, const otIp6Address *aAddress )
이 함수는 MGMT_ACTIVE_GET을 보냅니다.
세부 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
매개 변수 |
| ||||||||||
반환 값 |
|
otDatasetSendMgmtActiveSet
otError otDatasetSendMgmtActiveSet( otInstance *aInstance, const otOperationalDataset *aDataset, const uint8_t *aTlvs, uint8_t aLength )
이 함수는 MGMT_ACTIVE_SET을 보냅니다.
세부 | |||||||||
---|---|---|---|---|---|---|---|---|---|
매개 변수 |
| ||||||||
반환 값 |
|
otDatasetSendMgmtPendingGet
otError otDatasetSendMgmtPendingGet( otInstance *aInstance, const otOperationalDatasetComponents *aDatasetComponents, const uint8_t *aTlvTypes, uint8_t aLength, const otIp6Address *aAddress )
이 함수는 MGMT_PENDING_GET을 보냅니다.
세부 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
매개 변수 |
| ||||||||||
반환 값 |
|
otDatasetSendMgmtPendingSet
otError otDatasetSendMgmtPendingSet( otInstance *aInstance, const otOperationalDataset *aDataset, const uint8_t *aTlvs, uint8_t aLength )
이 함수는 MGMT_PENDING_SET을 보냅니다.
세부 | |||||||||
---|---|---|---|---|---|---|---|---|---|
매개 변수 |
| ||||||||
반환 값 |
|
otDatasetSetActive
otError otDatasetSetActive( otInstance *aInstance, const otOperationalDataset *aDataset )
이 기능은 Active Operational Dataset을 설정합니다.
데이터 세트에 활성 타임 스탬프가 포함되지 않은 경우 데이터 세트는 부분적으로 만 완료된 것입니다.
부분적으로 완전한 활성 데이터 세트가있는 장치에서 스레드가 활성화 된 경우 장치는 데이터 세트의 기존 정보를 사용하여 기존 스레드 네트워크에 연결을 시도합니다. 스레드 마스터 키만 네트워크에 연결하면됩니다.
채널이 데이터 세트에 포함되지 않은 경우 장치는 다른 채널에서 이웃을 찾기 위해 여러 채널을 통해 MLE Announce 메시지를 보냅니다.
장치가 스레드 네트워크에 성공적으로 연결되면 장치는 상위에서 전체 활성 데이터 세트를 검색합니다. 라우터 지원 장치는 완전한 활성 데이터 세트를 가질 때까지 라우터 또는 리더 역할로 전환되지 않습니다.
세부 | |||||||
---|---|---|---|---|---|---|---|
매개 변수 |
| ||||||
반환 값 |
|
otDatasetSetActiveTlvs
otError otDatasetSetActiveTlvs( otInstance *aInstance, const otOperationalDatasetTlvs *aDataset )
이 기능은 Active Operational Dataset을 설정합니다.
데이터 세트에 활성 타임 스탬프가 포함되지 않은 경우 데이터 세트는 부분적으로 만 완료된 것입니다.
부분적으로 완전한 활성 데이터 세트가있는 장치에서 스레드가 활성화 된 경우 장치는 데이터 세트의 기존 정보를 사용하여 기존 스레드 네트워크에 연결을 시도합니다. 스레드 마스터 키만 네트워크에 연결하면됩니다.
채널이 데이터 세트에 포함되지 않은 경우 장치는 다른 채널에서 이웃을 찾기 위해 여러 채널을 통해 MLE Announce 메시지를 보냅니다.
장치가 스레드 네트워크에 성공적으로 연결되면 장치는 상위에서 전체 활성 데이터 세트를 검색합니다. 라우터 지원 장치는 완전한 활성 데이터 세트를 가질 때까지 라우터 또는 리더 역할로 전환되지 않습니다.
세부 | |||||||
---|---|---|---|---|---|---|---|
매개 변수 |
| ||||||
반환 값 |
|
otDatasetSetDelayTimerMinimal
otError otDatasetSetDelayTimerMinimal( otInstance *aInstance, uint32_t aDelayTimerMinimal )
최소 지연 타이머를 설정합니다.
세부 | |||||
---|---|---|---|---|---|
매개 변수 |
| ||||
반환 값 |
|
otDatasetSetPending
otError otDatasetSetPending( otInstance *aInstance, const otOperationalDataset *aDataset )
이 함수는 Pending Operational Dataset을 설정합니다.
세부 | |||||||
---|---|---|---|---|---|---|---|
매개 변수 |
| ||||||
반환 값 |
|
otDatasetSetPendingTlvs
otError otDatasetSetPendingTlvs( otInstance *aInstance, const otOperationalDatasetTlvs *aDataset )
이 함수는 Pending Operational Dataset을 설정합니다.
세부 | |||||||
---|---|---|---|---|---|---|---|
매개 변수 |
| ||||||
반환 값 |
|
otDatasetUpdaterCancelUpdate
void otDatasetUpdaterCancelUpdate( otInstance *aInstance )
이 함수는 진행중인 (있는 경우) 운영 데이터 세트 업데이트 요청을 취소합니다.
세부 | |||
---|---|---|---|
매개 변수 |
|
otDatasetUpdaterIsUpdateOngoing
bool otDatasetUpdaterIsUpdateOngoing( otInstance *aInstance )
이 함수는 진행중인 Operation Dataset 업데이트 요청이 있는지 여부를 나타냅니다.
세부 | |||||
---|---|---|---|---|---|
매개 변수 |
| ||||
반환 값 |
|
otDatasetUpdaterRequestUpdate
otError otDatasetUpdaterRequestUpdate( otInstance *aInstance, const otOperationalDataset *aDataset, otDatasetUpdaterCallback aCallback, void *aContext, uint32_t aReryWaitInterval )
이 함수는 Operational Dataset에 대한 업데이트를 요청합니다.
aDataset
에는 업데이트 할 필드와 새 값이 포함되어야합니다. 활성 또는 보류중인 시간 소인 필드를 포함하지 않아야합니다. 지연 필드는 선택 사항이며 제공되지 않으면 기본값 (1000ms)이 사용됩니다.
세부 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
매개 변수 |
| ||||||||||
반환 값 |
|
매크로
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_MASTER_KEY_SIZE
OT_MASTER_KEY_SIZE 16
스레드 마스터 키의 크기 (바이트)
OT_MESH_LOCAL_PREFIX_SIZE
OT_MESH_LOCAL_PREFIX_SIZE OT_IP6_PREFIX_SIZE
메시 로컬 접두사의 크기 (바이트)
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의 최대 크기 (바이트)