X-LINUX-QT Distribution Package

Applicable for

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 v5.1.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 6.5.3 https://code.qt.io/yocto/meta-qt6.git layers/meta-qt6

For Qt5:
git clone -b scarthgap https://github.com/meta-qt5/meta-qt5.git layers/meta-qt5

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 :
DISTRO=openstlinux-weston MACHINE=stm32mp2 BSP_DEPENDENCY="layers/meta-qt6 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 ../layers/meta-qt6 ../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 :
DISTRO=openstlinux-weston MACHINE=stm32mp2 BSP_DEPENDENCY="layers/meta-qt5 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 ../layers/meta-qt5 ../layers/meta-st/meta-st-x-linux-qt

4. Re-build the X-LINUX-QT Starter Package[edit | edit source]

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]

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

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