blob: 329de4e6c4c13dd668bd373df46a42295b727a5c [file] [log] [blame]
Ying Zhangbb0dc102013-08-16 15:16:11 +08001----------------------------------------
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:
Pali Rohárd66b0f52022-03-25 10:51:46 +010017https://source.codeaurora.org/external/qoriq/qoriq-yocto-sdk/boot-format
Ying Zhangbb0dc102013-08-16 15:16:11 +080018
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
Ying Zhangbb0dc102013-08-16 15:16:11 +080060P1020RDB config_ddr2_1g_p1020rdb_533M.dat
61P1020RDB config_ddr2_1g_p1020rdb_667M.dat
62P2020RDB config_ddr2_1g_p2020rdb_800M.dat
63P2020RDB config_ddr2_1g_p2020rdb_667M.dat
64P2020RDB config_ddr3_1gb_64bit_p2020rdb_pc.dat
Ying Zhangbb0dc102013-08-16 15:16:11 +080065P1020RDB config_ddr3_1gb_p1_p2_rdb_pc_800M.dat
66P1011RDB config_ddr3_1gb_p1_p2_rdb_pc_800M.dat
67P1010RDB config_ddr3_1gb_p1010rdb_800M.dat
Ying Zhangbb0dc102013-08-16 15:16:11 +080068P1021RDB config_ddr3_1gb_p1_p2_rdb_pc_800M.dat
Ying Zhangbb0dc102013-08-16 15:16:11 +080069P1022DS config_ddr3_2gb_p1022ds.dat
Ying Zhangbb0dc102013-08-16 15:16:11 +080070P1024RDB config_ddr3_1gb_p1_p2_rdb_pc_667M.dat
Ying Zhangbb0dc102013-08-16 15:16:11 +080071P1025RDB config_ddr3_1gb_p1_p2_rdb_pc_667M.dat
72P1016RDB config_ddr3_1gb_p1_p2_rdb_pc_667M.dat
73P1020UTM config_ddr3_1gb_p1_p2_rdb_pc_800M.dat
74P1020MBG config_ddr3_1gb_p1_p2_rdb_pc_800M.dat
75MPC8536DS config_ddr2_512m_mpc8536ds_667M.dat