1.. zephyr:code-sample:: timeaware-gpio
2   :name: Time-aware GPIO
3   :relevant-api: tgpio_interface
4
5   Synchronize clocks.
6
7Overview
8********
9
10A sample application that can be used with any supported boards. eg. RPL.
11prints configuration info to the console. Below functionalities are tested:
12
131. Periodic pulse generation (an Oscilloscope or loopback may be required)
142. Input pulse timestamping (a pulse generator or loopback may be required)
15
16Building and Running
17********************
18
19This application can be built and executed as follows:
20
21.. zephyr-app-commands::
22   :zephyr-app: samples/drivers/misc/timeaware_gpio
23   :board: intel_rpl_crb
24   :host-os: unix
25   :goals: build
26
27
28To build for another supported board, change "intel_rpl_crb" to that board's
29name (if supported).
30
31Sample Output
32=============
33
34.. code-block:: console
35
36   *** Booting Zephyr OS build zephyr-v3.4.0-4166-g52b34a310c67 ***
37   [TGPIO] Bind Success
38   [TGPIO] Time now: 00000001477ed72f
39   [TGPIO] Running rate: 19200000
40   [TGPIO] Periodic pulses start at: 0000000148a3cf2f
41   [TGPIO] timestamp: 0000000000000000, event count: 0000000000000000
42   [TGPIO] timestamp: 0000000148a3cf31, event count: 0000000000000001
43   [TGPIO] timestamp: 0000000149c8c731, event count: 0000000000000002
44   [TGPIO] timestamp: 000000014aedbf31, event count: 0000000000000003
45   [TGPIO] timestamp: 000000014c12b731, event count: 0000000000000004
46   [TGPIO] timestamp: 000000014d37af31, event count: 0000000000000005
47   [TGPIO] timestamp: 000000014e5ca731, event count: 0000000000000006
48   [TGPIO] timestamp: 000000014f819f31, event count: 0000000000000007
49   [TGPIO] timestamp: 0000000150a69731, event count: 0000000000000008
50   [TGPIO] timestamp: 0000000151cb8f31, event count: 0000000000000009
51   [TGPIO] timestamp: 0000000152f08731, event count: 000000000000000a
52   [TGPIO] timestamp: 0000000154157f31, event count: 000000000000000b
53