Sincronizzazione dell'ora di rete

Questo modulo include funzioni che controllano il servizio di sincronizzazione dell'ora della 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 OpenThread.

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

funzioni
`otNetworkTimeGet ( otInstance aInstance, uint64_t aNetworkTime)`	`otNetworkTimeStatus` Ottieni il tempo della rete di discussione.
`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` Imposta la soglia di precisione XTAL per la sincronizzazione dell'ora per il dispositivo compatibile con router.
`otNetworkTimeSyncSetCallback ( otInstance aInstance, otNetworkTimeSyncCallbackFn aCallbackFn, void aCallbackContext)`	`void` Impostare un callback da chiamare quando si verifica una sincronizzazione dell'ora della rete o un cambio di stato.

enumerazioni

otNetworkTimeStatus

 otNetworkTimeStatus

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

Proprietà
`OT_NETWORK_TIME_RESYNC_NEEDED`	Il dispositivo non ha ricevuto la sincronizzazione oraria per 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

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

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

Questo puntatore a funzione viene chiamato quando si verifica una sincronizzazione dell'ora della rete o una modifica dello stato.

funzioni

otNetworkTimeGet

 otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

Ottieni il tempo della rete di discussione.

Dettagli

parametri

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

ritorna

Lo stato di 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 il 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 di restituzione

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

otNetworkTimeSetXtalThreshold

 otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

Imposta 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 il router, in PPM.

Valori di restituzione

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

otNetworkTimeSyncSetCallback

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

Impostare un callback da chiamare quando si verifica una sincronizzazione dell'ora della rete o un cambio di stato.

Questo callback deve essere chiamato solo quando l'offset 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 dell'invocazione

Macro

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

zero è considerato una sequenza di sincronizzazione temporale non valida.