Toradex is a partner of The Qt Company, the entity responsible for Qt development, productization and licensing under commercial and open-source licenses. This partnership is celebrated in the Partner Demo Image - Qt for Device Creation now available for download in the Toradex Easy Installer image format.
To get started sign-up for a free evaluation version of the Qt IDE.
This Partner Demo Image is ideal for evaluation of the Qt framework since it is pre-configured so you can directly build and deploy Qt demos and your own applications to the Toradex Module seamlessly.
Please see also our joint-webinar with The Qt Company.
The Qt framework is one of the most popular Graphical User Interface (GUI) frameworks used in Toradex Modules. Please refer to the Qt Documentation for comprehensive knowledge base documentation.
The following Computer on Modules are supported by The Qt Company:
For older versions, browse the Qt documentation archives.
If your SoM is not listed, The Qt Company provides documentation on How to Add Support for New Device.
While you can use a wide variety of displays and monitors, additional configuration may be required for a specific setup.
A section at the end of this guide provides instructions about the display and touch screen configuration.
The Boot2Qt pre-built evaluation image has as many features of the Qt framework enabled as possible and is not optimized for anything beyond evaluation, though it may be suitable for development, depending on your use case. You must use the Yocto Project to build your custom distribution and Boot2Qt is a great starting point. You should not use Boot2Qt in production without further customization.
The relationship between Boot to Qt versions and Toradex BSP versions does not follow a strict policy. As of Qt 6, every new Boot to Qt version aims to use our latest BSP release tags, without any guarantee that it will actually always be on the latest. It is up to you to adapt any given Boot to Qt release to a suitable Toradex BSP release according to our Toradex Embedded Linux Support Strategy, for instance, a quarterly or LTS release.
At the end of this page you will find:
If you cannot do the maintenance by yourself, consider some options:
This section provides instructions for you to quickly get started with Qt for Device Creation.
Note: The Qt Company provides a guide for Toradex supported modules. Please refer to the Qt Toradex Guide and QBSP Overview for additional reference.
Load the Toradex Easy Installer on the target module and select the Boot to Qt demo image from the list of available images:
Installing Qt for Device Creation using the Toradex Easy Installer (click to enlarge)
Qt for Device Creation is a commercial offering from the Qt Company.
Downloading Qt for Device Creation
Apalis iMX6 and Colibri iMX7 are Reference Devices, because of that, Boot to Qt can be easily installed directly from the component selection dialog under Qt for Device Creation -> Boot to Qt Software Stack.
Selecting the device
Note: Make sure to select the corresponding Toradex module.
These devices are not directly available from the component selection. You need to download the specific QBSP files from the Download section of your Qt account panel, this process is illustrated in the image below:
Downloading the QBSP
Note: Make sure you have selected Qt for Device Creation on the product menu.
After downloading the files, click on the Browse QBSP files button from the component selection and select the files.
Browsing and Installing QBSP
As shown in the video above, after selecting the files, the Boot To Qt Software Stack is auto-selected, you just need to click on the next button and proceed to the installation.
Note: In case you want to confirm which Boot to Qt Software Stack package is going to be installed, open the Qt For Device Creation dropdown and search for the Boot to Qt Software Stack <version> according to the version you have downloaded.
It's possible to add or remove components after Qt Creator installation, you can use the Maintenance Tool under <install_dir> to add components and to update or remove installed components.
![Qt Maintenance Tool](https://docs.toradex.cn/109429-maintenence-tool.png "Qt Maintenance Tool's wizard will appear. Press "Next".")
Qt Maintenance Tool's wizard will appear. Press "Next".
Tip: Normally Qt is installed at /home/user/Qt
Choose the desired option, in case you want to add a new QBSP, please refer to the Install Qt for Device Creation section.
Qt Creator can be used to create Qt applications for Toradex modules and the applications can be directly deployed either over network or USB.
Qt Creator Kit Selection
Warning: When creating a new project, make sure to select the correct module and processor model of your board in the kit selection.
Warning: Instructions in this documentation assume Ubuntu Linux 64-bit 16.04 LTS or later. Other Linux distributions may work but have not been tested.
To set up the USB access to the board, it is necessary to enable access to the device from your host computer. In order to do so, one must create a new udev rule
From Qt 5.9 onwards, run the following command
echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="dbdb", TAG+="udev-acl", TAG+="uaccess"' | sudo tee -a /etc/udev/rules.d/70-boot2qt.rules
Warning: Please make sure the udev rule applied is compatible to your Qt version, as described in the Qt documentation.
Connect your device to the development host via USB cable. If the device is already connected, disconnect and reconnect the USB cable after running the command above.
QtCreator will automatically set up networking over the USB link and the device will appear in the QtCreator's Devices list without need to manually add it.
No extra action is required, the device is recognized by the IDE seamlessly.
Find the board IP by booting to the default Qt demo and going to options, as illustrated in the screenshots below:
Qt Demo: Main Screen (click to enlarge)
Qt Demo: Settings (click to enlarge)
Alternatively, you can Access the debug UART, also known as serial terminal then Find your IP address from the debug UART.
or
Find your IP address by scanning your LAN.
To set up a device, in the Qt Creator IDE go to Tools -> Options -> Devices and add a Boot2Qt device with the previously found IP.
Boot2Qt Device (click to enlarge)
Make sure that the device is correctly assigned to the respective kit, under Tools -> Options -> Kits, as illustrated below:
Qt Creator Kit Configuration (click to enlarge)
For more information about how to develop a Qt Application head over to the extensive Qt documentation.
For more information about how to customize Boot2Qt, in addition to the Qt documentation, you can check some Toradex resources:
Displays and Monitors used in Embedded Systems are available in a myriad of configuration possibilities - resistive, capacitive or without touch, single or multi touch, different resolution, density of pixels, pin-out and clock frequency are some examples.
To make things easy for you, Toradex provides specific instructions on how to use its display offerings as well as comprehensive information about how to interface your custom display or monitor to Toradex modules. Please refer to the table below:
| Display | Display Resolution | Touch Screen Support | Touch Screen Calibration |
|---|---|---|---|
| Resistive Touch Display 7" Parallel | First Steps with Parallel Resistive Touch Display - Resolution | Supported out-of-the-box | Touch Screen Calibration (Linux) |
| Capacitive Touch Display 7" Parallel | First Steps with Capacitive Touch Display 7 Inch Parallel - Resolution | First Steps with Capacitive Touch Display 7 Inch Parallel - Touch Screen | Touch Screen Calibration (Linux) |
| VGA monitor | Display Output, Resolution and Timings | USB HID touch screen works out-of-the-box | Touch Screen Calibration (Linux) |
| DVI/HDMI monitor | Display Output, Resolution and Timings | USB HID touch screen works out-of-the-box | Touch Screen Calibration (Linux) |
| • For additional comprehensive information • If you use another display/monitor |
Display Output, Resolution and Timings | • Compile the specific kernel driver: Build Linux kernel • Enable it in the device-tree: Device Tree Customization |
Touch Screen Calibration (Linux) |
Note: Qt uses libinput as the default touch screen input library. Therefore, for calibration please see the libinput section of the article referred to in the table above.
Qt is a large framework with different licenses. Licenses also depend on which Qt version is used. Our partner, the Qt Company, can help you find the right license, therefore if you have questions consult the Qt Licensing page for details.
Those release notes are not from Qt For Device Creation, Boot 2 Qt or the Qt framework releases. They are only provided by Toradex for the given Partner Demo Images based on Toradex's testing.
This Partner Demo Image is provided and maintained by The Qt Company, Toradex only verifies if the image boots and the included demonstrations work. See their changelog for more information:
Extraordinary build by Toradex for the following reasons:
Download releases of Boot2Qt here:
