.. code-block:: shell

   $ ./tools/configure.sh sim:lvgl_fb
   $ make

If everything went fine you should have now the file ``nuttx``

.. code-block:: shell

   $ ls -l nuttx
   -rwxr-xr-x 1 root root 2819920 May 12 15:01 nuttx

Running the NuttX Simulator
~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code-block:: shell

   $ ./nuttx

Using the ``NSH>`` terminal start the LVGL demo:

.. code-block:: shell

   nsh> lvgldemo

NuttX On-Device
---------------

If you don't have an STM32F429I-DISCO, this process will be similar
for other boards.

Configure NuttX to use the stm32f429i-disco board and the LVGL Demo

.. code-block:: shell

   $ sudo openocd -f interface/stlink-v2.cfg -f target/stm32f4x.cfg -c init -c "reset halt" -c "flash write_image erase nuttx.bin 0x08000000"

Reset the board and using the 'NSH>' terminal start the LVGL demo:

.. code-block:: shell

   nsh> lvgldemo

Custom Usage
************

The example app called ``lvgldemo`` uses LVGL's NuttX integration
to run the demos in NuttX.

https://github.com/apache/nuttx-apps/tree/master/examples/lvgldemo

It is used by all LVGL defconfigs. See ``sim:lvgl_fb`` and ``sim:lvgl_lcd``.

You can use it as a reference for adding LVGL to your own NuttX app.
Start by copying the contents of ``lvgldemo.c``. It handles fb and lcd based
display drivers, the touchscreen input driver, and libuv.

NuttX Driver Support
********************

-  **fbdev** - LVGL can create a display for ``/dev/fb*`` devices.
-  **lcd** - LVGL can create a display for ``/dev/lcd*`` devices.
-  **input/uinput touchscreen** - LVGL can create an indev(s) for
   touch devices that use the NuttX input/uinput system.
-  **libuv** - LVGL has support for using libuv as its event loop manager.
   libuv apps can integrate seamlessly.

There is no support for input/uinput keyboards yet. The NuttX X11 sim
keyboard driver emits keycodes that are not standard so the LVGL integration
with it would not be generic, if it were added.

Other Integrations
******************

-  LVGL+NuttX profiler integration
-  Optional dedicated image cache heap

Configurations
**************

The LVGL library is a NuttX "app". You can configure LVGL in ``menuconfig``.

.. code-block:: shell

    $ ./tools/configure.sh stm32f429i-disco:lvgl
    $ make menuconfig

The LVGL `Kconfig`
file provides the available config options to the NuttX build system. The LVGL configs in
``menuconfig`` can be found under
**Application Configuration > Graphics Support > Light and Versatile Graphic Library (LVGL) > LVGL configuration**.

To find the location of a specific config, Press the "/" key to open a search interface.

Here are some configurations that you can use to customize your NuttX and LVGL setup:

-  **LV_USE_NUTTX_INDEPENDENT_IMAGE_HEAP** - You can enable or disable the
   LVGL image heap in NuttX. By default, it is disabled. If you enable
   it, LVGL will use the NuttX heap instead.

Using :c:macro:`LV_STDLIB_CLIB` for :c:macro:`LV_USE_STDLIB_MALLOC`,
:c:macro:`LV_USE_STDLIB_STRING`, or :c:macro:`LV_USE_STDLIB_SPRINTF` is
reasonable as NuttX fully implements these standard library APIs. Whether or
not you choose to use NuttX's ``malloc`` depends on whether you want LVGL
to allocate from the NuttX global heap or use its own.

Where is :c:macro:`LV_OS_NUTTX`?
--------------------------------

NuttX tries to be POSIX compliant where possible, meaning it supports
pthreads (POSIX threads). To enable OS features in LVGL on NuttX,
set :c:macro:`LV_USE_OS` to :c:macro:`LV_OS_PTHREAD`.
The main reason for enabling OS features is for multi-core rendering.
See :c:macro:`LV_DRAW_SW_DRAW_UNIT_CNT`. Otherwise there is no case
for setting it.

Using a Specific Version of LVGL
********************************

Here are the steps to use the latest (or any) version of LVGL in NuttX.

First ensure the build artifacts have been cleared. It will remove the existing unpacked LVGL and ZIP
if there is one.

.. code-block:: shell

    $ make distclean

Now you can ``git clone`` the latest LVGL into the NuttX apps tree. It will persist even after ``make distclean``
because the build system will not remove lvgl if it is a Git repo.

.. code-block:: shell

    $ cd /path/to/nuttxspace/apps/graphics/lvgl
    $ git clone https://github.com/lvgl/lvgl.git

Finally, you must copy the content of ``apps/graphics/lvgl/lvgl/Kconfig`` into
the middle of ``apps/graphics/lvgl/Kconfig``. See the "PASTE THE CONTENTS ..." section below.

``apps/graphics/lvgl/Kconfig``:

.. code-block:: kconfig

    #
    # For a description of the syntax of this configuration file,
    # see the file kconfig-language.txt in the NuttX tools repository.
    #

    menuconfig GRAPHICS_LVGL
    	bool "Light and Versatile Graphic Library (LVGL)"
    	default n
    	---help---
    		Enable support for the LVGL GUI library.

    if GRAPHICS_LVGL

    (PASTE THE CONTENTS OF apps/graphics/lvgl/lvgl/Kconfig HERE)

    config LV_OPTLEVEL
    	string "Customize compilation optimization level"
    	default ""

    endif # GRAPHICS_LVGL

Where can I find more information?
**********************************

-  This blog post: `LVGL on
   LPCXpresso54628 <https://acassis.wordpress.com/2018/07/19/running-nuttx-on-lpcxpresso54628-om13098/>`__
-  NuttX mailing list: `Apache NuttX Mailing
   List <https://nuttx.incubator.apache.org/community/>`__


.. Comment:  The above blank line is necessary for Sphinx to not complain,
    since it looks for the blank line after a bullet list.