To successfully set up the Boot to Qt software stack, you must closely follow the instructions in this section and perform all the described tasks.

In case of problems, see Troubleshooting.

Note: After you have installed the Boot to Qt software stack and want to connect to the target device with SSH or a serial cable, you can access the device by using the user root and an empty password.

1. Requirements for Development Host

Before you install the Boot to Qt software stack, you should install the required software on the development host:

• Requirements for Linux/X11
• Requirements for Windows

2. Installing Boot to Qt Software Stack

You can install the Boot to Qt software stack via the online installer. On Linux, see General Installation Issues for Linux.

Download the online installer and follow the instructions in the installation wizard. The Select components page in the wizard lists all the components that are available for your Qt account.

Select the Boot to Qt software stack for Toradex Apalis iMX6 with the following steps:

1. Select Qt > Qt for Device Creation.
2. Select the Boot to Qt software stack version.
3. Select Toradex Apalis iMX6.
4. Select Next.

To finish the installation, follow the instructions in the installation wizard.

Installation Content

The Boot to Qt software stack provides a system image (<target-device> Linux System) and a toolchain (<target-device> Linux Toolchain) for each target device. The system image contains the Boot to Qt software stack and needs to be flashed to the SD card or directly to the target device (see 3. Installing Boot to Qt on Target Device). 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 the Boot to Qt software stack 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 the Boot to Qt software stack 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 Device

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 software stack. After you have successfully flashed your device, Boot to Qt Demo Launcher automatically appears on the screen when you power on the device.

To flash the image, you can use either Toradex Easy Installer or Qt's Flashing Wizard. With Toradex Easy Installer, the image is flashed to the device's internal eMMC flash memory. Flashing Wizard uses an external SD card.

Flashing with Toradex Easy Installer

When Toradex Easy Installer is connected to the Internet, it automatically provides the latest Boot to Qt image in its image list but that is not necessarily compatible with your Boot to Qt installation. When you flash with Toradex Easy Installer, you should always use the *.tezi.tar package that is included into the Boot to Qt installation.

Flash the Boot to Qt image with Toradex Easy Installer as follows:

1. If your target device does not have the pre-installed Toradex Easy Installer, follow instructions in Load Toradex Easy Installer to load Toradex Easy Installer.
2. Your Boot to Qt installation has the *.tezi.tar package under <Qt installation directory>/<Qt version>/Boot2Qt/<target>/images. Extract the package to an SD card or a USB flash drive.
3. Flash the image from the SD card or the USB flash drive with Toradex Easy Installer. See Install Images with Toradex Easy Installer.

Flashing with Qt's Flashing Wizard

Use Flashing Wizard to flash the image to your Toradex Apalis iMX6:

• Connect your SD card reader to the development host. Make sure that the SD card size is at least 2 GB.

  Note: If you are using the Apalis evaluation board, you need to use the first SD card slot (X18).

• Launch Qt Creator.
• Select Tools > Flash Boot to Qt Device, and follow the instructions in Flashing Wizard.

In order to boot from the external SD card, U-Boot needs to be updated.

Booting from External SD Card

Connect a serial cable to the device and enter into the U-Boot environment by pressing any key before the autoboot.

Enter the following commands into U-Boot:

run setupdate
run update

Note: After running the command run update, the following warning message appears:

Warning: Programming fuses is an irreversible operation!
Updating to fast boot mode prevents easy downgrading to previous BSP versions.
Really perform this fuse programming? <y/N>

You can answer with y.

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.

For more information about the boot process on Toradex Apalis iMX6, see Toradex Linux Booting.

Carrier Board Support

Boot to Qt is configured for the Ixora carrier board v1.1 with a capacitive touch display. If you use different carrier board, you may need to change a U-boot environment accordingly.

The U-Boot environment variable fdt_file must match the used carrier board. If you use a different mmc slot in your board, you can select it with an additional environment variable sddrive. For the Ixora carried board v1.0, you must set sddrive as follows:

sddrive=2

The Ixora carrier board has a USB 2.0 OTG interface available on a Micro-AB connector (X9). The jumper JP2 must be set to open position to enable the OTG mode and make Qt Creator communication via this USB interface possible. For more information see Ixora Datasheet.

When you flash the Boot to Qt image with Qt's Flashing Wizard and you are using the Apalis evaluation board, you need to use the first SD card slot (X18).

4. Configuring a Device Kit in Qt Creator

After you have prepared the target device, you must set up the development tools in Qt Creator for your device. That is, you must configure your target 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 with Qt for your device. For detailed information about how to deploy Qt projects to the device, see Tutorial: Deploying Your First Project with Boot to Qt.

5. Powering on with Boot to Qt Demo Launcher

After you have successfully flashed your device with Boot to Qt software stack, Boot to Qt Demo Launcher automatically appears on the screen when you power on the device. With Boot to Qt Demo Launcher, you can test the Boot to Qt demos that are included into Boot to Qt software stack images. For more information, see Qt Device Creation Demos.