Sincronizzazione dell'ora di rete

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

Sommario

Enumerazioni
`otNetworkTimeStatus { OT_NETWORK_TIME_UNSYNCHRONIZED = -1, OT_NETWORK_TIME_RESYNC_NEEDED = 0, OT_NETWORK_TIME_SYNCHRONIZED = 1 }`	enum Questa enumerazione rappresenta lo stato di sincronizzazione dell'ora di OpenThread.

Typedef
`otNetworkTimeStatus`	typedef `enum otNetworkTimeStatus` Questa enumerazione rappresenta lo stato di sincronizzazione dell'ora di OpenThread.
`otNetworkTimeSyncCallbackFn )(void *aCallbackContext)`	typedef `void(*` Questo puntatore a funzione viene chiamato quando si verifica una sincronizzazione dell'ora di rete o un cambiamento di stato.

Funzioni
`otNetworkTimeGet ( otInstance aInstance, uint64_t aNetworkTime)`	`otNetworkTimeStatus` Ottieni l'ora della rete del thread.
`otNetworkTimeGetSyncPeriod ( otInstance *aInstance)`	`uint16_t` Ottieni il periodo di sincronizzazione dell'ora.
`otNetworkTimeGetXtalThreshold ( otInstance *aInstance)`	`uint16_t` Ottieni la soglia di precisione XTAL per la sincronizzazione dell'ora per il router.
`otNetworkTimeSetSyncPeriod ( otInstance *aInstance, uint16_t aTimeSyncPeriod)`	`otError` Imposta il periodo di sincronizzazione dell'ora.
`otNetworkTimeSetXtalThreshold ( otInstance *aInstance, uint16_t aXTALThreshold)`	`otError` Impostare la soglia di precisione XTAL per la sincronizzazione dell'ora per il dispositivo compatibile con router.
`otNetworkTimeSyncSetCallback ( otInstance aInstance, otNetworkTimeSyncCallbackFn aCallbackFn, void aCallbackContext)`	`void` Consente di impostare una richiamata da chiamare quando si verifica una sincronizzazione dell'orario di rete o un cambio di stato.

Enumerazioni

otNetworkTimeStatus

 otNetworkTimeStatus

Questa enumerazione rappresenta lo stato di sincronizzazione dell'ora di OpenThread.

Proprietà
`OT_NETWORK_TIME_RESYNC_NEEDED`	Il dispositivo non ha ricevuto la sincronizzazione dell'ora per più di due periodi di tempo.
`OT_NETWORK_TIME_SYNCHRONIZED`	L'ora di rete del dispositivo viene sincronizzata.
`OT_NETWORK_TIME_UNSYNCHRONIZED`	Il dispositivo non è collegato a una rete.

Typedef

otNetworkTimeStatus

enum otNetworkTimeStatus otNetworkTimeStatus

Questa enumerazione rappresenta lo stato di sincronizzazione dell'ora di OpenThread.

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

Questo puntatore a funzione viene chiamato quando si verifica una sincronizzazione dell'ora di rete o un cambiamento di stato.

Funzioni

otNetworkTimeGet

otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

Ottieni l'ora della rete del thread.

Dettagli

Parametri

`[in] aInstance`	La struttura dell'istanza OpenThread.
`[in,out] aNetworkTime`	Il tempo di rete del thread in microsecondi.

ritorna

Lo stato della sincronizzazione dell'ora.

otNetworkTimeGetSyncPeriod

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

Ottieni il periodo di sincronizzazione dell'ora.

Dettagli

Parametri

[in] aInstance

La struttura dell'istanza OpenThread.

ritorna

Il periodo di sincronizzazione dell'ora.

otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

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

Dettagli

Parametri

[in] aInstance

La struttura dell'istanza OpenThread.

ritorna

La soglia di precisione XTAL per Router, in PPM.

otNetworkTimeSetSyncPeriod

otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

Imposta il periodo di sincronizzazione dell'ora.

Questa funzione può essere chiamata solo mentre i protocolli Thread sono disabilitati.

Dettagli

Parametri

`[in] aInstance`	La struttura dell'istanza OpenThread.
`[in] aTimeSyncPeriod`	Il periodo di sincronizzazione dell'ora, in secondi.

Valori restituiti

`OT_ERROR_NONE`	Impostare correttamente il periodo di sincronizzazione dell'ora.
`OT_ERROR_INVALID_STATE`	I protocolli dei thread sono abilitati.

otNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

Impostare la soglia di precisione XTAL per la sincronizzazione dell'ora per il dispositivo compatibile con router.

Questa funzione può essere chiamata solo mentre i protocolli Thread sono disabilitati.

Dettagli

Parametri

`[in] aInstance`	La struttura dell'istanza OpenThread.
`[in] aXTALThreshold`	La soglia di precisione XTAL per Router, in PPM.

Valori restituiti

`OT_ERROR_NONE`	Impostare correttamente il periodo di sincronizzazione dell'ora.
`OT_ERROR_INVALID_STATE`	I protocolli dei thread sono abilitati.

otNetworkTimeSyncSetCallback

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

Consente di impostare una richiamata da chiamare quando si verifica una sincronizzazione dell'orario di rete o un cambio di stato.

Questa richiamata deve essere chiamata solo quando la differenza di orario di rete salta 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 come sequenza di sincronizzazione dell'ora non valida.