nl::Weave::Profiles::Time::TimeSyncNode

요약

상속

다음에서 상속: nl::Weave::Profiles::Time::_TimeSyncNodeBase

생성자 및 소멸자

TimeSyncNode(void)
mBootTimeForNextAutoDiscovery_usec
timesync_t
mIsAutoSyncEnabled
bool
자동 동기화 기능에 사용되는 상태
mIsUrgentDiscoveryPending
bool
mNominalDiscoveryPeriod_msec
int32_t
mShortestDiscoveryPeriod_msec
int32_t
mSyncPeriod_msec
int32_t
mActiveContact
커뮤니케이션 컨텍스트입니다.
mExchangeContext
mUnadjTimestampLastSent_usec
timesync_t
EnterState_Discover(void)
void
이러한 상태 전환 함수는 내부용이며 이전 상태에서 처리할 방법이 없으므로 오류 코드를 반환할 수 없습니다.
EnterState_ServiceSync_1(void)
void
EnterState_ServiceSync_2(void)
void
EnterState_Sync_1(void)
void
EnterState_Sync_2(void)
void

공개 유형

ClientState enum
이 시간 동기화 클라이언트의 현재 상태
CommState enum
상태를 나타냅니다.
ContributorFilter)(void *const aApp, Contact aContact[], const int aSize) typedef
void(*
콜백이 발생하는 시점은 응답에서 시간 수정을 계산하기 직전에 발생합니다.
OnSyncRequestReceivedHandler)(void *const aApp, const WeaveMessageInfo *aMsgInfo, const uint8_t aLikelyhood, const bool aIsTimeCoordinator) typedef
bool(*
방금 시간 동기화 요청을 수신했음을 나타냅니다.
ResponseStatus enum
특정 연락처에 대한 저장된 응답의 상태.
ServerState{
  kServerState_UnreliableAfterBoot,
  kServerState_Idle
}
enum
이 시간 동기화 서버의 현재 상태
SyncFailedHandler)(void *const aApp, const WEAVE_ERROR aErrorCode) typedef
void(*
콜백은 자동 동기화를 비롯하여 동기화가 실패한 것으로 간주될 때 발생합니다.
SyncSucceededHandler)(void *const aApp, const timesync_t aOffsetUsec, const bool aIsReliable, const bool aIsServer, const uint8_t aNumContributor) typedef
bool(*
콜백은 자동 동기화를 비롯하여 동기화가 성공한 것으로 간주된 후 결과가 적용되기 전에 발생합니다.
TimeChangeNotificationHandler)(void *const aApp, const uint64_t aNodeId, const IPAddress &aNodeAddr) typedef
void(*
방금 시간 변경 알림을 수신했음을 나타냅니다.

공개 속성

FilterTimeCorrectionContributor
OnSyncFailed
OnSyncRequestReceived
설정하지 않으면 기본 구현이 항상 true를 반환합니다.
OnSyncSucceeded
설정하지 않으면 기본 동작은 아주 작은 규모의 서버 수정을 제외한 모든 결과를 가져옵니다.
OnTimeChangeNotificationReceived
mEncryptionType
uint8_t
로컬 통신을 위한 암호화 방법
mKeyId
uint16_t
로컬 통신에 사용되는 키 ID

보호된 속성

mApp
void *
상위 레이어 데이터에 대한 포인터
mClientState
mConnectionToService
서비스와 통신하는 데 사용되는 TCP 연결입니다.
mContacts[WEAVE_CONFIG_TIME_CLIENT_MAX_NUM_CONTACTS]
탐색 과정에서 습득한 연락처 정보
mIsAlwaysFresh
bool
mIsInCallback
bool
상위 레이어에 대한 콜백에 있는 경우 true
mLastLikelihoodSent
int8_t
mNumContributorInLastLocalSync
uint8_t
mRole
TimeSyncRole
이 노드의 실제 역할입니다.
mServerState
mServiceContact
mTimestampLastCorrectionFromServerOrNtp_usec
timesync_t
수면 시간에 대한 보상이 필요하므로 부팅 시간이어야 합니다.
mTimestampLastLocalSync_usec
timesync_t
수면 시간에 대한 보상이 필요하므로 부팅 시간이어야 합니다.

공개 함수

Abort(void)
엔진을 유휴 상태로 되돌리고 수행 중인 모든 작업을 중단합니다.
DisableAutoSync(void)
void
자동 동기화 사용 중지
EnableAutoSync(const int32_t aSyncPeriod_msec, const int32_t aNominalDiscoveryPeriod_msec, const int32_t aShortestDiscoveryPeriod_msec)
자동 동기화 사용 설정
GetCapacityOfContactList(void) const
int
이 엔진이 저장하도록 구성된 최대 연락처 수에 대한 간단한 getter
GetClientState(void) const
클라이언트 상태의 간단한 getter
GetNextLikelihood(void) const
int8_t
확률을 추출합니다.
GetServerState(void) const
서버 상태의 간단한 getter
InitClient(void *const aApp, WeaveExchangeManager *aExchangeMgr, const uint8_t aEncryptionType, const uint16_t aKeyId, const int8_t aInitialLikelyhood)
이 클라이언트를 초기화합니다.
InitCoordinator(nl::Weave::WeaveExchangeManager *aExchangeMgr, const uint8_t aEncryptionType, const uint16_t aKeyId, const int32_t aSyncPeriod_msec, const int32_t aNominalDiscoveryPeriod_msec, const int32_t aShortestDiscoveryPeriod_msec)
이 코디네이터를 초기화합니다.
InitServer(void *const aApp, WeaveExchangeManager *const aExchangeMgr, const bool aIsAlwaysFresh)
시간 동기화 서버가 되려면 객체 생성 후 첫 번째 함수로 서버 역할의 초기화를 호출해야 합니다.
MulticastTimeChangeNotification(const uint8_t aEncryptionType, const uint16_t aKeyId) const
void
멀티캐스트 시간 변경 알림을 위해 상위 레이어에서 호출합니다.
RegisterCorrectionFromServerOrNtp(void)
void
서버와의 시간 동기화가 방금 완료되었음을 나타내기 위해 상위 레이어에서 호출되거나 NTP와 같은 안정적인 수단을 통해 호출됩니다.
RegisterLocalSyncOperation(const uint8_t aNumContributor)
void
다른 지역 코디네이터와의 동기화를 방금 마쳤음을 나타내기 위해 상위 레이어에서 호출합니다.
Shutdown(void)
해당 서비스가 어떤 역할을 수행하든지 중지할 수 있습니다.
Sync(const bool aForceDiscoverAgain)
기존 연락처를 사용하여 동기화합니다.
SyncWithNodes(const int16_t aNumNode, const ServingNode aNodes[])
동기화할 수 있습니다.
SyncWithService(WeaveConnection *const aConnection)
주어진 TCP 연결과 관련 암호화 및 키 ID를 사용하여

보호된 함수

AbortOnError(const WEAVE_ERROR aCode)
void
aCode가 WEAVE_NO_ERROR가 아닌 경우 내부 취소
AutoSyncNow(void)
void
자동 동기화 세션을 시작하는 내부 함수
CallbackForSyncCompletion(const bool aIsSuccessful, bool aShouldUpdate, const bool aIsCorrectionReliable, const bool aIsFromServer, const uint8_t aNumContributor, const timesync_t aSystemTimestamp_usec, const timesync_t aDiffTime_usec)
애플리케이션 계층에 콜백을 유도합니다.
ClearState(void)
void
DestroyCommContext(void)
bool
Weave ExchangeContext를 닫습니다.
EndLocalSyncAndTryCalculateTimeFix(void)
void
EndServiceSyncAndTryCalculateTimeFix(void)
void
FindReplaceableContact(const uint64_t aNodeId, const IPAddress & aNodeAddr, bool aIsTimeChangeNotification)
슬롯을 반환하여 연락처 정보 저장
GetClientStateName(void) const
const char *const
GetNextIdleContact(void)
통신할 다음 유효하고 유휴 상태 가져오기
GetNumNotYetCompletedContacts(void)
int16_t
유효한 연락처 수를 가져오지만 아직 이야기하지 않았습니다.
GetNumReliableResponses(void)
int16_t
지금까지 수집된 '신뢰할 수 있는' 응답의 수를 가져옵니다.
InitState(const TimeSyncRole aRole, void *const aApp, WeaveExchangeManager *const aExchangeMgr)
InvalidateAllContacts(void)
void
모든 로컬 연락처 무효화
InvalidateServiceContact(void)
void
서비스에 대한 연락처 무효화
RegisterCommError(Contact *const aContact)
void
특정 연락처의 통신 오류를 등록하고 필요한 경우 자동 검색 기간을 단축함
SendSyncRequest(bool *const rIsMessageSent, Contact *const aContact)
연락처에 유니캐스트 동기화 요청을 보냅니다.
SetAllCompletedContactsToIdle(void)
int16_t
완료된 모든 연락처를 다시 유휴 상태로 재설정하되 응답은 만지지 않습니다.
SetAllValidContactsToIdleAndInvalidateResponse(void)
int16_t
모든 유효한 로컬 연락처를 유휴 상태로 설정하고 응답을 지웁니다.
SetClientState(const ClientState state)
void
SetupUnicastCommContext(Contact *const aContact)
유니캐스트 통신을 위한 새로운 Weave Exchange 만들기
StoreNotifyingContact(const uint64_t aNodeId, const IPAddress & aNodeAddr)
void
방금 시간 변경 알림을 보낸 노드의 연락처 정보 저장
UpdateMulticastSyncResponse(const uint64_t aNodeId, const IPAddress & aNodeAddr, const TimeSyncResponse & aResponse)
void
멀티캐스트 요청에서 반환되는 응답 처리
UpdateUnicastSyncResponse(const TimeSyncResponse & aResponse)
void
유니캐스트 요청에서 반환되는 응답 처리
_InitClient(const uint8_t aEncryptionType, const uint16_t aKeyId, const int8_t aInitialLikelyhood)
초기화해야 합니다.
_InitServer(const bool aIsAlwaysFresh)
초기화합니다.
_ShutdownClient(void)
콜백에서 사용할 수 없는 클라이언트를 중지합니다.
_ShutdownCoordinator(void)
코디네이터를 중지합니다.
_ShutdownServer(void)
콜백에서 사용할 수 없는 서버를 중지합니다.

보호된 정적 함수

HandleAutoDiscoveryTimeout(System::Layer *aSystemLayer, void *aAppState, System::Error aError)
void
HandleAutoSyncTimeout(System::Layer *aSystemLayer, void *aAppState, System::Error aError)
void
HandleMulticastResponseTimeout(System::Layer *aSystemLayer, void *aAppState, System::Error aError)
void
HandleMulticastSyncResponse(ExchangeContext *ec, const IPPacketInfo *pktInfo, const WeaveMessageInfo *msgInfo, uint32_t profileId, uint8_t msgType, PacketBuffer *payload)
void
HandleSyncRequest(ExchangeContext *ec, const IPPacketInfo *pktInfo, const WeaveMessageInfo *msgInfo, uint32_t profileId, uint8_t msgType, PacketBuffer *payload)
void
시간 동기화 요청이 도착할 때 Weave Exchange의 콜백
HandleTimeChangeNotification(ExchangeContext *ec, const IPPacketInfo *pktInfo, const WeaveMessageInfo *msgInfo, uint32_t profileId, uint8_t msgType, PacketBuffer *payload)
void
HandleUnicastResponseTimeout(ExchangeContext *const ec)
void
HandleUnicastSyncResponse(ExchangeContext *ec, const IPPacketInfo *pktInfo, const WeaveMessageInfo *msgInfo, uint32_t profileId, uint8_t msgType, PacketBuffer *payload)
void
HandleUnreliableAfterBootTimer(System::Layer *aSystemLayer, void *aAppState, System::Error aError)
void
부팅 배리어 후 신뢰할 수 없는 값을 전달했을 때 Weave 타이머의 콜백이 호출됩니다.
IsOperationalState(ClientState aState)
bool
지정된 상태가 작동하는지 확인합니다.
_OnSyncSucceeded(void *const aApp, const nl::Weave::Profiles::Time::timesync_t aOffsetUsec, const bool aIsReliable, const bool aIsServer, const uint8_t aNumContributor)
bool

mBootTimeForNextAutoDiscovery_usec

timesync_t mBootTimeForNextAutoDiscovery_usec

mIsAutoSyncEnabled

bool mIsAutoSyncEnabled

자동 동기화 기능에 사용되는 상태

mIsUrgentDiscoveryPending

bool mIsUrgentDiscoveryPending

mNominalDiscoveryPeriod_msec

int32_t mNominalDiscoveryPeriod_msec

mShortestDiscoveryPeriod_msec

int32_t mShortestDiscoveryPeriod_msec

mSyncPeriod_msec

int32_t mSyncPeriod_msec

mActiveContact

Contact * mActiveContact

커뮤니케이션 컨텍스트입니다.

mExchangeContext

ExchangeContext * mExchangeContext

mUnadjTimestampLastSent_usec

timesync_t mUnadjTimestampLastSent_usec

EnterState_Discover

void EnterState_Discover(
  void
)

이러한 상태 전환 함수는 내부용이며 이전 상태에서 처리할 방법이 없으므로 오류 코드를 반환할 수 없습니다.

모든 실패가 결국 또 다른 상태 전환 (타임아웃될 수 있음)으로 이어짐

EnterState_ServiceSync_1

void EnterState_ServiceSync_1(
  void
)

EnterState_ServiceSync_2

void EnterState_ServiceSync_2(
  void
)

EnterState_Sync_1

void EnterState_Sync_1(
  void
)

EnterState_Sync_2

void EnterState_Sync_2(
  void
)

공개 유형

ClientState

 ClientState

이 시간 동기화 클라이언트의 현재 상태

CommState

 CommState

상태를 나타냅니다.

연락처가 공개 상태이므로 공개되었습니다.

ContributorFilter

void(* ContributorFilter)(void *const aApp, Contact aContact[], const int aSize)

콜백이 발생하는 시점은 응답에서 시간 수정을 계산하기 직전에 발생합니다.

애플리케이션 레이어는 계산에서 응답이 무시되도록 aContact[i].mResponseStatus를 kResponseStatus_Invalid로 덮어쓸 수 있습니다.

세부정보
매개변수
[in] aApp
Init에 설정된 앱 레이어 데이터를 가리키는 포인터입니다.
[in] aContact
연락처 배열 및 응답 상태
[in] aSize
aContact 배열의 레코드 수

OnSyncRequestReceivedHandler

bool(* OnSyncRequestReceivedHandler)(void *const aApp, const WeaveMessageInfo *aMsgInfo, const uint8_t aLikelyhood, const bool aIsTimeCoordinator)

방금 시간 동기화 요청을 수신했음을 나타냅니다.

세부정보
매개변수
[in] aApp
Init에 설정된 앱 레이어 데이터를 가리키는 포인터입니다.
[in] aMsgInfo
발신자 정보를 포함하여 수신된 시간 동기화 요청에 관한 정보가 포함된 WeaveMessageInfo입니다.
[in] aLikelyhood
생성자가 요청한 응답 가능성
[in] aIsTimeCoordinator
발신 노드가 시간 동기화 코디네이터인 경우 true
반환
false이면 엔진은 이 요청을 무시함

ResponseStatus

 ResponseStatus

특정 연락처에 대한 저장된 응답의 상태.

연락처가 공개 상태이므로 공개되었습니다.

ServerState

 ServerState

이 시간 동기화 서버의 현재 상태

속성
kServerState_Idle

서버는 정상적인 설정으로 요청에 응답할 준비가 되어 있습니다.

kServerState_UnreliableAfterBoot

Init 호출 시 aIsAlwaysFresh가 true인 경우에만 의미가 있는 다른 수단을 통해 서버가 시스템 시간을 동기화하기 위해 예약된 시간입니다.

SyncFailedHandler

void(* SyncFailedHandler)(void *const aApp, const WEAVE_ERROR aErrorCode)

콜백은 자동 동기화를 비롯하여 동기화가 실패한 것으로 간주될 때 발생합니다.

Abort가 호출되어 동기화를 중지하는 경우 콜백이 발생하지 않음

세부정보
매개변수
[in] aApp
Init에 설정된 앱 레이어 데이터를 가리키는 포인터입니다.
[in] aErrorCode
실패 이유

SyncSucceededHandler

bool(* SyncSucceededHandler)(void *const aApp, const timesync_t aOffsetUsec, const bool aIsReliable, const bool aIsServer, const uint8_t aNumContributor)

콜백은 자동 동기화를 비롯하여 동기화가 성공한 것으로 간주된 후 결과가 적용되기 전에 발생합니다.

성공한다고 해서 적용 가능한 결과가 있는 것은 아닙니다. 응답이 수신되지 않는 경우 aNumContributor는 0으로 설정됩니다. 애플리케이션 레이어는 aContact[i].mResponseStatus를 kResponseStatus_Invalid로 덮어써서 응답이 계산에서 무시되도록 할 수 있습니다.

세부정보
매개변수
[in] aApp
Init에 설정된 앱 레이어 데이터를 가리키는 포인터입니다.
[in] aOffsetUsec
usec의 교정량
[in] aIsReliable
내장 논리에 의해 신뢰할 수 있는 것으로 간주되는 교정값이
[in] aIsServer
수정사항이 서버에서
[in] aNumContributor
이 수정에 기여한 노드 수입니다. 0은 동기화 작업 결과가 없음을 의미합니다.
반환
이 오프셋을 시스템 시간을 조정하는 데 사용해야 하는 경우 true입니다. aNumContributor가 0인 경우 반환 값은 무시됩니다.

TimeChangeNotificationHandler

void(* TimeChangeNotificationHandler)(void *const aApp, const uint64_t aNodeId, const IPAddress &aNodeAddr)

방금 시간 변경 알림을 수신했음을 나타냅니다.

자동 동기화 모드가 사용 설정된 경우 시간 동기화가 이 콜백 직후에 자동으로 예약됩니다. 그렇지 않은 경우 애플리케이션 계층은 동기 함수 제품군을 호출하여 일반적인 콜백 사용 불가 규칙에 의해 제한되지 않는 동기화 작업을 직접 시작할 수 있습니다. 그러나 이 특별 콜백은 여전히 Weave 교환 레이어의 콜백 스택 위에 있음을 유의해야 합니다.

세부정보
매개변수
[in] aApp
Init에 설정된 앱 레이어 데이터를 가리키는 포인터입니다.
[in] aNodeId
노드 ID 요청
[in] aNodeAddr
요청 노드 주소

공개 속성

FilterTimeCorrectionContributor

ContributorFilter FilterTimeCorrectionContributor

OnSyncFailed

SyncFailedHandler OnSyncFailed

OnSyncRequestReceived

OnSyncRequestReceivedHandler OnSyncRequestReceived

설정하지 않으면 기본 구현이 항상 true를 반환합니다.

OnSyncSucceeded

SyncSucceededHandler OnSyncSucceeded

설정하지 않으면 기본 동작은 아주 작은 규모의 서버 수정을 제외한 모든 결과를 가져옵니다.

OnTimeChangeNotificationReceived

TimeChangeNotificationHandler OnTimeChangeNotificationReceived

mEncryptionType

uint8_t mEncryptionType

로컬 통신을 위한 암호화 방법

mKeyId

uint16_t mKeyId

로컬 통신에 사용되는 키 ID

보호된 속성

mApp

void * mApp

상위 레이어 데이터에 대한 포인터

mClientState

ClientState mClientState

mConnectionToService

WeaveConnection * mConnectionToService

서비스와 통신하는 데 사용되는 TCP 연결입니다.

mContacts

Contact mContacts[WEAVE_CONFIG_TIME_CLIENT_MAX_NUM_CONTACTS]

탐색 과정에서 습득한 연락처 정보

mIsAlwaysFresh

bool mIsAlwaysFresh

mIsInCallback

bool mIsInCallback

상위 레이어에 대한 콜백에 있는 경우 true

mLastLikelihoodSent

int8_t mLastLikelihoodSent

mNumContributorInLastLocalSync

uint8_t mNumContributorInLastLocalSync

mRole

TimeSyncRole mRole

이 노드의 실제 역할입니다.

mServerState

ServerState mServerState

mServiceContact

Contact mServiceContact

mTimestampLastCorrectionFromServerOrNtp_usec

timesync_t mTimestampLastCorrectionFromServerOrNtp_usec

수면 시간에 대한 보상이 필요하므로 부팅 시간이어야 합니다.

mTimestampLastLocalSync_usec

timesync_t mTimestampLastLocalSync_usec

수면 시간에 대한 보상이 필요하므로 부팅 시간이어야 합니다.

공개 함수

취소

WEAVE_ERROR Abort(
  void
)

엔진을 유휴 상태로 되돌리고 수행 중인 모든 작업을 중단합니다.

동기화 성공 또는 실패가 호출되지 않으며 모든 Weave 거래소가 종료됩니다. TCP 연결은 더 이상 터치되지 않습니다. 이미 유휴 상태인 경우 작업을 수행하지 않으며 콜백에서 사용할 수 없습니다.

세부정보
반환
성공 시 WEAVE_NO_ERROR

DisableAutoSync

void DisableAutoSync(
  void
)

자동 동기화 사용 중지

유휴 상태에서만 사용할 수 있으며 콜백에서는 사용할 수 없습니다.

EnableAutoSync

WEAVE_ERROR EnableAutoSync(
  const int32_t aSyncPeriod_msec,
  const int32_t aNominalDiscoveryPeriod_msec,
  const int32_t aShortestDiscoveryPeriod_msec
)

자동 동기화 사용 설정

유휴 상태에서만 사용할 수 있습니다. 검색은 즉시 이루어지며 콜백에서는 사용할 수 없습니다.

세부정보
매개변수
[in] aSyncPeriod_msec
동기화 간 밀리초 수
[in] aNominalDiscoveryPeriod_msec
통신 오류가 관찰되지 않는 경우 탐색 간 밀리초 수
[in] aShortestDiscoveryPeriod_msec
통신 오류가 관찰된 경우 탐색 사이의 최단 시간(밀리초)
반환
성공 시 WEAVE_NO_ERROR

GetCapacityOfContactList

int GetCapacityOfContactList(
  void
) const 

이 엔진이 저장하도록 구성된 최대 연락처 수에 대한 간단한 getter

GetClientState

ClientState GetClientState(
  void
) const 

클라이언트 상태의 간단한 getter

GetNextLikelihood

int8_t GetNextLikelihood(
  void
) const 

확률을 추출합니다.

결과는 동기화 작업이 완료된 후에만, OnSyncSucceeded 및 OnSyncFailed의 콜백 내에서만 유효합니다. 그렇지 않으면 결과는 일시적이며 다음 항목이 아닌 현재 가능성일 수 있습니다.

세부정보
반환
응답이 다음 요청에서 사용될 가능성

GetServerState

ServerState GetServerState(
  void
) const 

서버 상태의 간단한 getter

InitClient

WEAVE_ERROR InitClient(
  void *const aApp,
  WeaveExchangeManager *aExchangeMgr,
  const uint8_t aEncryptionType,
  const uint16_t aKeyId,
  const int8_t aInitialLikelyhood
)

이 클라이언트를 초기화합니다.

콜백에서는 사용할 수 없음

세부정보
매개변수
[in] aApp
상위 레이어 콜백에 사용되는 상위 레이어 데이터에 대한 포인터입니다.
[in] aExchangeMgr
시스템 전체 Weave Exchange Manager 객체에 대한 포인터입니다.
[in] aRole
kTimeSyncRole_Client 또는 kTimeSyncRole_Coordinator일 수 있습니다.
[in] aEncryptionType
요청 및 응답에 사용되는 암호화 유형
[in] aKeyId
요청 및 응답에 사용되는 키 ID
[in] aInitialLikelyhood
탐색 단계에서 사용될 초기 가능성
반환
성공 시 WEAVE_NO_ERROR

InitCoordinator

WEAVE_ERROR InitCoordinator(
  nl::Weave::WeaveExchangeManager *aExchangeMgr,
  const uint8_t aEncryptionType,
  const uint16_t aKeyId,
  const int32_t aSyncPeriod_msec,
  const int32_t aNominalDiscoveryPeriod_msec,
  const int32_t aShortestDiscoveryPeriod_msec
)

이 코디네이터를 초기화합니다.

세부정보
매개변수
[in] aExchangeMgr
시스템 전체 Weave Exchange Manager 객체에 대한 포인터입니다.
[in] aEncryptionType
요청 및 응답에 사용되는 암호화 유형
[in] aKeyId
요청 및 응답에 사용되는 키 ID
[in] aSyncPeriod_msec
동기화 간 밀리초 수
[in] aNominalDiscoveryPeriod_msec
통신 오류가 관찰되지 않는 경우 탐색 사이의 최단 시간(밀리초)
[in] aShortestDiscoveryPeriod_msec
통신 오류가 관찰된 경우 탐색 간 최소 밀리초 수
반환
성공 시 WEAVE_NO_ERROR

InitServer

WEAVE_ERROR InitServer(
  void *const aApp,
  WeaveExchangeManager *const aExchangeMgr,
  const bool aIsAlwaysFresh
)

시간 동기화 서버가 되려면 객체 생성 후 첫 번째 함수로 서버 역할의 초기화를 호출해야 합니다.

콜백에서는 사용할 수 없음

세부정보
매개변수
[in] aApp
상위 레이어 콜백에 사용되는 상위 레이어 데이터에 대한 포인터입니다.
[in] aExchangeMgr
시스템 전체 Weave Exchange Manager 객체에 대한 포인터입니다.
[in] aIsAlwaysFresh
true로 설정하면 초기의 신뢰할 수 없는 시간을 제외하고 서버가 항상 동기화된다는 것을 나타내기 위해 true로 설정할 수 있습니다. 조정자에 대해서는 false로 설정합니다.
반환
성공 시 WEAVE_NO_ERROR

MulticastTimeChangeNotification

void MulticastTimeChangeNotification(
  const uint8_t aEncryptionType,
  const uint16_t aKeyId
) const 

멀티캐스트 시간 변경 알림을 위해 상위 레이어에서 호출합니다.

사용할 수 없습니다.

세부정보
매개변수
[in] aEncryptionType
이 알림에 사용할 암호화 유형
[in] aKeyId
이 알림에 사용할 키 ID

RegisterCorrectionFromServerOrNtp

void RegisterCorrectionFromServerOrNtp(
  void
)

서버와의 시간 동기화가 방금 완료되었음을 나타내기 위해 상위 레이어에서 호출되거나 NTP와 같은 안정적인 수단을 통해 호출됩니다.

RegisterLocalSyncOperation

void RegisterLocalSyncOperation(
  const uint8_t aNumContributor
)

다른 지역 코디네이터와의 동기화를 방금 마쳤음을 나타내기 위해 상위 레이어에서 호출합니다.

세부정보
매개변수
[in] aNumContributor
이 시간 동기화에 기여한 조정자 수

종료

WEAVE_ERROR Shutdown(
  void
)

해당 서비스가 어떤 역할을 수행하든지 중지할 수 있습니다.

이 함수는 init 함수를 다시 호출하기 전에 할당된 리소스를 올바르게 회수하기 위해 호출되어야 합니다. 콜백에서는 사용할 수 없습니다.

세부정보
반환
성공 시 WEAVE_NO_ERROR

동기화

WEAVE_ERROR Sync(
  const bool aForceDiscoverAgain
)

기존 연락처를 사용하여 동기화합니다.

사용 가능한 유효한 연락처가 없으면 동기화 작업이 실패할 수 있습니다. aForceDiscoverAgain을 true로 설정하면 즉시 검색을 강제 실행할 수 있습니다. 유휴 상태에서만 사용할 수 있으며 콜백에서는 사용할 수 없습니다.

세부정보
매개변수
[in] aForceDiscoverAgain
기존 연락처가 모두 플러시되고 검색 작업이 수행되어야 하는 경우 true입니다.
반환
성공 시 WEAVE_NO_ERROR

SyncWithNodes

WEAVE_ERROR SyncWithNodes(
  const int16_t aNumNode,
  const ServingNode aNodes[]
)

동기화할 수 있습니다.

기존 연락처 목록이 삭제됩니다. 유휴 상태에서만 사용할 수 있고 콜백에서는 사용할 수 없습니다.

세부정보
매개변수
[in] aNumNode
배열 aNodes의 연락처 수
[in] aNodes
연락처 기록 배열
반환
성공 시 WEAVE_NO_ERROR

SyncWithService

WEAVE_ERROR SyncWithService(
  WeaveConnection *const aConnection
)

주어진 TCP 연결과 관련 암호화 및 키 ID를 사용하여

동기화가 완료되면 호출자는 TCP 연결의 소유권을 가져가야 합니다. 새로운 Weave Exchange가 생성되고 유휴 상태에서만 해당 컨텍스트 위에 설정된 콜백이 있으므로 TCP 연결에 대한 콜백을 덮어쓰지 않습니다. 콜백에서는 사용할 수 없습니다.

세부정보
매개변수
[in] aConnection
Weave 연결을 가리키는 포인터
반환
성공 시 WEAVE_NO_ERROR

TimeSyncNode

 TimeSyncNode(
  void
)

보호된 함수

AbortOnError

void AbortOnError(
  const WEAVE_ERROR aCode
)

aCode가 WEAVE_NO_ERROR가 아닌 경우 내부 취소

AutoSyncNow

void AutoSyncNow(
  void
)

자동 동기화 세션을 시작하는 내부 함수

CallbackForSyncCompletion

WEAVE_ERROR CallbackForSyncCompletion(
  const bool aIsSuccessful,
  bool aShouldUpdate,
  const bool aIsCorrectionReliable,
  const bool aIsFromServer,
  const uint8_t aNumContributor,
  const timesync_t aSystemTimestamp_usec,
  const timesync_t aDiffTime_usec
)

애플리케이션 계층에 콜백을 유도합니다.

aIsSuccess를 false로 설정하여 오류 콜백 유도

ClearState

void ClearState(
  void
)

DestroyCommContext

bool DestroyCommContext(
  void
)

Weave ExchangeContext를 닫습니다.

EndLocalSyncAndTryCalculateTimeFix

void EndLocalSyncAndTryCalculateTimeFix(
  void
)

EndServiceSyncAndTryCalculateTimeFix

void EndServiceSyncAndTryCalculateTimeFix(
  void
)

FindReplaceableContact

Contact * FindReplaceableContact(
  const uint64_t aNodeId,
  const IPAddress & aNodeAddr,
  bool aIsTimeChangeNotification
)

슬롯을 반환하여 연락처 정보 저장

GetClientStateName

const char *const GetClientStateName(
  void
) const 

GetNextIdleContact

Contact * GetNextIdleContact(
  void
)

통신할 다음 유효하고 유휴 상태 가져오기

GetNumNotYetCompletedContacts

int16_t GetNumNotYetCompletedContacts(
  void
)

유효한 연락처 수를 가져오지만 아직 이야기하지 않았습니다.

GetNumReliableResponses

int16_t GetNumReliableResponses(
  void
)

지금까지 수집된 '신뢰할 수 있는' 응답의 수를 가져옵니다.

충분한 수의 응답을 수집했는지 확인하기 위해

InitState

WEAVE_ERROR InitState(
  const TimeSyncRole aRole,
  void *const aApp,
  WeaveExchangeManager *const aExchangeMgr
)

InvalidateAllContacts

void InvalidateAllContacts(
  void
)

모든 로컬 연락처 무효화

InvalidateServiceContact

void InvalidateServiceContact(
  void
)

서비스에 대한 연락처 무효화

RegisterCommError

void RegisterCommError(
  Contact *const aContact
)

특정 연락처의 통신 오류를 등록하고 필요한 경우 자동 검색 기간을 단축함

SendSyncRequest

WEAVE_ERROR SendSyncRequest(
  bool *const rIsMessageSent,
  Contact *const aContact
)

연락처에 유니캐스트 동기화 요청을 보냅니다.

*rIsMessageSent는 메시지 전송 여부를 나타내도록 설정됩니다. 연결할 수 없는 주소와 같은 통신 오류는 반환되지 않으므로 호출자는 반환 코드와 *rIsMessageSent를 모두 확인해야 합니다.

SetAllCompletedContactsToIdle

int16_t SetAllCompletedContactsToIdle(
  void
)

완료된 모든 연락처를 다시 유휴 상태로 재설정하되 응답은 만지지 않습니다.

이것은 동일한 노드에 대한 두 번의 통신 사이에

SetAllValidContactsToIdleAndInvalidateResponse

int16_t SetAllValidContactsToIdleAndInvalidateResponse(
  void
)

모든 유효한 로컬 연락처를 유휴 상태로 설정하고 응답을 지웁니다.

그것은 각 팀에게 연락하기 전에 호출된다

SetClientState

void SetClientState(
  const ClientState state
)

SetupUnicastCommContext

WEAVE_ERROR SetupUnicastCommContext(
  Contact *const aContact
)

유니캐스트 통신을 위한 새로운 Weave Exchange 만들기

StoreNotifyingContact

void StoreNotifyingContact(
  const uint64_t aNodeId,
  const IPAddress & aNodeAddr
)

방금 시간 변경 알림을 보낸 노드의 연락처 정보 저장

UpdateMulticastSyncResponse

void UpdateMulticastSyncResponse(
  const uint64_t aNodeId,
  const IPAddress & aNodeAddr,
  const TimeSyncResponse & aResponse
)

멀티캐스트 요청에서 반환되는 응답 처리

UpdateUnicastSyncResponse

void UpdateUnicastSyncResponse(
  const TimeSyncResponse & aResponse
)

유니캐스트 요청에서 반환되는 응답 처리

InitClient

WEAVE_ERROR _InitClient(
  const uint8_t aEncryptionType,
  const uint16_t aKeyId,
  const int8_t aInitialLikelyhood
)

초기화해야 합니다.

공개 함수의 Init 계열에서 내부적으로 사용하기 위한 용도입니다. 반환 전에 mClientState를 설정해야 합니다. 콜백에서는 사용할 수 없습니다.

세부정보
매개변수
[in] aEncryptionType
요청 및 응답에 사용되는 암호화 유형
[in] aKeyId
요청 및 응답에 사용되는 키 ID
[in] aInitialLikelyhood
탐색 단계에서 사용될 초기 가능성
반환
성공 시 WEAVE_NO_ERROR

_InitServer

WEAVE_ERROR _InitServer(
  const bool aIsAlwaysFresh
)

초기화합니다.

공개 함수의 Init 계열에서 내부적으로 사용하기 위한 용도입니다. 반환 전에 mClientState를 설정해야 합니다. 콜백에서는 사용할 수 없습니다.

세부정보
매개변수
[in] aIsAlwaysFresh
true로 설정하면 초기의 신뢰할 수 없는 시간을 제외하고 서버가 항상 동기화된다는 것을 나타내기 위해 true로 설정할 수 있습니다. 조정자에 대해서는 false로 설정합니다.
반환
성공 시 WEAVE_NO_ERROR

_ShutdownClient

WEAVE_ERROR _ShutdownClient(
  void
)

콜백에서 사용할 수 없는 클라이언트를 중지합니다.

세부정보
반환
성공 시 WEAVE_NO_ERROR

_ShutdownCoordinator(종료 코디네이터)

WEAVE_ERROR _ShutdownCoordinator(
  void
)

코디네이터를 중지합니다.

세부정보
반환
성공 시 WEAVE_NO_ERROR

_ShutdownServer

WEAVE_ERROR _ShutdownServer(
  void
)

콜백에서 사용할 수 없는 서버를 중지합니다.

세부정보
반환
성공 시 WEAVE_NO_ERROR

보호된 정적 함수

HandleAutoDiscoveryTimeout

void HandleAutoDiscoveryTimeout(
  System::Layer *aSystemLayer,
  void *aAppState,
  System::Error aError
)

HandleAutoSyncTimeout

void HandleAutoSyncTimeout(
  System::Layer *aSystemLayer,
  void *aAppState,
  System::Error aError
)

HandleMulticastResponseTimeout

void HandleMulticastResponseTimeout(
  System::Layer *aSystemLayer,
  void *aAppState,
  System::Error aError
)

HandleMulticastSyncResponse

void HandleMulticastSyncResponse(
  ExchangeContext *ec,
  const IPPacketInfo *pktInfo,
  const WeaveMessageInfo *msgInfo,
  uint32_t profileId,
  uint8_t msgType,
  PacketBuffer *payload
)

HandleSyncRequest

void HandleSyncRequest(
  ExchangeContext *ec,
  const IPPacketInfo *pktInfo,
  const WeaveMessageInfo *msgInfo,
  uint32_t profileId,
  uint8_t msgType,
  PacketBuffer *payload
)

시간 동기화 요청이 도착할 때 Weave Exchange의 콜백

HandleTimeChangeNotification

void HandleTimeChangeNotification(
  ExchangeContext *ec,
  const IPPacketInfo *pktInfo,
  const WeaveMessageInfo *msgInfo,
  uint32_t profileId,
  uint8_t msgType,
  PacketBuffer *payload
)

HandleUnicastResponseTimeout

void HandleUnicastResponseTimeout(
  ExchangeContext *const ec
)

HandleUnicastSyncResponse

void HandleUnicastSyncResponse(
  ExchangeContext *ec,
  const IPPacketInfo *pktInfo,
  const WeaveMessageInfo *msgInfo,
  uint32_t profileId,
  uint8_t msgType,
  PacketBuffer *payload
)

HandleUnreliableAfterBootTimer

void HandleUnreliableAfterBootTimer(
  System::Layer *aSystemLayer,
  void *aAppState,
  System::Error aError
)

부팅 배리어 후 신뢰할 수 없는 값을 전달했을 때 Weave 타이머의 콜백이 호출됩니다.

IsOperationalState

bool IsOperationalState(
  ClientState aState
)

지정된 상태가 작동하는지 확인합니다.

ClientState가 작동 상태를 나타내는지(즉, 클라이언트가 초기화를 완료했고 종료 중이 아님)를 나타내는지 확인하는 편의 메서드입니다.

세부정보
매개변수
[in] aState
평가할 상태
반환
초기화가 완료된 후 종료가 시작되기 전에 상태가 발생하면 true, 그렇지 않으면 false입니다.

_OnSyncSucceeded(동기화 성공)

bool _OnSyncSucceeded(
  void *const aApp,
  const nl::Weave::Profiles::Time::timesync_t aOffsetUsec,
  const bool aIsReliable,
  const bool aIsServer,
  const uint8_t aNumContributor
)