The tutorial consists of 2 sections. The first will provide instructions for the PC and the second section presents instruction for BeagleBone Black.

If you encounter the following block

$ echo "Hello world"

you should type it in the terminal (GNOME Terminal, Konsole, xterm, etc)

BeagleBone Black side

Firstly, let us prepare BeagleBone Black flashing it with the latest Debian image. Download latest image from I used Debian Jessie 8.7.

$ wget

After that please insert SD card in your PC and identify which device it is your system, in my system it was /dev/sdb

The next step is to write image file to your SD card. There are two options of doing that: using p7zip or xz-tools.


Install 7zip using the following line.

$ sudo apt-get install p7zip

Now, you can unpack it.

$ 7z x bone-debian-8.7-lxqt-4gb-armhf-2017-03-19-4gb.img.xz

Write image file to your SD card using dd.

$ sudo if=bone-debian-8.7-lxqt-4gb-armhf-2017-03-19-4gb.img of=/dev/sdb bs=4M


Install xz-tools using the following line.

$ sudo apt-get install xz-tools

Now you can write it to your SD card.

$ xzcat bone-debian-8.7-lxqt-4gb-armhf-2017-03-19-4gb.img.xz > /dev/sdb

By default the image downloaded will not flash your eMMC. To flash new operating system you have to edit /boot/uEnv.txt

Insert your SD card into BeagleBone Black and boot it, BBB will load from SD card.

Now, after the OS was booted you can do it for example with nano.

$ ssh debian@
$ sudo nano /etc/uEnv.txt

Remove the ‘#’ on the line with ‘cmdline=init=/opt/scripts/tools/eMMC/’. For more details please refer to

Reboot and wait until flash light turn off. You can unplug you microSD card and boot into a fresh OS.

The final step on your BBB is to install gdbserver such that it would be possible to debug your application remotely with Qt Creator.

To install GDB server on BBB enter the following in your terminal

$ ssh debian@
$ sudo apt-get install gdbserver

Developer’s computer side

Install necessary compilers and tools for ARM architecture

$ sudo apt-get install crossbuild-essential-armhf gcc-4.9-arm-linux-gnueabihf

Install GDB debugger to enable remote debug

$ sudo apt-get install gdb-multiarch

Download Qt Creator from the official website Easiest path would be to follow the link below and select the latest version.

at the moment of writing of the document the latest version was 4.2.1 therefore

$ cd ~/Downloads
$ wget
$ chmod +x ./
$ ./

Now let us configure Qt Creator to work with BeagleBone Black

Press Tool->Options Tools

Select on the side bar Build and Run Build and Run

After that add a compiler

Add a compiler

To do so - press Add and select GCC, since we use this compiler.

Add a compiler hint

Fill accordingly the form.

Fill GCC C compiler

Set Compiler path to


And give the name to this compiler GCC 4.9 arm-linux-gnueabihf.

The add C++ compiler too Add GCC C++ compiler

Fill GCC C++ compiler

Let us add debugger as well, switch to Debugger tab. Add GDB Press Add and fill it accordingly

Fill GDB

Go to Kits tab and press Add

Kits overview

Fill the form accordingly BeagleBone Black

Now, let us add our BeagleBone Black Device to Qt Creator.

Devices overview

First step

Set IP - and username - debian and password - temppwd . Second step

Final step

Connection success! Connection Success

Let’s test if everything works creating a new C++ project in Qt Creator.

non Qt C++ application project

Name the project and select appropriate project location: Project location

Select CMake as a build system. Select building system

Select BeagleBone Black Kit Select **BeagleBone Black** Kit

Select GIT as source control systems Select GIT

Press finish and now you have a C++ project runnable on BeagleBone Black.

Now you can develop your C++ program in Qt Creator, at the moment you can compile it, but to run it and debug you should do additional steps. C++ project

Select Default->cross_compilation_test (on Remote Device)

Select needed configuration default

This will compile and run Release configuration on your BBB. You can test it pressing Play button or pressing CTRL-R.

Test run

Congratulation you have cross-compiled and executed your first program on BeagleBone Black.

Select needed configuration debug

Now to debug you should select Debug->cross_compilation_test (on Remote Device)

Select debug configuration

Put a breakpoint and press Debug button or F5. Stop at breakpoint


I would be happy to receive comments and feedback.