blob: bfae9ccc80507bb084086f34b3b68ce9c27c2299 [file] [log] [blame]
Yann Gautier75115392018-07-16 14:49:34 +02001Trusted Firmware-A for STM32MP1
2===============================
3
4STM32MP1 is a microprocessor designed by STMicroelectronics
5based on a dual Arm Cortex-A7.
6It is an Armv7-A platform, using dedicated code from TF-A.
Yann Gautier969be342019-02-20 17:34:16 +01007The STM32MP1 chip also embeds a Cortex-M4.
8More information can be found on `STM32MP1 Series`_ page.
Yann Gautier75115392018-07-16 14:49:34 +02009
10
11Design
12------
13The STM32MP1 resets in the ROM code of the Cortex-A7.
14The primary boot core (core 0) executes the boot sequence while
15secondary boot core (core 1) is kept in a holding pen loop.
16The ROM code boot sequence loads the TF-A binary image from boot device
17to embedded SRAM.
18
19The TF-A image must be properly formatted with a STM32 header structure
20for ROM code is able to load this image.
21Tool stm32image can be used to prepend this header to the generated TF-A binary.
22
23At compilation step, BL2, BL32 and DTB file are linked together in a single
24binary. The stm32image tool is also generated and the header is added to TF-A
25binary. This binary file with header is named tf-a-stm32mp157c-ev1.stm32.
26It can then be copied in the first partition of the boot device.
27
28
29Memory mapping
30~~~~~~~~~~~~~~
31
32::
33
34 0x00000000 +-----------------+
35 | | ROM
36 0x00020000 +-----------------+
37 | |
38 | ... |
39 | |
40 0x2FFC0000 +-----------------+ \
41 | | |
42 | ... | |
43 | | |
44 0x2FFD8000 +-----------------+ |
45 | TF-A DTB | | Embedded SRAM
46 0x2FFDC000 +-----------------+ |
47 | BL2 | |
48 0x2FFEF000 +-----------------+ |
49 | BL32 | |
50 0x30000000 +-----------------+ /
51 | |
52 | ... |
53 | |
54 0x40000000 +-----------------+
55 | |
56 | | Devices
57 | |
58 0xC0000000 +-----------------+ \
59 | | |
60 0xC0100000 +-----------------+ |
61 | BL33 | | Non-secure RAM (DDR)
62 | ... | |
63 | | |
64 0xFFFFFFFF +-----------------+ /
65
66
67Boot sequence
68~~~~~~~~~~~~~
69
70ROM code -> BL2 (compiled with BL2_AT_EL3) -> BL32 (SP_min) -> BL33 (U-Boot)
71
72
73Build Instructions
74------------------
75
76To build:
77
78.. code:: bash
79
80 make CROSS_COMPILE=arm-linux-gnueabihf- PLAT=stm32mp1 ARCH=aarch32 ARM_ARCH_MAJOR=7 AARCH32_SP=sp_min
Yann Gautierb4ddd302018-10-24 10:50:12 +020081 cd <u-boot_directory>
82 make stm32mp15_basic_defconfig
Yann Gautier969be342019-02-20 17:34:16 +010083 make DEVICE_TREE=stm32mp157c-ev1 all
Yann Gautierb4ddd302018-10-24 10:50:12 +020084 ./tools/mkimage -T stm32image -a 0xC0100000 -e 0xC0100000 -d u-boot.bin u-boot.stm32
Yann Gautier75115392018-07-16 14:49:34 +020085
86The following build options are supported:
87
88- ``ENABLE_STACK_PROTECTOR``: To enable the stack protection.
Yann Gautierb4ddd302018-10-24 10:50:12 +020089
90
91Populate SD-card
92----------------
93
94The SD-card has to be formated with GPT.
95It should contain at least those partitions:
96
97- fsbl: to copy the tf-a-stm32mp157c-ev1.stm32 binary
98- ssbl: to copy the u-boot.stm32 binary
99
100Usually, two copies of fsbl are used (fsbl1 and fsbl2) instead of one partition fsbl.
Yann Gautier969be342019-02-20 17:34:16 +0100101
102
103.. _STM32MP1 Series: https://www.st.com/en/microcontrollers-microprocessors/stm32mp1-series.html