Last edited one week ago

X-LINUX-QT Starter Package

Applicable for STM32MP25x lines

Warning DB.png Important
This version of X-LINUX-QT expansion package is validated against the ecosystem release v5.1.0 . It has not been ported yet on ecosystem release v6.0.0 More info.png .

This article aims to give the following information:

  • How to download and install the latest X-LINUX-QT Starter Package for the STM32 microprocessor series.
Info white.png Information
To use efficiently this Starter Package, go first through the Starter Package article relative to your STM32 microprocessor series / board: Category:Starter Package
1. Prerequisites[edit | edit source]

Check detailed prerequisites here.

2. Install OpenSTLinux Starter Package[edit | edit source]

Before developing with the Developer Package, it is essential to start up your board thanks to its Starter Package. All articles relative to Starter Packages are found in Category:Starter Package: find the one that corresponds to your board, and follow the installation instructions (if not yet done), before going further.

Thanks to the Starter Package, all Flash partitions are populated.

3. Install the X-LINUX-QT Starter Package[edit | edit source]
Warning white.png Warning
The software package is provided AS IS, and by downloading it, you agree to be bound to the terms of the software license agreement (SLA0048). The detailed content licenses can be found here.

The packagegroup-x-linux-qt package must be installed on top of the STM32MPU Starter Package to bring the "Qt framework" as graphics solution.

Once the board is booted, make sure it is connected to the internet then execute the following commands in the console to install the X-LINUX-QT packages:

  • First of all , you may need to update date and time on your connected board before running the below commands. Date and Time on your connected board can be updated by this command:
date +%y%m%d -s "20250101"
date +%T -s "00:00:00"
  • Refresh the apt database to access the Qt package repository:
apt-get update
Info white.png Information
If some proxy issue occurs executing the previous command, refer to prerequisites from here

.

  • Install the package with the apt configuration to access the Qt packages :
For Qt6:
apt-get install unknown version
For Qt5:
apt-get install unknown version
  • Update the apt database to read the Qt package repository :
apt-get update
  • Install the package group for the X-LINUX-QT package
apt-get install -y packagegroup-x-linux-qt
  • Restart the Weston graphical services with the new ST-Launcher
systemctl restart weston-graphical-session.service
Info white.png Information
Instead of restarting the Weston graphical service which could take few seconds, user could just close the current GTK demo-launcher and start the new ST-Launcher from the weston bottom toolbar (last icon in the list)
4. Starter Package expected results[edit | edit source]

Once the X-LINUX-QT Starter Package is installed and the Weston graphical service is restarted, the new STLauncher is displayed.

  • The STLauncher Splash Screen is displayed for few seconds
STLauncher Splash screen
  • The Main Window displays all compatible installed applications
  • To display more information about the running hardware and software:
    • Click on the Settings button on the top right of the screen
STLauncher Main window
  • The SETTINGS screen is displayed
STLauncher Settings window
  • Click on the INFORMATIONS button
  • The INFORMATIONS screen is displayed
STLauncher Information window
5. Run examples from the starter package[edit | edit source]
5.1. Legacy demonstrations[edit | edit source]

Demos, which are available via the GTK demo launcher, are still supported by the new QT STLauncher.
For example, you can run the 3D Cube Demo from the new Qt STLauncher:

  • Select the demo's icon (Selected icon will be in Yellow)
STLauncher - Selected 3D Cube Icon
  • Click on the demo's icon again to run the demo
Running 3D Cube Demo
5.2. New Qt examples[edit | edit source]
  • Qt OpenGL Cube example
The Qt OpenGL Cube example is now displayed in the new STLauncher.
In order to run the examples, select its icon first then click on it again to start it
  • Select the Qt OpenGL Cube example icon (Selected icon will be in Yellow)
STLauncher - Selected OpenGL Cube Icon
  • Click on the demo's icon again to run the demo
Running OpenGL Cube Demo
5.3. New Qt demonstrations[edit | edit source]

The new Medical and RobotArm3D demonstrations are displayed in the new STLauncher. In order to run the demonstration, select its icon first then click on it again to start it.

  • ST Medical
ST Medical Demo - Startup screen



Running ST Medical Demo
  • ST RobotArm3D Demo
ST RobotArm3D Demo - Startup screen



Running ST RobotArm3D Demo