STM32MP25 U-Boot

Applicable for

This article briefly describes the STM32MP25x lines support in U-Boot.

1. STM32MP25x lines support[edit | edit source]

For detailed information, read the file in the delivered U-Boot code = doc/board/st/stm32mp2.rst or the documentation generated by make htlmdocs: board/st/stm32mp2.html.

Code:

arch/arm/mach-stm32mp : arch specific code for STM32 Arm^® Cortex^® MPUs
- arch/arm/mach-stm32mp/Kconfig : generic configuration for STM32 Arm^® Cortex^® MPUs
- arch/arm/mach-stm32mp/Kconfig.25x : specific configuration for STM32MP25x lines
board/st/common : STMicroelectronics common code
board/st/stm32mp2 : STMicroelectronics boards support for STM32MP2 series
drivers/*/*stm32* : drivers

Configuration files:

defconfig file
- configs/stm32mp25_defconfig
config files
- include/configs/stm32mp25_common.h : generic for STM32MP25x lines
- include/configs/stm32mp25_st_common.h : STMicroelectronics board for STM32MP25x lines
STM32_MPU_device_tree in arch/arm/dts : stm32mp25*.dts*
- <Device tree>.dts: same as kernel
- <Device tree>-u-boot.dtsi: addition for u-boot automatically included in build process
- stm32mp25-u-boot.dtsi : SoC add-on file included in <Device tree>-u-boot.dtsi

2. Selecting targets: choose defconfig and device tree[edit | edit source]

The U-Boot configuration with defconfig is stm32mp25_defconfig.

The boards are supported with the associated device tree (same name as kernel):

Board part number	Device tree	Description
STM32MP257F-DK Discovery kit	stm32mp257f-dk	MB1605
STM32MP257F-EV1 Evaluation board	stm32mp257f-ev1	MB1936

3. Compilation[edit | edit source]

see U-Boot_overview#U-Boot_build, with installed aarch64 cross-compiler.

For STM32MP257F-EV1 Evaluation board , the device tree is already selected in defconfig stm32mp25_defconfig

 make stm32mp25_defconfig
 make all

For other boards, you need to select the correct device tree

 make stm32mp25_defconfig
 make DEVICE_TREE=<Device tree> all

The supported variables are:

DEVICE_TREE: select in arch/arm/dts or in EXT_DTS the device tree that is used.
KBUILD_OUTPUT: change the destination directory for the build
EXT_DTB: select external device tree.
EXT_DTS: select PATH of external device tree source, by default the sub-directory "arch/arm/dts/external-dt" is used to allow sub-module.

The output files u-boot.dtb and u-boot-nodtb.bin are integrated in FIP.

Note: All the compiled devices trees are available in $KBUILD_OUTPUT/arch/arm/dts/*.dtb.
You can select them instead of u-boot.dtb without U-Boot recompilation.

See example with EXT_DTS in chapter STM32MP257F-EV1 Evaluation board with OSTL device tree.

4. Examples[edit | edit source]

4.1. STM32MP257F-DK Discovery kit [edit | edit source]

 make stm32mp25_defconfig
 make DEVICE_TREE=stm32mp257f-dk all

and

 fiptool --verbose update --nt-fw u-boot-nodtb.bin  --hw-config u-boot.dtb \
                        fip-stm32mp257f-dk.bin

4.2. STM32MP257F-EV1 Evaluation board with export[edit | edit source]

 export KBUILD_OUTPUT=../build/stm32mp25
 export DEVICE_TREE=stm32mp257f-ev1
 make stm32mp25_defconfig
 make  all

and

 fiptool --verbose update --nt-fw $KBUILD_OUTPUT/u-boot-nodtb.bin  \
                        --hw-config $KBUILD_OUTPUT/u-boot.dtb \
                        fip-stm32mp257f-ev1.bin

4.3. STM32MP257F-EV1 Evaluation board with OSTL device tree[edit | edit source]

For compilation of OSTL device tree in the external Git, u-boot/stm32mp257f-ev1-ostl.dts, you can use the git submodule command:

 git submodule add https://github.com/STMicroelectronics/dt-stm32mp arch/arm/dts/external-dt
 make stm32mp25_defconfig
 make DEVICE_TREE=stm32mp257f-ev1-ostl all

or git clone command with EXT_DTS:

 git clone https://github.com/STMicroelectronics/dt-stm32mp ../dt-stm32mp
 make stm32mp25_defconfig
 make EXT_DTS=$PATH/dt-stm32mp DEVICE_TREE=stm32mp257f-ev1-ostl all

and

 fiptool --verbose update --nt-fw u-boot-nodtb.bin \
             --hw-config  u-boot.dtb \
             fip-stm32mp257f-ev1-ostl.bin

4.4. Custom board with external device tree[edit | edit source]

 make stm32mp25_defconfig
 make EXT_DTB=stm32mp257f-myboard.dtb all

 fiptool --verbose update --nt-fw u-boot-nodtb.bin \
             --hw-config  u-boot.dtb \
             fip-stm32mp257f-myboard.bin