![X-LINUX-QT-Expansion Package-logo.png](/stm32mpu/nsfr_img_auth.php/thumb/a/ae/X-LINUX-QT-Expansion_Package-logo.png/700px-X-LINUX-QT-Expansion_Package-logo.png)
1. Article purpose[edit source]
Purpose of this article is to:
- Introduce the X-LINUX-QT expansion package
- Define the hardware & software deliverables to use the X-LINUX-QT package,
- Describe all steps to integrate the X-LINUX-QT package and associated expected results
- Describe all steps to use Qt Creator with the X-LINUX-QT package and associated expected results
2. X-LINUX-QT expansion package description[edit source]
2.1. Overview[edit source]
X-LINUX-QT is an STM32 MPU OpenSTLinux Expansion Package that targets Qt based application and graphical user interface (GUI) development for STM32MP25xx series microprocessors. It contains Linux® Qt™ Frameworks, as well as an ST Application Launcher based on Qt™ Framework and application examples to get started with Qt application development.
The Qt framework contains a comprehensive set of highly intuitive and modularized C++ library classes and is loaded with APIs to simplify your application development. Qt produces highly readable, easily maintainable and reusable code with high runtime performance and small footprint – and it's cross-platform.
This expansion package is a complete ecosystem that allow developers working with OpenSTLinux to create Qt based application very easily.
- All-in-one Qt solutions for the entire STM32MPU series supporting Wayland and Weston.
- Pre-integrated into Linux distribution based on ST environment
- Include Qt frameworks to build UIs and Applications
- Include ST Application Launcher based on Qt framework for MPU devices (see supported platforms list)
2.2. Versioning[edit source]
Latest version of X-LINUX-QT is 1.0.0.
The generic versioning X-LINUX-QT vx.y.z is built as follows:
x: major version depending on Qt major versions. Each new major version is incompatible with previous Qt versions. Initial major version 1.0.0 will be for Qt 5.x
y: minor version depending on the OpenSTLinux Distribution major versions. Each new major version is incompatible with previous OpenSTLinux distribution versions. Initial minor version will be for OpenSTLinux Distribution v5.x
z: patch version is changed when new functionalities, bug fixes and/or modules are added to the X-LINUX-QT OpenSTLinux Expansion Package in a backward compatible manner.
3. Prerequisites[edit source]
3.1. Hardware prerequisites[edit source]
3.2. Software prerequisites[edit source]
The X-LINUX-QT expansion package runs with OpenSTLinux ecosystem release v5.1.0 .
In this article we will be using the Qt Creator tool to build, debug and run applications demos on target.
- You will need to create a Qt account then download and install the Qt Creator
- The Qt online installer is available from here
4. Hardware setup[edit source]
4.1. STM32MP257x-EV1 Evaluation board[edit source]
- Hardware description
- Board assembly
- Power jumper
- How to connect LVDS display to MB1936
- STM32MP257x-EV1 Evaluation board assembled
- Board connection
5. Software setup[edit source]
5.1. How to get software[edit source]
There are two possibilities to install the additional X-LINUX-QT expansion package software to port on top of OpenSTLinux. Select the one corresponding to your needs amongst :
- X-LINUX-QT Distribution package: an OpenEmbedded meta-layer must be added on top of the STM32MPU Distribution Package to bring "Qt framework" as graphics solution.
![X-LINUX-QT-Distribution Package-BlockDiagram.png](/stm32mpu/nsfr_img_auth.php/thumb/f/fa/X-LINUX-QT-Distribution_Package-BlockDiagram.png/300px-X-LINUX-QT-Distribution_Package-BlockDiagram.png)
- X-LINUX-QT Developer package: quickly and easily bring Qt framework on STM32MPx as graphics solution.
![X-LINUX-QT-Developer Package-BlockDiagram.png](/stm32mpu/nsfr_img_auth.php/thumb/e/e7/X-LINUX-QT-Developer_Package-BlockDiagram.png/300px-X-LINUX-QT-Developer_Package-BlockDiagram.png)
5.1.1. How to install distribution package[edit source]
- Download and install the STM32MPU Distribution Package
- to install the STM32MPU Distribution Package, follow instruction give in STM32MPU_Distribution_Package v5.1.0.
- Install the X-LINUX-QT Distribution Package
- Clone the meta-st-x-linux-qt git repository
cd <Distribution Package installation directory> git clone -b v1.0.0 https://github.com/STMicroelectronics/meta-st-x-linux-qt.git layers/meta-st/meta-st-x-linux-qt
- Clone the meta-qt5 git repository
git clone -b scarthgap https://github.com/meta-qt5/meta-qt5.git layers/meta-qt5
- Source the build environment with the correct board and layer
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
|
- Building the X-LINUX-QT Starter Package
![X-LINUX-QT-Starter Package-Overview.png](/stm32mpu/nsfr_img_auth.php/thumb/4/44/X-LINUX-QT-Starter_Package-Overview.png/800px-X-LINUX-QT-Starter_Package-Overview.png)
To rebuild the X-LINUX-QT Starter Package, user must install the X-LINUX-QT Distribution Package, setup 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
- Building the X-LINUX-QT Developer Package
![X-LINUX-QT-Developer Package-Overview.png](/stm32mpu/nsfr_img_auth.php/thumb/3/30/X-LINUX-QT-Developer_Package-Overview.png/800px-X-LINUX-QT-Developer_Package-Overview.png)
To rebuild the X-LINUX-QT Developer Package, user must install the X-LINUX-QT Distribution Package, setup 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
5.1.2. How to install developer package[edit source]
![X-LINUX-QT-Developer Package-BlockDiagram.png](/stm32mpu/nsfr_img_auth.php/thumb/e/e7/X-LINUX-QT-Developer_Package-BlockDiagram.png/300px-X-LINUX-QT-Developer_Package-BlockDiagram.png)
- Download and Install the OpenSTLinux Developer Package
- Install the SDK for OpenSTLinux distribution
- Read more about the STM32MPU Developer Package
- Read more about the SDK for OpenSTLinux distribution
- Install the SDK for OpenSTLinux distribution
- Install the X-LINUX-QT SDK-Addon
For STM32MP25x lines ![]() |
---|
X-LINUX-QT Developer Package |
5.2. How to run the X-LINUX-QT package software[edit source]
- X-LINUX-QT Starter Package: the packagegroup-x-linux-qt package must be installed on top of the STM32MPU Starter Package to bring the "Qt framework" as graphics solution.
![X-LINUX-QT-Starter Package-Overview.png](/stm32mpu/nsfr_img_auth.php/thumb/4/44/X-LINUX-QT-Starter_Package-Overview.png/800px-X-LINUX-QT-Starter_Package-Overview.png)
5.2.1. How to install the starter package[edit source]
![X-LINUX-QT-Starter Package-BlockDiagram.png](/stm32mpu/nsfr_img_auth.php/thumb/c/ca/X-LINUX-QT-Starter_Package-BlockDiagram.png/300px-X-LINUX-QT-Starter_Package-BlockDiagram.png)
- Download and Install the OpenSTLinux Starter Package
- Install the STM32MPU Starter Package
- Read more about the OpenSTLinux Starter Package
- Install the STM32MPU Starter Package
- Install the X-LINUX-QT Starter Package
Once the board is booted, make sure it is connected to the internet then execute the following command in the console to install the X-LINUX-QT packages:
- Refresh the apt database to access the Qt package repository :
apt-get update
- Install the package with the apt configuration to access the Qt packages :
apt-get install apt-openstlinux-x-linux-qt
- Update the apt database to read the Qt package repository :
apt-get update
- Install the package group for the X-LINUX-QT
apt-get install -y packagegroup-x-linux-qt
- Restart the Weston graphical services with the new ST-Launcher
systemctl restart weston-graphical-session.service
5.2.2. How to run the starter package[edit source]
Once the X-LINUX-QT Starter Package is installed and the weston graphical service is restarted, the new STLauncher will be displayed
- The STLauncher Splash Screen will be displayed for few seconds
- The Main Window will be displaying all compatible installed applications
- To display more information about the running HW and SW:
- Click on the Settings button on the top right of the screen
- The SETTINGS screen will be displayed
- Click on the INFORMATIONS button
- The INFORMATIONS screen will be displayed
5.2.3. How to run examples from the starter package[edit source]
5.2.3.1. Old GTK Demos[edit source]
Old GTK demos are still supported by the new STLauncher. For example, you could run the 3D Cube Demo
- Select the demo's icon (Selected icon will be in Yellow
- Click on the demo's icon again to run the demo
5.2.3.2. New Qt Examples[edit source]
Qt OpenGL Cube example is now displayed in the new STLauncher In order to run the example, please select its icon first then click on it again to start it
- Select the Qt OpenGL Cube example icon
- Click on the demo's icon again to run the demo
5.2.3.3. New Qt Demos[edit source]
The new Medical and RobotArm3D demos are displayed in the new STLauncher In order to run the demo, please select its icon first then click on it again to start it.
- The ST RobotArm3D Demo
6. Using Qt Creator with the X-LINUX-QT Developer Package[edit source]
6.1. Install and run the Qt Creator[edit source]
- The Qt Creator must be installed from here before installing the X-LINUX-QT Developer Package.
- Installing the X-LINUX-QT Developer Package will also configure the Qt Creator for the new STM32MPU Kit.
6.2. Open your project[edit source]
6.3. Select the new Kit installed by the X-LINUX-QT SDK-Addon[edit source]
6.4. Build and Run your application[edit source]
7. References[edit source]