Questa pagina è stata tradotta dall'API Cloud Translation.

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 `enum otNetworkTimeStatus` 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)`	`otNetworkTimeStatus` 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)`	`otError` Imposta il periodo di sincronizzazione temporale.
`otNetworkTimeSetXtalThreshold(otInstance *aInstance, uint16_t aXTALThreshold)`	`otError` 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.