This article briefly describes the STM32MP13x lines support in U-Boot.
1. STM32MP13x lines
support[edit source]
For detailed information, please read the file in the delivered U-Boot code = doc/board/st/stm32mp1.rst or the stm32mp1 documentation generated by make htlmdocs
[1].
Also available in official U-Boot Git.
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.13x : specific configuration for STM32MP13x lines
- arch/arm/mach-stm32mp/Kconfig : generic configuration for STM32 Arm® Cortex® MPUs
- board/st/common : STMicroelectronics common code
- board/st/stm32mp1 : generic STMicroelectronics board for STM32MP1 series
- drivers/*/*stm32* : drivers
Configuration Files:
- defconfig file
- config files
- STM32MP13_device_tree in arch/arm/dts : stm32mp13*.dts*
- <Device tree>.dts : same as kernel
- <Device tree>-u-boot.dtsi : addition for u-boot automatically included in build process
2. Selecting targets : choose defconfig and Device Tree[edit source]
The U-Boot configuration with defconfig is stm32mp13_defconfig
The STM32MP13 boards are supported with the associated device-tree (same name as kernel):
Board part number | Device tree | Description |
---|---|---|
STM32MP135F-DK Discovery kit ![]() |
stm32mp135f-dk | MB1635 |
3. Compilation[edit source]
see U-Boot_overview#U-Boot_build
For STM32MP135F-DK Discovery kit , the device tree is already selected in defconfig stm32mp13_defconfig
make stm32mp13_defconfig
make all
For other boards, you need to select the correct device tree
make stm32mp13_defconfig make DEVICE_TREE=<Device tree> all
The supported variables are:
- DEVICE_TREE: select in arch/arm/dts the device tree that is used
- KBUILD_OUTPUT: change the destination directory for the build
- EXT_DTB: select external device tree
The ouput file, used to generated FIP, are u-boot-nodtb.bin and u-boot.dtb.
4. U-Boot integration in FIP[edit source]
U-Boot binary and its associated device tree are part of the FIP binary, created with TF-A Makefile option :
- BL33_CFG = u-boot.dtb
- BL33 = u-boot-nodtb.bin
or updated with fiptools
:
- --hw-config u-boot.dtb
- --nt-fw u-boot-nodtb.bin
Example for fip upddate of STM32MP135F-DK Discovery kit :
fiptool update --nt-fw u-boot-nodtb.bin \ --hw-config u-boot.dtb \ tf-a-fip-stm32mp135f-dk.bin
5. Examples[edit source]
5.1. STM32MP135F-DK Discovery kit
[edit source]
make stm32mp13_defconfig
make all
or
make stm32mp13_defconfig make DEVICE_TREE=stm32mp135f-dk all
fiptool update --nt-fw u-boot-nodtb.bin \ --hw-config u-boot.dtb \ tf-a-fip-stm32mp135f-dk.bin