Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

설정

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

요약

열거

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)
설정에 값을 추가합니다.
otPlatSettingsDeinit ( otInstance *aInstance)
void
필요한 경우 설정 하위 시스템에 대한 초기화 해제를 수행합니다.
otPlatSettingsDelete ( otInstance *aInstance, uint16_t aKey, int aIndex)
설정 저장소에서 설정을 제거합니다.
otPlatSettingsGet ( otInstance *aInstance, uint16_t aKey, int aIndex, uint8_t *aValue, uint16_t *aValueLength)
설정 값을 가져옵니다.
otPlatSettingsInit ( otInstance *aInstance)
void
필요한 경우 설정 하위 시스템에 대한 초기화를 수행합니다.
otPlatSettingsSet ( otInstance *aInstance, uint16_t aKey, const uint8_t *aValue, uint16_t aValueLength)
설정 값을 설정하거나 바꿉니다.
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 인스턴스 구조.