STM32CubeMP2 Package - Getting started

Revision as of 16:19, 30 November 2023 by Registered User (Created page with "<noinclude>{{ApplicableFor |MPUs list=STM32MP25x |MPUs checklist=STM32MP25x }}</noinclude> The '''STM32CubeMP25 Package''' / '''STM32CubeMP2 Package''' is part of the STM32...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Applicable for STM32MP25x lines


The STM32CubeMP25 Package / STM32CubeMP2 Package is part of the STM32 MPU embedded software offer. It runs on the Arm® Cortex®-M33 coprocessor.
It is included in the three software packages proposed by the Linux® Yocto-based embedded software:

  • in the starter package as pre-built examples (firmware),
  • in the developer package as full source code for development (associated with an IDE),
  • in the distribution package as a dedicated recipe (that integrates the full source code) in the OpenSTLinux distribution.

Therefore, this article explains how to develop, build and run existing or new examples thanks to these three software packages.

1. Prerequisites[edit source]

In the next chapters, it is assumed that the selected board is assembled according to the information provided in its hardware description article (e.g., STM32MP257x-EV1 - hardware description for STM32MP257x-EV1 Evaluation boards), and that the different boot related switches of the board are also known (e.g., boot related switches for STM32MP257x-EV1 Evaluation boards).

Refer also to the Which Package better suits your needs article for further information on all packages.

There are two ways (boot modes) to load the firmware into the Arm® Cortex®-M33 coprocessor:

  • the production boot mode (the firmware is loaded into the coprocessor by the Arm® Cortex®-A35 processor running the Linux® distribution,
  • the engineering boot mode (the firmware is loaded from the IDE).

The How to use engineering and production modes article details the differences between these two different boot modes, and suggests the boot mode to use depending on the development phase.


2. Starter Package for STM32CubeMP25[edit source]

The Linux Yocto-based starter packages (STM32MP25 Evaluation boards - Starter_Package) contain pre-built examples (firmware) that are located in the Linux file system (userfs folder: /usr/local/Cube-M33-examples/<board_name>/Examples), and that be run from a host console thanks to a dedicated script (fw_cortex_m33.sh).

This chapter, and its sub-chapters, aims to explain all steps needed to run an existing example.