Last edited 2 months 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 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]

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

.

  • Install the package with the apt configuration to access the Qt packages :
CollapseFor Qt6:
apt-get install apt-openstlinux-x-linux-qt_2.0
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 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]
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