u-boot/doc/README.mediatek

1 # SPDX-License-Identifier: GPL-2.0+
7 This document describes how to compile the U-Boot and how to change U-Boot
13 	-Set the cross compiler:
15 		# export CROSS_COMPILE=/path/to/toolchain/arm-linux-gnueabi-
17 	-Clean-up old residuals:
21 	-Configure the U-Boot:
26 		- For the MT7623n bananapi R2 board use "mt7623n_bpir2_defconfig"
27 		- For the MT7629 reference board use "mt7629_rfb_defconfig"
30 Boot sequence
32 	-Bootrom -> MTK preloader -> U-Boot
34 		- MT7623n
36 	This version of U-Boot doesn't implement SPL. So, MTK preloader binary
37 	is needed to boot up:
39 	https://github.com/BPI-SINOVOIP/BPI-R2-bsp/tree/master/mt-pack/mtk/bpi-r2/bin
42 	-Bootrom -> SPL -> U-Boot
44 		- MT7629
49 	To update the U-Boot configuration, please refer to doc/README.kconfig
56 	- BootROM image header. This header is used by the first stage bootloader. It records
57 	  the desired compatible boot device, integrity information and its load address.
59 	  The on-chip BootROM will firstly verify integrity and compatibility of the bootloader.
61 	  If verification passed, the BootROM will then load the bootloader into on-chip SRAM,
67 	  Used by U-Boot SPL of MT7629 and preloader of MT7623.
70 	- MediaTek legacy image header. This header was originally used by the legacy image. It
76 	  Now this header is used by U-Boot of MT7623.
81 	# mkimage -T mtk_image -a <load_addr> -n <option_string> -d <input_file> <image_file>
83 	- mtk_image means using MediaTek's header generation method.
86 	- load_addr is the load address of this image.
87 	  For first stage bootloader like U-Boot SPL or preloader, it usually points to the
88 	  on-chip SRAM.
90 	  For second stage bootloader like U-Boot, it usually points to the DRAM.
93 	- option_string contains options to generate the header.
102 			The default value is "U-Boot".
104 		media: Desired boot device. The valid values are:
124 MT7629 partitions on Serial NOR
128 	00000000 - 0000ffff: 64KiB      U-Boot SPL
129 	00010000 - 0005ffff: 320KiB     U-Boot
130 	00060000 - 0006ffff: 64KiB      U-Boot env / MediaTek NVRAM
131 	00070000 - 000affff: 256KiB     RF calibration data
132 	000b0000 - xxxxxxxx: all left   Firmware image
135 BPi-R2 (MT7623N) partitions on SD
137 	Please note that the last two partitions can vary from different Linux distributions
141 	00000000 - 000001ff: 512B       Device header (with MBR partition table)
142 	00000200 - 000007ff: 1536B      BRLYT header
143 	00000800 - 0004ffff: 318KiB     Preloader (with GFH header)
144 	00050000 - 000fffff: 704KiB     U-Boot
145 	00100000 - 063fffff: 99MiB      Reserved
146 	06400000 - 163fffff: 256MiB     Partition 1 (FAT32)
147 	16400000 - xxxxxxxx: all left   Partition 2 (ext4)
156 	- To probe current NOR flash:
160 	- To erase a region:
164 	- To write data to an offset:
168 	- To boot kernel:
172 	The memory address range 0x30000000 - 0x3fffffff is mapped to the NOR flash.
175 	Please note that the output binary u-boot-mtk.bin is a combination of SPL and U-Boot,
180 		spl/u-boot-spl-mtk.bin for SPL,
181 		u-boot.img for U-Boot.
188 	Normally only Preloader and U-Boot can be upgraded within U-Boot, and other partitions
191 	- To probe current SD card / eMMC:
196 	- To erase a region:
200 	- To write data to a block offset:
204 	- To load kernel image from partition 1:
209 	- To boot kernel:
221 	http://wiki.banana-pi.org/Banana_Pi_BPI-R2