X-LINUX-QT Developer Package

Applicable for

STM32MP13x lines, STM32MP15x lines, STM32MP21x lines, STM32MP23x lines, STM32MP25x lines

Important

The X-LINUX-QT expansion package is validated against the ecosystem release v6.0.0 and ecosystem release v6.1.0 .
The X-LINUX-QT expansion package compatible with ecosystem release v6.1.0 provides only the Distribution package, which can be used to generate the Starter and Developer packages

This article explains how to get and install the X-LINUX-QT developer package.

X-LINUX-QT developer package v2.1.0 compatible with Yocto-based OpenSTLinux embedded software v6.0.0 is provided by ST.

X-LINUX-QT developer package is not delivered for the version v2.2.0 compatible with Yocto-based OpenSTLinux embedded software v6.1.0 nevertheless the developer package can be generated thanks to the X-LINUX-QT_Distribution_Package. This article is still useful for this version of X-LINUX-QT expansion package.

Installation commands, given in this article for STM32MP2 series, can be extended to STM32MP1 series.

1. Prerequisites[edit | edit source]

Needed prerequisites are described in X-LINUX-QT_expansion_package#Prerequisites.

2. Install the OpenSTLinux developer package[edit | edit source]

As prerequisite to X-LINUX-QT developer package installation, get and install

the STM32MPU OpenSTLinux developer package v6.0.0 for X-LINUX-QT expansion package v2.1.0.
the STM32MPU OpenSTLinux developer package v6.1.0 for X-LINUX-QT expansion package v2.2.0.

The way to proceed is given in STM32MPU_Developer_Package#Developer_Package_step-by-step_overview article.

3. Install the X-LINUX-QT developer package v2.2.0[edit | edit source]

The X-LINUX-QT developer package v2.2.0 is compatible with Yocto-based OpenSTLinux embedded software v6.1.0.

3.1. Generate the X-LINUX-QT developer package image[edit | edit source]

First step is to create the X-LINUX-QT developer package. It must be generated following instructions available in X-LINUX-QT_Distribution_Package#Re-build_the_X-LINUX-QT_developer _package.

3.2. Install the generated X-LINUX-QT developer package[edit | edit source]

The SDK installation script (st-image-qt-openstlinux-weston-<machine>.rootfs-x86_64-toolchain-5.0.8-snapshot.sh) is under build-openstlinux-weston-<machine>/tmp-glibc/deploy/sdk.
Run the script with the SDK location you want to install it:

./st-image-qt-openstlinux-weston-stm32mp25-disco.rootfs-x86_64-toolchain-5.0.8-snapshot.sh -d <SDK installation directory>

4. Install the X-LINUX-QT developer package v2.1.0[edit | edit source]

Click on EXPAND, displayed on the right of the line, if you want to know how to install the X-LINUX-QT developer package v2.1.0

The X-LINUX-QT developer package v2.1.0 is compatible with Yocto-based OpenSTLinux embedded software v6.0.0.

Download and install the X-LINUX-QT developer package

The software package is provided AS IS, and by downloading it, you agree to be bound to the terms of the software license agreement (SLA0048). The detailed content licenses can be found here.

X-LINUX-QT developer package v2.1.0 release

Download

Go on st.com to download
- en.SDK-x86_64-stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-x-linux-qt-v2.1.0.tar.gz file for x86_64 host architecture
- en.SDK-aarch64-stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-x-linux-qt-v2.1.0.tar.gz file for arm64 host architecture

If you have already generated your own X-LINUX-QT developer package, jump to next step.

Installation

For x86_64 host architecture

Uncompress the tarball file to get the developer package installation script.

 mkdir -p ~/MySDK
 tar xvf en.SDK-x86_64-stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-x-linux-qt-v2.1.0.tar.gz -C ~/MySDK

If needed, change the permissions on the SDK installation script so that it is executable.

 chmod +x ~/MySDK/stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-x-linux-qt-v2.1.0/sdk/st-image-qt-openstlinux-weston-stm32mp2.rootfs-x86_64-toolchain-5.0.3-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-addon-x-linux-qt-v2.1.0.sh

Run the SDK installation script.
- Go to the absolute path to the directory in which is installed the developer package (<developer package installation directory>).
- It is possible to follow the proposition to organize the working directory:

 cd <working directory absolute path>/Developer-Package/SDK
 ~/MySDK/stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-x-linux-qt-v2.1.0/sdk/st-image-qt-openstlinux-weston-stm32mp2.rootfs-x86_64-toolchain-5.0.3-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-addon-x-linux-qt-v2.1.0.sh

A successful installation outputs the following log:

===============================================================================================================================================
ST OpenSTLinux - Weston - (A Yocto Project Based Distro) SDK installer version 5.0.3-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06 - X-LINUX-QT version 2.1.0 SDK-Addon installer
===============================================================================================================================================
Extracting X-LINUX-QT-Addon SDK................................................................................................Done.
Setting it up... Done.
Do you want to configure the Qt Creator for this SDK [y/n]? n
Qt Creator configuration will be ignored.
X-LINUX-QT-Addon SDK has been successfully set up and is ready to be used.

Alternative : If Qt Creator has been installed as explained in the "Prerequisites" chapter, it is now possible to configure it. For that, answer y to the next question:

Do you want to configure the Qt Creator for this SDK [y/n]? y
Please enter the directory where Qt Tools are installed (default: "/usr/lib, /usr/libexec"): /usr/libexec
Using /home/USER/Qt/Tools/sdktool/libexec/qtcreator/sdktool
Adding "Qt 6.8.0 for STM32MP2 ( 5.0.3-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06, X-LINUX-QT v2.1.0)" kit for Qt Design Studio... Done.
Using /home/USER/Qt/Tools/sdktool/libexec/qtcreator/sdktool
Adding "Qt 6.8.0 for STM32MP2 ( 5.0.3-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06, X-LINUX-QT v2.1.0)" kit for Qt Creator... Done.

X-LINUX-QT-Addon SDK has been successfully set up and is ready to be used.

For arm64 host architecture

Uncompress the tarball file to get the developer package installation script.

 mkdir -p ~/MySDK
 tar xvf en.SDK-aarch64-stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-x-linux-qt-v2.1.0.tar.gz -C ~/MySDK

If needed, change the permissions on the SDK installation script so that it is executable.

 chmod +x ~/MySDK/stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-x-linux-qt-v2.1.0/sdk/st-image-qt-openstlinux-weston-stm32mp2.rootfs-aarch64-toolchain-5.0.3-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-addon-x-linux-qt-v2.1.0.sh

Run the SDK installation script.
- Go to the absolute path to the directory in which is installed the SDK (<SDK installation directory>).
- It is possible to follow the proposition to organize the working directory:

 cd <working directory absolute path>/Developer-Package/SDK
 ~/MySDK/stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-x-linux-qt-v2.1.0/sdk/st-image-qt-openstlinux-weston-stm32mp2.rootfs-aarch64-toolchain-5.0.3-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06-addon-x-linux-qt-v2.1.0.sh

A successful installation outputs the following log:

==================================================================================================================================================
ST OpenSTLinux - Weston - (A Yocto Project Based Distro) SDK installer version 5.0.3-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06 - X-LINUX-QT version 2.1.0 SDK-Addon installer
===================================================================================================================================================
Extracting X-LINUX-QT-Addon SDK......................................................................................................... Done.
Setting it up... Done.
Do you want to configure the Qt Creator for this SDK [y/n]? n
Qt Creator configuration will be ignored.
X-LINUX-QT-Addon SDK has been successfully set up and is ready to be used.

Alternative: If the Qt Creator has been installed preliminary as explained in the "Prerequisites" chapter, it is now possible to configure it. For that, answer y to the next question:

Do you want to configure the Qt Creator for this SDK [y/n]? y 
Please enter the directory where Qt Tools are installed (default: "/usr/lib, /usr/libexec"): /usr/libexec
Using /home/USER/Qt/Tools/sdktool/libexec/qtcreator/sdktool
Adding "Qt 6.8.0 for STM32MP2 ( 5.0.3-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06, X-LINUX-QT v2.1.0)" kit for Qt Design Studio... Done.
Using /home/USER/Qt/Tools/sdktool/libexec/qtcreator/sdktool
Adding "Qt 6.8.0 for STM32MP2 ( 5.0.3-openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06, X-LINUX-QT v2.1.0)" kit for Qt Creator... Done.
X-LINUX-QT-Addon SDK has been successfully set up and is ready to be used.

5. How to create QT applications using the X-LINUX-QT Developer Package[edit | edit source]

Articles explaining how to create some QT applications are available :