Personal tools


From Variscite Wiki

Jump to: navigation, search

- Boot to QT based on Yocto

1 About Boot to Qt

Boot to Qt is a light-weight, Qt-optimized, full software stack for embedded Linux systems that is installed into the actual target device.

The stack can be customized to production with Build-Your-Own-Stack tooling, including proprietary Yocto Project recipes.


The full B2QT documentation is available at Qt for Device Creation official page.

2 Requirements

You should be familiar with the Yocto tools and the concept of recipes. For more information, see Yocto Project documentation.

To get started, you need the following:

  • Install the dependencies for the Yocto tools. In Ubuntu, the following packages are required:
sudo apt-get install gawk curl git-core diffstat unzip p7zip texinfo \
gcc-multilib build-essential chrpath libsdl1.2-dev xterm gperf bison \

3 Setting Up Yocto Build Environment

Run the setup script that initializes the Yocto environment. Using Variscite VAR-SOM-MX6 as an example:

mkdir ~/var-b2qt
cd ~/var-b2qt
git clone  -b 
cd meta-variscite-boot2qt
./b2qt-init-build-env init --device <target>

b2qt-init-build-env has the following additional command line options:

  • list-devices: show all supported devices that can be used for a Boot to Qt build
  • mirror: create a local mirror of the yocto repositories. This enables you to use the same repository downloads for multiple build environments, when initializing with init --reference <mirror path>.

For all command line options, see:

./b2qt-init-build-env help

4 Building the Image and Toolchain

After the Yocto environment is set up, you need to configure the build environment for your target device:

MACHINE= source ./

The following table lists the MACHINE values for our reference platforms:

SoMs & boards target
VAR-SOM-SOLO/DUAL/MX6, DART-MX6 and related board configurations var-som-mx6
DART-6UL and related board configurations imx6ul-var-dart
VAR-SOM-MX7 and related board configurations imx7-var-som

Yocto recipes for Boot to Qt for embedded Linux have two main targets to build: The target image, and the external toolchain that can be used with Qt Creator for building Qt applications.

MACHINE= bitbake b2qt-embedded-qt5-image
MACHINE= bitbake meta-toolchain-b2qt-embedded-qt5-sdk

The target rootfs image is located in the


and the new toolchain is in


5 Flashing the SD card image

Plug the SD card into your Linux HOST PC, run "dmesg|tail" and see which device is added (i.e. /dev/sdX or /dev/mmcblkX)

$ sudo umount /dev/sdX*
$ sudo dd if=tmp/deploy/images//b2qt-embedded-qt5-image-.img of=/dev/sdX bs=1M && sync

Replace /dev/sdX with your actual device name, e.g. /dev/sdb

6 Creating an extended SD card

Variscite provides the script which creates our NAND/eMMC recovery SD card. The script copies the NAND/eMMC flash burning scripts and relevant binaries for your convenience.
Later, you will be able to follow either the more automatic Yocto Recovery SD card guide to burn your images to NAND flash or eMMC.

Plug the SD card into your Linux HOST PC, run "dmesg|tail" and see which device is added (i.e. /dev/sdX or /dev/mmcblkX)

$ cd ~/var-b2qt/meta-variscite-boot2qt
$ sudo MACHINE= sources/meta-variscite-fslc/scripts/var_mk_yocto_sdcard/ /dev/sdX

Replace /dev/sdX with your actual device name, e.g. /dev/sdb