Sincronización de la hora de la red

En este módulo, se incluyen funciones que controlan el servicio de sincronización de la hora de la red.

Resumen

Enumeraciones

otNetworkTimeStatus{
  OT_NETWORK_TIME_UNSYNCHRONIZED = -1,
  OT_NETWORK_TIME_RESYNC_NEEDED = 0,
  OT_NETWORK_TIME_SYNCHRONIZED = 1
}
enum
Representa el estado de sincronización de tiempo de OpenThread.

Typedefs

otNetworkTimeStatus typedef
Representa el estado de sincronización de tiempo de OpenThread.
otNetworkTimeSyncCallbackFn)(void *aCallbackContext) typedef
void(*
Se llama al puntero cuando se produce una sincronización de la hora de la red o un cambio de estado.

remotas

otNetworkTimeGet(otInstance *aInstance, uint64_t *aNetworkTime)
Obtén el tiempo de red de Thread.
otNetworkTimeGetSyncPeriod(otInstance *aInstance)
uint16_t
Obtén el período de sincronización de hora.
otNetworkTimeGetXtalThreshold(otInstance *aInstance)
uint16_t
Obtén el umbral de precisión XTAL de sincronización de hora para el router.
otNetworkTimeSetSyncPeriod(otInstance *aInstance, uint16_t aTimeSyncPeriod)
Establece el período de sincronización de hora.
otNetworkTimeSetXtalThreshold(otInstance *aInstance, uint16_t aXTALThreshold)
Establece el umbral de precisión XTAL de sincronización de tiempo para el dispositivo compatible con router.
otNetworkTimeSyncSetCallback(otInstance *aInstance, otNetworkTimeSyncCallbackFn aCallbackFn, void *aCallbackContext)
void
Configura una devolución de llamada para que se llame cuando se produzca una sincronización de la hora de red o un cambio de estado.

Enumeraciones

otNetworkTimeStatus

 otNetworkTimeStatus

Representa el estado de sincronización de tiempo de OpenThread.

Propiedades
OT_NETWORK_TIME_RESYNC_NEEDED

El dispositivo no recibió sincronización de tiempo durante más de dos períodos.

OT_NETWORK_TIME_SYNCHRONIZED

Se sincroniza la hora de la red del dispositivo.

OT_NETWORK_TIME_UNSYNCHRONIZED

El dispositivo no se conectó a una red.

Typedefs

otNetworkTimeStatus

enum otNetworkTimeStatus otNetworkTimeStatus

Representa el estado de sincronización de tiempo de OpenThread.

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

Se llama al puntero cuando se produce una sincronización de la hora de la red o un cambio de estado.

remotas

otNetworkTimeGet

otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

Obtén el tiempo de red de Thread.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread
[in,out] aNetworkTime
El tiempo de red de Thread en microsegundos.
Qué muestra
Estado de sincronización de hora.

otNetworkTimeGetSyncPeriod

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

Obtén el período de sincronización de hora.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread
Qué muestra
El período de sincronización de tiempo.

otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

Obtén el umbral de precisión XTAL de sincronización de hora para el router.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread
Qué muestra
El umbral de precisión XTAL para el router, en PPM.

otNetworkTimeSetSyncPeriod

otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

Establece el período de sincronización de hora.

Solo se puede llamar mientras los protocolos de Thread están inhabilitados.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread
[in] aTimeSyncPeriod
El período de sincronización de tiempo, en segundos.
Valores que se muestran
OT_ERROR_NONE
El período de sincronización se estableció correctamente.
OT_ERROR_INVALID_STATE
Los protocolos de subprocesos están habilitados.

otNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

Establece el umbral de precisión XTAL de sincronización de tiempo para el dispositivo compatible con router.

Solo se puede llamar mientras los protocolos de Thread están inhabilitados.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread
[in] aXTALThreshold
El umbral de precisión XTAL para el router, en PPM.
Valores que se muestran
OT_ERROR_NONE
El período de sincronización se estableció correctamente.
OT_ERROR_INVALID_STATE
Los protocolos de subprocesos están habilitados.

otNetworkTimeSyncSetCallback

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

Configura una devolución de llamada para que se llame cuando se produzca una sincronización de la hora de red o un cambio de estado.

Se debe llamar a esta devolución de llamada solo cuando la compensación horaria de la red salte de OPENTHREAD_CONFIG_TIME_SYNC_JUMP_NOTIF_MIN_US o cuando cambie el estado.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread
[in] aCallbackFn
La función de devolución de llamada que se llamará
[in] aCallbackContext
El contexto que se pasará a la función de devolución de llamada en el momento de la invocación

Macros

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

cero se considera una secuencia de sincronización de tiempo no válida.

Recursos

Los temas de referencia de la API de OpenThread se originan a partir del código fuente, disponible en GitHub. Para obtener más información o contribuir a nuestra documentación, consulta Recursos.