xref: /openbmc/u-boot/board/st/stm32mp1/README (revision 936f575e)
1SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause
2#
3# Copyright (C) 2018 STMicroelectronics - All Rights Reserved
4#
5
6U-Boot on STMicroelectronics STM32MP1
7======================================
8
91. Summary
10==========
11This is a quick instruction for setup stm32mp1 boards.
12
132. Supported devices
14====================
15U-Boot supports one STMP32MP1 SoCs: STM32MP157
16
17The STM32MP157 is a Cortex-A MPU aimed at various applications.
18It features:
19- Dual core Cortex-A7 application core
20- 2D/3D image composition with GPU
21- Standard memories interface support
22- Standard connectivity, widely inherited from the STM32 MCU family
23- Comprehensive security support
24
25Everything is supported in Linux but U-Boot is limited to:
261. UART
272. SDCard/MMC controller (SDMMC)
28
29And the necessary drivers
301. I2C
312. STPMU1
322. STPMU1 (PMIC and regulator)
333. Clock, Reset, Sysreset
344. Fuse
35
36Currently the following boards are supported:
37+ stm32mp157c-ev1
38+ stm32mp157c-ed1
39
403. Boot Sequences
41=================
42
43BootRom => FSBL in SYSRAM => SSBL in DDR => OS (Linux Kernel)
44
45with FSBL = First Stage Bootloader
46     SSBL = Second Stage Bootloader
47
48One boot configuration is supported:
49
50   The "Basic" boot chain (defconfig_file : stm32mp15_basic_defconfig)
51   BootRom => FSBL = U-Boot SPL => SSBL = U-Boot
52   SPL has limited security initialisation
53   U-Boot is running in secure mode and provide a secure monitor to the kernel
54   with only PSCI support (Power State Coordination Interface defined by ARM)
55
56All the STM32MP1 board supported by U-Boot use the same generic board
57stm32mp1 which support all the bootable devices.
58
59Each board is configurated only with the associated device tree.
60
614. Device Tree Selection
62========================
63
64You need to select the appropriate device tree for your board,
65the supported device trees for stm32mp157 are:
66
67+ ev1: eval board with pmic stpmu1 (ev1 = mother board + daughter ed1)
68  dts: stm32mp157c-ev1
69
70+ ed1: daughter board with pmic stpmu1
71  dts: stm32mp157c-ed1
72
735. Build Procedure
74==================
75
761. Install required tools for U-Boot
77
78   + install package needed in U-Boot makefile
79     (libssl-dev, swig, libpython-dev...)
80   + install ARMv7 toolchain for 32bit Cortex-A (from Linaro,
81     from SDK for STM32MP1, or any crosstoolchains from your distribution)
82
832. Set the cross compiler:
84
85	# export CROSS_COMPILE=/path/to/toolchain/arm-linux-gnueabi-
86	(you can use any gcc cross compiler compatible with U-Boot)
87
883. Select the output directory (optional)
89
90	# export KBUILD_OUTPUT=/path/to/output
91
92	for example: use one output directory for each configuration
93	# export KBUILD_OUTPUT=stm32mp15_basic
94
954. Configure the U-Boot:
96
97	# make <defconfig_file>
98
99	- For basic boot mode: "stm32mp15_basic_defconfig"
100
1015. Configure the device-tree and build the U-Boot image:
102
103	# make DEVICE_TREE=<name> all
104
105
106  example:
107     basic boot on ev1
108	# export KBUILD_OUTPUT=stm32mp15_basic
109	# make stm32mp15_basic_defconfig
110	# make DEVICE_TREE=stm32mp157c-ev1 all
111
112     basic boot on ed1
113	# export KBUILD_OUTPUT=stm32mp15_basic
114	# make stm32mp15_basic_defconfig
115	# make DEVICE_TREE=stm32mp157c-ed1 all
116
1176. Output files
118
119  BootRom and TF-A expect binaries with STM32 image header
120  SPL expects file with U-Boot uImage header
121
122  So in the output directory (selected by KBUILD_OUTPUT),
123  you can found the needed files:
124
125   + FSBL = spl/u-boot-spl.stm32
126   + SSBL = u-boot.img
127
1286. Switch Setting for Boot Mode
129===============================
130
131You can select the boot mode, on the board ed1 with the switch SW1
132
133 -----------------------------------
134  Boot Mode   BOOT2   BOOT1   BOOT0
135 -----------------------------------
136  Reserved	0	0	0
137  NOR		0	0	1
138  SD-Card	1	1	1
139  SD-Card	1	0	1
140  eMMC		0	1	0
141  NAND		0	1	1
142  Recovery	1	1	0
143  Recovery	0	0	0
144
145Recovery is a boot from serial link (UART/USB) and it is used with
146STM32CubeProgrammer tool to load executable in RAM and to update the flash
147devices available on the board (NOR/NAND/eMMC/SDCARD).
148The communication between HOST and board is based on
149- for UARTs : the uart protocol used with all MCU STM32
150- for USB : based on USB DFU 1.1 (without the ST extensions used on MCU STM32)
151
1527. Prepare an SDCard
153===================
154
155The minimal requirements for STMP32MP1 boot up to U-Boot are:
156- GPT partitioning (with gdisk or with sgdisk)
157- 2 fsbl partitions, named fsbl1 and fsbl2, size at least 256KiB
158- one ssbl partition for U-Boot
159
160Then the minimal GPT partition is:
161   ----- ------- --------- -------------
162  | Num | Name  | Size    |  Content    |
163   ----- ------- -------- --------------
164  |  1  | fsbl1 | 256 KiB |  TF-A or SPL |
165  |  2  | fsbl2 | 256 KiB |  TF-A or SPL |
166  |  3  | ssbl  | enought |  U-Boot     |
167  |  *  |  -    |  -      |  Boot/Rootfs|
168   ----- ------- --------- -------------
169
170(*) add bootable partition for extlinux.conf
171    following Generic Distribution
172    (doc/README.distro for use)
173
174  according the used card reader select the block device
175  (/dev/sdx or /dev/mmcblk0)
176  in the next example I use /dev/mmcblk0
177
178for example: with gpt table with 128 entries
179
180  a) remove previous formatting
181	# sgdisk -o /dev/<SDCard dev>
182
183  b) create minimal image
184	# sgdisk --resize-table=128 -a 1 \
185		-n 1:34:545		-c 1:fsbl1 \
186		-n 2:546:1057		-c 2:fsbl2 \
187		-n 3:1058:5153		-c 3:ssbl \
188		-p /dev/<SDCard dev>
189
190	you can add other partitions for kernel
191	one partition rootfs for example:
192		-n 3:5154:		-c 4:rootfs
193
194  c) copy the FSBL (2 times) and SSBL file on the correct partition.
195     in this example in partition 1 to 3
196
197     for basic boot mode : <SDCard dev> = /dev/mmcblk0
198	# dd if=u-boot-spl.stm32 of=/dev/mmcblk0p1
199	# dd if=u-boot-spl.stm32 of=/dev/mmcblk0p2
200	# dd if=u-boot.img of=/dev/mmcblk0p3
201
202To boot from SDCard, select BootPinMode = 1 1 1 and reset.
203
2048. Prepare eMMC
205===============
206You can use U-Boot to copy binary in eMMC.
207
208In the next example, you need to boot from SDCARD and the images (u-boot-spl.stm32, u-boot.img)
209are presents on SDCARD (mmc 0) in ext4 partition 4 (bootfs).
210
211To boot from SDCard, select BootPinMode = 1 1 1 and reset.
212
213Then you update the eMMC with the next U-Boot command :
214
215a) prepare GPT on eMMC,
216	example with 2 partitions, bootfs and roots:
217
218	# setenv emmc_part "name=ssbl,size=2MiB;name=bootfs,type=linux,bootable,size=64MiB;name=rootfs,type=linux,size=512"
219	# gpt write mmc 1 ${emmc_part}
220
221b) copy SPL on eMMC on firts boot partition
222	(SPL max size is 256kB, with LBA 512, 0x200)
223
224	# ext4load mmc 0:4 0xC0000000 u-boot-spl.stm32
225	# mmc dev 1
226	# mmc partconf 1 1 1 1
227	# mmc write ${fileaddr} 0 200
228	# mmc partconf 1 1 1 0
229
230b) copy U-Boot in first GPT partition of eMMC
231
232	# ext4load mmc 0:4 0xC0000000 u-boot.img
233	# mmc dev 1
234	# part start mmc 1 1 partstart
235	# part size mmc 1 1 partsize
236	# mmc write ${fileaddr} ${partstart} ${partsize}
237
238To boot from eMMC, select BootPinMode = 0 1 0 and reset.
239
2409. MAC Address
241==============
242
243Please read doc/README.enetaddr for the implementation guidelines for mac id
244usage. Basically, environment has precedence over board specific storage.
245
246Mac id storage and retrieval in stm32mp otp :
247- OTP_57[31:0] = MAC_ADDR[31:0]
248- OTP_58[15:0] = MAC_ADDR[47:32]
249
250To program a MAC address on virgin OTP words above, you can use the fuse command
251on bank 0 to access to internal OTP:
252
253    example to set mac address "12:34:56:78:9a:bc"
254
255    1- Write OTP
256       STM32MP> fuse prog -y 0 57 0x78563412 0x0000bc9a
257
258    2- Read OTP
259       STM32MP> fuse sense 0 57 2
260       Sensing bank 0:
261       Word 0x00000039: 78563412 0000bc9a
262
263    3- next REBOOT :
264       ### Setting environment from OTP MAC address = "12:34:56:78:9a:bc"
265
266    4 check env update
267       STM32MP> print ethaddr
268       ethaddr=12:34:56:78:9a:bc
269