Sincronizzazione dell'ora della rete

Questo modulo include funzioni che controllano il servizio di sincronizzazione dell'ora della rete.

Riepilogo

Enumerazioni
otNetworkTimeStatus{
  OT_NETWORK_TIME_UNSYNCHRONIZED = -1,
  OT_NETWORK_TIME_RESYNC_NEEDED = 0,
  OT_NETWORK_TIME_SYNCHRONIZED = 1
} 		enum
Rappresenta lo stato di sincronizzazione temporale OpenThread.

Typedef
otNetworkTimeStatus typedef
Rappresenta lo stato di sincronizzazione temporale OpenThread.
otNetworkTimeSyncCallbackFn)(void *aCallbackContext) typedef
void(*
Il puntatore viene chiamato quando si verifica una sincronizzazione dell'ora della rete o un cambiamento di stato.

Funzioni
otNetworkTimeGet(otInstance *aInstance, uint64_t *aNetworkTime)
Recupera l'ora della rete Thread.
otNetworkTimeGetSyncPeriod(otInstance *aInstance)
uint16_t
Conoscere il periodo di sincronizzazione temporale.
otNetworkTimeGetXtalThreshold(otInstance *aInstance)
uint16_t
Ottieni la soglia di precisione XTAL della sincronizzazione dell'ora per il router.
otNetworkTimeSetSyncPeriod(otInstance *aInstance, uint16_t aTimeSyncPeriod)
Imposta il periodo di sincronizzazione temporale.
otNetworkTimeSetXtalThreshold(otInstance *aInstance, uint16_t aXTALThreshold)
Imposta la soglia di precisione XTAL della sincronizzazione temporale per il dispositivo compatibile con il router.
otNetworkTimeSyncSetCallback(otInstance *aInstance, otNetworkTimeSyncCallbackFn aCallbackFn, void *aCallbackContext)
void
Imposta un callback da chiamare quando si verifica una sincronizzazione dell'ora della rete o un cambiamento dello stato.

Enumerazioni

otNetworkTimeStatus

 otNetworkTimeStatus

Rappresenta lo stato di sincronizzazione temporale OpenThread.

Proprietà
OT_NETWORK_TIME_RESYNC_NEEDED

Il dispositivo non riceve la sincronizzazione dell'ora da più di due periodi di tempo.

OT_NETWORK_TIME_SYNCHRONIZED

L'ora della rete del dispositivo è sincronizzata.

OT_NETWORK_TIME_UNSYNCHRONIZED

Il dispositivo non è collegato a una rete.

Typedef

otNetworkTimeStatus

enum otNetworkTimeStatus otNetworkTimeStatus

Rappresenta lo stato di sincronizzazione temporale OpenThread.

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

Il puntatore viene chiamato quando si verifica una sincronizzazione dell'ora della rete o un cambiamento di stato.

Funzioni

otNetworkTimeGet

otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

Recupera l'ora della rete Thread.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in,out] aNetworkTime
Il tempo della rete Thread in microsecondi.
Restituisce
Lo stato della sincronizzazione dell'ora.

otNetworkTimeGetSyncPeriod

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

Conoscere il periodo di sincronizzazione temporale.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
Restituisce
Il periodo di sincronizzazione temporale.

otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

Ottieni la soglia di precisione XTAL della sincronizzazione dell'ora per il router.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
Restituisce
La soglia di precisione XTAL per il router, in PPM.

otNetworkTimeSetSyncPeriod

otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

Imposta il periodo di sincronizzazione temporale.

Può essere chiamato solo quando i protocolli Thread sono disabilitati.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aTimeSyncPeriod
Il periodo di sincronizzazione temporale, in secondi.
Valori restituiti
OT_ERROR_NONE
Periodo di sincronizzazione temporale impostato.
OT_ERROR_INVALID_STATE
I protocolli Thread sono abilitati.

otNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

Imposta la soglia di precisione XTAL della sincronizzazione temporale per il dispositivo compatibile con il router.

Può essere chiamato solo quando i protocolli Thread sono disabilitati.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aXTALThreshold
La soglia di precisione XTAL per il router, in PPM.
Valori restituiti
OT_ERROR_NONE
Periodo di sincronizzazione temporale impostato.
OT_ERROR_INVALID_STATE
I protocolli Thread sono abilitati.

otNetworkTimeSyncSetCallback

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

Imposta un callback da chiamare quando si verifica una sincronizzazione dell'ora della rete o un cambiamento dello stato.

Questo callback viene chiamato solo quando lo scarto con fuso orario della rete passa di OPENTHREAD_CONFIG_TIME_SYNC_JUMP_NOTIF_MIN_US o quando lo stato cambia.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aCallbackFn
La funzione di callback da chiamare
[in] aCallbackContext
Il contesto da passare alla funzione di callback al momento della chiamata

Macro

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

zero è considerato una sequenza di sincronizzazione temporale non valida.

Risorse

Gli argomenti di riferimento dell'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per saperne di più o per contribuire alla nostra documentazione, consulta la sezione Risorse.