STM32MP15 Discovery kits - Starter Package

This article shows how to start up a STM32MP157x-DKx Discovery kit (flexible and complete development platform for the STM32MP15 microprocessor devices). It is valid both for the STM32MP157A-DK1 and STM32MP157C-DK2 Discovery kits: the part numbers are specified in the STM32MP15 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

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 STM32MP157x-DKx Discovery kit

Components of the Starter Package

2. Starter Package step-by-step overview

The steps to get the STM32MP157x-DKx 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 STM32MP157x-DKx Discovery kit

3. Checking the material

Mandatory

PC	Linux or Windows operating systems. See PC prerequisites for more details on the required configurations.
STM32MP157x-DKx Discovery kit (STM32MP157A-DK1 or STM32MP157c-DK2)	Flexible and complete development platform for the STM32MP15 microprocessor device including: a MB1272 motherboard a MB1407 daughterboard (480x800 pixels DSI display): only for the STM32MP157C-DK2 Discovery kit
Power supply	Including: a USB Type-C™ cable (delivered in the packages) a USB Type-C™ charger (5 V, 3 A) (not delivered in the packages)
MicroSD card	Populated with OpenSTLinux distribution (Linux software), and providing extra storage capacity. A 2-Gbyte minimum microSD card is needed.
USB micro-B cable	In order to connect the STM32MP157x-DKx Discovery kit to the PC through the USB micro-B (ST-LINK/V2-1) connector
USB Type-C™ cable	In order to connect the STM32MP157x-DKx Discovery kit to an USB OTG device through the USB Type-C™ connector

Optional

USB keyboard and mouse	Thanks to the USB type A connectors, the STM32MP157x-DKx Discovery kit can be equipped with a full-size keyboard and mouse
Ethernet cable	In order to connect the STM32MP157x-DKx Discovery kit to a network through the RJ45 connector
HDMI cable	In order to connect the STM32MP157x-DKx Discovery kit to an HDMI monitor (or TV) through the HDMI connector

Optional, more devices and extension boards might be plugged to the STM32MP157x-DKx Discovery kit thanks to expansion connectors such as:

• the GPIO expansion connector
• the Arduino Uno connector
• ...

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

Recommended material for this Starter Package

4. Assembling the board

The STM32MP157x-DKx Discovery kits packages (STM32MP157A-DK1 and STM32MP157C-DK2) are delivered assembled, and contain the items listed below. A USB Type-C^™ cable is also included.

Please note that;

• the STM32MP157A-DK1 Discovery kit neither includes the "WLAN + Bluetooth" component (muRata LBEE5KL1DX), nor the MB1407 daughterboard DSI display
• the STM32MP157C-DK2 Discovery kit includes the "WLAN + Bluetooth" component (muRata LBEE5KL1DX), and the MB1407 daughterboard DSI display

Position	Description
1	MB1272 motherboard ("WLAN + Bluetooth" component included only for the STM32MP157C-DK2 Discovery kit)
2	MB1407 daughterboard DSI display (480x800 pixels): only for the STM32MP157C-DK2 Discovery kit
3	microSD card

STM32MP157x-DKx Discovery kit assembled
STM32MP157C-DK2 shown here (picture not contractual)
(for the STM32MP157A-DK1, the element 2 is not present)

5. Installing the tools

5.1. Installing the STM32CubeProgrammer tool

	STM32CubeProgrammer for Linux® host PC	STM32CubeProgrammer for Windows® host PC
Download	Version 2.4.0 To access the SetupSTM32CubeProgrammer link and follow instructions to download the package, you need a myST account. 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.4.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

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

6.1. Image download

• The STM32MP1 image (binaries) is delivered through one tarball file named
  • en.FLASH-stm32mp1-openstlinux-20-02-19.tar.xz for STM32MP157C-EV1 and STM32MP157X-DKX boards

• 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 (SLA). The detailed content licenses can be found here.

Warning

To download a package, it is recommended to be logged in to your "myst" account [1]. If, trying to download, you encounter a “403 error”, you could try to empty your browser cache to workaround the problem. We are working on the resolution of this problem. We apologize for this inconvenience

	STM32MP1 Starter Package image - STM32MP15-Ecosystem-v1.2.0 release
Download	You need to be logged on to my.st.com before accessing the following link: en.FLASH-stm32mp1-openstlinux-20-02-19.tar.xz
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 en.FLASH-stm32mp1-openstlinux-20-02-19.tar.xz
Release note	Details of the content of this software package are available in the associated STM32MP15 ecosystem 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>/openstlinux-20-02-19/images/stm32mp1/ directory:

stm32mp1
├── flashlayout_st-image-weston                                 Flash layout files (description of the partitions) for the supported Flash devices and boards
│   ├── FlashLayout_sdcard_stm32mp157a-dk1-basic.tsv            Flash layout file for microSD card and basic boot chain → STM32MP15 Discovery kits
│   ├── FlashLayout_sdcard_stm32mp157a-dk1-extensible.tsv       Flash layout file for microSD card with no userfs partition but a rootfs partition extended to sdcard size (recommended setup for package repository service) → STM32MP157A-DK1
│   ├── FlashLayout_sdcard_stm32mp157a-dk1-optee.tsv            Flash layout file for microSD card and optee boot chain → STM32MP15 Discovery kits
│   ├── FlashLayout_sdcard_stm32mp157a-dk1-trusted.tsv          Flash layout file for microSD card and trusted boot chain (recommended setup) → STM32MP15 Discovery kits
│   ├── FlashLayout_sdcard_stm32mp157c-dk2-basic.tsv            Flash layout file for microSD card and basic boot chain → STM32MP15 Discovery kits
│   ├── FlashLayout_sdcard_stm32mp157c-dk2-extensible.tsv       Flash layout file for microSD card with no userfs partition but a rootfs partition extended to sdcard size (recommended setup for package repository service) → STM32MP157C-DK2
│   ├── FlashLayout_sdcard_stm32mp157c-dk2-optee.tsv            Flash layout file for microSD card and optee boot chain → STM32MP15 Discovery kits
│   ├── FlashLayout_sdcard_stm32mp157c-dk2-trusted.tsv          Flash layout file for microSD card and trusted boot chain (recommended setup) → STM32MP15 Discovery kits
│   ├── FlashLayout_emmc_stm32mp157c-ev1-optee.tsv              Flash layout file for eMMC and optee boot chain → STM32MP15 Evaluation boards
│   ├── FlashLayout_emmc_stm32mp157c-ev1-trusted.tsv            Flash layout file for eMMC and trusted boot chain → STM32MP15 Evaluation boards
│   ├── FlashLayout_nand-4-256_stm32mp157c-ev1-optee.tsv        Flash layout file for NAND Flash and optee boot chain → STM32MP15 Evaluation boards
│   ├── FlashLayout_nand-4-256_stm32mp157c-ev1-trusted.tsv      Flash layout file for NAND Flash and trusted boot chain → STM32MP15 Evaluation boards
│   ├── FlashLayout_nor-emmc_stm32mp157c-ev1-optee.tsv          Flash layout file for NOR Flash (and eMMC) and optee boot chain → STM32MP15 Evaluation boards
│   ├── FlashLayout_nor-emmc_stm32mp157c-ev1-trusted.tsv        Flash layout file for NOR Flash (and eMMC) and trusted boot chain → STM32MP15 Evaluation boards
│   ├── FlashLayout_nor-nand-4-256_stm32mp157c-ev1-optee.tsv    Flash layout file for NOR Flash (and NAND Flasdh) and optee boot chain → STM32MP15 Evaluation boards
│   ├── FlashLayout_nor-nand-4-256_stm32mp157c-ev1-trusted.tsv  Flash layout file for NOR Flash (and NAND Flasdh) and trusted boot chain → STM32MP15 Evaluation boards
│   ├── FlashLayout_nor-sdcard_stm32mp157c-ev1-optee.tsv        Flash layout file for NOR Flash (and microSD card) and optee boot chain → STM32MP15 Evaluation boards
│   ├── FlashLayout_nor-sdcard_stm32mp157c-ev1-trusted.tsv      Flash layout file for NOR Flash (and microSD card) and trusted boot chain → STM32MP15 Evaluation boards
│   ├── FlashLayout_sdcard_stm32mp157c-ev1-basic.tsv            Flash layout file for microSD card and basic boot chain → STM32MP15 Evaluation boards
│   ├── FlashLayout_sdcard_stm32mp157c-ev1-optee.tsv            Flash layout file for microSD card and optee boot chain → STM32MP15 Evaluation boards
│   └── FlashLayout_sdcard_stm32mp157c-ev1-trusted.tsv          Flash layout file for microSD card and trusted boot chain (recommended setup) → STM32MP15 Evaluation boards
├── scripts
│   └── create_sdcard_from_flashlayout.sh
├── st-image-bootfs-openstlinux-weston-stm32mp1.ext4            Binary for bootfs partition
├── st-image-bootfs-openstlinux-weston-stm32mp1.manifest
├── st-image-userfs-openstlinux-weston-stm32mp1.ext4            Binary for userfs partition
├── st-image-userfs-openstlinux-weston-stm32mp1.manifest
├── st-image-vendorfs-openstlinux-weston-stm32mp1.ext4          Binary for vendorfs partition
├── st-image-vendorfs-openstlinux-weston-stm32mp1.manifest
├── st-image-weston-openstlinux-weston-stm32mp1.ext4            Binary for rootfs partition
├── st-image-weston-openstlinux-weston-stm32mp1.license
├── st-image-weston-openstlinux-weston-stm32mp1-license_content.html
├── st-image-weston-openstlinux-weston-stm32mp1.manifest
├── st-image-weston-openstlinux-weston-stm32mp1_nand_4_256_multivolume.ubi
├── tee-header_v2-stm32mp157a-dk1-optee.stm32
├── tee-header_v2-stm32mp157c-dk2-optee.stm32
├── tee-header_v2-stm32mp157c-ev1-optee.stm32
├── tee-pageable_v2-stm32mp157a-dk1-optee.stm32
├── tee-pageable_v2-stm32mp157c-dk2-optee.stm32
├── tee-pageable_v2-stm32mp157c-ev1-optee.stm32
├── tee-pager_v2-stm32mp157a-dk1-optee.stm32
├── tee-pager_v2-stm32mp157c-dk2-optee.stm32
├── tee-pager_v2-stm32mp157c-ev1-optee.stm32
├── tf-a-stm32mp157a-dk1-optee.stm32                            TF-A binary for FSBL partition (optee boot chain) → STM32MP15 Discovery kits
├── tf-a-stm32mp157a-dk1-trusted.stm32                          TF-A binary for FSBL partition (trusted boot chain) → STM32MP15 Discovery kits
├── tf-a-stm32mp157c-dk2-optee.stm32                            TF-A binary for FSBL partition (optee boot chain) → STM32MP15 Discovery kits
├── tf-a-stm32mp157c-dk2-trusted.stm32                          TF-A binary for FSBL partition (trusted boot chain) → STM32MP15 Discovery kits
├── tf-a-stm32mp157c-ev1-optee.stm32                            TF-A binary for FSBL partition (optee boot chain) → STM32MP15 Evaluation boards
├── tf-a-stm32mp157c-ev1-trusted.stm32                          TF-A binary for FSBL partition (trusted boot chain) → STM32MP15 Evaluation boards
├── u-boot-spl.stm32-stm32mp157a-dk1-basic                      U-Boot binary for FSBL partition (basic boot chain) → STM32MP15 Discovery kits
├── u-boot-spl.stm32-stm32mp157c-dk2-basic                      U-Boot binary for FSBL partition (basic boot chain) → STM32MP15 Discovery kits
├── u-boot-spl.stm32-stm32mp157c-ev1-basic                      U-Boot binary for FSBL partition (basic boot chain) → STM32MP15 Evaluation boards
├── u-boot-stm32mp157a-dk1-basic.img                            U-Boot binary for SSBL partition (basic boot chain) → STM32MP15 Discovery kits
├── u-boot-stm32mp157a-dk1-trusted.stm32                        U-Boot binary for SSBL partition (trusted boot chain) → STM32MP15 Discovery kits
├── u-boot-stm32mp157a-dk1-optee.stm32                          U-Boot binary for SSBL partition (optee boot chain) → STM32MP15 Discovery kits
├── u-boot-stm32mp157c-dk2-basic.img                            U-Boot binary for SSBL partition (basic boot chain) → STM32MP15 Discovery kits
├── u-boot-stm32mp157c-dk2-trusted.stm32                        U-Boot binary for SSBL partition (trusted boot chain) → STM32MP15 Discovery kits
├── u-boot-stm32mp157c-dk2-optee.stm32                          U-Boot binary for SSBL partition (optee boot chain) → STM32MP15 Discovery kits
├── u-boot-stm32mp157c-ev1-basic.img                            U-Boot binary for SSBL partition (basic boot chain) → STM32MP15 Evaluation boards
├── u-boot-stm32mp157c-ev1-trusted.stm32                        U-Boot binary for SSBL partition (trusted boot chain) → STM32MP15 Evaluation boards
└── u-boot-stm32mp157c-ev1-optee.stm32                          U-Boot binary for SSBL partition (optee boot chain) → STM32MP15 Evaluation boards

6.2. Image flashing

The STM32CubeProgrammer tool is used to flash the STM32MP157x-DKx 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 chains overview, the trusted boot chain is the default solution delivered by STMicroelectronics. Thus, the steps below use the image for the trusted boot chain.

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

• Set the boot switches (1) to the off position
• Connect the USB Type-C^™ (OTG) port (2) to the host PC that contains the downloaded image
• Insert the delivered microSD card into the dedicated slot (3)
• Connect the delivered power supply to the USB Type-C^™ port (4)
• Press the reset button (5) to reset the board

Discovery kit connections for flashing
STM32MP157C-DK2 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>/stm32mp1-openstlinux-4.19-thud-mp1-19-10-09/images/stm32mp1

If you have followed the the proposition to organize the working directory, the command is
  cd Starter-Package/stm32mp1-openstlinux-4.19-thud-mp1-19-10-09/images/stm32mp1

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/FlashLayout_sdcard_stm32mp157c-dk2-trusted.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.

      -------------------------------------------------------------------
                        STM32CubeProgrammer <tool version>
      -------------------------------------------------------------------



USB speed              : High Speed (480MBit/s)
Manufacturer ID        : STMicroelectronics
Product ID             : DFU in HS Mode @Device ID /0x500, @Revision ID /0x0000
Serial number          : 000000000000
Firmware version       : 0x011a
Device ID              : 0x0500
 
   AREA NAME          SECT.NBR        PARTITION.ID    SIZE         TYPE
 
 
   Partition0           0000          0x00000000      0256 KB      RW

   SECBL                0000          0x00000001      0001 MB      RW

   Partition2           0000          0x00000002      0001 MB      RW

   Partition3           0000          0x00000003      0256 KB      RW

   Partition4           0000          0x00000004      0016 MB      RW

   virtual              0000          0x000000f1      0512 B       R

Device name : STM32MPxxx
Device type : MPU
Device CPU  : Cortex-A7


Start Embedded Flashing service



Memory Programming ...
Opening and parsing file: tf-a-stm32mp157c-dk2-trusted.stm32
  File          : tf-a-stm32mp157c-dk2-trusted.stm32
  Size          : 228536 Bytes
  Partition ID  : 0x01 

Download in Progress:
[==================================================] 100% 

File download complete
Time elapsed during the download operation is: 00:00:00.561

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

Flashlayout Programming ...
[==================================================] 100% 
Running Flashlayout Partition ...
Flashlayout partition started successfully


Memory Programming ...
Opening and parsing file: u-boot-stm32mp157c-dk2-trusted.stm32
  File          : u-boot-stm32mp157c-dk2-trusted.stm32
  Size          : 722945 Bytes
  Partition ID  : 0x03 

Download in Progress:
[==================================================] 100% 

File download complete
Time elapsed during the download operation is: 00:00:00.665

RUNNING Program ... 
  PartID:      :0x03 

reconnecting the device ...

USB speed              : High Speed (480MBit/s)
Manufacturer ID        : STMicroelectronics
Product ID             : USB download gadget@Device ID /0x500, @Revision ID /0x0000
Serial number          : 0000000000
Firmware version       : 0x0110
Device ID              : 0x0500
 
   AREA NAME          SECT.NBR        PARTITION.ID    SIZE         TYPE
 
 
   fsbl1                0000          0x00000001      0256 KB      RW

   fsbl2                0000          0x00000002      0256 KB      RW

   ssbl                 0000          0x00000003      0002 MB      RW

   bootfs               0000          0x00000011      0064 MB      RW

   rootfs               0000          0x00000012      0768 MB      RW

   userfs               0000          0x00000013      6846 MB      RW

   virtual              0000          0x000000f1      0512 B       RW

   OTP                  0000          0x000000f2      0512 B       RW

   PMIC                 0000          0x000000f4      0008 B       RW

Start operation done successfully at partition 0x03


Memory Programming ...
Opening and parsing file: tf-a-stm32mp157c-dk2-trusted.stm32
  File          : tf-a-stm32mp157c-dk2-trusted.stm32
  Size          : 228536 Bytes
  Partition ID  : 0x01 

Download in Progress:
[==================================================] 100% 

File download complete
Time elapsed during the download operation is: 00:00:00.097

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


Memory Programming ...
Opening and parsing file: tf-a-stm32mp157c-dk2-trusted.stm32
  File          : tf-a-stm32mp157c-dk2-trusted.stm32
  Size          : 228536 Bytes
  Partition ID  : 0x02 

Download in Progress:
[==================================================] 100% 

File download complete
Time elapsed during the download operation is: 00:00:00.107

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


Memory Programming ...
Opening and parsing file: u-boot-stm32mp157c-dk2-trusted.stm32
  File          : u-boot-stm32mp157c-dk2-trusted.stm32
  Size          : 722945 Bytes
  Partition ID  : 0x03 

Download in Progress:
[==================================================] 100% 

File download complete
Time elapsed during the download operation is: 00:00:00.326

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


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

Download in Progress:
[==================================================] 100% 

File download complete
Time elapsed during the download operation is: 00:00:32.392

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


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

Download in Progress:
[==================================================] 100% 

File download complete
Time elapsed during the download operation is: 00:04:06.544

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


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

Download in Progress:
[==================================================] 100% 

File download complete
Time elapsed during the download operation is: 00:00:32.095

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

Now that the image is flashed on the STM32MP157x-DKx Discovery kit, let's finalize the system configuration:

• Step 1: check the configuration of the switches
  • The figure below shows the position of the boot switches in order 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 (3 and 4)

• Step 3: (optional) connect an Ethernet cable (not provided) to the dedicated connector (7)

STM32MP157x-DKx Discovery kit connections

STM32MP157C-DK2 shown here without the MB1407 daughterboard DSI display to avoid hiding the connections (picture is not contractual)

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

• 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 (5) to a host PC that runs a Terminal program with ST-LINK/V2-1 virtual port (e.g. Minicom on Ubuntu Linux PC or Tera Term on Windows PC)
  • install and configure a remote Terminal program onto your host PC

• Step 7: (optional) connect a HDMI monitor (or TV) to the HDMI connector. This option is particularly useful for the STM32MP157A-DK1 Discovery kit that does not include any DSI display daughterboard

• Step 8: press the reset button (6) to reset the board

The board boots and the system will be available after few seconds.

8. Checking the boot sequence

Assuming you have performed the optional step 6 above, the information (coming successively from the U-Boot and the Linux operating system that is booting on the board), should be displayed on the host PC Terminal.

Information

The information displayed below might differ from that on your own application, and should just be considered an example.

First information scrolled on the remote Terminal during boot

Last information scrolled on the remote Terminal during boot

In parallel, a U-Boot splash screen picture is displayed on the DSI display (if one is connected to the board).

A user space graphical boot splash screen (PSplash) picture is then briefly displayed on the HDMI monitor if one is connected to the board, or otherwise on the DSI display (if one is connected to the board).

When the boot process is complete, the launcher application is shown on the HDMI monitor if one is connected to the board, or otherwise on the DSI display (if one is connected to the board).

launcher application layer shown on the HDMI monitor or on the DSI display

More detail about this launcher application in GTK demo launcher page.

9. Mouse, keyboard and Ethernet hot-plugs

Let's assume that the optional step 2 and step 3 were not achieved when setting up the system above.

When connecting a USB mouse, the following information is displayed by the Terminal program:

[  926.786326] usb 2-1.1: new low-speed USB device number 3 using ehci-platform
[  926.961413] input: Logitech Optical USB Mouse as /devices/platform/soc/5800d000.usbh-ehci/usb2/2-1/2-1.1/2-1.1:1.0/0003:046D:C016.0001/input/input2
[  926.975098] hid-generic 0003:046D:C016.0001: input: USB HID v1.10 Mouse [Logitech Optical USB Mouse] on usb-5800d000.usbh-ehci-1.1/input0

When connecting a USB keyboard, the following information is displayed by the Terminal program:

[ 1009.026567] usb 2-1.3: new low-speed USB device number 4 using ehci-platform
[ 1009.193990] input: Dell Dell USB Keyboard as /devices/platform/soc/5800d000.usbh-ehci/usb2/2-1/2-1.3/2-1.3:1.0/0003:413C:2003.0002/input/input3
[ 1009.280101] hid-generic 0003:413C:2003.0002: input: USB HID v1.10 Keyboard [Dell Dell USB Keyboard] on usb-5800d000.usbh-ehci-1.3/input0

When connecting an Ethernet cable, the following information is displayed by the Terminal program:

[ 1215.356377] stm32-dwmac 5800a000.ethernet eth0: Link is Up - 1Gbps/Full - flow control rx/tx
[ 1215.363377] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready
[ 1215.391068] Link is Up - 1000/Half

10. Remote and local Terminal programs

As already explained in the step 6 above, a remote Terminal program can be installed and configured on your host PC in order to communicate with the board through a serial link or an Ethernet link: see How to get Terminal.

The remote Terminal on your host PC can be used to enter command lines, as shown below with the ifconfig command to query the network interface parameters:

Example of command (ifconfig) executed on the remote Terminal program

A local Terminal program can be launched directly on the board. Click on the small icon at the top left corner of the display (see the red arrow on the figure below):

Icon to launch a local Terminal program

Wayland Terminal program

Then the on-board Wayland Terminal can be used to directly enter command lines as shown below, still with the ip addr command to query the network interface parameters:

Example of command (ip addr) executed on the Wayland Terminal program

Consequently, unless an explicit restriction is mentioned, command lines can be run from both Terminals.

Note: in this article, any command executed on the board (through the remote Terminal or the Wayland Terminal) starts with , while any command executed on the host PC starts with .

11. Executing basic commands

Information

The outputs of the commands executed below are examples; the outputs obtained might differ.

11.1. Having a look at the OpenSTLinux directory structure

The directory structure and directory contents in the OpenSTLinux distribution is standard. Some details are available in the OpenSTLinux directory structure article.

11.2. Identifying the software running on board

Information

Obviously, what you obtain might differ from what is displayed on the Output example column.

For ecosystem release v1.2.0

Software	How to get its version	Output example
TF-A	TF-A Version number	NOTICE: BL2: v2.0-r3.0(debug):v2.0-r3.0
U-Boot	See the version displayed in the console	U-Boot 2018.11-stm32mp-r4 [...]
Linux kernel	cat /proc/version	Linux version 4.19.94 (xxxx@yyyy) (gcc version 8.2.0 (GCC)) [...]
GCC	cat /proc/version	Linux version 4.19.94 (xxxx@yyyy) (gcc version 8.2.0 (GCC)) [...]
Yocto Project	lsb_release -c	Codename: thud
Weston	weston --version	weston 5.0.0
GStreamer	gst-play-1.0 --version	GStreamer 1.14.4
GPU	cat /sys/kernel/debug/gc/version	6.2.4.p4.190076 built [...]

For ecosystem release v1.1.0

Software	How to get its version	Output example
TF-A	TF-A Version number	NOTICE: BL2: v2.0-r1.5(debug):v2.0-r1.5
U-Boot	See the version displayed in the console	U-Boot 2018.11-stm32mp-r3 [...]
Linux kernel	cat /proc/version	Linux version 4.19.49 (xxxx@yyyy) (gcc version 8.2.0 (GCC)) [...]
GCC	cat /proc/version	Linux version 4.19.49 (xxxx@yyyy) (gcc version 8.2.0 (GCC)) [...]
Yocto Project	lsb_release -c	Codename: thud
Weston	weston --version	weston 5.0.0
GStreamer	gst-play-1.0 --version	GStreamer 1.14.4
GPU	cat /sys/kernel/debug/gc/version	6.2.4.p4.190076 built [...]

For ecosystem release v1.0.0

Software	How to get its version	Output example
TF-A	TF-A Version number	NOTICE: BL2: v2.0(debug):v2.0-dirty
U-Boot	See the version displayed in the console	U-Boot 2018.11-stm32mp-r2 [...]
Linux kernel	cat /proc/version	Linux version 4.19.9 (xxxx@yyyy) (gcc version 8.2.0 (GCC)) [...]
GCC	cat /proc/version	Linux version 4.19.9 (xxxx@yyyy) (gcc version 8.2.0 (GCC)) [...]
Yocto Project	lsb_release -c	Codename: thud
Weston	weston --version	weston 5.0.0
GStreamer	gst-play-1.0 --version	GStreamer 1.14.2
GPU	cat /sys/kernel/debug/gc/version	6.2.4.p3.174315 built [...]

11.3. Configuration tips

• Configure the keyboard layout (qwerty, azerty...)

11.4. Getting board IP address

Prerequisite: your board is connected to your local network through the Ethernet connector (see step 3).

• Get the IP address of your board with the ip Linux command line (recommended method):

 ip addr show eth0                                                                           
3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
    inet xx.xx.xx.xx/xx brd xx.xx.xx.xx scope global dynamic eth0
       valid_lft 159045sec preferred_lft 159045sec
    inet6 xxxx::xx:xx:xx:xx/xx scope link 
       valid_lft forever preferred_lft forever

• Get the IP address of your board with the ifconfig Linux command line (a deprecated but well-known command):

 ifconfig eth0
eth0      Link encap:Ethernet  HWaddr xx:xx:xx:xx:xx:xx
          inet addr:xx.xx.xx.xx  Bcast:xx.xx.xx.xx  Mask:255.255.252.0
          inet6 addr: xxxx::xx:xx:xx:xx/xx Scope:Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:2619 errors:0 dropped:0 overruns:0 frame:0
          TX packets:1311 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000
          RX bytes:353250 (344.9 KiB)  TX bytes:118305 (115.5 KiB)
          Interrupt:247

11.5. Copying a file from your host PC to your board (and reciprocally)

• How to transfer a file over network (recommended method)

• How to transfer a file over serial console

11.6. Miscellaneous commands

Information

The outputs of the commands executed below are examples; the outputs that you obtain might differ.

11.6.1. Printing distribution specific information

 lsb_release -a
LSB Version:    core-5.0-noarch:core-5.0-arm
Distributor ID: openstlinux-weston
Description:    ST OpenSTLinux - Weston - (A Yocto Project Based Distro) 2.6-...
Release:        2.6...
Codename:       thud

Where:

LSB Version	Version of LSB (Linux Standard Base) against which distribution is compliant
Distributor ID	String identifier of distributor
Description	Single line text description of distribution
Release	Release number of distribution
Codename	Codename according to distribution release

11.6.2. Printing system information

 uname -a
Linux stm32mp1 4.19.49 #1 SMP PREEMPT Sun Jun 9 07:17:25 UTC 2019 armv7l armv7l  armv7l GNU/Linux

Where:

Linux	Kernel name
stm32mp1	Network node hostname
4.19.49	Kernel release
#1 SMP PREEMPT Sun Jun 9 07:17:25 UTC 2019	Kernel version
armv7l	Machine hardware name
GNU/Linux	Operating system

11.6.3. Printing Linux kernel and GCC versions

 cat /proc/version
Linux version 4.19.49 (xxxx@yyyy) (gcc version 8.2.0 (GCC)) #1 SMP PREEMPT Sun Jun 9 07:17:25 UTC 2019

Where:

Linux	Kernel name
version 4.19.49	Kernel release
(xxxx@yyyy)	Person (xxxx) who compiled the kernel, and machine (yyyy) where it happened
(gcc version 8.2.0 (GCC) )	Version of the GCC compiler used to compile the kernel
#1 SMP PREEMPT Sun Jun 9 07:17:25 UTC 2019	Kernel version; type of kernel (SMP) and date and time of the kernel compilation

11.6.4. Printing the amount of disk space available on all mounted file systems

 df -h
Filesystem      Size  Used Avail Use% Mounted on
/dev/root       719M  342M  339M  51% /
devtmpfs        372M     0  372M   0% /dev
tmpfs           436M     0  436M   0% /dev/shm
tmpfs           436M   14M  423M   4% /run
tmpfs           436M     0  436M   0% /sys/fs/cgroup
tmpfs           436M  4.0K  436M   1% /tmp
/dev/mmcblk0p4   58M  8.2M   46M  16% /boot
/dev/mmcblk0p7  6.4G   68M  6.1G   2% /usr/local
tmpfs           436M  128K  436M   1% /var/volatile
/dev/mmcblk0p5   15M  8.2M  5.3M  61% /vendor
tmpfs            88M     0   88M   0% /run/user/0

Where:

Filesystem	Source of the mount point, usually a device
Size	Total size in human readable format (e.g. 1K, 234M, 2G)
Used	Used size in human readable format
Available	Available size in human readable format
Use%	Percentage of used size divided by the total size
Mounted on	Mount point

Note: the user file system (userfs) and the boot file system (bootfs) are accessible respectively through the /usr/local mounting point, and the /boot mounting point (see Flash partitions for a description of the file systems).

12. Examples

12.1. Examples running on Cortex-A7

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)

12.2. Examples running on Cortex-M4

Please read STM32CubeMP1 Package article.

13. Fast links to essential commands

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

14. How to go further?

Now that the image is flashed on the STM32MP157x-DKx 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.

Microprocessor Unit

Display Serial Interface (MIPI^® Alliance standard)

USB port or connector

USB On-The-Go (Capability/type of USB port, acting primarily as USB device, to also act as USB host. Also known as USB OTG.)

High-Definition Multimedia Interface (HDMI standard)

General-Purpose Input/Output (A realization of open ended transmission between devices on an embedded level. These pins available on a processor can be programmed to be used to either accept input or provide output to external devices depending on user desires and applications requirements.)

Device Firmware Upgrade

Universal Asynchronous Receiver/Transmitter

Operating System

Flash memory shortened to gain space in titles, tables and block diagrams

former spelling for e•MMC ('e' in italic)

Trusted Firmware for Arm Cortex-A

First Stage Boot Loader

Das U-Boot -- the Universal Boot Loader (see U-Boot_overview)

Second Stage Boot Loader

Flash memories combine high density and cost effectiveness of EPROMs with the electrical erasability of EEPROMs. For this reason, the Flash memory market is one of the most exciting areas of the semiconductor industry today and new applications requiring in system reprogramming, such as cellular telephones, automotive engine management systems, hard disk drives, PC BIOS software for Plug & Play, digital TV, set top boxes, fax and other modems, PC cards and multimedia CD-ROMs, offer the prospect of very high volume demand.

High Speed (MIPI^® Alliance DSI standard)

Central processing unit

One Time Programmed

Power Management Integrated Circuit

Human Interface Device (for USB, Bluetooth...)

Boot Loader stage 2

Graphics Processing Units

uniprocessor

Receive

Transmit

symetric multiprocessing

Microprocessor Unit

Display Serial Interface (MIPI^® Alliance standard)

USB port or connector

USB On-The-Go (Capability/type of USB port, acting primarily as USB device, to also act as USB host. Also known as USB OTG.)

High-Definition Multimedia Interface (HDMI standard)

General-Purpose Input/Output (A realization of open ended transmission between devices on an embedded level. These pins available on a processor can be programmed to be used to either accept input or provide output to external devices depending on user desires and applications requirements.)

Device Firmware Upgrade

Universal Asynchronous Receiver/Transmitter

Operating System

Flash memory shortened to gain space in titles, tables and block diagrams

former spelling for e•MMC ('e' in italic)

Trusted Firmware for Arm Cortex-A

First Stage Boot Loader

Das U-Boot -- the Universal Boot Loader (see U-Boot_overview)

Second Stage Boot Loader

Flash memories combine high density and cost effectiveness of EPROMs with the electrical erasability of EEPROMs. For this reason, the Flash memory market is one of the most exciting areas of the semiconductor industry today and new applications requiring in system reprogramming, such as cellular telephones, automotive engine management systems, hard disk drives, PC BIOS software for Plug & Play, digital TV, set top boxes, fax and other modems, PC cards and multimedia CD-ROMs, offer the prospect of very high volume demand.

High Speed (MIPI^® Alliance DSI standard)

Central processing unit

One Time Programmed

Power Management Integrated Circuit

Human Interface Device (for USB, Bluetooth...)

Boot Loader stage 2

Graphics Processing Units

uniprocessor

Receive

Transmit

symetric multiprocessing

Mobile Industry Processor Interface, open membership organization that includes leading companies in the mobile industry that share the objective of defining and promoting open specifications for interfaces inside mobile terminals, see MIPI^® Alliance standard web site https://www.mipi.org

Capability/type of USB port, acting primarily as USB device, to also act as USB host. Also known as USB OTG.

MultimediaCard