1.. zephyr:code-sample:: lvgl
2   :name: LVGL basic sample
3   :relevant-api: display_interface
4
5   Display "Hello World" and a dynamic counter using LVGL.
6
7Overview
8********
9
10This sample application displays "Hello World" in the center of the screen
11and a counter at the bottom which increments every second. If an input driver
12is supported, such as the touch panel controller on mimxrt10{50,60,64}_evk
13boards, "Hello World" is enclosed in a button that changes to the toggled state
14when touched.
15
16Requirements
17************
18
19Display shield and a board which provides a configuration
20for Arduino connectors, for example:
21
22- :ref:`adafruit_2_8_tft_touch_v2` and :ref:`nrf52840dk_nrf52840`
23- :ref:`buydisplay_2_8_tft_touch_arduino` and :ref:`nrf52840dk_nrf52840`
24- :ref:`ssd1306_128_shield` and :ref:`frdm_k64f`
25
26or a board with an integrated display:
27
28- :ref:`esp_wrover_kit`
29
30or a simulated display environment in a native Posix application:
31
32- :ref:`native_posix`
33- `SDL2`_
34
35or
36
37- :ref:`mimxrt1050_evk`
38- `RK043FN02H-CT`_
39
40or
41
42- :ref:`mimxrt1060_evk`
43- `RK043FN02H-CT`_
44
45Building and Running
46********************
47
48Example building for :ref:`nrf52840dk_nrf52840`:
49
50.. zephyr-app-commands::
51   :zephyr-app: samples/subsys/display/lvgl
52   :board: nrf52840dk_nrf52840
53   :shield: adafruit_2_8_tft_touch_v2
54   :goals: build flash
55
56Example building for :ref:`native_posix`:
57
58.. zephyr-app-commands::
59   :zephyr-app: samples/subsys/display/lvgl
60   :board: native_posix
61   :goals: build run
62
63Alternatively, if building from a 64-bit host machine, the previous target
64board argument may also be replaced by ``native_posix_64``.
65
66References
67**********
68
69.. target-notes::
70
71.. _LVGL Web Page: https://lvgl.io/
72.. _SDL2: https://www.libsdl.org
73.. _RK043FN02H-CT: https://www.nxp.com/products/processors-and-microcontrollers/arm-based-processors-and-mcus/i.mx-applications-processors/i.mx-rt-series/4.3-lcd-panel:RK043FN02H-CT
74