이 페이지는 Cloud Translation API를 통해 번역되었습니다.

설정

이 모듈은 설정의 비휘발성 저장을 위한 플랫폼 추상화를 포함합니다.

요약

열거
anonymous enum { OT_SETTINGS_KEY_ACTIVE_DATASET = 0x0001, OT_SETTINGS_KEY_PENDING_DATASET = 0x0002, OT_SETTINGS_KEY_NETWORK_INFO = 0x0003, OT_SETTINGS_KEY_PARENT_INFO = 0x0004, OT_SETTINGS_KEY_CHILD_INFO = 0x0005, OT_SETTINGS_KEY_RESERVED = 0x0006, OT_SETTINGS_KEY_SLAAC_IID_SECRET_KEY = 0x0007, OT_SETTINGS_KEY_DAD_INFO = 0x0008, OT_SETTINGS_KEY_OMR_PREFIX = 0x0009, OT_SETTINGS_KEY_ON_LINK_PREFIX = 0x000a, OT_SETTINGS_KEY_SRP_ECDSA_KEY = 0x000b, OT_SETTINGS_KEY_SRP_CLIENT_INFO = 0x000c, OT_SETTINGS_KEY_SRP_SERVER_INFO = 0x000d }	열거 이 열거형은 설정 키를 정의합니다.

열거

anonymous enum {
 OT_SETTINGS_KEY_ACTIVE_DATASET = 0x0001,
 OT_SETTINGS_KEY_PENDING_DATASET = 0x0002,
 OT_SETTINGS_KEY_NETWORK_INFO = 0x0003,
 OT_SETTINGS_KEY_PARENT_INFO = 0x0004,
 OT_SETTINGS_KEY_CHILD_INFO = 0x0005,
 OT_SETTINGS_KEY_RESERVED = 0x0006,
 OT_SETTINGS_KEY_SLAAC_IID_SECRET_KEY = 0x0007,
 OT_SETTINGS_KEY_DAD_INFO = 0x0008,
 OT_SETTINGS_KEY_OMR_PREFIX = 0x0009,
 OT_SETTINGS_KEY_ON_LINK_PREFIX = 0x000a,
 OT_SETTINGS_KEY_SRP_ECDSA_KEY = 0x000b,
 OT_SETTINGS_KEY_SRP_CLIENT_INFO = 0x000c,
 OT_SETTINGS_KEY_SRP_SERVER_INFO = 0x000d
 }

열거

이 열거형은 설정 키를 정의합니다.

기능
`otPlatSettingsAdd ( otInstance aInstance, uint16_t aKey, const uint8_t aValue, uint16_t aValueLength)`	`otError` 설정에 값을 추가합니다.
`otPlatSettingsDeinit ( otInstance *aInstance)`	`void` 필요한 경우 설정 하위 시스템에 대한 초기화 해제를 수행합니다.
`otPlatSettingsDelete ( otInstance *aInstance, uint16_t aKey, int aIndex)`	`otError` 설정 저장소에서 설정을 제거합니다.
`otPlatSettingsGet ( otInstance aInstance, uint16_t aKey, int aIndex, uint8_t aValue, uint16_t *aValueLength)`	`otError` 설정 값을 가져옵니다.
`otPlatSettingsInit ( otInstance *aInstance)`	`void` 필요한 경우 설정 하위 시스템에 대한 초기화를 수행합니다.
`otPlatSettingsSet ( otInstance aInstance, uint16_t aKey, const uint8_t aValue, uint16_t aValueLength)`	`otError` 설정 값을 설정하거나 바꿉니다.
`otPlatSettingsSetCriticalKeys ( otInstance aInstance, const uint16_t aKeys, uint16_t aKeysLength)`	`void` 이 기능은 보안 영역에 저장되어야 하는 중요한 키를 설정합니다.
`otPlatSettingsWipe ( otInstance *aInstance)`	`void` 설정 저장소에서 모든 설정을 제거합니다.

열거

익명의 열거형

 anonymous enum

이 열거형은 설정 키를 정의합니다.

참고 : 키에 해당하는 설정이 보안 민감한 정보가 포함되어있는 경우, 새로운 setings 키를 추가 할 때, 개발자가 배열에 키를 추가해야합니다 kCriticalKeys .

속성
`OT_SETTINGS_KEY_ACTIVE_DATASET`	활성 운영 데이터 세트.
`OT_SETTINGS_KEY_CHILD_INFO`	아동 정보.
`OT_SETTINGS_KEY_DAD_INFO`	중복 주소 감지(DAD) 정보.
`OT_SETTINGS_KEY_NETWORK_INFO`	스레드 네트워크 정보.
`OT_SETTINGS_KEY_OMR_PREFIX`	OMR(오프 메시 라우팅 가능) 접두사.
`OT_SETTINGS_KEY_ON_LINK_PREFIX`	인프라 링크에 대한 온링크 접두사.
`OT_SETTINGS_KEY_PARENT_INFO`	부모 정보.
`OT_SETTINGS_KEY_PENDING_DATASET`	보류 중인 운영 데이터 세트.
`OT_SETTINGS_KEY_RESERVED`	예약됨(이전에는 자동 시작).
`OT_SETTINGS_KEY_SLAAC_IID_SECRET_KEY`	의미적으로 불투명한 IID를 생성하기 위한 SLAAC 키입니다.
`OT_SETTINGS_KEY_SRP_CLIENT_INFO`	SRP 클라이언트 정보(선택한 SRP 서버 주소).
`OT_SETTINGS_KEY_SRP_ECDSA_KEY`	SRP 클라이언트 ECDSA 공개/개인 키 쌍.
`OT_SETTINGS_KEY_SRP_SERVER_INFO`	SRP 서버 정보(UDP 포트).

기능

otPlatSettings추가

otError otPlatSettingsAdd(
  otInstance *aInstance,
  uint16_t aKey,
  const uint8_t *aValue,
  uint16_t aValueLength
)

설정에 값을 추가합니다.

이 함수는 기존 값을 바꾸지 않고 Key로 식별된 설정에 값을 추가합니다.

특정 키와 연결된 항목의 순서를 유지하기 위해 기본 구현이 필요하지 않습니다. 부가 가치는 끝, 시작, 또는 중간 어딘가에 추가될 수 있습니다. 기존 값의 순서도 변경될 수 있습니다.

이 함수를 성공적으로 호출하면 여러 값이 있는 관련 없는 설정이 재정렬될 수 있습니다.

세부

매개변수

`[in] aInstance`	OpenThread 인스턴스 구조.
`[in] aKey`	변경할 설정과 관련된 키입니다.
`[in] aValue`	설정의 새 값을 읽어야 하는 위치에 대한 포인터입니다. aValueLength가 0이 아닌 경우 NULL이 아니어야 합니다(MUST NOT).
`[in] aValueLength`	Value가 가리키는 데이터의 길이입니다. 0일 수 있습니다.

반환 값

`OT_ERROR_NONE`	지정된 설정이 추가되었거나 추가될 준비가 되었습니다.
`OT_ERROR_NOT_IMPLEMENTED`	이 기능은 이 플랫폼에서 구현되지 않습니다.
`OT_ERROR_NO_BUFS`	주어진 설정을 저장할 공간이 남아 있지 않습니다.

otPlatSettingsDeinit

void otPlatSettingsDeinit(
  otInstance *aInstance
)

필요한 경우 설정 하위 시스템에 대한 초기화 해제를 수행합니다.

세부

매개변수

[in] aInstance

OpenThread 인스턴스 구조.

otPlat 설정삭제

otError otPlatSettingsDelete(
  otInstance *aInstance,
  uint16_t aKey,
  int aIndex
)

설정 저장소에서 설정을 제거합니다.

이 기능은 설정 저장소에서 aKey로 식별된 설정의 특정 값을 삭제합니다.

특정 키와 연결된 항목의 순서를 유지하기 위해 기본 구현이 필요하지 않습니다.

세부

매개변수

`[in] aInstance`	OpenThread 인스턴스 구조.
`[in] aKey`	요청한 설정과 연결된 키입니다.
`[in] aIndex`	제거할 값의 인덱스입니다. -1로 설정하면 이 키의 모든 값이 제거됩니다.

반환 값

`OT_ERROR_NONE`	주어진 키와 인덱스가 발견되어 성공적으로 제거되었습니다.
`OT_ERROR_NOT_FOUND`	지정된 키 또는 인덱스를 설정 저장소에서 찾을 수 없습니다.
`OT_ERROR_NOT_IMPLEMENTED`	이 기능은 이 플랫폼에서 구현되지 않습니다.

otPlatSettingsGet

otError otPlatSettingsGet(
  otInstance *aInstance,
  uint16_t aKey,
  int aIndex,
  uint8_t *aValue,
  uint16_t *aValueLength
)

설정 값을 가져옵니다.

이 함수는 aKey로 식별된 설정 값을 가져와 aValue가 가리키는 메모리에 씁니다. 그런 다음 aValueLength가 가리키는 정수에 길이를 씁니다. aValueLength의 초기 값은 aValue에 쓸 최대 바이트 수입니다.

이 함수는 aValue 및 aValueLength를 NULL로 설정하여 값을 가져오지 않고 키의 존재를 확인하는 데 사용할 수 있습니다. aValue만 NULL로 설정하여 설정을 가져오지 않고 설정의 길이를 확인할 수도 있습니다.

여러 값으로 설정 순서를 유지하기 위해 기본 저장소 구현이 필요하지 않습니다. 이러한 값의 순서는 저장소에 대한 모든 쓰기 작업 후에 변경될 수 있습니다(MAY).

세부

매개변수

`[in] aInstance`	OpenThread 인스턴스 구조.
`[in] aKey`	요청한 설정과 연결된 키입니다.
`[in] aIndex`	가져올 특정 항목의 인덱스입니다.
`[out] aValue`	설정 값을 기록해야 하는 위치에 대한 포인터입니다. 설정의 존재 또는 길이를 테스트하는 경우 NULL로 설정할 수 있습니다.
`[in,out] aValueLength`	값의 길이에 대한 포인터입니다. 호출될 때 이 포인터는 Value에 쓸 수 있는 최대 값 크기를 포함하는 정수를 가리켜야 합니다. 반환 시 설정의 실제 길이가 기록됩니다. 존재 확인을 수행하는 경우 NULL로 설정될 수 있습니다.

반환 값

`OT_ERROR_NONE`	지정된 설정을 찾아 성공적으로 가져왔습니다.
`OT_ERROR_NOT_FOUND`	설정 저장소에서 지정된 설정을 찾을 수 없습니다.
`OT_ERROR_NOT_IMPLEMENTED`	이 기능은 이 플랫폼에서 구현되지 않습니다.

otPlatSettingsInit

void otPlatSettingsInit(
  otInstance *aInstance
)

필요한 경우 설정 하위 시스템에 대한 초기화를 수행합니다.

세부

매개변수

[in] aInstance

OpenThread 인스턴스 구조.

otPlatSettingsSet

otError otPlatSettingsSet(
  otInstance *aInstance,
  uint16_t aKey,
  const uint8_t *aValue,
  uint16_t aValueLength
)

설정 값을 설정하거나 바꿉니다.

이 함수는 aKey로 식별되는 설정 값을 설정하거나 대체합니다. 이전에 Key와 연결된 값이 두 개 이상이었다면 모두 삭제되고 이 단일 항목으로 대체됩니다.

이 함수를 성공적으로 호출하면 여러 값이 있는 관련 없는 설정이 재정렬될 수 있습니다.

세부

매개변수

`[in] aInstance`	OpenThread 인스턴스 구조.
`[in] aKey`	변경할 설정과 관련된 키입니다.
`[in] aValue`	설정의 새 값을 읽어야 하는 위치에 대한 포인터입니다. aValueLength가 0이 아닌 경우 NULL이 아니어야 합니다(MUST NOT).
`[in] aValueLength`	Value가 가리키는 데이터의 길이. 0일 수 있습니다.

반환 값

`OT_ERROR_NONE`	주어진 설정이 변경되거나 준비되었습니다.
`OT_ERROR_NOT_IMPLEMENTED`	이 기능은 이 플랫폼에서 구현되지 않습니다.
`OT_ERROR_NO_BUFS`	주어진 설정을 저장할 공간이 남아 있지 않습니다.

otPlatSettingsSetCriticalKeys

void otPlatSettingsSetCriticalKeys(
  otInstance *aInstance,
  const uint16_t *aKeys,
  uint16_t aKeysLength
)

이 기능은 보안 영역에 저장되어야 하는 중요한 키를 설정합니다.

메모리가 가리키는 있습니다 aKeys 이전에 출시되어서는 안 aInstance 파괴된다.

세부

매개변수

`[in] aInstance`	OpenThread 인스턴스 구조.
`[in] aKeys`	중요한 키 목록을 포함하는 배열에 대한 포인터입니다.
`[in] aKeysLength`	항목 수 `aKeys` 배열.

otPlat 설정 지우기

void otPlatSettingsWipe(
  otInstance *aInstance
)

설정 저장소에서 모든 설정을 제거합니다.

이 기능은 설정 저장소에서 모든 설정을 삭제하고 초기 공장 상태로 재설정합니다.

세부

매개변수

[in] aInstance

OpenThread 인스턴스 구조.