C
Requirements for Linux/X11
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:
Dependency | Description |
---|---|
C/C++ build essentials | Qt for Device Creation assumes that a C++ compiler, debugger, make, and other development tools are provided by the host operating system. |
Python | Required by the Qt for Device Creation toolchain installer. The minimum version is Python 2.7. |
libusb-1.0 | Required by the QDB tool. |
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:
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.
- 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
- 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:
- Start the VirtualBox user interface.
- Select File > Preferences > Network to open VirtualBox network settings.
- 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.
- Select
- Edit the properties of the created host-only network:
- Change the IPv4 address to
192.168.56.1
and the IPv4 network mask to255.255.255.0
. - In the DCHP Server tab, select the Enable Server check box.
- Change the server address to
192.168.56.1
. - Change the server mask to
255.255.255.0
. - Change both the lower and upper address bounds to
192.168.56.101
.
- Change the IPv4 address to
If a firewall is enabled on the development host, it needs to allow TCP and UDP packets between your host and the virtual machine.
Available under certain Qt licenses.
Find out more.