Last edited one month ago

X-LINUX-QT Starter Package


This article explains how to get and install the X-LINUX-QT starter 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 OpenSTLinux starter Package[edit | edit source]

As additional prerequisite of X-LINUX-QT starter package, get and install the Yocto-based OpenSTLinux embedded software v6.0.0.

All articles relative to starter packages are available in Category:Starter Package: find the one corresponding to your ST board, and follow the installation instructions (if not yet done), before going further.

Thanks to the starter package, the Flash partitions are populated.

3. Install the X-LINUX-QT starter package[edit | edit source]

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

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

  • First of all, it might be necessary to update date and time on the connected board before running the commands below. Date and Time on the connected board can be updated by this command:
date +%y%m%d -s "20250701"
date +%T -s "00:00:00"

For STM32MP1 series' boards More info green.png, click on "Expand", visible on the right side of the page, to view command lines to add right Qt package Debian:


For STM32MP2 series' boards More info green.png, click on "Expand", visible on the right side of the page, to view command lines to add right Qt package Debian:


  • Refresh the apt database to access the Qt package repository:
apt-get update
  • Install the package group for the X-LINUX-QT package:
 apt install -y packagegroup-x-linux-qt 
  • For board with GPU support (STM32MP157F-DK2 Discovery kit More info green.png, STM32MP257F-DK Discovery kit More info green.png), you can add a Qt demo-launcher:
apt-get install -y demo-launcher
  • When available, restart the Weston graphical services with the new Qt STLauncher:
systemctl restart weston-graphical-session.service

4. Starter package expected results[edit | edit source]

The X-LINUX-QT starter package is firstly installed, then follow steps defined below depending if your board supports the GPU or not.

4.1. For board without GPU support[edit | edit source]

STM32MP135F-DK Discovery kit More info green.png and STM32MP215F-DK Discovery kit Info.png do not support the GPU. For such board, the splash screen is displayed.

In order to run a Qt example, "psplash-drm" process first needs to be killed:

killall psplash-drm

Then any Qt example can be run such as analog clock widget:

/usr/share/examples/widgets/widgets/analogclock/analogclock 
Analogclock2.png

4.2. For board with GPU support[edit | edit source]

STM32MP157F-DK2 Discovery kit More info green.png and STM32MP257F-DK Discovery kit More info green.png support the GPU. For such boards, once the Weston graphical service is restarted, the new Qt STLauncher is displayed.

  • The Qt 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]

Demonstrations, available via the GTK demo launcher, are also supported by the new Qt STLauncher.
For example, 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 Qt 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 Qt 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