feat(wayland): add egl support (#9398)
Arduino Lint / lint (push) Has been cancelled
Build Examples with C++ Compiler / build-examples (push) Has been cancelled
MicroPython CI / Build esp32 port (push) Has been cancelled
MicroPython CI / Build rp2 port (push) Has been cancelled
MicroPython CI / Build stm32 port (push) Has been cancelled
MicroPython CI / Build unix port (push) Has been cancelled
C/C++ CI / Build OPTIONS_16BIT - Ubuntu (push) Has been cancelled
C/C++ CI / Build OPTIONS_24BIT - Ubuntu (push) Has been cancelled
C/C++ CI / Build OPTIONS_FULL_32BIT - Ubuntu (push) Has been cancelled
C/C++ CI / Build OPTIONS_NORMAL_8BIT - Ubuntu (push) Has been cancelled
C/C++ CI / Build OPTIONS_SDL - Ubuntu (push) Has been cancelled
C/C++ CI / Build OPTIONS_16BIT - cl - Windows (push) Has been cancelled
C/C++ CI / Build OPTIONS_16BIT - gcc - Windows (push) Has been cancelled
C/C++ CI / Build OPTIONS_24BIT - cl - Windows (push) Has been cancelled
C/C++ CI / Build OPTIONS_24BIT - gcc - Windows (push) Has been cancelled
C/C++ CI / Build OPTIONS_FULL_32BIT - cl - Windows (push) Has been cancelled
C/C++ CI / Build OPTIONS_FULL_32BIT - gcc - Windows (push) Has been cancelled
C/C++ CI / Build ESP IDF ESP32S3 (push) Has been cancelled
C/C++ CI / Run tests with 32bit build (push) Has been cancelled
C/C++ CI / Run tests with 64bit build (push) Has been cancelled
BOM Check / bom-check (push) Has been cancelled
Verify that lv_conf_internal.h matches repository state / verify-conf-internal (push) Has been cancelled
Verify the widget property name / verify-property-name (push) Has been cancelled
Verify code formatting / verify-formatting (push) Has been cancelled
Compare file templates with file names / template-check (push) Has been cancelled
Build docs / build-and-deploy (push) Has been cancelled
Test API JSON generator / Test API JSON (push) Has been cancelled
Install LVGL using CMake / build-examples (push) Has been cancelled
Check Makefile / Build using Makefile (push) Has been cancelled
Check Makefile for UEFI / Build using Makefile for UEFI (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark - Script Check (scripts/perf/tests/benchmark_results_comment/test.sh) (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark - Script Check (scripts/perf/tests/filter_docker_logs/test.sh) (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark - Script Check (scripts/perf/tests/serialize_results/test.sh) (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark 32b - lv_conf_perf32b (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark 64b - lv_conf_perf64b (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark - Save PR Number (push) Has been cancelled
Hardware Performance Test / Hardware Performance Benchmark (push) Has been cancelled
Hardware Performance Test / HW Benchmark - Save PR Number (push) Has been cancelled
Performance Tests CI / Perf Tests OPTIONS_TEST_PERF_32B - Ubuntu (push) Has been cancelled
Performance Tests CI / Perf Tests OPTIONS_TEST_PERF_64B - Ubuntu (push) Has been cancelled
Port repo release update / run-release-branch-updater (push) Has been cancelled
Verify Font License / verify-font-license (push) Has been cancelled
Verify Kconfig / verify-kconfig (push) Has been cancelled
Close stale issues and PRs / stale (push) Has been cancelled

This commit is contained in:
André Costa
2026-01-15 09:41:14 +01:00
committed by GitHub
parent 2b37b12aba
commit 0648b6d916
10 changed files with 525 additions and 16 deletions
@@ -64,6 +64,46 @@ It uses Wayland's shared memory protocol (``wl_shm``) for rendering, which is su
The SHM backend is enabled by default and requires no additional configuration.
EGL Backend
-----------
The **EGL Backend** provides hardware-accelerated rendering for the Wayland driver using OpenGL ES.
It utilizes the EGL (Embedded-System Graphics Library) interface to create OpenGL ES rendering contexts,
enabling GPU-accelerated graphics on Wayland compositors that support the necessary protocols.
**Features:**
* Hardware-accelerated rendering via OpenGL ES
* Full rotation support
* Compatible with LVGL 3D rendering capabilities (see :ref:`3d_gltf_support`)
* Efficient GPU-based compositing
**Requirements:**
* OpenGL ES 2.0 support on the target hardware
* ``LV_USE_OPENGLES`` must be enabled in your LVGL configuration
* Must link with the ``wayland-egl`` library
**Usage:**
To enable the EGL backend:
1. Enable OpenGL ES support in your LVGL configuration:
.. code-block:: c
#define LV_USE_OPENGLES 1
2. Link your application with the ``wayland-egl`` library (add to your build system):
.. code-block:: bash
-lwayland-egl
**Note:** If your target board has OpenGL ES 2.0 support, this backend can be used with LVGL's 3D rendering
capabilities for glTF model visualization. See :ref:`3d_gltf_support` for details on 3D rendering support.
G2D Backend
-----------
@@ -82,13 +122,20 @@ The G2D backend leverages NXP's hardware-accelerated 2D graphics engine availabl
**Usage:**
Enable the G2D backend in ``lv_conf.h``:
To enable the G2D backend:
.. code:: c
1. Enable G2D support in your LVGL configuration:
#define LV_USE_DRAW_G2D 1
.. code-block:: c
When ``LV_USE_DRAW_G2D`` is enabled, the Wayland driver will automatically use the G2D backend instead of the default SHM backend.
#define LV_USE_G2D 1
#define LV_USE_DRAW_G2D 1
2. Link your application with the ``g2d`` library (add to your build system):
.. code-block:: bash
-lg2d
@@ -248,7 +295,6 @@ For applications that don't need decorations (fullscreen, kiosk mode, etc.), sim
Current state and objectives
****************************
* EGL Support
* Server-side window decorations
* Rotation support for the SHM backend
@@ -70,6 +70,8 @@ for integration into custom graphics pipelines.
For complete implementation details, see :ref:`OpenGL driver <opengl_driver>`.
.. _3d_gltf_support:
3D/glTF Support
===============