Toradex Apalis iMX8 Guide
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.
Before you install the Boot to Qt software stack, you should install the required software on the development host:
The Boot to Qt software stack is available as a Qt Board Support Package (QBSP) that can be installed with the MaintenanceTool application or directly from the Qt online installer.
- Download the QBSP file from the Qt Account Downloads page. QBSP files have either a .qbsp or .7z extension.
- Start the MaintenanceTool application and select Add or Remove Components.
- Select Browse QBSP Files, locate the downloaded file, and select Open.
- The Select Components view is updated with content from the QBSP.
Select the Boot to Qt software stack for Toradex Apalis iMX8 with the following steps:
- Select Qt > Qt for Device Creation.
- Select the Boot to Qt software stack version.
- Select Toradex Apalis iMX8.
- Select Next.
To finish the installation, follow the instructions in the installation wizard.
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.
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.
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:
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.
Use Flashing Wizard to flash the image to your Toradex Apalis iMX8:
- Use the RS-232 cable to access the serial terminal on Toradex Apalis iMX8.
- Power on your Toradex Apalis iMX8 device and press any key to stop the autoboot.
- Run the following command in U-Boot:
ums 0 mmc 0
- Use Flashing Wizard to flash the image to the device:
- Launch Qt Creator.
- Select Tools > Flash Boot to Qt Device, and follow the instructions in Flashing Wizard.
- Press Ctrl+C in the U-Boot console and run the reset command.
For more information about flashing the Toradex devices, see eMMC Boot in Toradex Boards.
Note: The Boot to Qt software stack for Toradex Apalis iMX8 supports only the v1.0B silicon.
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:
- Select Tools > Options > Build & Run > Kits.
- Select one of the predefined kits starting with Boot to Qt... that matches the type of your device.
- Select the correct device in the Device field.
- 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.
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.
Available under certain Qt licenses.
Find out more.