Simple Hello World application using qt5 for embedded Linux device.

Simple Hello World application using qt5 for embedded Linux device.

This blog presents a simple example of how to create a qt5 application for a Linux embedded device that runs Wayland or x-server. I’m using Yocto build system. I already have a BSP for IMX8 + toolchain so. I just have to install qt5 on it. In the time that I wrote this page. See here a reference to use Yocto project.

bug workaroud

I worked with sumo branch and had to do some work around over three bugs that I found during the compilation of qt5.

  1. apply this patch
  2. apply changes to this file: qfilesystemengine_unix.cpp. I found it under tmp/work/x86_64-linux/qtbase-native/5.10.1+gitAUTOINC+6c6ace9d23-r0/git/src/corelib/io/qfilesystemengine_unix.cpp.
    • line 101,107 - remove the static keyword, since the function already defined as an extern in another file.
    • line 106 -removed - it caused to multiplay definition compilation error message.

install qt5-layer

The layer meta-qt5 should defined on local/conf/bblayers.conf and the following command should run under the build directory:

bitbake bitbake meta-toolchain-qt5

to install to sdk type under the build directory:

sudo  ./tmp/deploy/sdk/

when you do it, you can test it:

$  . /opt/fsl-imx-xwayland/4.14-sumo/environment-setup-aarch64-poky-linux
$ echo $CC
aarch64-poky-linux-gcc --sysroot=/opt/fsl-imx-xwayland/4.14-sumo/sysroots/aarch64-poky-linux

Simple application

I created a straightforward application using qt-creator, and I had to run this command:

. /opt/fsl-imx-xwayland/4.14-sumo/environment-setup-aarch64-poky-linux

before I run qmake & make:


These two commands should create the ELF file ready to run under the ARM.

install and run the application

QT_QPA_PLATFORM_PLUGIN_PATH=/ptath/to/plugins ./app 

In Gentoo desktop, the plugin path is /usr/lib/qt5/plugins/platforms/, so when we install the qt5 libraries that application depends on, we should also install it in the correct location. To install the application as part of an image, we have to write an appropriate bitbabke file that will install all dependencies. See recipes-qt to understand which files it requires to install.

Demo of embedded QT5 application on touch screen

Demo Application

The demo application runs two scripts as a response to a button press: and, each runs as a child process, and it displays its standard output on the text editor widget.



comments powered by Disqus