User space static library project

< How to debug a user space application with STM32CubeIDE
Applicable for STM32MP13x lines, STM32MP15x lines

This article explains how to create, build and debug a static library linked with a Linux® user space application for STM32 MPU.

Warning white.png Important
This article has been written with the example of STM32MP15x lines More info.png. Nevertheless, it is applicable to any lines present in applicability field displayed on the top of this article

BackToNavigationTree button.png

1 Create a user space static library project[edit]

In the Cortex®-A7 sub-project context, named here MP157C-DK2_CA7, right-click and select Create a userspace Project...

User space project wizard shortcut

Here, the Static Library project type, in C language, is selected.

Note that the user space project uses by default the SDK version associated to the Cortex®-A7 sub-project.

User space project creation wizard

2 Build[edit]

  • Select your project, right-click and then Build Project.
Static Library Build

3 Update myExe project sources and properties to use myStaticLib[edit]

Hereafter is an updated code for main() to call myStaticLib function say_hello().
You must also reference myStaticLib project inside myExe properties: C/C++ General > Paths and Symbols > References as depicted below.

Executable source & properties update

4 Prepare Debug Configuration[edit]

You can check boot messages via Linux® console opened with butterfly icon (shown below), but remember this console cannot be shared outside STM32CubeIDE (minicom,...). In order to debug user space application, your target must be Linux® booted and network connected.


In order to check network connection, start the Target Status widget in the bottom right corner of the window.

Target Status - green

Check also How to set up proxy and P2P Ethernet connection with STM32CubeIDE if you are in that case.

5 Set Debug Configuration[edit]

Select your project, right-click Debug as... > Debug Configurations, then select STM32 Cortex-A Remote Application'.

Debug configuration shortcut

The default connection proposed is "MPU SSH", corresponding to the target IP address discovered by the Target Status widget. The default destination directory is /home/root.

User space debug configuration - main tab

6 Debug: stepping into myStaticLib[edit]

Click Debug :

  1. Executable is downloaded to the target,
  2. GDBServer is launched on the target,
  3. GDBClient is launched on the workstation and can exchange via the network with GDBServer.
User space static library debug
Info white.png Information
In case of error, stop any GDBServer running on the target before launching a new debug session.

BackToNavigationTree button.png