C

Installation Guide

To successfully set up Qt for Device Creation, you must closely follow the instructions in this section and perform all the described tasks.

In case of problems, see Troubleshooting.

1. Requirements for Development Host

Before you install Qt for Device Creation, you should install the required software on the development host:

2. Installing Qt for Device Creation

You can install the Qt for Device Creation via the online installer. Download the online installer and follow the instructions in the installation wizard. On Linux, see General Installation Issues for Linux.

The Select components page in the installation wizard lists all the Qt for Device Creation versions and their target devices under the Qt Embedded checkbox:

For each target device Qt for Device Creation provides a system image (<target-device> Linux System) and a toolchain (<target-device> Linux Toolchain). The system image contains the Boot to Qt stack and needs to be flashed to the SD card or directly to the target device (see Installing Boot to Qt on Target Devices). The toolchain is required for building and developing applications for the target devices.

Note: Building the Boot to Qt system image and toolchain are not supported on Windows. Thus the sources of Qt for Device Creation are available only via the Linux online installer.

General Installation Issues for Linux

On Linux, remember to allow the execution of the installer binary. You can do this by using one of the following methods:

  • On the command line enter the chmod +x <filename> command.
  • Right-click the file, and select Properties > Permissions > Allow executing file as program.

Note: Do not execute the installer as a root user or with sudo.

Installation Directory

The installer will let you select a directory where Qt for Device Creation will be installed. In this documentation, the installation directory is referred to as <INSTALL_DIR>. The default installation directories are:

  • ~/Qt on Linux
  • C:\Qt on Windows

3. Installing Boot to Qt on Target Devices

If you target only the emulator, you can skip this step.

Before you can test your Qt applications on the target device, you must flash the target device with an image containing the Boot to Qt stack. Your Qt for Device Creation installation contains images for the Group 1 and Group 2 devices (see Supported Target Devices and Development Hosts). You can also flash an image that you have built yourself (see Building Your Own Embedded Linux Image).

Use Flashing Wizard tool in Qt Creator for flashing the image. Follow the steps in the target device guides:

4. Configuring a Device Kit in Qt Creator

After you have prepared the hardware, you must perform one final step to set up the development tools in Qt Creator for your device. That is, you must configure the correct device to be used for each build and run kit. Connect your device to the development host via USB and launch Qt Creator. In Qt Creator:

  1. Select Tools > Options > Build & Run > Kits.
  2. Select one of the predefined kits starting with Boot to Qt... that matches the type of your device.
  3. Select the correct device in the Device field.
  4. Select OK.

You are now ready to start developing for your device. For more information, see Building and Running an Example.

Available under certain Qt licenses.
Find out more.