Last edited 2 months ago

X-LINUX-QT Distribution Package

Applicable for STM32MP13x lines, STM32MP15x lines, STM32MP23x lines, STM32MP25x lines

Warning DB.png Important
This version of X-LINUX-QT expansion package is validated against the ecosystem release v6.0.0 More info.png . Porting on ecosystem release v6.1.0 More info.png is ongoing.

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:
  • For STM32MP1 series' boards More info green.png, click on "Expand", visible on the right side of the page
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
  • For STM32MP2 series' boards More info green.png, click on "Expand", visible on the right side of the page
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]

X-LINUX-QT-Starter Package-Overview.png

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]

X-LINUX-QT-Developer Package-Overview.png

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.