Synchronizacja czasu sieciowego

Ten moduł zawiera funkcje, które kontrolują usługę synchronizacji czasu w sieci.

Podsumowanie

Wyliczenia

otNetworkTimeStatus{
  OT_NETWORK_TIME_UNSYNCHRONIZED = -1,
  OT_NETWORK_TIME_RESYNC_NEEDED = 0,
  OT_NETWORK_TIME_SYNCHRONIZED = 1
}
enum | typ wyliczeniowy
Ten wynik reprezentuje stan synchronizacji czasu według OpenThread.

Typy

otNetworkTimeStatus typedef
Ten wynik reprezentuje stan synchronizacji czasu według OpenThread.
otNetworkTimeSyncCallbackFn)(void *aCallbackContext) typedef
void(*
Ten wskaźnik funkcji jest wywoływany, gdy zostanie zsynchronizowana godzina w sieci lub zmieni się stan.

Funkcje

otNetworkTimeGet(otInstance *aInstance, uint64_t *aNetworkTime)
Uzyskiwanie czasu sieciowego dla wątku.
otNetworkTimeGetSyncPeriod(otInstance *aInstance)
uint16_t
Sprawdź okres synchronizacji.
otNetworkTimeGetXtalThreshold(otInstance *aInstance)
uint16_t
Pobierz próg dokładności XTAL synchronizacji czasu dla routera.
otNetworkTimeSetSyncPeriod(otInstance *aInstance, uint16_t aTimeSyncPeriod)
Ustaw przedział czasu synchronizacji.
otNetworkTimeSetXtalThreshold(otInstance *aInstance, uint16_t aXTALThreshold)
Ustaw próg dokładności synchronizacji XTAL dla urządzeń obsługujących router.
otNetworkTimeSyncSetCallback(otInstance *aInstance, otNetworkTimeSyncCallbackFn aCallbackFn, void *aCallbackContext)
void
Skonfiguruj wywołanie zwrotne, które będzie wykonywane, gdy wystąpi synchronizacja czasu w sieci lub zmiana stanu.

Wyliczenia

StanOtNetworkTimeStatus

 otNetworkTimeStatus

Ten wynik reprezentuje stan synchronizacji czasu według OpenThread.

Właściwości
OT_NETWORK_TIME_RESYNC_NEEDED

Urządzenie nie było synchronizowane przynajmniej przez dwa okresy.

OT_NETWORK_TIME_SYNCHRONIZED

Czas sieci na urządzeniu jest synchronizowany.

OT_NETWORK_TIME_UNSYNCHRONIZED

Urządzenie nie jest podłączone do sieci.

Typy

StanOtNetworkTimeStatus

enum otNetworkTimeStatus otNetworkTimeStatus

Ten wynik reprezentuje stan synchronizacji czasu według OpenThread.

otNetworkTimeSyncCallbackFn.

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

Ten wskaźnik funkcji jest wywoływany, gdy zostanie zsynchronizowana godzina w sieci lub zmieni się stan.

Funkcje

Czas_dostępności sieci

otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

Uzyskiwanie czasu sieciowego dla wątku.

Szczegóły
Parametry
[in] aInstance
Struktura instancji OpenThread.
[in,out] aNetworkTime
Czas sieciowy wątków w mikrosekundach.
Zwroty
Stan synchronizacji czasu.

GodzinaSerwisuPrzesiadkowego

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

Sprawdź okres synchronizacji.

Szczegóły
Parametry
[in] aInstance
Struktura instancji OpenThread.
Zwroty
Okres synchronizacji czasu.

Wartość otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

Pobierz próg dokładności XTAL synchronizacji czasu dla routera.

Szczegóły
Parametry
[in] aInstance
Struktura instancji OpenThread.
Zwroty
Próg dokładności XTAL dla routera w PPM.

OTNetworkTimeSetSyncPeriod

otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

Ustaw przedział czasu synchronizacji.

Funkcję tę można wywołać tylko po wyłączeniu protokołów Thread.

Szczegóły
Parametry
[in] aInstance
Struktura instancji OpenThread.
[in] aTimeSyncPeriod
Okres synchronizacji czasu (w sekundach).
Zwracane wartości
OT_ERROR_NONE
Okres synchronizacji został ustawiony.
OT_ERROR_INVALID_STATE
Protokoły wątków są włączone.

OTNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

Ustaw próg dokładności synchronizacji XTAL dla urządzeń obsługujących router.

Funkcję tę można wywołać tylko po wyłączeniu protokołów Thread.

Szczegóły
Parametry
[in] aInstance
Struktura instancji OpenThread.
[in] aXTALThreshold
Próg dokładności XTAL dla routera w PPM.
Zwracane wartości
OT_ERROR_NONE
Okres synchronizacji został ustawiony.
OT_ERROR_INVALID_STATE
Protokoły wątków są włączone.

OTNetworkTimeSyncSetCallback

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

Skonfiguruj wywołanie zwrotne, które będzie wykonywane, gdy wystąpi synchronizacja czasu w sieci lub zmiana stanu.

To wywołanie zwrotne powinno być wywoływane tylko wtedy, gdy przesunięcie czasu w sieci skoczy o OPENThread_CONFIG_TIME_SYNC_JUMP_NOTIF_MIN_US lub gdy zmieni się stan.

Szczegóły
Parametry
[in] aInstance
Struktura instancji OpenThread.
[in] aCallbackFn
Funkcja wywołania zwrotnego, która ma zostać wywołana
[in] aCallbackContext
Kontekst, który ma zostać przekazany do wywołania zwrotnego podczas wywołania

Makra

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

zero jest uznawane za nieprawidłową sekwencję synchronizacji czasu.

Zasoby

Tematy referencyjne interfejsu API OpenThread pochodzą z kodu źródłowego i są dostępne w GitHub. Więcej informacji oraz dodatkowe informacje znajdziesz w materiałach.