Monday, June 24, 2024

Setting Up Qt On Raspberry Pi And Basic Application

This project describes the steps to get started with Qt software on Raspberry Pi operating system. Qt is a platform-independent application that can run on all desktop and mobile operating systems (OSes), in addition to most embedded OSes—including Linux Embedded, Windows Embedded, QNX, vxWorks and Integrity—with one technology and one codebase. When developed, the application can run across multiple platforms at near-native performance. Thus, Qt saves a lot of development time and, hence, minimises time-to-market.

Qt is well-documented and has extensive API functionality, high-end graphics and integrated development tools. It has all that is needed to make the creation of embedded applications easy.

Hardware required for building an embedded application on Qt is as follows:

  1. Raspberry Pi 3 board
  2. Touchscreen or computer monitor
  3. USB keyboard and mouse
  4. Memory card (16GB or 8GB)
  5. Power adaptor (5V, 2A)

Preparing Raspberry Pi for Qt framework

Download Raspbian OS from the Internet, and install it on the SD card (NOOBS is recommended).

Internet connectivity is required for Raspberry Pi. Open the terminal on Raspberry Pi by pressing ctrl+alt+t simultaneously on the keyboard. Then, check GCC compiler. If it is not available, install it using the following command:

- Advertisement -

$ Sudo apt-get install gcc

Use the following commands to install Qt Creator:

$ sudo apt-get update
sudo apt-get upgrade
sudo apt-get install qt4-dev-tools
sudo apt-get install qtcreator
sudo apt-get install git-core
sudo apt-get install subversion

- Advertisement -

After successful execution of these steps, Qt Creator will be added to the programming list on Raspberry Pi OS on the desktop.

Setting up Qt platform on Raspbian OS

When running Qt Creator for the first time, configure the following settings:

  1. Go to Tools>Options>Build & Run>Compilers. Compilers window is shown in Fig. 1.
  2. Click on Add>GCC. Set the path to usr/bin/arm- linux-gnueabihf-gcc-4.9, as shown in Fig. 2. Then, click on Apply to save changes.
  3. Go to Qt Versions>Add>Browse (usr/bin/qmake-qt4) and select the latest version, as shown in Fig. 3. Click on Apply.
  4. Go to Kits>Add. Set Device Name as Raspberry Pi (or any other name of your choice). Select Device Type as Desktop, and Device as Local PC, as shown in Fig. 4. Click on Apply.
Compilers window
Fig. 1: Compilers window
Adding the path
Fig. 2: Adding the path
Select latest version of Qt
Fig. 3: Select latest version of Qt
Select device type
Fig. 4: Select device type

Project development with Qt

You are now ready to begin with the first project. The steps are as follows:

  1. Click on New Project.
  2. Select Applications>Qt Widgets Application>Choose…, as shown in Fig. 5.
  3. Type in the name of your project (HelloWorld) and choose the destination folder where you wish to save your project, as shown in Fig. 6.
  4. Select the kit as Raspberry Pi (or the name that you chose in Fig. 4 above for your kit) and click on Next, as shown in Fig. 7.
  5. Continue with default names (MainWindow class, mainwindow.h, mainwindow.cpp) in the class information sub-window, as shown in Fig. 8. Click on Next.
  6. All files to be added in the project should be listed here. Click on Finish.
    A new project called HelloWorld will be created. Project Explorer will show all relevant project files, as shown in Fig. 9.
  7. Click on Build>Build Project. The console window should show no errors if the kit is correctly configured.
  8. Click on Build>Run. MainWindow form will be displayed, as shown in Fig. 10.
  9. When you click on main.cpp, the default screen will appear.
  10. Add the following code to main.cpp to display ‘Hello World’ on the main window form as shown in Fig. 11.
Select Qt widgets application
Fig. 5: Select Qt widgets application
Project name
Fig. 6: Project name
Select Raspberry Pi kit
Fig. 7: Select Raspberry Pi kit
Class information window
Fig. 8: Class information window
HelloWorld project on Project Explorer window
Fig. 9: HelloWorld project on Project Explorer window
MainWindow screen
Fig. 10: MainWindow screen
Default main.cpp screen
Fig. 11: Default main.cpp screen

Qlable *lable=new Qlabel (&w);
lable->setText(“Hello World”);

11. Click on Build>Run. The form with ‘Hello World’ on the screen will be displayed, as shown in Fig. 12.

Hello World screen
Fig. 12: Hello World screen

Harwinder Singh and Harsimranjit Kaur are project engineers at C-DAC Mohali, Punjab


  1. Excellent job explaining all the details. This is the first time I’ve been able to get a proper working Qt on my Raspian system, and all thanks to following your directions.

    It inspired me to extrapolate from your description, and I managed to get another system working (eventually) with Qt5, and kinds of extra features.

    Thank you for a job well done.


Unique DIY Projects

Electronics News

Truly Innovative Tech

MOst Popular Videos

Electronics Components