The ST App Launcher (or st-launcher) is a lightweight graphical application based on the Qt Quick module and written primarily in QML. It is designed by STMicroelectronics as the default user interface and application dashboard for their STM32 Microprocessor Units (MPUs)—such as the STM32MP1 and STM32MP2 series—running the OpenSTLinux operating system. 🧰 Core Ecosystem Components
To get started with the launcher, you must utilize the X-LINUX-QT Expansion Package. This package provides a pre-integrated ecosystem supporting Wayland and Weston display servers. It includes: The ST Application Launcher binary and its source code.
Qt6 Framework Libraries cross-compiled for ARM architectures.
Sample Qt GUI use cases to understand hardware-accelerated rendering. 🚀 Step-by-Step Quick Start Guide 1. Flash the Hardware Image Insert a microSD card into your host PC. Open Qt Creator. Navigate to Tools > Flash Boot to Qt Device.
Follow the flashing wizard to write the OpenSTLinux image containing X-LINUX-QT to your card.
Insert the card into your STM32MPU board (e.g., STM32MP257F-DK) and power it on. 2. Interact with the Launcher
The board will automatically boot into the ST App Launcher home screen.
To interact with the interface, click an application icon once to highlight it, and click it a second time to execute it.
To find your device’s network configuration, navigate to the Settings menu inside the launcher. It will display the active IP address needed for remote deployment. 3. Setup the Host Development Environment
You can build and deploy your own applications to the launcher using either Qt Creator or STM32CubeIDE. Using Qt Creator Using STM32CubeIDE Prerequisites OpenSTLinux SDK + Qt Creator IDE OpenSTLinux SDK + STM32CubeIDE Kit Configuration
Select the target MPU kit installed by the X-LINUX-QT package.
Update the SDK environment settings for CMake inside the IDE. Device Linking
Add a “Boot to Qt device” and input the IP address found in the launcher.
Target the live board IP within the run configurations profile. Deployment
Click the Run button to automatically compile, transfer, and execute your code.
Import the project, click build, and use the “Deploy” layout script. 🎨 Customizing the Launcher UI
Because the system is heavily reliant on QML, developers can easily customize the dashboard layout, asset styles, or add new application shortcuts.
Pull the source code repository directly from the official STMicroelectronics GitHub Launcher Page.
Edit the .qml files to modify visual styling, font mappings, or button animations.
Ensure your CMakeLists.txt file contains the proper installation lines so that the newly compiled binaries map correctly to the system’s execution prefix.
Perhaps you are trying to build a custom touchscreen interface for a commercial product or industrial control unit? I can provide you with a custom QML template snippet designed to integrate a new application shortcut directly into the ST App Launcher layout. X-LINUX-QT expansion package – stm32mpu – ST wiki
Leave a Reply