Network Time Protocol functions. More...

Modules

Types
NTP data types.
 

Functions

gos_result_t gos_ntp_update (ntp_packet_t *packet_buffer, gos_ntp_update_event_t event_handler)
 Invoke a NTP update. More...
 

Detailed Description

Network Time Protocol functions.

Function Documentation

◆ gos_ntp_update()

gos_result_t gos_ntp_update ( ntp_packet_t packet_buffer,
gos_ntp_update_event_t  event_handler 
)

Invoke a NTP update.

A network connection is required for this API. Once invoked Gecko OS will attempt to retrieve the time from the NTP server specified in the 'ntp.server' setting.

The API is non-blocking. Once called a background process attempts to retrieve the time. When the process passes/fails, the supplied event handler is called. See gos_ntp_update_event_t .

Note
The 'ntp.enabled' setting MUST be enabled on startup for this API to work.
a NTP update is automatically invoked every 'ntp.interval' seconds.

See the NTP settings documentation NTP Update.

Parameters
[in]packet_bufferBuffer to hold NTP packet supplied to event handler, optional, leave NULL if unused
[in]event_handlerEvent handler to be called when new NTP time is received, see gos_ntp_update_event_t
Returns
Result of API call, gos_result_t