Network Time Protocol functions. More...


NTP data types.


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_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 .

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 .

[in] packet_buffer Buffer to hold NTP packet supplied to event handler, optional, leave NULL if unused
[in] event_handler Event handler to be called when new NTP time is received, see gos_ntp_update_event_t
Result of API call, gos_result_t