STM32MP13 Discovery kits - Starter Package

This message will disappear after all relevant tasks have been resolved.

Semantic MediaWiki

There are 1 incomplete or pending task to finish installation of Semantic MediaWiki. An administrator or user with sufficient rights can complete it. This should be done before adding new data to avoid inconsistencies.

Applicable for

STM32MP13x lines

This article shows how to start up a STM32MP135x-DK Discovery kit (flexible and complete development platform for the STM32MP13x lines ). It is valid for the STM32MP135F-DK Discovery kits: the part numbers are specified in the STM32MP13 microprocessor part numbers article.

It lists the required material, points to the board features description, and gives the step-by-step process to set up the system.

Finally, it proposes to run some basic use cases and to discover some of the board capabilities.

1 Starter Package content[edit source]

If you are not yet familiar with the STM32MPU Embedded Software distribution and its Packages, please read the following articles:

Which STM32MPU Embedded Software Package better suits your needs (and especially the Starter Package chapter)
STM32MPU Embedded Software distribution

If you are already familiar with the Starter Package for the STM32MPU Embedded Software distribution, the fast links to essential commands might be of interest.

To sum up, this Starter Package provides:

the software image for the STM32MPU Embedded Software distribution, which includes:
- the binaries for the OpenSTLinux distribution
- one or more firmware example(s) for the STM32Cube MPU Package
the (STM32CubeProgrammer) tool to install this image on the STM32MP135F-DK Discovery kit

Components of the Starter Package

2 Starter Package step-by-step overview[edit source]

The steps to get the STM32MP135x-DK Discovery kit up and running, are:
☐ Checking the material
☐ Assembling the board
☐ Installing the tools
☐ Downloading the image and flashing it on the board
☐ Booting the board

Once these steps are achieved, you are able to:

check the boot sequence
execute basic commands
run basic use cases
discover on your own the capabilities of the STM32MP135x-DK Discovery kit

3 Checking the material[edit source]

Mandatory

PC	Linux^® or Windows^® operating systems. See PC prerequisites for more details on the required configurations.
STM32MP135x-DK Discovery kit	Flexible and complete development platform for the STM32MP135 microprocessor device including: an MB1635 mother board
Power supply	Including: a USB Type-C^® cable (included in the packaging) a USB Type-C^® charger (5 V, 3 A) (not included in the packaging)
microSD^™ card	Populated with OpenSTLinux distribution (Linux^® software), and providing extra storage capacity. A 2-Gbyte minimum microSD^™ card is needed. Populated with STM32CubeMPU firmware, the microSD^™ card can be used as external memory to populate firmware into board
USB Micro-B cable	To connect the STM32MP135x-DK Discovery kit to the PC through the USB Micro-B (ST-LINK/V2-1) connector.
USB Type-C^® cable	To connect the STM32MP135x-DK Discovery kit to a USB OTG device through the USB Type-C^® connector.

Optional

USB keyboard and mouse	Through its USB Type-A connectors, the STM32MP135x-DK Discovery kit can be equipped with a full-size keyboard and mouse.
Ethernet cable	To connect the STM32MP135x-DK Discovery kit to a network through the RJ45 connector.

Optional: It is possible to plug more devices and extension boards to the STM32MP135x-DK Discovery kit by means of its expansion connectors such as the GPIO expansion connector.

The following figure shows the optional material (not included in STM32MP135x-DK Discovery kit package), that is used with this Starter Package.

Recommended material for this Starter Package

4 Assembling the board[edit source]

Please note that the STM32MP135x-DK Discovery kit includes the MB1723 camera module with its flat cable but neither USB cable nor USB charger is provided.


Position	Description
1	MB1635 motherboard
2	MB1723 camera module
3	Camera module flat cable

STM32MP135x-DKx Discovery kit assembled
STM32MP135F-DK Discovery kit shown here (picture not contractual)

5 Installing the tools[edit source]

5.1 Installing the STM32CubeProgrammer tool[edit source]

	STM32CubeProgrammer for Linux^® host PC	STM32CubeProgrammer for Windows^® host PC
Download	Version v2.16.0 Go on st.com to download the STM32CubeProgrammer software Download the archive file on your host PC in a temporary directory Uncompress the archive file to get the STM32CubeProgrammer installers: unzip en.stm32cubeprog.zip
Installation	Execute the Linux installer, which guides you through the installation process. $> ./SetupSTM32CubeProgrammer-2.16.0.linux The path to the STM32CubeProgrammer binary must be added to the PATH environment variable either in each Terminal program in which the STM32CubeProgrammer binary needs to be used, using the following command: $> export PATH=<my STM32CubeProgrammer install directory>/bin:$PATH or once for all by creating a link to the STM32CubeProgrammer binary in a directory already present in PATH. For example, if "/home/bin" is in the PATH environment variable, run the following command: $> ln -s <my STM32CubeProgrammer install directory>/bin/STM32_Programmer_CLI /home/bin/STM32_Programmer_CLI	Execute the Windows installer, which guides you through the installation process.
User manual	Instructions to follow for using the STM32CubeProgrammer can be found in user manual, UM2237 available from ST web site, or in STM32CubeProgrammer#How to flash with STM32CubeProgrammer article.
Detailed release note	Details about the content of this tool version are available from ST web site at Release Note .

5.2 Preparing the USB serial link for flashing[edit source]

It is recommended to use the USB (in DFU mode) for flashing rather than the UART, which is too slow.

Below indications on how to install the USB in DFU mode under Linux and Windows OS, respectively.

For Linux host PC or Windows host PC with VMWare:

The libusb1.0 package (including USB DFU mode) must be installed to be able to connect to the board via the USB port. This is achieved by typing the following command from the host PC terminal:

 sudo apt-get install libusb-1.0-0

To allow STM32CubeProgrammer to access the USB port through low-level commands, proceed as follows:

 cd <your STM32CubeProgrammer install directory>/Drivers/rules 

 sudo cp *.* /etc/udev/rules.d/

For Windows host PC:

Run the “STM32 Bootloader.bat” file to install the STM32CubeProgrammer DFU driver and activate the STM32 microprocessor device in USB DFU mode. This driver (installed by STM32 Bootloader.bat) is provided within the STM32CubeProgrammer release package. It is located in the DFU driver folder, \Drivers\DFU_Driver.

In case of issue, refer to How to proceed when the DFU driver installation fails on Windows host PC.

To validate the installation, the DFU driver functionality can be verified by following the FAQ instructions provided in how to check if the DFU driver is functional.

6 Downloading the image and flashing it on the board[edit source]

6.1 Image download[edit source]

Warning

Only microSD cards SanDisk Class 10 and UHS Speed Class 1 are verified. Others are not recommended.

The STM32MP1 image (binaries) is delivered through one tarball file named
- en.flash-stm32mp1-openstlinux-6.1-yocto-mickledore-mp1-v23.06.21.tar.gz for STM32MP135x-DK , STM32MP157x-DKx and STM32MP157x-EV1

Download and install the STM32MP1 image (binaries):

The software package is provided AS IS, and by downloading it, you agree to be bound to the terms of the software license agreement (SLA0048). The detailed content licenses can be found here.

STM32MP1 Starter Package image - STM32MP1-Ecosystem-v5.0.0 release

Download

Go on st.com to download the STM32MP1 Starter Package image, en.flash-stm32mp1-openstlinux-6.1-yocto-mickledore-mp1-v23.06.21.tar.gz file.

Installation

Go to the host PC directory in which you want to install the Starter Package (<Starter Package installation directory>); if you follow the proposition to organize the working directory, this means:

$ cd <working directory path>/Starter-Package

Download the tarball file in this directory
Uncompress the tarball file to get the binaries for the different partitions of the image, and the Flash layout files:

$ tar xvf en.flash-stm32mp1-openstlinux-6.1-yocto-mickledore-mp1-v23.06.21.tar.gz

Release note

Details of the content of this software package are available in the associated STM32 MPU OpenSTLinux release note.
If you are interested in older releases, please have a look into the section Archives

The binaries and the Flash layout files are in the <Starter Package installation directory>/stm32mp1-openstlinux-6.1-yocto-mickledore-mp1-v23.06.21/images/stm32mp1/ directory:

stm32mp1
├── arm-trusted-firmware                       TF-A binaries for FSBL partitions and supported boot chains
│   ├── metadata.bin                           Meta data binary for METADATA partition for the supported boards
│   ├── tf-a-stm32mp135f-dk-sdcard.stm32       TF-A binary for FSBL partition (microSD card boot device) for STM32MP135F-DK → STM32MP13 Discovery kits
│   ├── tf-a-stm32mp135f-dk-uart.stm32         TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP135F-DK → STM32MP13 Discovery kits
│   ├── tf-a-stm32mp135f-dk-usb.stm32          TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP135F-DK → STM32MP13 Discovery kits
│   ├── tf-a-stm32mp157a-dk1-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157A-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157a-dk1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157A-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157a-dk1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157A-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157a-ev1-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157a-ev1-nand.stm32        TF-A binary for FSBL partition (NAND boot device) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157a-ev1-nor.stm32         TF-A binary for FSBL partition (NOR boot device) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157a-ev1-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157a-ev1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157a-ev1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-dk2-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157c-dk2-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157c-dk2-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157c-ed1-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157c-ed1-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157c-ed1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157c-ed1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157c-ev1-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-ev1-nand.stm32        TF-A binary for FSBL partition (NAND boot device) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-ev1-nor.stm32         TF-A binary for FSBL partition (NOR boot device) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-ev1-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-ev1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-ev1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-dk1-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157D-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157d-dk1-uart.stm32        TF-A binary for serial boot mode (STM32CubeProgrammer) for STM32MP157D-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157d-dk1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157D-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157d-ev1-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-ev1-nand.stm32        TF-A binary for FSBL partition (NAND boot device) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-ev1-nor.stm32         TF-A binary for FSBL partition (NOR boot device) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-ev1-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-ev1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-ev1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157f-dk2-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157F-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157f-dk2-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157F-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157f-dk2-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157F-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157f-ed1-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157f-ed1-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157f-ed1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157f-ed1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157f-ev1-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157f-ev1-nand.stm32        TF-A binary for FSBL partition (NAND boot device) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157f-ev1-nor.stm32         TF-A binary for FSBL partition (NOR boot device) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157f-ev1-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157f-ev1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│   └── tf-a-stm32mp157f-ev1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
├── fip                                        FIP binaries for FIP partitions and supported boot chains
│   ├── fip-stm32mp135f-dk-optee.bin           FIP binary for FIP partition (optee boot chain) for STM32MP135F-DK → STM32MP13 Discovery kits
│   ├── fip-stm32mp157a-dk1-optee.bin          FIP binary for FIP partition (optee boot chain) for STM32MP157A-DK1 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157a-ev1-optee.bin          FIP binary for FIP partition (optee boot chain) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157c-dk2-optee.bin          FIP binary for FIP partition (optee boot chain) for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157c-ed1-optee.bin          FIP binary for FIP partition (optee boot chain) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157c-ev1-optee.bin          FIP binary for FIP partition (optee boot chain) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157d-dk1-optee.bin          FIP binary for FIP partition (optee boot chain) for STM32MP157D-DK1 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157d-ev1-optee.bin          FIP binary for FIP partition (optee boot chain) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157f-dk2-optee.bin          FIP binary for FIP partition (optee boot chain) for STM32MP157F-DK2 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157f-ed1-optee.bin          FIP binary for FIP partition (optee boot chain) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   └── fip-stm32mp157f-ev1-optee.bin          FIP binary for FIP partition (optee boot chain) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
├── flashlayout_st-image-weston                                 Flash layout files (description of the partitions) for the supported boot chains on supported boot devices and boards
│   ├── extensible                                              Flash layout files for microSD card boot device with no userfs partition but a rootfs partition extended to microSD card size
│   │   ├── FlashLayout_sdcard_stm32mp135f-dk-optee.tsv         (recommended setup for package repository service) microSD card boot device for STM32MP135F-DK → STM32MP13 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp157a-dk1-extensible.tsv   (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size for STM32MP157A-DK1 → STM32MP15 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp157c-dk2-extensible.tsv   (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp157d-dk1-extensible.tsv   (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size for STM32MP157D-DK1 → STM32MP15 Discovery kits
│   │   └── FlashLayout_sdcard_stm32mp157f-dk2-extensible.tsv   (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size for STM32MP157F-DK2 → STM32MP15 Discovery kits
│   └── optee                                                   Flash layout files for optee boot chain
│       ├── FlashLayout_emmc_stm32mp157a-ev1-optee.tsv          eMMC boot device for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_emmc_stm32mp157c-ed1-optee.tsv          eMMC boot device for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│       ├── FlashLayout_emmc_stm32mp157c-ev1-optee.tsv          eMMC boot device for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_emmc_stm32mp157d-ev1-optee.tsv          eMMC boot device for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_emmc_stm32mp157f-ed1-optee.tsv          eMMC boot device for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│       ├── FlashLayout_emmc_stm32mp157f-ev1-optee.tsv          eMMC boot device for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nand-4-256_stm32mp157a-ev1-optee.tsv    NAND boot device for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nand-4-256_stm32mp157c-ev1-optee.tsv    NAND boot device for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nand-4-256_stm32mp157d-ev1-optee.tsv    NAND boot device for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nand-4-256_stm32mp157f-ev1-optee.tsv    NAND boot device for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nor-sdcard_stm32mp157a-ev1-optee.tsv    NOR boot device and microSD card device for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nor-sdcard_stm32mp157c-ev1-optee.tsv    NOR boot device and microSD card device for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nor-sdcard_stm32mp157d-ev1-optee.tsv    NOR boot device and microSD card device for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nor-sdcard_stm32mp157f-ev1-optee.tsv    NOR boot device and microSD card device for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_sdcard_stm32mp135f-dk-optee.tsv         (recommended setup) microSD card boot device for STM32MP135F-DK → STM32MP13 Discovery kits
│       ├── FlashLayout_sdcard_stm32mp157a-dk1-optee.tsv        microSD card boot device for STM32MP157A-DK1 → STM32MP15 Discovery kits
│       ├── FlashLayout_sdcard_stm32mp157a-ev1-optee.tsv        microSD card boot device for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_sdcard_stm32mp157c-dk2-optee.tsv        microSD card boot device for STM32MP157C-DK2 → STM32MP15 Discovery kits
│       ├── FlashLayout_sdcard_stm32mp157c-ed1-optee.tsv        microSD card boot device for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│       ├── FlashLayout_sdcard_stm32mp157c-ev1-optee.tsv        microSD card boot device for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_sdcard_stm32mp157d-dk1-optee.tsv        microSD card boot device for STM32MP157D-DK1 → STM32MP15 Discovery kits
│       ├── FlashLayout_sdcard_stm32mp157d-ev1-optee.tsv        microSD card boot device for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_sdcard_stm32mp157f-dk2-optee.tsv        microSD card boot device for STM32MP157F-DK2 → STM32MP15 Discovery kits
│       ├── FlashLayout_sdcard_stm32mp157f-ed1-optee.tsv        microSD card boot device for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│       └── FlashLayout_sdcard_stm32mp157f-ev1-optee.tsv        microSD card boot device for STM32MP157F-EV1 → STM32MP15 Evaluation boards
├── scripts
│   └── create_sdcard_from_flashlayout.sh
├── st-image-bootfs-openstlinux-weston-stm32mp1.ext4                            Binary for bootfs partition on eMMC and microSD card devices
├── st-image-bootfs-openstlinux-weston-stm32mp1.manifest
├── st-image-userfs-openstlinux-weston-stm32mp1.ext4                            Binary for userfs partition on eMMC and microSD card devices
├── st-image-userfs-openstlinux-weston-stm32mp1.manifest
├── st-image-vendorfs-openstlinux-weston-stm32mp1.ext4                          Binary for vendorfs partition on eMMC and microSD card devices
├── st-image-vendorfs-openstlinux-weston-stm32mp1.manifest
├── st-image-weston-openstlinux-weston-stm32mp1.ext4                            Binary for rootfs partition on eMMC and microSD card devices
├── st-image-weston-openstlinux-weston-stm32mp1.license
├── st-image-weston-openstlinux-weston-stm32mp1-license_content.html            License summary for all packages needed to feed all partitions
├── st-image-weston-openstlinux-weston-stm32mp1.manifest
└── st-image-weston-openstlinux-weston-stm32mp1_nand_4_256_multivolume.ubi      Binary for bootfs, vendorfs, rootfs and userfs partitions on NAND device

6.2 Image flashing[edit source]

The STM32CubeProgrammer tool is used to flash the STM32MP135x-DK Discovery kit with the downloaded image.

The microSD card, provided in the box, is used as the Flash device: see the STM32MP15 Flash mapping article if you want to know more about the supported Flash memory technologies, and the Flash partitions.

As explained in the boot chain overview, the optee boot chain is the default solution delivered by STMicroelectronics. Thus, the steps below use the image for the optee boot chain.

Let's flash the downloaded image on the microSD card:

Connect the USB Type-C^™ (OTG) port (7) to the host PC that contains the downloaded image
Insert the delivered microSD card into the dedicated slot ('4)
Connect the delivered power supply to the USB Type-C^™ port (11)
Press the reset button (8) to reset the board

Discovery kit connections for flashing
STM32MP135F-DK shown here (picture is not contractual)

Go to the Starter Package directory that contains the binaries and the Flash layout files

 cd <Starter Package installation directory>/unknown revision

If you have followed the the proposition to organize the working directory, the command is
  cd Starter-Package/unknown revision

Information

The commands below are for a Linux host PC; however, they are similar for a Windows host PC except that STM32_Programmer_CLI is replaced by STM32_Programmer_CLI.exe.

Check that the STM32CubeProgrammer tool is installed and accessible; if not, go to the installation procedure (installing the tools)

 STM32_Programmer_CLI --h
      -------------------------------------------------------------------
                        STM32CubeProgrammer <tool version>                  
      -------------------------------------------------------------------

Get the device port location for the USB link

 STM32_Programmer_CLI -l usb
      -------------------------------------------------------------------
                        STM32CubeProgrammer <tool version>                
      -------------------------------------------------------------------


Total number of available STM32 device in DFU mode: 1

  Device Index           : USB1
  USB Bus Number         : 002
  USB Address Number     : 002
  Product ID             : DFU in HS Mode @Device ID /0x500, @Revision ID /0x0000
  Serial number          : 000000000000
  Firmware version       : 0x011a
  Device ID              : 0x0500

Flash the microSD card with the image for the trusted boot chain

 STM32_Programmer_CLI -c port=usb1 -w flashlayout_st-image-weston/optee/FlashLayout_sdcard_stm32mp135f-dk-optee.tsv

This operation takes several minutes (mainly depending of the rootfs size). A successful flashing outputs the following log:

Information

Please note that the logs that you will obtain, might be slightly different, especially if you use a different software release or a different STM32 MPU.

      -------------------------------------------------------------------
                        STM32CubeProgrammer v2.9.0                       
      -------------------------------------------------------------------



Warning: Timeout is forced to 65535 ms


USB speed   : High Speed (480MBit/s)
Manuf. ID   : STMicroelectronics
Product ID  : DFU in HS Mode @Device ID /0x501, @Revision ID /0x1000
SN          : 000080163031510A30333432
FW version  : 0x0110
Board       : --
Device ID   : 0x0501
Device name : STM32MP13xx
Device type : MPU
Revision ID : --  
Device CPU  : Cortex-A7


Start Embedded Flashing service



Memory Programming ...
Opening and parsing file: tf-a-stm32mp135f-dk-usb.stm32
  File          : tf-a-stm32mp135f-dk-usb.stm32
  Size          : 88838 Bytes
  Partition ID  : 0x01 

Download in Progress:


File download complete
Time elapsed during download operation: 00:00:00.319

RUNNING Program ... 
  PartID:      :0x01 
Start operation done successfully at partition 0x01


Memory Programming ...
Opening and parsing file: fip-stm32mp135f-dk-optee.bin
  File          : fip-stm32mp135f-dk-optee.bin
  Size          : 1371986 Bytes
  Partition ID  : 0x03 

Download in Progress:


File download complete
Time elapsed during download operation: 00:00:01.147

RUNNING Program ... 
  PartID:      :0x03 

Reconnecting the device ...


Start operation done successfully at partition 0x03

Memory Programming ...
Opening and parsing file: tf-a-stm32mp135f-dk-sdcard.stm32
  File          : tf-a-stm32mp135f-dk-sdcard.stm32
  Size          : 88767 Bytes
  Partition ID  : 0x04 

Download in Progress:


File download complete
Time elapsed during download operation: 00:00:00.023

RUNNING Program ... 
  PartID:      :0x04 
Start operation done successfully at partition 0x04


Memory Programming ...
Opening and parsing file: tf-a-stm32mp135f-dk-sdcard.stm32
  File          : tf-a-stm32mp135f-dk-sdcard.stm32
  Size          : 88767 Bytes
  Partition ID  : 0x05 

Download in Progress:


File download complete
Time elapsed during download operation: 00:00:00.022

RUNNING Program ... 
  PartID:      :0x05 
Start operation done successfully at partition 0x05


Memory Programming ...
Opening and parsing file: fip-stm32mp135f-dk-optee.bin
  File          : fip-stm32mp135f-dk-optee.bin
  Size          : 1371986 Bytes
  Partition ID  : 0x06 

Download in Progress:


File download complete
Time elapsed during download operation: 00:00:00.263

RUNNING Program ... 
  PartID:      :0x06 
Start operation done successfully at partition 0x06


Memory Programming ...
Opening and parsing file: st-image-bootfs-openstlinux-weston-stm32mp13-disco.ext4
  File          : st-image-bootfs-openstlinux-weston-stm32mp13-disco.ext4
  Size          : 64 MBytes
  Partition ID  : 0x10 

Download in Progress:


File download complete
Time elapsed during download operation: 00:00:16.369

RUNNING Program ... 
  PartID:      :0x10 
Start operation done successfully at partition 0x10


Memory Programming ...
Opening and parsing file: st-image-vendorfs-openstlinux-weston-stm32mp13-disco.ext4
  File          : st-image-vendorfs-openstlinux-weston-stm32mp13-disco.ext4
  Size          : 16 MBytes
  Partition ID  : 0x11 

Download in Progress:


File download complete
Time elapsed during download operation: 00:00:03.981

RUNNING Program ... 
  PartID:      :0x11 
Start operation done successfully at partition 0x11


Memory Programming ...
Opening and parsing file: st-image-weston-openstlinux-weston-stm32mp13-disco.ext4
  File          : st-image-weston-openstlinux-weston-stm32mp13-disco.ext4
  Size          : 609412 KBytes
  Partition ID  : 0x12 

Download in Progress:


File download complete
Time elapsed during download operation: 00:02:28.997

RUNNING Program ... 
  PartID:      :0x12 
Start operation done successfully at partition 0x12


Memory Programming ...
Opening and parsing file: st-image-userfs-openstlinux-weston-stm32mp13-disco.ext4
  File          : st-image-userfs-openstlinux-weston-stm32mp13-disco.ext4
  Size          : 128 MBytes
  Partition ID  : 0x13 

Download in Progress:


File download complete
Time elapsed during download operation: 00:00:31.960

RUNNING Program ... 
  PartID:      :0x13 
Start operation done successfully at partition 0x13
Flashing service completed successfully

Go to the STM32CubeProgrammer article:

to know more about the flashing operation

7 Booting the board[edit source]

Once the firmware image is programmed on the STM32MP135x-DK Discovery kit, it is possible to finalize the system configuration:

Step 1: check the configuration of the switches
- The figure below shows the position of the boot switches to boot from the microSD™ card.

Boot from microSD™ card

Step 2: (optional) connect a USB keyboard and/or a USB mouse (not provided) using the USB Type-A ports (10 and 11)

Step 3: (optional) connect an Ethernet cable (not provided) to the dedicated connectors (5 or 6)

STM32MP135F-DK Discovery kit connections. (picture is not contractual)

Step 4: check that the microSD™ card is inserted into the dedicated slot (4)

Step 5: connect the provided power supply (5 V, 3 A) to the USB Type-C^® connector (8)

Step 6: (optional) connect the ST-LINK/V2-1 USB Micro-B port (7) to a host PC that runs a terminal program with ST-LINK/V2-1 Virtual COM port (such as Minicom on Ubuntu^® Linux^® PC or Tera Term on Windows^® PC)
- install and configure a remote terminal program onto the host PC

Step 7: press the reset button (12) to reset the board

The board boots and the system is available after few seconds.

Subpart - STM32MP13 - Starter Package

8 Examples[edit source]

The examples are under construction: few of them are proposed below; more examples will come with the next releases.

8.1 Examples running on Cortex-A7[edit source]

The table below gathers links towards articles proposing examples of peripherals usage.


Link to the example
Playing an audio/video local file
Playing an audio/video stream
Displaying an image
Running a simple 3D example (GPU usage)
Setting up a wifi connection
Setting up a Bluetooth connection
Displaying on the HDMI monitor (or TV)

9 Fast links to essential commands[edit source]

If you are already familiar with the Starter Package for the STM32MPU Embedded Software distribution, fast links to the essential commands are listed below.

Information

With the links below, you will be redirected to other articles; use the back button of your browser to come back to these fast links

Link to the command
Download and install the latest image
Set boot switches
Flash the image on the microSD card
Start a remote Terminal with Minicom
Get the board IP address
Start a remote Terminal over Ethernet
Copy a file from the host PC to the board over Ethernet

10 How to go further?[edit source]

Now that the image is flashed on the STM32MP135F-DK Discovery kit, you might want to switch to the STM32MP1 Developer Package, in order to modify or tune the STM32MPU Embedded Software distribution with your own developments.