Difference between revisions of "STM32MP15 U-Boot"

[unchecked revision] [quality revision]
m
m (Reverted edits by Patrick Delaunay (talk) to last revision by Jean-Christophe Trotin)
(Tag: Rollback)
 

This article briefly describes the STM32MP15x lines More info.png support in U-Boot.

1 STM32MP15x lines More info.png support[edit]

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 :

Configuration Files:

2 Selecting targets : choose defconfig and Device Tree[edit]

The STM32 MPU boot chain is supported by one U-Boot configuration with defconfig = stm32mp15_trusted_defconfig

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

Board part number Device tree Description
STM32MP157A-EV1 Evaluation board More info green.png stm32mp157a-ev1 MB1262+MB1263
STM32MP157C-EV1 Evaluation board More info green.png stm32mp157c-ev1
STM32MP157D-EV1 Evaluation board More info green.png stm32mp157d-ev1
STM32MP157F-EV1 Evaluation board More info green.png stm32mp157f-ev1
STM32MP157A-DK1 Discovery kit More info green.png stm32mp157a-dk1 MB1272
STM32MP157D-DK1 Discovery kit More info green.png stm32mp157d-dk1
STM32MP157C-DK2 Discovery kit More info green.png stm32mp157c-dk2 MB1272+MB1407
STM32MP157F-DK2 Discovery kit More info green.png stm32mp157f-dk2

For information the 'Evaluation' daughter-board only (MB1263 without MB1262) is also supported by stm32mp15*-ed1.dts device tree files.

3 Compilation[edit]

see U-Boot_overview#U-Boot_build

With the defconfig file: stm32mp15_trusted_defconfig

 
 make stm32mp15_trusted_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 two ouput files are used to generate the FIP are:

  • BL33_CFG=u-boot.dtb
  • BL33=u-boot-nodtb.bin

You can also update a existing FIP with fiptools after U-Boot compilation:

fiptool update --nt-fw u-boot-nodtb.bin --hw-config u-boot.dtb tf-a-fip.bin

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

The ouput file is u-boot.stm32 for ecosystem release ≤ v2. 1.0 More info.png or if you activate CONFIG_STM32MP15x_STM32IMAGE in your defconfig for ecosystem release unknown revision 3.0.0 Warning.png (this temporary option is only introduced to facilitate the FIP migration but it will be removed in the next EcosystemRelease).

4 SPL compilation[edit]

The alternate boot chain with SPL is also supported by "stm32mp15_basic_defconfig" but only for U-Boot_SPL:_DDR_interactive_mode

The resulting U-Boot files are located in your build directory:

  • u-boot-spl.stm32 : FSBL = SPL binary with STM32 image header, loaded by ROM code
  • u-boot.img : SSBL = U-Boot binary with U-Boot image header (uImage), loaded by SPL
Warning white.png Warning
This alternate boot chain with SPL is not supported/promoted by STMicroelectronics to make product.

5 Examples[edit]

5.1 STM32MP157F-EV1 Evaluation board More info green.png[edit]

 
 make stm32mp15_trusted_defconfig
  make DEVICE_TREE=stm32mp157f-ev1 all

5.2 STM32MP157C-EV1 Evaluation board More info green.png[edit]

 
 make stm32mp15_trusted_defconfig
  make DEVICE_TREE=stm32mp157c-ev1 all

5.3 STM32MP157D-DK1 Discovery kit More info green.png[edit]

 
 make stm32mp15_trusted_defconfig
  make DEVICE_TREE=stm32mp157d-dk1 all

5.4 STM32MP157C-DK2 Discovery kit More info green.png[edit]

Using export to select the device tree

 
 export KBUILD_OUTPUT=../build/stm32mp15_trusted
  export DEVICE_TREE=stm32mp157c-dk2
  make stm32mp15_trusted_defconfig
  make all

5.5 Custom board with external device tree[edit]

 
 make stm32mp15_trusted_defconfig
  make EXT_DTB=stm32mp151a-myboard.dtb all

5.6 SPL for STM32MP157F-EV1 Evaluation board More info green.png[edit]

  make stm32mp15_basic_defconfig
  make DEVICE_TREE=stm32mp157f-ev1 all

This article briefly describes the {{MicroprocessorDevice | device=15}} support in [[U-Boot_overview|U-Boot]].

== {{MicroprocessorDevice | device=15}} support ==

For detailed information, please read the file in the delivered U-Boot code = {{CodeSource | U-Boot | doc/board/st/stm32mp1.rst}} or the stm32mp1 documentation generated by <code>make htlmdocs</code><ref>https://u-boot.readthedocs.io/en/stable/board/st/stm32mp1.html</ref>.

Also available in official U-Boot Git.

Code :
* {{CodeSource | U-Boot | arch/arm/mach-stm32mp}}: arch specific code for {{MicroprocessorDevice | device=Class}}
* {{CodeSource | U-Boot | board/st/common}}: STMicroelectronics common code 
* {{CodeSource | U-Boot | board/st/stm32mp1}}: generic STMicroelectronics board for {{MicroprocessorDevice | device=1}}
* drivers/*/*stm32* : drivers

Configuration Files:
* defconfig file
** {{CodeSource | U-Boot | configs/stm32mp15_basic_defconfig}}
** {{CodeSource | U-Boot | configs/stm32mp15_trusted_defconfig}}
* config files
** {{CodeSource | U-Boot | include/configs/stm32mp1.h}}
* [[STM32MP15_device_tree]] in {{CodeSource | U-Boot | arch/arm/dts }} : stm32mp15*.dts*
** {{HighlightParam|<Device tree>}}.dts : same as kernel
** {{HighlightParam|<Device tree>}}-u-boot.dtsi : addition for u-boot automatically included in build process

== Selecting targets : choose defconfig and Device Tree ==

The [[Boot_chain_overview|STM32 MPU boot chain]] is supported by one [[U-Boot_overview#Kbuild|U-Boot configuration with defconfig]] = {{HighlightParam|stm32mp15_trusted_defconfig}}

Several [[STM32MP15_boards|boards]] are supported with the associated device-tree (same name as kernel):

{| class="st-table"
|-
! Board part number  !! {{HighlightParam|Device tree}} !! Description 
|-
| '''{{Board | type=157A-EV1}}''' || {{CodeSource | U-Boot | arch/arm/dts/stm32mp157a-ev1.dts|stm32mp157a-ev1}} || rowspan="4" | [[MB1262]]+[[MB1263]]
|-
| '''{{Board | type=157C-EV1}}''' || {{CodeSource | U-Boot | arch/arm/dts/stm32mp157c-ev1.dts|stm32mp157c-ev1}}
|-
| '''{{Board | type=157D-EV1}}''' || {{CodeSource | U-Boot | arch/arm/dts/stm32mp157d-ev1.dts|stm32mp157d-ev1}}
|-
| '''{{Board | type=157F-EV1}}''' || {{CodeSource | U-Boot | arch/arm/dts/stm32mp157f-ev1.dts|stm32mp157f-ev1}}
|-
| '''{{Board | type=157A-DK1}}''' ||  {{CodeSource | U-Boot | arch/arm/dts/stm32mp157a-dk1.dts|stm32mp157a-dk1}} || rowspan="2" | [[MB1272]]
|-
| '''{{Board | type=157D-DK1}}''' ||  {{CodeSource | U-Boot | arch/arm/dts/stm32mp157d-dk1.dts|stm32mp157d-dk1}}
|-
| '''{{Board | type=157C-DK2}}''' || {{CodeSource | U-Boot | arch/arm/dts/stm32mp157c-dk2.dts|stm32mp157c-dk2}} || rowspan="2" | [[MB1272]]+[[MB1407]] 
|-
| '''{{Board | type=157F-DK2}}''' || {{CodeSource | U-Boot | arch/arm/dts/stm32mp157f-dk2.dts|stm32mp157f-dk2}}
|}

For information the 'Evaluation' daughter-board only ([[MB1263]] without [[MB1262]]) is also supported by stm32mp15*-ed1.dts device tree files.

== Compilation ==
see [[U-Boot_overview#U-Boot_build]]

With the defconfig file: {{HighlightParam|stm32mp15_trusted_defconfig}}

  {{PC$}} make {{HighlightParam|stm32mp15_trusted_defconfig}}
  {{PC$}} make DEVICE_TREE={{HighlightParam|<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 two ouput files are used to generate the FIP are:
* {{HighlightParam|BL33_CFG}}={{Highlight|'''u-boot.dtb'''}}
* {{HighlightParam|BL33}}={{Highlight|'''u-boot-nodtb.bin'''}}

You can also update a existing FIP with <code>fiptools</code> after U-Boot compilation:
  {{PC$}} fiptool update {{HighlightParam|--nt-fw}} {{Highlight|u-boot-nodtb.bin}} {{HighlightParam|--hw-config}} {{Highlight|u-boot.dtb}} {{Highlight|tf-a-fip.bin}}

Nota: All the compiled device tree are available in $KBUILD_OUTPUT/arch/arm/dts/*.dtb.<br/>You can select them instead of {{Highlight|u-boot.dtb}} without U-Boot recompilation.

The ouput file is {{Highlight|'''u-boot.stm32'''}} for {{EcosystemRelease | revision=2.1.0 | range=and before}} or if you activate {{HighlightParam|CONFIG_STM32MP15x_STM32IMAGE}} in your defconfig for {{EcosystemRelease | revision=3.0.0}} (this temporary option is only introduced to facilitate the FIP migration but it will be removed in the next EcosystemRelease).
<div class="mw-collapsible mw-collapsed">

== SPL compilation ==<div class="mw-collapsible-content">.

== SPL compilation ==

The alternate boot chain with SPL is also supported by ''"stm32mp15_basic_defconfig"'' but only for [[U-Boot_SPL:_DDR_interactive_mode]]

The resulting U-Boot files are located in your build directory:
* '''u-boot-spl.stm32''' : FSBL = SPL binary with STM32 image header, loaded by ROM code
* '''u-boot.img''' : SSBL = U-Boot binary with U-Boot image header (uImage), loaded by SPL

{{Warning | This alternate boot chain with SPL is not supported/promoted by STMicroelectronics to make product.}} </div></div>


== Examples ==

=== {{Board | type=157F-EV1}} ===
  {{PC$}} make {{HighlightParam|stm32mp15_trusted_defconfig}}
  {{PC$}} make DEVICE_TREE={{HighlightParam|stm32mp157f-ev1}} all

=== {{Board | type=157C-EV1}} ===
  {{PC$}} make {{HighlightParam|stm32mp15_trusted_defconfig}}
  {{PC$}} make DEVICE_TREE={{HighlightParam|stm32mp157c-ev1}} all

=== {{Board | type=157D-DK1}} ===
  {{PC$}} make {{HighlightParam|stm32mp15_trusted_defconfig}}
  {{PC$}} make DEVICE_TREE={{HighlightParam|stm32mp157d-dk1}} all

=== {{Board | type=157C-DK2}} ===
Using export to select the device tree
  {{PC$}} export KBUILD_OUTPUT=../build/stm32mp15_trusted
  {{PC$}} export DEVICE_TREE={{HighlightParam|stm32mp157c-dk2}}
  {{PC$}} make {{HighlightParam|stm32mp15_trusted_defconfig}}
  {{PC$}} make all

=== Custom board with external device tree ===
  {{PC$}} make {{HighlightParam|stm32mp15_trusted_defconfig}}
  {{PC$}} make EXT_DTB={{HighlightParam|stm32mp151a-myboard.dtb}} all
<div class="mw-collapsible mw-collapsed">
=== SPL for {{Board | type=157F-EV1}} ===<div class="mw-collapsible-content">
  {{PC$}} make stm32mp15_basic_defconfig
  {{PC$}} make DEVICE_TREE={{HighlightParam|stm32mp157f-ev1}} all</div></div>


<noinclude>

[[Category:U-Boot]]
{{PublicationRequestId | 12895 | 2019-08-01}}</noinclude>
Line 65: Line 65:
 
* '''EXT_DTB''': select external device tree
 
* '''EXT_DTB''': select external device tree
   
The two ouput files are used to generate the FIP are:
+
The ouput file is {{Highlight|'''u-boot.stm32'''}}.
* {{HighlightParam|BL33_CFG}}={{Highlight|'''u-boot.dtb'''}}
 
* {{HighlightParam|BL33}}={{Highlight|'''u-boot-nodtb.bin'''}}
 
   
You can also update a existing FIP with <code>fiptools</code> after U-Boot compilation:
+
== SPL compilation ==
  {{PC$}} fiptool update {{HighlightParam|--nt-fw}} {{Highlight|u-boot-nodtb.bin}} {{HighlightParam|--hw-config}} {{Highlight|u-boot.dtb}} {{Highlight|tf-a-fip.bin}}
 
 
 
Nota: All the compiled device tree are available in $KBUILD_OUTPUT/arch/arm/dts/*.dtb.<br/>You can select them instead of {{Highlight|u-boot.dtb}} without U-Boot recompilation.
 
 
 
The ouput file is {{Highlight|'''u-boot.stm32'''}} for {{EcosystemRelease | revision=2.1.0 | range=and before}} or if you activate {{HighlightParam|CONFIG_STM32MP15x_STM32IMAGE}} in your defconfig for {{EcosystemRelease | revision=3.0.0}} (this temporary option is only introduced to facilitate the FIP migration but it will be removed in the next EcosystemRelease).
 
   
<div class="mw-collapsible mw-collapsed">
 
== SPL compilation ==
 
<div class="mw-collapsible-content">
 
 
The alternate boot chain with SPL is also supported by ''"stm32mp15_basic_defconfig"'' but only for [[U-Boot_SPL:_DDR_interactive_mode]]
 
The alternate boot chain with SPL is also supported by ''"stm32mp15_basic_defconfig"'' but only for [[U-Boot_SPL:_DDR_interactive_mode]]
   
Line 86: Line 76:
   
 
{{Warning | This alternate boot chain with SPL is not supported/promoted by STMicroelectronics to make product.}}  
 
{{Warning | This alternate boot chain with SPL is not supported/promoted by STMicroelectronics to make product.}}  
</div></div>
 
   
 
== Examples ==
 
== Examples ==
Line 113: Line 102:
 
   {{PC$}} make EXT_DTB={{HighlightParam|stm32mp151a-myboard.dtb}} all
 
   {{PC$}} make EXT_DTB={{HighlightParam|stm32mp151a-myboard.dtb}} all
   
<div class="mw-collapsible mw-collapsed">
 
 
=== SPL for {{Board | type=157F-EV1}} ===
 
=== SPL for {{Board | type=157F-EV1}} ===
<div class="mw-collapsible-content">
 
 
   {{PC$}} make stm32mp15_basic_defconfig
 
   {{PC$}} make stm32mp15_basic_defconfig
 
   {{PC$}} make DEVICE_TREE={{HighlightParam|stm32mp157f-ev1}} all
 
   {{PC$}} make DEVICE_TREE={{HighlightParam|stm32mp157f-ev1}} all
</div></div>
 
   
 
<noinclude>
 
<noinclude>