Take the following steps to prepare a Toradex Colibri iMX6 for Boot to Qt.

Note: It is important that you repeat the steps in this section after you update Qt for Device Creation.

The images containing the Boot to Qt stack for Toradex Colibri iMX6 are included in Qt for Device Creation, ready to be copied to an SD card.

Preparing an SD Card

An SD card of at least 1 GB capacity is sufficient.

Plug in the SD card or reader to the development host, and use the following command on Linux to find out its device name:

lsblk -d

Removable devices such as SD cards have the value '1' in the RM column.

Typical device names for SD cards include sdb and mmcblk0. The full device path is /dev/ followed by the name.

On Windows, use the following command to get the SD cards device name:

wmic logicaldisk where "drivetype=2 and access=0" get deviceid, volumename

Warning: Make sure to select the correct device, because selecting the wrong one can result in a wiped hard drive.

Installing the Boot to Qt Image

Install Using the Flashing Wizard

Qt for Device Creation includes an easy to use application for setting up a supported device for Boot to Qt. In Qt Creator, select Tools > Flash Boot to Qt Device and follow the step-by-step instructions.

On Linux, you can alternatively install the image from the command line using the instructions below.

Install from the Command Line

To write the image to the SD card, ensure that no partitions on the SD card are mounted:

umount /dev/<device_name>

Then,

cd <INSTALL_DIR>
sudo dd bs=4k if=5.6/Boot2Qt/colibri-imx6/images/b2qt-embedded-qt5-image-colibri-imx6.img of=/dev/<device_name>

By default, the Toradex Colibri iMX6 boots from its internal eMMC. In order to boot from the external SD card, the U-Boot needs to be updated. Connect a serial cable to the device and enter into the U-Boot environment by pressing any key before the autoboot. Enter following commands into U-Boot:

run setupdate
run update

Reset or power cycle the device to start the new U-Boot. To reset the U-Boot environment to new default values, enter the following commands in the U-Boot command line

env default -a
saveenv

New U-Boot commands are now stored into the device, and you can start Boot to Qt. For more information about the boot process on Toradex Colibri iMX6, see Toradex Linux Booting.

After the image has been deployed, insert the SD card, power on the device and check that the Boot to Qt welcome screen and/or demo appear.

Setting up USB Access

The carrier boards for Toradex Colibri iMX6 include a USB 2.0 port that can be used for an ADB connection between the device and the development host.

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. 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.

You can confirm that the connection is working by running the following command on Linux:

<INSTALL_DIR>/Tools/b2qt/adb devices -l

On Windows, you need to install ADB as instructed in 1.2 Windows: Installing ADB. You can confirm that the connection is working with the following command:

<Android-SDK-Tools-install-dir>\platform-tools\adb.exe devices -l

The output should be a list of connected Boot to Qt (and Android) devices, identified with a serial number and a name. If your device is missing from the list, or the serial number is ??????, the connection is not working properly. Check that the device is powered on, and disconnect and reconnect the USB cable.

The emulator may be listed as well. Its serial number is its IP and the port number: 192.168.56.101:5555.

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.