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

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

Note: The requirements for building your own embedded Linux image are listed in Yocto Build Environment Requirements.

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.

Note: If you target Raspberry Pi or NVIDIA Jetson TX1, you need to set up a wired or wireless connection. See the target device guides:

• Raspberry Pi
• NVIDIA Jetson TX1

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.

Requirements for Boot to Qt emulator

The Boot to Qt emulator in Qt for Device Creation relies on VirtualBox virtualization software. You can download it from https://www.virtualbox.org/wiki/Downloads or install it via the distribution tools. The minimum version is VirtualBox 4.3.

Installing VirtualBox on the Older Ubuntu version

If you are running an older Ubuntu system such as 12.04, the version of VirtualBox provided by the distribution is not recent enough. To install a newer version, first add a foreign package source:

wget -q http://download.virtualbox.org/virtualbox/debian/oracle_vbox.asc -O- | sudo apt-key add -
echo "deb http://download.virtualbox.org/virtualbox/debian $(lsb_release -sc) contrib" | sudo tee /etc/apt/sources.list.d/virtualbox.list
sudo apt-get update

Then, install VirtualBox on your computer:

sudo apt-get install virtualbox-4.3

Configuring VirtualBox

After you have installed VirtualBox, configure it:

1. Start the VirtualBox user interface.
2. Select File > Preferences > Network to open VirtualBox network settings.
3. Create a new host-only network. VirtualBox automatically assigns a name for the new host-only network. On Linux the default name is vboxnet0.

   Note: If the created host-only network is not named as vboxnet0, you must change the VirtualBox settings to use the created host-only network. In VirtualBox:

   • Select Boot2Qt-59 machine in the VirtualBox main view.
   • Select Machine > Settings > Network > Adapter 1 and choose the created host-only network in the Name field.
4. Edit the properties of the created host-only network:
   1. Change the IPv4 address to 192.168.56.1 and the IPv4 network mask to 255.255.255.0.
   2. In the DCHP Server tab, select the Enable Server check box.
   3. Change the server address to 192.168.56.1.
   4. Change the server mask to 255.255.255.0.
   5. Change both the lower and upper address bounds to 192.168.56.101.

If a firewall is enabled on the development host, it needs to allow TCP and UDP packets between your host and the virtual machine.