zephyr/samples/posix/gettimeofday
Gerard Marull-Paretas 9dfbdf1997 doc: use kconfig role and directive
Stop using :option: for Kconfig options.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2021-06-29 10:26:28 -04:00
..
src samples: posix: gettimeofday: incorporate libc time API tests 2020-09-04 14:46:43 +02:00
CMakeLists.txt samples: make find_package(Zephyr...) REQUIRED 2020-05-29 10:47:25 +02:00
Makefile.posix
README.rst doc: use kconfig role and directive 2021-06-29 10:26:28 -04:00
prj.conf samples: gettimeofday: Increase stack size by 64 bytes. 2020-04-29 23:15:12 +03:00
sample.yaml samples/posix/gettimeofday: Filter out INTEL_ADSP 2021-03-08 19:25:25 -05:00

README.rst

.. _posix-gettimeofday-sample:

POSIX gettimeofday() with clock initialization over SNTP
########################################################

Overview
********

This sample application demonstrates using the POSIX gettimeofday()
function to display the absolute wall clock time and local time every
second. At system startup, the current time is queried using the SNTP
networking protocol, enabled by setting the
:kconfig:`CONFIG_NET_CONFIG_CLOCK_SNTP_INIT` and
:kconfig:`CONFIG_NET_CONFIG_SNTP_INIT_SERVER` options.

Requirements
************

- :ref:`networking_with_host`
- or, a board with hardware networking
- NAT/routing should be set up to allow connections to the Internet
- DNS server should be available on the host to resolve domain names

Building and Running
********************

This project outputs to the console.  It can be built and executed
on QEMU as follows:

.. zephyr-app-commands::
   :zephyr-app: samples/posix/gettimeofday
   :host-os: unix
   :board: qemu_x86
   :goals: run
   :compact:

For comparison, a version for native POSIX operating systems (e.g. Linux)
can be built using:

.. code-block:: console

   make -f Makefile.posix