Instructions in this documentation assume Ubuntu Linux 64-bit 16.04 LTS or later. Other Linux distributions may work, but have not been tested.

Minimum Hardware Requirements

Approximate minimal hardware requirements for running Boot to Qt are:

• 256 MB of RAM
• 500 MHz CPU, 1 GHz preferred for 60-FPS velvet-smooth UI
• OpenGL ES 2.0 support *

* On GPU-less hardware, Qt Quick 2D Renderer can replace the OpenGL ES 2.0 requirement (with some limitations on graphics capabilities).

Installing Platform Dependencies

Before you can build the applications with Qt for Device Creation, you must have the correct build tools and other dependencies installed in the development host:

You can install the dependencies with the following command in a terminal:

sudo apt-get install build-essential python2.7 libusb-1.0-0

If you have problems with installing the build essentials, see https://help.ubuntu.com/community/InstallingCompilers.

Setting Up USB Access to Embedded Devices

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

On Ubuntu Linux, the development user account must have access to plugged in devices. To allow the development user access to the device via USB, create a new udev rule.

1. From Qt 5.9 onwards, run the following command in a shell:

   echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="dbdb", TAG+="udev-acl", TAG+="uaccess"' | sudo tee -a /etc/udev/rules.d/70-boot2qt.rules

   For Qt 5.8 or older, run the following command in a shell:

   echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", TAG+="udev-acl", TAG+="uaccess"' | sudo tee -a /etc/udev/rules.d/70-boot2qt.rules

2. Connect the running device to the development host with a USB cable. If the device is already connected, disconnect and reconnect the USB cable after running the command above.

The system log files /var/log/udev and /var/log/syslog may provide relevant information in case of connection problems.