This guide provides a clear overview of how different versions of GUI Guider integrate with LVGL and the supported rendering backends: DRM and Wayland. It also explains how to configure and run your application based on the selected backend.
Switching between backends is straightforward—simply modify a few lines in the lv_conf.h file, located in the lvgl folder of the code generated by GUI Guider.
Default Rendering Backends by GUI Guider Version
GUI Guider Version | LVGL v8 | LVGL v9 |
1.9.1 | DRM | WAYLAND |
1.9.0 | WAYLAND | WAYLAND |
Note: Only one configuration (DRM or Wayland) can be used at a time.
Configuration Settings in lv_conf.h
To use DRM, set the following:
#define LV_USE_WAYLAND 0
#define LV_USE_LINUX_DRM 1
To use Wayland, set:
#define LV_USE_WAYLAND 1
#define LV_USE_LINUX_DRM 0
Running LVGL with DRM
Before launching the gui_guider binary in DRM mode, you must stop the Weston service:
systemctl stop weston
./gui_guider
Note: These steps must be executed via the debug console or over SSH, as stopping Weston will disable the desktop environment and make the local display unavailable
Running LVGL with Wayland
No special steps are required. Simply run the binary:
./gui_guider
You can refer to the following guides to learn how to compile GUI Guider binaries according to the version you are using:
Build GUI Guider projects for iMX93 (GUI GUIDER 1.9.X)
Build GUI Guider projects for iMX93 (GUI GUIDER 1.6.x, 1.7.x, 1.8x)