imx/mkimage/imximage.txt

1 ---------------------------------------------
3 ---------------------------------------------
5 This document describes how to set up a U-Boot image that can be booted
9 These processors can boot directly from NAND, SPI flash and SD card flash
15 For more details refer Chapter 2 - System Boot and section 2.14
19 --------------
20 ./tools/mkimage -l <mx u-boot_file>
23 ./tools/mkimage -T imximage \
24 		-n <board specific configuration file> \
25 		-e <execution address> -d <u-boot binary>  <output image file>
28 ./tools/mkimage -n ./board/freescale/mx51evk/imximage.cfg \
29 		-T imximage -e 0x97800000  \
30 		-d u-boot.bin u-boot.imx
32 You can generate directly the image when you compile u-boot with:
34 $ make u-boot.imx
36 The output image can be flashed on the board SPI flash or on a SD card.
38 chosen media devices (0x400 for both SPI flash or SD card).
43 -------------------------------------------------
46 2. This file can have empty lines and lines starting with "#" as first
48 3. This file can have configuration command lines as mentioned below,
52 ---------------------------------
55 2. Following are the valid command strings and associated data strings:-
57 	--------------		-----------
74 						mach-imx/imximage.cfg
78 	BOOT_FROM		nand/spi/sd/onenand/nor/sata
96 				'manually' appended to the u-boot.imx file.
99 				to the u-boot image, making a signed bootloader,
128 Setup a SD Card for booting
129 --------------------------------
131 The following example prepare a SD card with u-boot and a FAT partition
133 I will set the SD in the most compatible mode, setting it with
135 howto on line (I took as reference the preparation of a SD Card for the
136 Beagleboard, running u-boot as bootloader).
138 You should start clearing the partitions table on the SD card. Because
139 the u-boot image must be stored at the offset 0x400, it must be assured
140 that there is no partition at that address. A new SD card is already
144 You can do all steps with fdisk. If the device for the SD card is
169 Number of heads (1-256, default 4): 255
172 Number of sectors (1-63, default 16): 63
185 Number of cylinders (1-1048576, default 60032): 239
195 to not overwrite the space where I will put u-boot.
200    p   primary partition (1-4)
202 Partition number (1-4): 1
203 First cylinder (1-239, default 1): 3
204 Last cylinder, +cylinders or +size{K,M,G} (3-239, default 239): +100M
216 I have set 100MB, leaving the first 2 sectors free. I will copy u-boot
224 Calling ioctl() to re-read partition table.
226 9. Copy u-boot.imx on the SD card
230 dd if=u-boot.imx of=/dev/mmcblk0 bs=512 seek=2
232 This command copies the u-boot image at the address 0x400, as required
236 the u-boot prompt should come after power on.
238 ------------------------------------------------