Jumpnow Technologies


Using Qt Creator to cross-compile and debug Raspberry Pi Qt5 apps

10 Apr 2017

The following instructions assume a few things

1) You have built a Linux system for the Raspberry Pi with tools from the Yocto Project using these instructions or something similar.

2) You are currently running the qt5-image or another image with similar Qt5.7 headers, libs and associated dev tools installed.

3) You have built a cross-compiler SDK with Yocto and installed it on the workstation you plan to develop on.

For (3) you can refer to this post for some more details, but here is the short version

Setup the Yocto environment as normal

scott@fractal:~$ source poky-krogoth/oe-init-build-env ~/rpi/build

build the SDK

scott@fractal:~/rpi/build$ bitbake meta-toolchain-qt5

The resulting SDK installation script can be found in ${TMPDIR}/deploy/sdk.

Copy the script to the workstation you plan to work from and run it.

I built my SDK on an Ubuntu 16.04 server, but for the RPi Qt cross-development I’m going to use a laptop with Fedora 24 installed.

I ran the SDK installation script on the laptop as root like this

scott@t410:~$ sudo poky-glibc-x86_64-meta-toolchain-qt5-cortexa7hf-neon-vfpv4-toolchain-2.1.1.sh

The default installation path is /opt/poky/2.1.1.

I chose /opt/poky/rpi-2.1.1 instead for the install directory on my workstation. Adjust paths for your installation accordingly in the following examples.

Configuring Qt Creator

Startup Qt Creator, I’m using version 4.0.3, the default with Fedora 24.

Open the Tools | Options dialog.

Add a Qt version

Here is where you setup the path to qmake for the version of Qt the RPi is running.

Give the version whatever name you want, the important thing is the path to qmake.

Screenshot - Qt Creator Version Setup

Add a compiler

Add a new GCC compiler with the following path, again choose any name you want

Screenshot - Qt Creator Compiler Setup

Add a debugger

Note: Remote debugging broke with the Yocto [morty] branch. Cross-compiling and remote deploy from Qt Creator still work. Use the Yocto [krogoth] branch if you require remote debugging.

If you want to remotely debug your Qt applications you need to setup the path to gdb.

Screenshot - Qt Creator Debugger Setup

Add a kit

Add a Qt Creator kit using the version, compiler and debugger setups that were just added and specifying a sysroots path in the SDK and a mkspec to use.

Screenshot - Qt Creator Kit Setup

This kit will be remembered by Qt Creator and can be reused for any Qt project.

Using the new setup

I’ll use a simple QML example with the source available in github.

Clone the project.

scott@t410:~/projects$ git clone https://github.com/scottellis/qqtest
Cloning into 'qqtest'...
remote: Counting objects: 29, done.
remote: Total 29 (delta 0), reused 0 (delta 0), pack-reused 29
Unpacking objects: 100% (29/29), done.
Checking connectivity... done.

Source the SDK environment script to setup some initial environment variables.

scott@t410:~$ source /opt/poky/rpi-2.1.1/environment-setup-cortexa7hf-neon-vfpv4-poky-linux-gnueabi

Launch Qt Creator from that same shell.

scott@t410:~$ qtcreator

Then open the project file qqtest.pro using File | Open File or Project...

You should see an option to use the new RPi kit that you just setup.

Screenshot - Qt Creator Kit Selection

Check the RPi kit and click Configure Project.

At this point you should be able to build the project, cross-compiled for the RPi.

For automatic deployment and remote debugging go to the Tools | Options dialog again and select Devices in the left pane.

You’ll need the IP address of the RPi, in this example mine is

Screenshot - Qt Creator Devices Setup

It’s all defaults except for the IP address. Use root with no password unless you added one.

You can leave the GDB server executable blank. It will be found automatically.


You should now be able to build, run and debug Qt5 applications on the Raspberry Pi from your Linux workstation.