imx/common/mxs.txt

1 Booting U-Boot on a MXS processor
4 This document describes the MXS U-Boot port. This document mostly covers topics
8 -----------
14 into the unix command prompt in U-Boot source code root directory.
16 The (=>) introduces a snipped of code that should by typed into U-Boot command
20 --------
23 2) Compiling U-Boot for a MXS based board
24 3) Installation of U-Boot for a MXS based board to SD card
25 4) Installation of U-Boot into NAND flash on a MX28 based board
26 5) Installation of U-Boot into SPI NOR flash on a MX28 based board
29 ----------------
32 mandatory tool is the "mxsboot" tool found in U-Boot source tree. The
33 tool is built automatically when compiling U-Boot for i.MX23 or i.MX28.
36 also part of the U-Boot source tree. The "mkimage" requires OpenSSL
40 	$ sudo apt-get install libssl-dev
43       longer necessary for general use of U-Boot on i.MX23 and i.MX28.
45       with a zero key, which is the vast majority of use-cases. In
46       case you do need to produce image encrypted with non-zero key
53 	ftp://ftp.denx.de/pub/tools/elftosb-10.12.01.tar.gz
60 	$ wget ftp://ftp.denx.de/pub/tools/elftosb-${VER}.tar.gz
64 	$ tar xzf elftosb-${VER}.tar.gz
68 	$ cd elftosb-${VER}/
69 	$ make LIBS="-lstdc++ -lm" elftosb
83 2) Compiling U-Boot for a MXS based board
84 -------------------------------------------
86 Compiling the U-Boot for a MXS board is straightforward and done as compiling
87 U-Boot for any other ARM device. For cross-compiler setup, please refer to
92 Next, configure U-Boot for a MXS based board
98 1. For building U-Boot for Aries M28EVK board:
102 2. For building U-Boot for Freescale MX28EVK board:
106 3. For building U-Boot for Freescale MX23EVK board:
110 4. For building U-Boot for Olimex MX23 Olinuxino board:
114 Lastly, compile U-Boot and prepare a "BootStream". The "BootStream" is a special
115 type of file, which MXS CPUs can boot. This is handled by the following
118 	$ make u-boot.sb
120 HINT: To speed-up the build process, you can add -j<N>, where N is number of
123 The code produces "u-boot.sb" file. This file needs to be augmented with a
124 proper header to allow successful boot from SD or NAND. Adding the header is
127 NOTE: The process that produces u-boot.sb uses the mkimage to generate the
134 	$ elftosb -zf imx23 -c arch/arm/cpu/arm926ejs/mxs/u-boot-imx23.bd \
135 		-o u-boot.sb
136 	$ elftosb -zf imx28 -c arch/arm/cpu/arm926ejs/mxs/u-boot-imx28.bd \
137 		-o u-boot.sb
139 3) Installation of U-Boot for a MXS based board to SD card
140 ----------------------------------------------------------
142 To boot a MXS based board from SD, set the boot mode DIP switches according to
143 to MX28 manual, section 12.2.1 (Table 12-2) or MX23 manual, section 35.1.2
144 (Table 35-3).
146 The SD card used to boot U-Boot must contain a DOS partition table, which in
158 run fdisk with the option "-u=sectors" to set units to sectors:
175 	$ ./tools/mxsboot sd u-boot.sb u-boot.sd
177 The resulting file, "u-boot.sd", shall then be written to the partition. In this
180 	$ dd if=u-boot.sd of=/dev/mmcblk0p1
182 Last step is to insert the card into the MXS based board and boot.
185       a "-p" switch for that purpose. The "-p" switch takes the sector number as
188 4) Installation of U-Boot into NAND flash on a MX28 based board
189 ---------------------------------------------------------------
191 To boot a MX28 based board from NAND, set the boot mode DIP switches according
192 to MX28 manual section 12.2.1 (Table 12-2), PORT=GPMI, NAND 1.8 V.
197 	----------------------------------------------------------
201 	   is invoked on "u-boot.sb" file from chapter 2):
203 		 $ ./tools/mxsboot nand u-boot.sb u-boot.nand
209 		 -w <size>	change page size (default 2048 b)
210 		 -o <size>	change oob size (default 64 b)
211 		 -e <size>	change erase size (default 131072 b)
213 		 The geometry information can be obtained from running U-Boot
216 	   The resulting file, "u-boot.nand" can be written directly to NAND
217 	   from the U-Boot prompt. To simplify the process, the U-Boot default
221 	   "u-boot.nand" in it's root directory. This can be changed by
224 	   To update the system, run the following in U-Boot prompt:
232 	------------------------------------------------
239 	   To simplify the process of firmware update, the U-Boot default
244 	   "u-boot.sb" in it's root directory. This can be changed by
247 	   To update the system, run the following in U-Boot prompt:
252 	--------------------------------------------
254 	   STRIDE and COUNT options of the NAND boot. For description of these,
263 	   In case the user needs to boot a firmware image bigger than 1Mb, the
267 5) Installation of U-Boot into SPI NOR flash on a MX28 based board
268 ------------------------------------------------------------------
270 The u-boot.sb file can be directly written to SPI NOR from U-Boot prompt.
272 Load u-boot.sb into RAM, this can be done in several ways and one way is to use
274        => tftp u-boot.sb 0x42000000
281 Erase the blocks where U-Boot binary will be written to:
284 Write u-boot.sb to SPI NOR:
287 Power off the board and set the boot mode DIP switches to boot from the SPI NOR
288 according to MX28 manual section 12.2.1 (Table 12-2)
290 Last step is to power up the board and U-Boot should start from SPI NOR.