Se usó la API de Cloud Translation para traducir esta página.

Sincronización de hora de la red

Este módulo incluye 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 Esta enumeración representa el estado de sincronización de OpenThread.

Typedefs
`otNetworkTimeStatus`	typedef `enum otNetworkTimeStatus` Esta enumeración representa el estado de sincronización de OpenThread.
`otNetworkTimeSyncCallbackFn)(void *aCallbackContext)`	typedef `void(*` Se llama a este puntero de función cuando se produce un cambio de tiempo de red o se produce un cambio de estado.

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

Enumeraciones

otNetworkTimeStatus

 otNetworkTimeStatus

Esta enumeración representa el estado de sincronización de OpenThread.

Properties
`OT_NETWORK_TIME_RESYNC_NEEDED`	El dispositivo no ha sincronizado 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 está conectado a ninguna red.

Typedefs

otNetworkTimeStatus

enum otNetworkTimeStatus otNetworkTimeStatus

Esta enumeración representa el estado de sincronización de OpenThread.

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

Se llama a este puntero de función cuando se produce un cambio de tiempo de red o se produce un cambio de estado.

Functions

OtNetworkTimeGet

otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

Obtén el tiempo de red de Thread.

Detalles

Parámetros

`[in] aInstance`	Estructura de la instancia de OpenThread
`[in,out] aNetworkTime`	Indica el tiempo de la red de Thread en microsegundos.

Qué muestra

Estado de sincronización de la hora.

otNetworkTimeGetSyncPeriod

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

Obtiene el período de sincronización de tiempo.

Detalles

Parámetros

[in] aInstance

Estructura de la instancia de OpenThread

Qué muestra

Período de sincronización de tiempo.

otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

Obtiene el umbral de precisión XTAL de la sincronización de tiempo para el router.

Detalles

Parámetros

[in] aInstance

Estructura de la instancia de OpenThread

Qué muestra

El umbral de exactitud de XTAL para el router, en PPM.

otNetworkTimeSetSyncPeriod

otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

Establece el período de sincronización.

Solo se puede llamar a esta función cuando los protocolos de Thread están inhabilitados.

Detalles

Parámetros

`[in] aInstance`	Estructura de la instancia de OpenThread
`[in] aTimeSyncPeriod`	Período de sincronización de tiempo, en segundos.

Valores que se muestran

`OT_ERROR_NONE`	Se estableció correctamente el período de sincronización.
`OT_ERROR_INVALID_STATE`	Los protocolos de Thread están habilitados.

otNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

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

Solo se puede llamar a esta función cuando los protocolos de Thread están inhabilitados.

Detalles

Parámetros

`[in] aInstance`	Estructura de la instancia de OpenThread
`[in] aXTALThreshold`	El umbral de exactitud de XTAL para el router, en PPM.

Valores que se muestran

`OT_ERROR_NONE`	Se estableció correctamente el período de sincronización.
`OT_ERROR_INVALID_STATE`	Los protocolos de Thread están habilitados.

otNetworkTimeSyncSetCallback

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

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

Solo se llamará a esta devolución de llamada cuando la compensación de tiempo de red salte a la(s) OPENThread_CONFIG_TIME_SYNC_JUMP_NOTIF_MIN_US o cuando cambie el estado.

Detalles

Parámetros

`[in] aInstance`	Estructura de la instancia 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 en el código fuente, disponible en GitHub. Para obtener más información o colaborar con nuestra documentación, consulta Recursos.