Sincronização de tempo de rede

Este módulo inclui funções que controlam o serviço de sincronização de horário da rede.

Resumo

Enumerações
`otNetworkTimeStatus { OT_NETWORK_TIME_UNSYNCHRONIZED = -1, OT_NETWORK_TIME_RESYNC_NEEDED = 0, OT_NETWORK_TIME_SYNCHRONIZED = 1 }`	enum Esta enumeração representa o status de sincronização de tempo OpenThread.

Typedefs
`otNetworkTimeStatus`	typedef `enum otNetworkTimeStatus` Esta enumeração representa o status de sincronização de tempo OpenThread.
`otNetworkTimeSyncCallbackFn )(void *aCallbackContext)`	typedef `void(*` Este ponteiro de função é chamado quando ocorre uma sincronização de tempo de rede ou mudança de status.

Funções
`otNetworkTimeGet ( otInstance aInstance, uint64_t aNetworkTime)`	`otNetworkTimeStatus` Obtenha o tempo da rede Thread.
`otNetworkTimeGetSyncPeriod ( otInstance *aInstance)`	`uint16_t` Obtenha o período de sincronização de tempo.
`otNetworkTimeGetXtalThreshold ( otInstance *aInstance)`	`uint16_t` Obtenha o limite de precisão XTAL da sincronização de tempo para o Roteador.
`otNetworkTimeSetSyncPeriod ( otInstance *aInstance, uint16_t aTimeSyncPeriod)`	`otError` Defina o período de sincronização de tempo.
`otNetworkTimeSetXtalThreshold ( otInstance *aInstance, uint16_t aXTALThreshold)`	`otError` Defina o limite de precisão XTAL de sincronização de tempo para dispositivo compatível com roteador.
`otNetworkTimeSyncSetCallback ( otInstance aInstance, otNetworkTimeSyncCallbackFn aCallbackFn, void aCallbackContext)`	`void` Defina um retorno de chamada a ser chamado quando ocorrer uma sincronização de horário da rede ou alteração de status.

Enumerações

otNetworkTimeStatus

 otNetworkTimeStatus

Esta enumeração representa o status de sincronização de tempo OpenThread.

Propriedades
`OT_NETWORK_TIME_RESYNC_NEEDED`	O dispositivo não recebeu sincronização de tempo por mais de dois períodos de tempo.
`OT_NETWORK_TIME_SYNCHRONIZED`	A hora da rede do dispositivo está sincronizada.
`OT_NETWORK_TIME_UNSYNCHRONIZED`	O dispositivo não está conectado a uma rede.

Typedefs

otNetworkTimeStatus

enum otNetworkTimeStatus otNetworkTimeStatus

Esta enumeração representa o status de sincronização de tempo OpenThread.

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

Este ponteiro de função é chamado quando ocorre uma sincronização de tempo de rede ou mudança de status.

Funções

otNetworkTimeGet

otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

Obtenha o tempo da rede Thread.

Detalhes

Parâmetros

`[in] aInstance`	A estrutura da instância OpenThread.
`[in,out] aNetworkTime`	O tempo da rede Thread em microssegundos.

Devoluções

O status de sincronização de tempo.

otNetworkTimeGetSyncPeriod

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

Obtenha o período de sincronização de tempo.

Detalhes

Parâmetros

[in] aInstance

A estrutura da instância OpenThread.

Devoluções

O período de sincronização de tempo.

otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

Obtenha o limite de precisão XTAL da sincronização de tempo para o Roteador.

Detalhes

Parâmetros

[in] aInstance

A estrutura da instância OpenThread.

Devoluções

O limite de precisão XTAL para roteador, em PPM.

otNetworkTimeSetSyncPeriod

otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

Defina o período de sincronização de tempo.

Esta função só pode ser chamada enquanto os protocolos de thread estão desabilitados.

Detalhes

Parâmetros

`[in] aInstance`	A estrutura da instância OpenThread.
`[in] aTimeSyncPeriod`	O período de sincronização de tempo, em segundos.

Valores Retornados

`OT_ERROR_NONE`	Defina o período de sincronização de tempo com sucesso.
`OT_ERROR_INVALID_STATE`	Os protocolos de thread estão ativados.

otNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

Defina o limite de precisão XTAL de sincronização de tempo para dispositivo compatível com roteador.

Esta função só pode ser chamada enquanto os protocolos de thread estão desabilitados.

Detalhes

Parâmetros

`[in] aInstance`	A estrutura da instância OpenThread.
`[in] aXTALThreshold`	O limite de precisão XTAL para roteador, em PPM.

Valores Retornados

`OT_ERROR_NONE`	Defina o período de sincronização de tempo com sucesso.
`OT_ERROR_INVALID_STATE`	Os protocolos de thread estão ativados.

otNetworkTimeSyncSetCallback

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

Defina um retorno de chamada a ser chamado quando ocorrer uma sincronização de horário da rede ou alteração de status.

Este retorno de chamada deve ser chamado apenas quando o deslocamento de tempo da rede salta por OPENTHREAD_CONFIG_TIME_SYNC_JUMP_NOTIF_MIN_US ou quando o status muda.

Detalhes

Parâmetros

`[in] aInstance`	A estrutura da instância OpenThread.
`[in] aCallbackFn`	A função de retorno de chamada a ser chamada
`[in] aCallbackContext`	O contexto a ser passado para a função de retorno de chamada na invocação

Macros

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

zero é considerado uma sequência de sincronização de tempo inválida.