Last edited one day ago

X-LINUX-QT Starter Package



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.
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 the board thanks to its Starter Package. All articles relative to Starter Packages are found in Category:Starter Package: find the one that corresponds to the 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]

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 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 may 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"
  • 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:
CollapseFor Qt6:
cd /var/cache/apt/archives
wget http://extra.packages.openstlinux.st.com/Qt/5.1/pool/config/a/apt-openstlinux-x-linux-qt/apt-openstlinux-x-linux-qt_1.0_all.deb
apt-get install ./apt-openstlinux-x-linux-qt_1.0_all.deb
For Qt5:
apt-get install apt-openstlinux-qt
  • 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
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 ST-Launcher 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, 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