The STM32MP25 SOC platform includes a low-power Cortex-M33 processor with a low gate count and low interrupt latency. The Cortex-M33 implements the ARMv8-M instruction set architecture (ISA) and adds significant capabilities with digital signal processor (DSP) and single instruction multiple data (SIMD) extensions. The Cortex-M33 operates as a coprocessor, either autonomously as any external microcontroller, or by communicating with the main processor (Cortex-A35) via the RPMsg communication pipe.

STMicroelectronics provides an integrated development environment (IDE) for developing and debugging CortexM applications.

1. Develop and build firmware for the Cortex-M33

To develop and build firmware for the Cortex-M33, follow the instructions in the STM32MP25 Getting Started guide to:

  • Download and install the STM32CubeIDE

  • Install the STM32Cube MPx package

  • Create and build a firmware project

The example applications included in the STM32CubeIDE may use peripherals, such as GPIOs or ADC lines, available on STM evaluation boards. You may need to adapt the source code to lines and peripherals that are available on the ConnectCore MP25 Development Kit.

2. Deploy the firmware onto the target

Choose one of the following ways to deploy the firmware onto the Cortex-M33:

Run your firmware application with Remoteproc from Linux

The remote processor (RPROC) framework allows the different platforms/architectures to control (power on, load firmware, power off) remote processors while abstracting the hardware differences. The application must either be stored on a partition of an external device or included in the rootfs image.

  1. Locate the built firmware file (.elf). This is located in your project folder, under a path such as <yourproject>/STM32CubeIDE/CM33/NonSecure/Debug.

  2. Copy the firmware from the host to the target inside /lib/firmware, for instance over SSH:

    $ scp <firmware-file.elf> root@<device-ip>:/lib/firmware

  3. To load the firmware on the Cortex-M33:

    # echo -n <firmware-file.elf> > /sys/class/remoteproc/remoteproc0/firmware

  4. To start the firmware:

    # echo start > /sys/class/remoteproc/remoteproc0/state

  5. To check the firmware output log:

    # cat /sys/kernel/debug/remoteproc/remoteproc0/trace0

  6. To stop the firmware:

    # echo stop > /sys/class/remoteproc/remoteproc0/state

Remoteproc looks for firmware files in /lib/firmware by default. You can set a different location with the following command, and the remoteproc framework parses this path first.

# echo -n <firmware_path> > /sys/module/firmware_class/parameters/path

Run and debug your firmware using the IDE

To run or debug the firmware from the IDE you need one of these debuggers:

Run the firmware

The following instructions show how to download the firmware to your device and run it:

  1. Connect the ST-LINK debugger to your development computer. This is required by the IDE, but you don’t need to connect it to the device. The firmware is transferred via Ethernet.

  2. Start the STM32CubeIDE.

  3. Select your Cortex-M33 project.

  4. Right click the project and select Run As > Run configurations. This opens the Run configuration panel.

  5. If not already created, create your run configuration by clicking on the STM32 C/C++ Application.

  6. On the Debugger tab:

    1. Select thru Linuxcore (Production mode).

    2. Select the ST-Link serial port available on the Serial Port. The IDE automatically detects ST-Link serial port.

    3. Set the IP address of your target in the Inet Address field. The IDE will create a SSH connection to the target for the firmware download.

  7. Click Apply and Run.

This loads the firmware on the target and runs it.

Debug the firmware

  1. Connect the ST-LINK debugger to your development computer and to the CPU JTAG connector (J21) on the ConnectCore MP25 Development Kit. (The connector is not populated by default.)

  2. Start the STM32CubeIDE.

  3. Select your Cortex-M33 project.

  4. Right click the project and select Debug As > Debug configurations. This opens the Debug configuration panel.

  5. If not already created, create your debug configuration by clicking on the STM32 C/C++ Application.

  6. On the Debugger tab:

    1. Select thru Linuxcore (Production mode).

    2. Select the ST-Link serial port available on the Serial Port. The IDE automatically detects ST-Link serial port.

    3. Set the IP address of your target in the Inet Address field. The IDE will create a SSH connection to the target for the firmware download.

  7. Click Apply and Debug.

This loads the firmware on the target, runs it and opens the debug perspective. You can press Suspend to stop the firmware.

For the best GDB debug experience, Digi recommends you upgrade the onboard ST-Link version with the latest release by going to Help > ST-Link Upgrade in the STM32CubeIDE menu.

For more information, refer to the STM32CubeIDE documentation.

Boot your firmware from U-Boot

You can load and start the firmware application from U-Boot with the rproc command.

  1. Transfer the firmware to the target RAM address, for instance if the firmware is on a USB stick:

    => usb start
=> load usb 0:1 ${loadaddr} <firmware-file.elf>

  2. Initialize rproc and load the firmware from RAM

    => rproc init
=> rproc load 0 ${loadaddr} ${filesize}

  3. Start the firmware:

    => rproc start 0