Last edited one week ago

X-LINUX-QT Distribution Package

Applicable for STM32MP25x lines


This article aims to explain How to download and install the latest X-LINUX-QT Distribution Package for the STM32 microprocessor series.

1. Prerequisites[edit | edit source]

Refer to the detailed prerequisites here.

2. Install the STM32MPU OpenSTLinux Distribution Package[edit | edit source]

As prerequisite to X-LINUX-QT Distribution Package, you need to get and install the STM32MPU OpenSTLinux Distribution Package v6.0.0.

The way to proceed is given in STM32MPU_Distribution_Package article.

3. Install X-LINUX-QT Distribution Package[edit | edit source]

To install the X-LINUX-QT Distribution Package follow the below steps

3.1. Clone the meta-st-x-linux-qt git repository[edit | edit source]
 cd <Distribution Package installation directory>
For Qt6:
 git clone -b v2.0.0 https://github.com/STMicroelectronics/meta-st-x-linux-qt.git layers/meta-st/meta-st-x-linux-qt
For Qt5:
 git clone -b v1.0.0 https://github.com/STMicroelectronics/meta-st-x-linux-qt.git layers/meta-st/meta-st-x-linux-qt
3.2. Clone the meta-qt git repository[edit | edit source]
For Qt6:
 git clone -b  unknown package unknown package
For Qt5:
 git clone -b  unknown package unknown package
3.3. Setup the build environment[edit | edit source]
For Qt6:
  • For a new environment
Source the build environment with the correct board and layers:
For STM32MP25x lines More info.png:
 DISTRO=openstlinux-weston MACHINE=stm32mp2 BSP_DEPENDENCY="unknown package layers/meta-st/meta-st-x-linux-qt" source layers/meta-st/scripts/envsetup.sh
  • For an already installed environment
Add the layers to the Yocto environment:
 cd <Distribution Package installation directory>
 source layers/meta-st/scripts/envsetup.sh
 bitbake-layers add-layer ../unknown package ../layers/meta-st/meta-st-x-linux-qt
For Qt5:
  • For a new environment
Source the build environment with the correct board and layers:
For STM32MP25x lines More info.png:
 DISTRO=openstlinux-weston MACHINE=stm32mp2 BSP_DEPENDENCY="unknown package layers/meta-st/meta-st-x-linux-qt" source layers/meta-st/scripts/envsetup.sh
  • For an already installed environment
Add the layers to the Yocto environment:
 cd <Distribution Package installation directory>
 source layers/meta-st/scripts/envsetup.sh
 bitbake-layers add-layer ../unknown package ../layers/meta-st/meta-st-x-linux-qt
4. Re-build the X-LINUX-QT Starter Package[edit | edit source]
X-LINUX-QT-Starter Package-Overview.png

To rebuild the X-LINUX-QT Starter Package, user must install the X-LINUX-QT Distribution Package (as explained in previous chapter), set up the environment and run the adequate bitbake command as below:

 bitbake st-image-qt package-index

The output will be the "full image" files for the st-image-qt.

5. Re-build the X-LINUX-QT Developer Package[edit | edit source]
X-LINUX-QT-Developer Package-Overview.png


To rebuild the X-LINUX-QT Developer Package, user must install the X-LINUX-QT Distribution Package (as explained in previous chapter), set up the environment and run the adequate bitbake command as below:

 bitbake st-image-qt -c do_populate_sdk

The output will be the full SDK installer for the st-image-qt.

Warning white.png Warning
Note that installing the generated full SDK will not add the STM32MPU Kit for the Qt™ Creator