diff options
author | Nathan Rossi <nathan.rossi@xilinx.com> | 2014-03-12 18:10:34 +1000 |
---|---|---|
committer | Nathan Rossi <nathan.rossi@xilinx.com> | 2014-03-12 18:10:34 +1000 |
commit | 0b724effb21e0a586fc4a1ce794e5bdbedc2aea8 (patch) | |
tree | 7f8193d9ca91606fbd8be9dcb0ebe7d57caaf6e8 /docs | |
parent | ee89ef1f3bce7166f77bf57a1a093195ea58c898 (diff) | |
download | meta-xilinx-0b724effb21e0a586fc4a1ce794e5bdbedc2aea8.tar.gz |
docs/BOOT.sdcard: Update documentation for sd booting
* Remove documentation of -ram.dts and -mmcblk*.dts files
* Use the "bootargs" variable of U-Boot to configure kernel 'root='
* Document the use of "uEnv.txt"
Signed-off-by: Nathan Rossi <nathan.rossi@xilinx.com>
Diffstat (limited to 'docs')
-rw-r--r-- | docs/BOOT.sdcard | 94 |
1 files changed, 65 insertions, 29 deletions
diff --git a/docs/BOOT.sdcard b/docs/BOOT.sdcard index ebaf9709..488638c9 100644 --- a/docs/BOOT.sdcard +++ b/docs/BOOT.sdcard | |||
@@ -9,33 +9,69 @@ Creating boot file | |||
9 | Using the Xilinx tools, package 'zynq_fsbl_0.elf' and 'u-boot.elf' into a | 9 | Using the Xilinx tools, package 'zynq_fsbl_0.elf' and 'u-boot.elf' into a |
10 | 'BOOT.BIN' (See http://www.wiki.xilinx.com/Prepare+Boot+Image for details). | 10 | 'BOOT.BIN' (See http://www.wiki.xilinx.com/Prepare+Boot+Image for details). |
11 | 11 | ||
12 | Boot using a ramdisk | 12 | Additionally if you require a bitstream at boot ensure that the bitstream is |
13 | -------------------- | 13 | included in the BOOT.BIN. |
14 | |||
15 | Booting to U-Boot via SD | ||
16 | ------------------------ | ||
17 | Use an SD card with partition one in FAT16 format. | ||
18 | |||
19 | Copy the following to the SD card partition one: | ||
20 | * Boot file: BOOT.BIN | ||
21 | |||
22 | Insert the SD Card, connect UART to terminal program and boot the board the | ||
23 | board. (Ensure the board is configured via the MIO's for SD Boot). | ||
24 | |||
25 | Booting the Kernel (with ramdisk rootfs) | ||
26 | ---------------------------------------- | ||
14 | Use an SD card with partition one in FAT16 format. | 27 | Use an SD card with partition one in FAT16 format. |
15 | Copy the following to the SD card partition one (ensure to rename the files | 28 | |
16 | where appropriate): | 29 | Copy the following to the SD card partition one: |
17 | Boot file: BOOT.BIN | 30 | * Kernel: uImage |
18 | Kernel: uImage | 31 | * Root FS: core-image-minimal-<machine name>.ext2.gz.u-boot |
19 | RootFS: uramdisk.image.gz (core-image-minimal-<machine name>.ext2.gz.u-boot) | 32 | * Devicetree: uImage-<machine name>.dtb |
20 | DTB: devicetree.dtb (uImage-<machine name>-ram.dtb) | 33 | |
21 | 34 | Also create the file "uEnv.txt" on the SD card parition one, with the following | |
22 | Insert SD Card, connect UART to Terminal program and boot board (Ensure the | 35 | contents. Replacing the names of files where appropriate (this file will be |
23 | board is configured for SD Boot). | 36 | loaded into the U-Boot environment). Ensure to replace the file names with the |
24 | 37 | correct name for you machine/system. | |
25 | Boot using SD card partition | 38 | |
26 | ---------------------------- | 39 | kernel_image=uImage |
27 | Use an SD card with partition one in FAT16 format and partition two in EXT2 format. | 40 | devicetree_image=uImage-<machine name>.dtb |
28 | Copy the following to the SD card partition one (ensure to rename the files where | 41 | ramdisk_image=core-image-minimal-<machine name>.ext2.gz.u-boot |
29 | appropriate): | 42 | |
30 | Boot file: BOOT.BIN | 43 | Alternatively you can use the default names for the images, rename them |
31 | Kernel: uImage | 44 | according to below and copy them onto partition one. Doing this removes the need |
32 | DTB: devicetree.dtb (uImage-<machine name>-mmcblk0p2.dtb) | 45 | to create the uEnv.txt file. |
33 | Extract the following to the SD card partion two | 46 | |
34 | RootFS: core-image-minimal-<machine name>.tar.gz | 47 | * Kernel: uImage |
35 | 48 | * Root FS: uramdisk.image.gz | |
36 | Insert SD Card, connect UART to Terminal program and boot board. | 49 | * Devicetree: devicetree.dtb |
37 | The loading of 'ramdisk' will fail as it is not present. Perform a manual | 50 | |
38 | boot by typing | 51 | Insert the SD Card, connect UART to terminal program and boot the board the |
39 | bootm 0x3000000 - 0x2A00000 | 52 | board. (Ensure the board is configured via the MIO's for SD Boot). |
40 | Refer to u-boot documention to see how to modify and save these settings, | 53 | |
41 | so the following boot will correctly locate the rootfs in partition two. | 54 | Booting the Kernel (with mmcblk/SD card rootfs) |
55 | ----------------------------------------------- | ||
56 | Use an SD card with partition one in FAT16 format, and an additional partition | ||
57 | for the root filesystem (formatted as EXT2). | ||
58 | |||
59 | Copy the following to the SD card partition one: | ||
60 | * Kernel: uImage | ||
61 | * Devicetree: uImage-<machine name>.dtb | ||
62 | |||
63 | Extract the following to the SD card partion two: | ||
64 | * Root FS: core-image-minimal-<machine name>.tar.gz | ||
65 | |||
66 | Also create the file "uEnv.txt" on the SD card parition one, with the following | ||
67 | contents. Replacing the names of files where appropriate (this file will be | ||
68 | loaded into the U-Boot environment). Ensure to replace the file names with the | ||
69 | correct name for you machine/system. | ||
70 | |||
71 | kernel_image=uImage | ||
72 | devicetree_image=uImage-<machine name>.dtb | ||
73 | bootargs=console=ttyPS0,115200 root=/dev/mmcblk0p2 rw rootwait earlyprintk | ||
74 | uenvcmd=echo Copying Linux from SD to RAM... && fatload mmc 0 0x3000000 ${kernel_image} && fatload mmc 0 0x2A00000 ${devicetree_image} && bootm 0x3000000 - 0x2A00000 | ||
75 | |||
76 | Insert the SD Card, connect UART to terminal program and boot the board the | ||
77 | board. (Ensure the board is configured via the MIO's for SD Boot). | ||