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