This article explains how to download and install the X-LINUX-QT distribution package v2.1.0, on top of Yocto-based OpenSTLinux embedded software v6.0.0.
1. Prerequisites[edit | edit source]
Needed prerequisites are described in X-LINUX-QT_expansion_package#Prerequisites.
2. Install the STM32MPU OpenSTLinux distribution package[edit | edit source]
As prerequisite to X-LINUX-QT distribution package, get and install the STM32MPU OpenSTLinux distribution package v6.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 steps below.
3.1. Clone the meta-st-x-linux-qt git repository[edit | edit source]
cd <distribution package installation directory>
git clone -b v2.1.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]
git clone -b 6.6.3 https://code.qt.io/yocto/meta-qt6.git layers/meta-qt6
3.3. Setup the build environment[edit | edit source]
- For a new environment
- Source the build environment with the correct board and layers:
DISTRO=openstlinux-weston MACHINE=stm32mp1 BSP_DEPENDENCY="layers/meta-qt6 layers/meta-st/meta-st-x-linux-qt" source layers/meta-st/scripts/envsetup.sh
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
4. Re-build the X-LINUX-QT starter package[edit | edit source]

To rebuild the X-LINUX-QT starter package, the 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 follow:
bitbake st-image-qt package-index
The output will be the "full image" files for the st-image-qt.
Then jump to X-LINUX-QT_Starter_Package to play with your new X-LINUX-QT starter package.
5. Re-build the X-LINUX-QT developer package[edit | edit source]

To rebuild the X-LINUX-QT developer package, the 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.
To configure a new STM32MPU Kit for the Qt™ Creator tool, please refer to a kit previously installed with the X-LINUX-QT Developer Package.
Jump to X-LINUX-QT_Developer_Package to play with your new X-LINUX-QT developer package.