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
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
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
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
43       longer necessary for general use of U-Boot on i.MX23 and i.MX28.
83 2) Compiling U-Boot for a MXS based board
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
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
142 To boot a MXS based board from SD, set the boot mode DIP switches according to
146 The SD card used to boot U-Boot must contain a DOS partition table, which in
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.
188 4) Installation of U-Boot into NAND flash on a MX28 based board
191 To boot a MX28 based board from NAND, set the boot mode DIP switches according
201 	   is invoked on "u-boot.sb" file from chapter 2):
203 		 $ ./tools/mxsboot nand u-boot.sb u-boot.nand
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:
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:
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
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
290 Last step is to power up the board and U-Boot should start from SPI NOR.