Revision as of 18:09, 20 June 2024 by Registered User
1. Overview[edit source]
This step explains how to get the Starter Package, then install and boot the STM32MP25 Evaluation boards with the Starter Package.
2. Open a terminal[edit source]
Open a terminal on the host computer.
Ubuntu terminal
All the commands preceded by have to be executed from the host computer terminal.
- Create your STM32MPU workspace directory on the host computer:
mkdir $HOME/STM32MPU_workspace cd $HOME/STM32MPU_workspace
3. Check the host computer Internet access[edit source]
- An Internet access through http and https protocols must be provided.
The command below enables checking for Internet access through http/https protocols:
wget -q www.google.com && echo "Internet access over HTTP/HTTPS is OK !" || echo "No internet access over HTTP/HTTPS ! You may need to set up a proxy."
If an 'OK' message is returned, the network is correctly configured.
In this case, skip the rest of this section.
Otherwise, a proxy for http/https protocols is required.
The best solution is to set this proxy through the shell variables http_proxy and https_proxy:
export http_proxy=http://<MyProxyLogin>:<MyProxyPassword>@<MyProxyServerUrl>:<MyProxyPort> export https_proxy=http://<MyProxyLogin>:<MyProxyPassword>@<MyProxyServerUrl>:<MyProxyPort>
Check again the Internet access using the command:
wget -q www.google.com && echo "Internet access over HTTP/HTTPS is OK !" || echo "No internet access over HTTP/HTTPS ! You may need to set up a proxy."
4. Install the tools[edit source]
4.1. STM32CubeProgrammer[edit source]
- Create your "STM32MPU tools" directory on the host computer:
mkdir $HOME/STM32MPU_workspace/STM32MPU-Tools mkdir $HOME/STM32MPU_workspace/STM32MPU-Tools/STM32CubeProgrammer-x.y.z
- Create a temporary directory in your STM32MPU workspace:
mkdir $HOME/STM32MPU_workspace/tmp cd $HOME/STM32MPU_workspace/tmp
4.2. Installing the STM32CubeProgrammer tool[edit source]
| STM32CubeProgrammer for Linux® host PC | STM32CubeProgrammer for Windows® host PC | |
|---|---|---|
| Download |
Version v2.17.0
| |
| Installation |
$> ./SetupSTM32CubeProgrammer-2.17.0.linux
$> export PATH=<my STM32CubeProgrammer install directory>/bin:$PATH
$> ln -s <my STM32CubeProgrammer install directory>/bin/STM32_Programmer_CLI /home/bin/STM32_Programmer_CLI |
|
| User manual |
| |
| Detailed release note |
| |
4.3. 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.
5. Test[edit source]
- Check that the STM32CubeProgrammer tool is properly installed and accessible:
STM32_Programmer_CLI --h
-------------------------------------------------------------------
STM32CubeProgrammer vx.y.z
-------------------------------------------------------------------
6. Download the image[edit source]
- The STM32MP2 image (binaries) is delivered through one tarball file named
- en.flash-stm32mp2-openstlinux-6.1-yocto-mickledore-mpu-v24.06.26.tar.gz for STM32MP257x-DK
and STM32MP257x-EV1 
- en.flash-stm32mp2-openstlinux-6.1-yocto-mickledore-mpu-v24.06.26.tar.gz for STM32MP257x-DK
- Download and install the STM32MP2 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.
| STM32MP2 Starter Package image - STM32MP2-Ecosystem-v5.1.0 release | |
|---|---|
| Download |
|
| Installation |
cd <working directory path>/Starter-Package
tar xvf en.flash-stm32mp2-openstlinux-6.1-yocto-mickledore-mpu-v24.06.26.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 - The binaries and the Flash layout files are in the <Starter Package installation directory>/stm32mp2-openstlinux-6.1-yocto-mickledore-mpu-v24.06.26/images/stm32mp2/ directory. The most important ones are:
stm32mp2 ├── 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-stm32mp257f-dk-ca35tdcid-ostl-optee-emmc.stm32 TF-A binary for FSBL partition (eMMC boot device) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── tf-a-stm32mp257f-dk-ca35tdcid-ostl-optee-sdcard.stm32 TF-A binary for FSBL partition (microSD card boot device) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── tf-a-stm32mp257f-dk-ca35tdcid-ostl-uart.stm32 TF-A binary for uart serial boot partition (STM32CubeProgrammer) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── tf-a-stm32mp257f-dk-ca35tdcid-ostl-usb.stm32 TF-A binary for usb serial boot partition (STM32CubeProgrammer) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── tf-a-stm32mp257f-dk-optee-emmc.stm32 TF-A binary for FSBL partition (eMMC boot device) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── tf-a-stm32mp257f-dk-optee-sdcard.stm32 TF-A binary for FSBL partition (microSD card boot device) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── tf-a-stm32mp257f-dk-uart.stm32 TF-A binary for uart serial boot partition (STM32CubeProgrammer) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── tf-a-stm32mp257f-dk-usb.stm32 TF-A binary for usb serial boot partition (STM32CubeProgrammer) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── tf-a-stm32mp257f-ev1-ca35tdcid-ostl-optee-emmc.stm32 TF-A binary for FSBL partition (eMMC boot device) for STM32MP257F-EV1 OSTL → STM32MP25 Evaluation boards │ ├── tf-a-stm32mp257f-ev1-ca35tdcid-ostl-optee-sdcard.stm32 TF-A binary for FSBL partition (microSD card boot device) for STM32MP257F-EV1 OSTL → STM32MP25 Evaluation boards │ ├── tf-a-stm32mp257f-ev1-ca35tdcid-ostl-uart.stm32 TF-A binary for uart serial boot partition (STM32CubeProgrammer) for STM32MP257F-EV1 OSTL → STM32MP25 Evaluation boards │ ├── tf-a-stm32mp257f-ev1-ca35tdcid-ostl-usb.stm32 TF-A binary for usb serial boot partition (STM32CubeProgrammer) for STM32MP257F-EV1 OSTL → STM32MP25 Evaluation boards │ ├── tf-a-stm32mp257f-ev1-optee-emmc.stm32 TF-A binary for FSBL partition (eMMC boot device) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── tf-a-stm32mp257f-ev1-optee-nor.stm32 TF-A binary for FSBL partition (NOR boot device) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── tf-a-stm32mp257f-ev1-optee-sdcard.stm32 TF-A binary for FSBL partition (microSD card boot device) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── tf-a-stm32mp257f-ev1-uart.stm32 TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── tf-a-stm32mp257f-ev1-usb.stm32 TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ └── [...] ├── fip FIP binaries for FIP partitions and supported boot chains │ ├── fip-stm32mp257f-dk-ca35tdcid-ostl-ddr-fastboot-emmc.bin FIP binary for FIP DDR partition (eMMC boot device for fastboot flashing) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-ca35tdcid-ostl-ddr-fastboot-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device for fastboot flashing) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-ca35tdcid-ostl-ddr-optee-emmc.bin FIP binary for FIP DDR partition (eMMC boot device) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-ca35tdcid-ostl-ddr-optee-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-ca35tdcid-ostl-fastboot-emmc.bin FIP binary for FIP partition (eMMC boot device for fastboot flashing) for STM32MP257F-DK → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-ca35tdcid-ostl-fastboot-sdcard.bin FIP binary for FIP partition (microSD card boot device for fastboot flashing) for STM32MP257F-DK OSTL→ STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-ca35tdcid-ostl-optee-emmc.bin FIP binary for FIP partition (eMMC boot device) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-ca35tdcid-ostl-optee-sdcard.bin FIP binary for FIP partition (microSD card boot device) for STM32MP257F-DK OSTL → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-ddr-fastboot-emmc.bin FIP binary for FIP DDR partition (eMMC boot device for fastboot flashing) for STM32MP257F-DK → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-ddr-fastboot-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device for fastboot flashing) for STM32MP257F-DK → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-ddr-optee-emmc.bin FIP binary for FIP DDR partition (eMMC boot device) for STM32MP257F-DK → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-ddr-optee-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device) for STM32MP257F-DK → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-fastboot-emmc.bin FIP binary for FIP DDR partition (eMMC boot device for fastboot flashing) for STM32MP257F-DK → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-fastboot-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device for fastboot flashing) for STM32MP257F-DK → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-optee-emmc.bin FIP binary for FIP DDR partition (eMMC boot device) for STM32MP257F-DK → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-dk-optee-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device) for STM32MP257F-DK → STM32MP25 Discovery boards │ ├── fip-stm32mp257f-ev1-ca35tdcid-ostl-ddr-fastboot-emmc.bin FIP binary for FIP DDR partition (eMMC boot device for fastboot flashing) for STM32MP257F-EV1 OSTL → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-ca35tdcid-ostl-ddr-fastboot-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device for fastboot flashing) for STM32MP257F-EV1 OSTL → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-ca35tdcid-ostl-ddr-optee-emmc.bin FIP binary for FIP DDR partition (eMMC boot device) for STM32MP257F-EV1 OSTL → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-ca35tdcid-ostl-ddr-optee-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device) for STM32MP257F-EV1 OSTL → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-ca35tdcid-ostl-fastboot-emmc.bin FIP binary for FIP partition (eMMC boot device for fastboot flashing) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-ca35tdcid-ostl-fastboot-sdcard.bin FIP binary for FIP partition (microSD card boot device for fastboot flashing) for STM32MP257F-EV1 OSTL→ STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-ca35tdcid-ostl-optee-emmc.bin FIP binary for FIP partition (eMMC boot device) for STM32MP257F-EV1 OSTL → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-ca35tdcid-ostl-optee-sdcard.bin FIP binary for FIP partition (microSD card boot device) for STM32MP257F-EV1 OSTL → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-ddr-fastboot-emmc.bin FIP binary for FIP DDR partition (eMMC boot device for fastboot flashing) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-ddr-fastboot-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device for fastboot flashing) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-ddr-optee-emmc.bin FIP binary for FIP DDR partition (eMMC boot device) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-ddr-optee-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-fastboot-emmc.bin FIP binary for FIP DDR partition (eMMC boot device for fastboot flashing) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-fastboot-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device for fastboot flashing) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-optee-emmc.bin FIP binary for FIP DDR partition (eMMC boot device) for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── fip-stm32mp257f-ev1-optee-sdcard.bin FIP binary for FIP DDR partition (microSD card boot device) for STM32MP257F-EV1 → STM32MP25 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_stm32mp257f-dk-extensible.tsv (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size for STM32MP257F-DK → STM32MP25 Discovery kits │ │ └── [...] │ ├── fastboot Flash layout files for flashing via fastboot │ │ ├── FlashLayout_emmc_stm32mp257f-dk-ca35tdcid-ostl-fastboot.tsv eMMC boot device for STM32MP257F-DK OSTL→ → STM32MP25 Discovery kits │ │ ├── FlashLayout_emmc_stm32mp257f-dk-fastboot.tsv eMMC boot device for STM32MP257F-DK → → STM32MP25 Discovery kits │ │ ├── FlashLayout_emmc_stm32mp257f-ev1-ca35tdcid-ostl-fastboot.tsv eMMC boot device for STM32MP257F-EV1 → → STM32MP25 Evaluation kits │ │ ├── FlashLayout_emmc_stm32mp257f-ev1-fastboot.tsv eMMC boot device for STM32MP257F-EV1 → → STM32MP25 Evaluation kits │ │ ├── FlashLayout_sdcard-EFI_stm32mp257f-dk-ca35tdcid-ostl-fastboot.tsv microSD card boot device with EFI for STM32MP257F-DK OSLT→ → STM32MP25 Discovery kits │ │ ├── FlashLayout_sdcard-EFI_stm32mp257f-dk-fastboot.tsv microSD card boot device with EFI for STM32MP257F-DK→ → STM32MP25 Discovery kits │ │ ├── FlashLayout_sdcard-EFI_stm32mp257f-ev1-ca35tdcid-ostl-fastboot.tsv microSD card boot device with EFI for STM32MP257F-EV1 OSLT→ → STM32MP25 Evaluation kits │ │ ├── FlashLayout_sdcard-EFI_stm32mp257f-ev1-fastboot.tsv microSD card boot device with EFI for STM32MP257F-EV1→ → STM32MP25 Evaluation kits │ │ ├── FlashLayout_sdcard_stm32mp257f-dk-ca35tdcid-ostl-fastboot.tsv microSD card boot device for STM32MP257F-DK OSLT→ → STM32MP25 Discovery kits │ │ ├── FlashLayout_sdcard_stm32mp257f-dk-fastboot.tsv microSD card boot device for STM32MP257F-DK→ → STM32MP25 Discovery kits │ │ ├── FlashLayout_sdcard_stm32mp257f-ev1-ca35tdcid-ostl-fastboot.tsv microSD card boot device for STM32MP257F-EV1 OSLT→ → STM32MP25 Evaluation kits │ │ ├── FlashLayout_sdcard_stm32mp257f-ev1-fastboot.tsv microSD card boot device for STM32MP257F-EV1→ → STM32MP25 Evaluation kits │ │ └── [...] │ └── optee Flash layout files for optee boot chain │ ├── FlashLayout_emmc_stm32mp257f-ev1-optee.tsv eMMC boot device for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── FlashLayout_nor-sdcard_stm32mp257f-ev1-optee.tsv NOR boot device and microSD card device for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ ├── FlashLayout_sdcard_stm32mp257f-ev1-optee.tsv microSD card boot device for STM32MP257F-EV1 → STM32MP25 Evaluation boards │ └── [...] ├── scripts │ └── create_sdcard_from_flashlayout.sh ├── st-image-bootfs-openstlinux-weston-stm32mp2.ext4 Binary for bootfs partition on eMMC and microSD card devices ├── st-image-bootfs-openstlinux-weston-stm32mp2.manifest ├── st-image-bootfs-efi-openstlinux-weston-stm32mp2.vfat Binary for bootfs for EFI partition on eMMC and microSD card devices ├── st-image-bootfs-efi-openstlinux-weston-stm32mp2.manifest ├── st-image-userfs-openstlinux-weston-stm32mp2.ext4 Binary for userfs partition on eMMC and microSD card devices ├── st-image-userfs-openstlinux-weston-stm32mp2.manifest ├── st-image-vendorfs-openstlinux-weston-stm32mp2.ext4 Binary for vendorfs partition on eMMC and microSD card devices ├── st-image-vendorfs-openstlinux-weston-stm32mp2.manifest ├── st-image-weston-openstlinux-weston-stm32mp2.ext4 Binary for rootfs partition on eMMC and microSD card devices ├── st-image-weston-openstlinux-weston-stm32mp2.license ├── st-image-weston-openstlinux-weston-stm32mp2-license_content.html License summary for all packages needed to feed all partitions ├── st-image-weston-openstlinux-weston-stm32mp2.manifest └── [...]
7. Populate the SDCard[edit source]
- Set the boot switches (located on the MB1936) to the OFF position:
- Connect the PC to CN15/USB_OTG port of the STM32MP257F-EV1 mother board through the USB Type A to Type C cable.
- Power up the board.
- Press the reset button to reset the board.
- Launch STM32CubeProgrammer to get the GUI :
- On the right of the window, select USB (instead of STLINK, set by default) from the connection picklist, and click the "Refresh" button. The serial number is displayed if the USB has been detected.
- Click "Connect"
- Select the "Open File" tab and choose the "FlashLayout_sdcard_stm32mp257f-ev1-ca35tdcid-ostl-m33-examples-optee.tsv" in the Starter Package installation folder ("$HOME/STM32MPU_workspace/STM32MPU-Ecosystem-v5.1.0/Starter-Package/stm32mp2-openstlinux-6.1-yocto-mickledore-mpu-v24.06.26/images/stm32mp2/flashlayout_st-image-weston/optee")
- Fill the "Binaries Path" by browsing to the $[Starter_Pack_Path]/images/stm32mp2 folder.
- Click "Download" to launch the flashing process.
- A progress bar indicates the process progress until a completion pop-up message is displayed.
8. Boot the board[edit source]
- Set the boot switches (located on the MB1936) to the microSD card boot position.
- Power on the board.
- Press the "Reset" button to reset the board.
- After few seconds, the board starts and automatically goes through the following screens:
