For creating the QT5 toolchain a complete Yocto build environment is required.

Depending on your module choose the correct guide - if not already set up.


QSXP, QSXM, QS8M, TX8M, TX8P use NXP Yocto BSP Guide


QSMP, TXMP, TX6, TXUL use Mainline Yocto BSP Guide

Building SDK

  1. Setup the Yocto build-directory as described in the Yocto guide for your machine. Use the following values:

  • DISTRO=karo-wayland

  • MACHINE=<desired-machine>

  1. Build the image for your target:

bitbake karo-image-qt5
  1. Program your board using our manufacturing tools. You can also boot the image from net/tftp.


QSXP, QSXM, QS8M, TX8M, TX8P use UUU - Universal Update Utility


QSMP, TXMP use STM32CubeProgrammer


TX6, TXUL use MFG-Tool

  1. Populate the corresponding SDK:

bitbake karo-image-qt5 -c populate_sdk

Installing SDK

To install the previously built SDK on your host, simply run:



It is recommended to install every toolchain into a seperate folder inside /opt/

Installing QT Creator

Download the QT Creator offline installation for Linux from https://www.qt.io/offline-installers and execute the .run file. This will install the QT Creator for you.

Setup QT Creator

Now we have to tell QtCreator to use our previously installed SDK.


Start QT Creator, go to Tools ‣ Options and select the Kits section.

Configure QMake, Compilers, Debuggers, and CMake as shown in the following screenshots. Of course you have to fit the paths depending on your SDK.


QT Versions


C Compilers


C++ Compilers







For the next steps it is required that your target has a working ethernet connection to your host.

Go to section Devices and choose Add ‣ Generic Linux Device ‣ Start Wizard. Follow the steps to configure your target.

To find out the IP of our target, run ifconfig -a on it.



Now - in Kits section again - setup the Kit itself with the previously configured parameters.


Complete Kits

Press Apply and close the Options Window.

Hello World

Create a new project using the project wizard on QTCreators start screen clicking + New.

Select e.g. “Qt Quick Application - Scroll” and go through the steps. Make sure you select the right Kit.

Once created you should be able to run project on your target.