Skip to content

Commit 24b5c71

Browse files
StaticRocketcshilwant
authored andcommitted
fix: add disclaimer about qt eglfs backend
Add a disclaimer about the EGLFS backend and the required device parameter, since it's a little unclear what could cause "Failed to create display device" error messages. Signed-off-by: Randolph Sapp <[email protected]>
1 parent 05fd1b2 commit 24b5c71

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

source/linux/Foundational_Components/Graphics/Common/QT_Graphics_Framework.rst

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,14 @@ provided with Qt. By default EGLFS will use the ``eglfs_kms`` backend.
3131
The default ``eglfs_kms`` configuration file for Qt5 is located at
3232
:file:`/etc/qt5/eglfs_kms_cfg.json`.
3333

34+
Please note that EGLFS backend is not smart enough to select a display device
35+
automatically. One must be specified in the config file using the ``device``
36+
key. If one is not specified, :file:`/dev/dri/card0` will be used, which can
37+
either point at the GPU or the Display device depending on the order in which
38+
the devices were initialized. We recommend using the :file:`/dev/dri/by-path/*`
39+
path for a persistent device path. If an incorrect device was chosen, an error
40+
like the following can appear: ``Failed to create display device (err=19)``.
41+
3442
For more information about Qt's EGLFS and using Qt5 in embedded
3543
applications see:
3644

0 commit comments

Comments
 (0)