네트워크 시간 동기화

이 모듈에는 네트워크 시간 동기화 서비스를 제어하는 기능이 포함되어 있습니다.

요약

열거
`otNetworkTimeStatus { OT_NETWORK_TIME_UNSYNCHRONIZED = -1, OT_NETWORK_TIME_RESYNC_NEEDED = 0, OT_NETWORK_TIME_SYNCHRONIZED = 1 }`	열거 형 이 열거는 OpenThread 시간 동기화 상태를 나타냅니다.

타입 정의
`otNetworkTimeStatus`	typedef `enum otNetworkTimeStatus` 이 열거는 OpenThread 시간 동기화 상태를 나타냅니다.
`otNetworkTimeSyncCallbackFn )(void *aCallbackContext)`	typedef `void(*` 이 기능 포인터는 네트워크 시간 동기화 또는 상태 변경이 발생할 때 호출됩니다.

기능
`otNetworkTimeGet ( otInstance aInstance, uint64_t aNetworkTime)`	`otNetworkTimeStatus` 스레드 네트워크 시간을 가져옵니다.
`otNetworkTimeGetSyncPeriod ( otInstance *aInstance)`	`uint16_t` 시간 동기화 기간을 가져옵니다.
`otNetworkTimeGetXtalThreshold ( otInstance *aInstance)`	`uint16_t` 라우터의 시간 동기화 XTAL 정확도 임계 값을 가져옵니다.
`otNetworkTimeSetSyncPeriod ( otInstance *aInstance, uint16_t aTimeSyncPeriod)`	`otError` 시간 동기화 기간을 설정하십시오.
`otNetworkTimeSetXtalThreshold ( otInstance *aInstance, uint16_t aXTALThreshold)`	`otError` 라우터 가능 장치의 시간 동기화 XTAL 정확도 임계 값을 설정하십시오.
`otNetworkTimeSyncSetCallback ( otInstance aInstance, otNetworkTimeSyncCallbackFn aCallbackFn, void aCallbackContext)`	`void` 네트워크 시간 동기화 또는 상태 변경시 콜백을 호출하도록 설정하십시오.

열거

otNetworkTimeStatus

 otNetworkTimeStatus

이 열거는 OpenThread 시간 동기화 상태를 나타냅니다.

속성
`OT_NETWORK_TIME_RESYNC_NEEDED`	장치가 두 시간 이상 시간 동기화를받지 못했습니다.
`OT_NETWORK_TIME_SYNCHRONIZED`	장치 네트워크 시간이 동기화되었습니다.
`OT_NETWORK_TIME_UNSYNCHRONIZED`	장치가 네트워크에 연결되지 않았습니다.

타입 정의

otNetworkTimeStatus

enum otNetworkTimeStatus otNetworkTimeStatus

이 열거는 OpenThread 시간 동기화 상태를 나타냅니다.

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

이 기능 포인터는 네트워크 시간 동기화 또는 상태 변경이 발생할 때 호출됩니다.

기능

otNetworkTimeGet

 otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

스레드 네트워크 시간을 가져옵니다.

세부

매개 변수

`[in] aInstance`	OpenThread 인스턴스 구조.
`[in,out] aNetworkTime`	스레드 네트워크 시간 (마이크로 초)

보고

시간 동기화 상태

otNetworkTimeGetSyncPeriod

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

시간 동기화 기간을 가져옵니다.

세부

매개 변수

[in] aInstance

OpenThread 인스턴스 구조.

보고

시간 동기화 기간

otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

라우터의 시간 동기화 XTAL 정확도 임계 값을 가져옵니다.

세부

매개 변수

[in] aInstance

OpenThread 인스턴스 구조.

보고

PPM의 라우터에 대한 XTAL 정확도 임계 값입니다.

otNetworkTimeSetSyncPeriod

 otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

시간 동기화 기간을 설정하십시오.

이 기능은 스레드 프로토콜이 비활성화 된 경우에만 호출 할 수 있습니다.

세부

매개 변수

`[in] aInstance`	OpenThread 인스턴스 구조.
`[in] aTimeSyncPeriod`	시간 동기화 기간 (초)입니다.

반환 값

`OT_ERROR_NONE`	시간 동기화 기간을 설정했습니다.
`OT_ERROR_INVALID_STATE`	스레드 프로토콜이 활성화되었습니다.

otNetworkTimeSetXtalThreshold

 otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

라우터 가능 장치의 시간 동기화 XTAL 정확도 임계 값을 설정하십시오.

이 기능은 스레드 프로토콜이 비활성화 된 경우에만 호출 할 수 있습니다.

세부

매개 변수

`[in] aInstance`	OpenThread 인스턴스 구조.
`[in] aXTALThreshold`	PPM의 라우터에 대한 XTAL 정확도 임계 값입니다.

반환 값

`OT_ERROR_NONE`	시간 동기화 기간을 설정했습니다.
`OT_ERROR_INVALID_STATE`	스레드 프로토콜이 활성화되었습니다.

otNetworkTimeSyncSetCallback

void otNetworkTimeSyncSetCallback(
  otInstance *aInstance,
  otNetworkTimeSyncCallbackFn aCallbackFn,
  void *aCallbackContext
)

네트워크 시간 동기화 또는 상태 변경시 콜백을 호출하도록 설정하십시오.

이 콜백은 네트워크 시간 오프셋이 OPENTHREAD_CONFIG_TIME_SYNC_JUMP_NOTIF_MIN_US만큼 점프하거나 상태가 변경 될 때만 호출됩니다.

세부

매개 변수

`[in] aInstance`	OpenThread 인스턴스 구조.
`[in] aCallbackFn`	호출 할 콜백 함수
`[in] aCallbackContext`	호출시 콜백 함수에 전달 될 컨텍스트

매크로

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

0은 유효하지 않은 시간 동기화 시퀀스로 간주됩니다.