Adding New Device Configurations

By default, Boot to Qt for embedded Linux supports several Yocto meta layers. If you are developing software for a hardware that is not supported by default, you can add a new Yocto meta layer to your Boot to Qt for embedded Linux environment.


A new Yocto meta layer can be added to the Boot to Qt for embedded Linux environment only if you have the Yocto meta layer available for your hardware. Thus you should be familiar with the Yocto tools and the concept of recipes. For more information, see the Yocto Project documentation.

To get started, you need the following:

  • Install the Boot to Qt source packages. You can find these by running the MaintenanceTool application located in the Qt for Device Creation installation directory and selecting Package Manager. The Yocto meta layer package contains the additional recipes required to make the image compatible with Boot to Qt.
  • Install the Yocto tools dependencies as described in Building Your Own Embedded Linux Image.

Adding a New Yocto Meta Layer

To add a new Yocto meta layer, you need to modify the file /sources/meta-b2qt/manifest.xml. You need to edit the elements Remote and Project:

Remote element:

fetchA Git repository URL of a new meta layer
nameA project name used in the Git repository. You need to add it without the .git postfix.

Project element:

nameA project name used in the Git repository. You need to add it without the .git postfix.
remoteA remote Git repository name
revisionA Yocto meta layer Git revision
pathA Yocto meta layer source path
groupsGroups of the Yocto meta layer. The group value must match the PROJECT_GROUPS in the file /sources/meta-b2qt/b2qt-init-build-env. See the section Fetching the Meta Layer.

For example:

<remote fetch="git://github.com/newmetalayer" name="mynewhw"/>
<project name="mynewhw"

Fetching the Meta Layer

To fetch the new Yocto meta layer, you need to modify the file /sources/meta-b2qt/b2qt-init-build-env. The PROJECT_GROUPS value in the file must match the groups attribute value in the file /sources/meta-b2qt/manifest.xml.


Creating Meta Layer Configuration File

Each hardware configuration usually has its own bblayers.conf configuration file. The file lists the meta layers that are included in the built image. The configuration files are found from the directory /sources/meta-b2qt/conf.

Create a new bblayer.conf file (for example bblayers.conf.mynewhw.sample) for your Yocto meta layer and add it to the directory /sources/meta-b2qt/conf.

Edit the file /sources/meta-b2qt/scipts/setup-environment.sh so that it contains a reference to the created bblayer.conf file:


Hardware Specific Configurations

The new Yocto meta layer may require also some hardware specific configurations. The configurations are defined in the .conf files located in the directory /sources/meta-b2qt/conf/distro/include. Typically, a hardware specific configuration file defines a boot configuration, EGL provider library, and other configurations that might be required (for example a support for Wayland).

Create a new configuration file for your hardware and add it to the directory /sources/meta-b2qt/conf/distro/include. In our example we name the configuration file as mynewhw.conf:

DEFAULTTUNE = "cortexa15hf-neon"
MACHINE_EXTRA_INSTALL = “myspecial-gpudriver”
MACHINE_EXTRA_INSTALL_SDK = “libegl-mygpu-dev”

Testing the New Yocto Meta Layer

You can test the new Yocto meta layer by running the Yocto build commands described in Building Your Own Embedded Linux Image:

cd <BuildDir>
<INSTALL_DIR>/5.9/Boot2Qt/sources/meta-b2qt/b2qt-init-build-env init --device mynewhw
export MACHINE=mynewhw
source ./setup-environment.sh
bitbake b2qt-embedded-qt5-image
bitbake meta-toolchain-b2qt-embedded-qt5-sdk

Available under certain Qt licenses.
Find out more.