1----------------------------------------
2Booting from On-Chip ROM (eSDHC or eSPI)
3----------------------------------------
4
5boot_format is a tool to write SD bootable images to a filesystem and build
6SD/SPI images to a binary file for writing later.
7
8When booting from an SD card/MMC, boot_format puts the configuration file and
9the RAM-based U-Boot image on the card.
10When booting from an EEPROM, boot_format generates a binary image that is used
11to boot from this EEPROM.
12
13Where to get boot_format:
14========================
15
16you can browse it online at:
17http://git.freescale.com/git/cgit.cgi/ppc/sdk/boot-format.git/
18
19Building
20========
21
22Run the following to build this project
23
24	$ make
25
26Execution
27=========
28
29boot_format runs under a regular Linux machine and requires a super user mode
30to run. Execute boot_format as follows.
31
32For building SD images by writing directly to a file system on SD media:
33
34	$ boot_format $config u-boot.bin -sd $device
35
36Where $config is the included config.dat file for your platform and $device
37is the target block device for the SD media on your computer.
38
39For build binary images directly a local file:
40
41	$ boot_format $config u-boot.bin -spi $file
42
43Where $file is the target file. Also keep in mind the u-boot.bin file needs
44to be the u-boot built for your particular platform and target media.
45
46Example: To generate a u-boot.bin for a P1022DS booting from SD, run the
47following in the u-boot repository:
48
49	$ make P1022DS_SDCARD
50
51Configuration Files
52===================
53
54Below are the configuration files to be used with a particular platform. Keep
55in mind that some of these config files are tied to the platforms DDR speed.
56Please see the SoC reference manual for more documentation.
57
58P1022DS		config_sram_p1022ds.dat
59P2020DS		config_sram_p2020ds.dat
60P2010DS		config_sram_p2020ds.dat
61P1020RDB	config_ddr2_1g_p1020rdb_533M.dat
62P1020RDB	config_ddr2_1g_p1020rdb_667M.dat
63P2020RDB	config_ddr2_1g_p2020rdb_800M.dat
64P2020RDB	config_ddr2_1g_p2020rdb_667M.dat
65P2020RDB	config_ddr3_1gb_64bit_p2020rdb_pc.dat
66P2010RDB	config_ddr3_1gb_64bit_p2020rdb_pc.dat
67P1020RDB	config_ddr3_1gb_p1_p2_rdb_pc_800M.dat
68P1011RDB	config_ddr3_1gb_p1_p2_rdb_pc_800M.dat
69P1010RDB	config_ddr3_1gb_p1010rdb_800M.dat
70P1014RDB	config_ddr3_1gb_p1014rdb_800M.dat
71P1021RDB	config_ddr3_1gb_p1_p2_rdb_pc_800M.dat
72P1012RDB	config_ddr3_1gb_p1_p2_rdb_pc_800M.dat
73P1022DS		config_ddr3_2gb_p1022ds.dat
74P1013DS		config_ddr3_2gb_p1022ds.dat
75P1024RDB	config_ddr3_1gb_p1_p2_rdb_pc_667M.dat
76P1013RDB	config_ddr3_1gb_p1_p2_rdb_pc_667M.dat
77P1025RDB	config_ddr3_1gb_p1_p2_rdb_pc_667M.dat
78P1016RDB	config_ddr3_1gb_p1_p2_rdb_pc_667M.dat
79P1020UTM	config_ddr3_1gb_p1_p2_rdb_pc_800M.dat
80P1020MBG	config_ddr3_1gb_p1_p2_rdb_pc_800M.dat
81MPC8536DS	config_ddr2_512m_mpc8536ds_667M.dat
82