Skip to content

Latest commit

 

History

History
37 lines (28 loc) · 1.57 KB

build-device.md

File metadata and controls

37 lines (28 loc) · 1.57 KB
Raw

Target Build Guide

This guide gives an overview on how to build lvgljs for an embedded Linux target.

This is not too different from building for a regular Linux target, besides that you will probably need to cross-compile and won't want to use the sdl2 simulator.

When building for a target device, the device HAL is selected.
Currently it is not possible to configure the properties of the device and it will by default use a screen size of 1024x600 together with the framebuffer device.

You will most likely need to tweak the screen size for your device, and can also opt to use a different LVGL display like DRM or wayland.

The way you cross-compile applications for your target will depend on your use-case, which is out-of-scope for this guide.

You will have to make sure that:

  • your sysroot has all the necessary dependencies.
    Take a look at the txiki readme for a list of the dependencies
  • you provide your own libffi library, since building it together with txiki doesn't work when cross-compiling at this moment.
    Do this by passing -DUSE_EXTERNAL_FFI=ON to cmake.

You can now cross-compile like normal. For instance, if you're using Yocto, you source your SDK environment and then do

cmake -B build -DUSE_EXTERNAL_FFI=ON
cmake --build build

You can then copy build/lvgljs to your target device together with one of the demo's like demo/widgets and try to run it there:

./lvgljs run demo/widgets/index.js