Building and setting up QT environment for BeagleBone

There are too few information available on how to easily setup QT environment for building Beaglebone applications (command line or GUI). In this tutorial we will compile QT and setup the environment from scratch.

1. My environment

• Host: Ubuntu 12.10 32bit (VMplayer)
• Target: BeagleBone Black running Angstrom
• QT: 4.8.5

2. Setup Angstrom cross-compile toolchain for Linux

• Download angstrom-2011.03-x86_64-linux-armv7a-linux-gnueabi-toolchain-qte-4.6.3.tar.bz2 for 64bit host or angstrom-2011.03-i686-linux-armv7a-linux-gnueabi-toolchain-qte-4.6.3.tar.bz2 for x86 (or download more recent version at http://www.angstrom-distribution.org/toolchains/). (The Angstrom website is down for 3 weeks – meanwhile you can download the required toolchains from my gdrive –https://googledrive.com/host/0B3Z340LOBulvMG5NRmNlZEppSEE)
• Run
   

  $ tar -C / -xjf angstrom-2011.03-i686-linux-armv7a-linux-gnueabi-toolchain-qte-4.6..tar.bz2

3. Download and un-tar QT

$ wget http://download.qt-project.org/official_releases/qt/4.8/4.8.5/qt-everywhere-opensource-src-4.8.5.tar.gz
$ tar -xzf qt-everywhere-opensource-src-4.8..tar.gz
$ mv qt-everywhere-opensource-src-4.8. qt-4.8.-beagle

4. Create qmake.conf

$ cd qt-4.8.-beagle
$ mkdir ./mkspecs/qws/linux-am335x-g++
$ cp ./mkspecs/qws/linux-arm-g++/qplatformdefs.h ./mkspecs/qws/linux-am335x-g++
$ touch ./mkspecs/qws/linux-am335x-g++/qmake.conf

Add the following to qmake.conf with your favorite editor:

 

#
# qmake configuration for building with arm-linux-g++
#

include(../../common/linux.conf)
include(../../common/gcc-base-unix.conf)
include(../../common/g++-unix.conf)
include(../../common/qws.conf)

# modifications to g++.conf
#Toolchain

#Compiler Flags to take advantage of the ARM architecture
QMAKE_CFLAGS_RELEASE =   -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp
QMAKE_CXXFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp

QMAKE_CC = /usr/local/angstrom/arm/arm-angstrom-linux-gnueabi/bin/gcc
QMAKE_CXX = /usr/local/angstrom/arm/arm-angstrom-linux-gnueabi/bin/g++
QMAKE_LINK = /usr/local/angstrom/arm/arm-angstrom-linux-gnueabi/bin/g++
QMAKE_LINK_SHLIB = /usr/local/angstrom/arm/arm-angstrom-linux-gnueabi/bin/g++

# modifications to linux.conf
QMAKE_AR = /usr/local/angstrom/arm/arm-angstrom-linux-gnueabi/bin/ar cqs
QMAKE_OBJCOPY = /usr/local/angstrom/arm/arm-angstrom-linux-gnueabi/bin/objcopy
QMAKE_STRIP = /usr/local/angstrom/arm/arm-angstrom-linux-gnueabi/bin/strip

load(qt_config)

5. Configure QT embedded

./configure -v -opensource -confirm-license -prefix /opt/qt -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-am335x-g++ -depths 16,24,32 -no-mmx -no-3dnow -no-sse -no-sse2 -no-glib -no-cups -no-largefile -no-accessibility -no-openssl -no-gtkstyle -qt-mouse-pc -qt-mouse-linuxtp -qt-mouse-linuxinput -plugin-mouse-linuxtp -plugin-mouse-pc -fast -little-endian -host-big-endian -no-pch -no-sql-ibase -no-sql-mysql -no-sql-odbc -no-sql-psql -no-sql-sqlite -no-sql-sqlite2 -no-webkit -no-qt3support -nomake examples -nomake demos -nomake docs -nomake translations

　　

 

6. Build and install

$ make -j
$ sudo make install

“-j 4″ will run the long build process reusing 4 CPU cores, you can change to your own CPU cores amount.

7. Install Qt SDK (lib) we built previously on your board

• Make sure you beaglebone is connected to your host
• ssh to your beagle (ssh root@192.168.7.2)
• Create dir structure from your prefix:
   

  root@beaglebone:/# mkdir /opt
  root@beaglebone:/# mkdir /opt/qt

• Copy lib from your host to beagle:
   

  $ scp -r /opt/qt/lib root@192.168.7.2:"/opt/qt"

• Add the lib directory to path by editing /etc/profile and adding:
   

  PATH="...:/opt/qt/lib"

8. Download, install and configure QT Creator

• I suggest installing QT Creator using regular installer:
• Download qt-creator-linux-x86-opensource-2.8.0.run for x86 or qt-creator-linux-x86_64-opensource-2.8.0.run for 64bit
•  

  chmod +x qt-creator-linux-x86_64-opensource-2.8..run
  ./qt-creator-linux-x86_64-opensource-2.8..run

• Follow installation Wizard
• Run Angstrom toolchain environment setup:
   

  $ . /usr/local/angstrom/arm/environment-setup

• Open Qt Creator and
• Configure Qt version
• Go to Tools->Options->Build & Run->Qt Versions and click Add
• Select qmake.conf from /opt/qt/bin
• Click Ok
• Configure target device connection
• Go to Tools->Options->Devices
• Click Add and select Generic Linux Device
• Add IP 192.168.7.2, User: root
• Set name to “Beaglebone”
• Click Ok
• Configure Compiler
• Go to Tools->Options->Build & Run->Compilers and click Add->GCC
• Select compiler path: /usr/local/angstrom/arm/bin/arm-angstrom-linux-gnueabi-g++
• Click Ok
• Configure Kit
• Go to Tools->Options->Build & Run->Kits and click Add
• Call new kit Beaglebone
• Select device type: “Generic Linux Device”
• Select the device you previously created
• Select compiler you created
• Select Qt version you created
• Select GDK path as /usr/local/angstrom/arm/bin/arm-angstrom-linux-gnueabi-gdk
• Click Ok

9. Build Qt application

• Create new project (File->New project->Qt Project->Qt Console application)
• Edit your project (.pro) file
• Add the following after “TARGET=…” line:
   

  target.files = <YOUR EXECUTABLE NAME>
  target.path = /home/root
  INSTALLS = target

• Go to Projects -> Run, you should see on “Files to deploy” table your “target” settings
• Now you are ready to build and deploy you project on your target board
• The following example application should print Hello world inside your console:
   

  #include <QCoreApplication>
  #include <iostream>
  
  int main(int argc, char *argv[])
  {
      QCoreApplication a(argc, argv);
  
      std::cout << "hello world" << std::endl;
  
      return a.exec();
  }

Good luck!

Meir Tseitlin

This entry was posted in Beaglebone, Linux Embedded, QT by Miro. Bookmark the permalink.

71 THOUGHTS ON “BUILDING AND SETTING UP QT ENVIRONMENT FOR BEAGLEBONE”