diff options
| author | Nathan Rossi <nathan@nathanrossi.com> | 2017-02-09 02:18:12 +1000 |
|---|---|---|
| committer | Nathan Rossi <nathan@nathanrossi.com> | 2017-02-16 13:55:57 +1000 |
| commit | df9184e66d6da0a40b04ffa95e65461f8f10dc9a (patch) | |
| tree | a3ea5e67d7d51ef18c4a0ee6042b87974007bebf | |
| parent | 1c91956a05ec272fc6dfa739a26e924464772780 (diff) | |
| download | meta-xilinx-df9184e66d6da0a40b04ffa95e65461f8f10dc9a.tar.gz | |
docs/*: Remove old documentation
The documentation in the docs/ directory is now out dated and was
replaced with the README.*.md files in the root of the repository.
Signed-off-by: Nathan Rossi <nathan@nathanrossi.com>
| -rw-r--r-- | docs/BOOT.jtag | 30 | ||||
| -rw-r--r-- | docs/BOOT.sdcard | 77 | ||||
| -rw-r--r-- | docs/BOOT.tftp | 35 | ||||
| -rw-r--r-- | docs/Rootfs | 11 |
4 files changed, 0 insertions, 153 deletions
diff --git a/docs/BOOT.jtag b/docs/BOOT.jtag deleted file mode 100644 index 0588e822..00000000 --- a/docs/BOOT.jtag +++ /dev/null | |||
| @@ -1,30 +0,0 @@ | |||
| 1 | |||
| 2 | Loading U-Boot via JTAG | ||
| 3 | ======================= | ||
| 4 | |||
| 5 | Note: This boot flow requires access to Xilinx tools (for JTAG programming). | ||
| 6 | |||
| 7 | Download the bitstream for the target machine using JTAG (The pre-built | ||
| 8 | bitstream provided in the reference design files should be used). | ||
| 9 | |||
| 10 | (MicroBlaze) Download the 'u-boot.elf' to the target CPU via the use of XMD. | ||
| 11 | $ xmd | ||
| 12 | XMD% connect mb mdm | ||
| 13 | XMD% rst | ||
| 14 | XMD% dow u-boot.elf | ||
| 15 | XMD% con | ||
| 16 | |||
| 17 | (Zynq) Download the 'u-boot.elf' to the target CPU via the use of XMD. | ||
| 18 | (Note: Ensure to have the boot mode pins/switches configured in JTAG mode) | ||
| 19 | $ xmd | ||
| 20 | XMD% connect arm hw | ||
| 21 | XMD% rst | ||
| 22 | XMD% dow zynq_fsbl_0.elf | ||
| 23 | XMD% con; sleep 1; stop | ||
| 24 | XMD% dow u-boot.elf | ||
| 25 | XMD% con | ||
| 26 | |||
| 27 | U-Boot will load and the console will be avaliable on the UART interface. | ||
| 28 | ... | ||
| 29 | Hit any key to stop autoboot: 0 | ||
| 30 | U-Boot> | ||
diff --git a/docs/BOOT.sdcard b/docs/BOOT.sdcard deleted file mode 100644 index 62897f3c..00000000 --- a/docs/BOOT.sdcard +++ /dev/null | |||
| @@ -1,77 +0,0 @@ | |||
| 1 | |||
| 2 | SD Card Boot (Zynq Only) | ||
| 3 | ======================== | ||
| 4 | |||
| 5 | Note: This boot flow requires access to Xilinx tools (for BOOT.BIN generation). | ||
| 6 | |||
| 7 | Creating boot file | ||
| 8 | ------------------ | ||
| 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). | ||
| 11 | |||
| 12 | Additionally if you require a bitstream at boot ensure that the bitstream is | ||
| 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 | ---------------------------------------- | ||
| 27 | Use an SD card with partition one in FAT16 format. | ||
| 28 | |||
| 29 | Copy the following to the SD card partition one: | ||
| 30 | * Kernel: uImage | ||
| 31 | * Root FS: core-image-minimal-<machine name>.cpio.gz.u-boot | ||
| 32 | * Devicetree: uImage-<machine name>.dtb | ||
| 33 | |||
| 34 | Also create the file "uEnv.txt" on the SD card parition one, with the following | ||
| 35 | contents. Replacing the names of files where appropriate (this file will be | ||
| 36 | loaded into the U-Boot environment). Ensure to replace the file names with the | ||
| 37 | correct name for you machine/system. | ||
| 38 | |||
| 39 | kernel_image=uImage | ||
| 40 | devicetree_image=uImage-<machine name>.dtb | ||
| 41 | ramdisk_image=core-image-minimal-<machine name>.cpio.gz.u-boot | ||
| 42 | |||
| 43 | Alternatively you can use the default names for the images, rename them | ||
| 44 | according to below and copy them onto partition one. Doing this removes the need | ||
| 45 | to create the uEnv.txt file. | ||
| 46 | |||
| 47 | * Kernel: uImage | ||
| 48 | * Root FS: uramdisk.image.gz | ||
| 49 | * Devicetree: devicetree.dtb | ||
| 50 | |||
| 51 | Insert the SD Card, connect UART to terminal program and boot the board the | ||
| 52 | board. (Ensure the board is configured via the MIO's for SD Boot). | ||
| 53 | |||
| 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/3/4). | ||
| 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). | ||
diff --git a/docs/BOOT.tftp b/docs/BOOT.tftp deleted file mode 100644 index 5b6d3386..00000000 --- a/docs/BOOT.tftp +++ /dev/null | |||
| @@ -1,35 +0,0 @@ | |||
| 1 | |||
| 2 | Boot Linux via TFTP (using U-Boot) | ||
| 3 | ================================== | ||
| 4 | |||
| 5 | Note: This boot flow requires a TFTP server. | ||
| 6 | |||
| 7 | Boot your system into U-Boot, using an alternative boot method (e.g. JTAG, SD). | ||
| 8 | |||
| 9 | Place the following images into the root of the TFTP server directory: | ||
| 10 | * core-image-minimal-<machine name>.cpio.gz.u-boot (RootFS) | ||
| 11 | * linux.bin.ub or uImage (Linux Kernel) | ||
| 12 | * <kernel binary>-<machine name>.dtb (DTB) | ||
| 13 | |||
| 14 | The serial console of the target board will display the U-Boot console. | ||
| 15 | Configure the 'ipaddr' and 'serverip' of the U-Boot environment. | ||
| 16 | U-Boot> set serverip <server ip> | ||
| 17 | U-Boot> set ipaddr <board ip> | ||
| 18 | |||
| 19 | Using the U-Boot console; load the Kernel, RootFS and the DTB into memory. | ||
| 20 | And then boot Linux using the 'bootm' command. (Note the load addresses will | ||
| 21 | be dependant on machine used) | ||
| 22 | |||
| 23 | For MicroBlaze (kc705-microblazeel): | ||
| 24 | U-Boot> tftpboot 0x85000000 linux.bin.ub | ||
| 25 | U-Boot> tftpboot 0x86000000 core-image-minimal-<machine name>.cpio.gz.u-boot | ||
| 26 | U-Boot> tftpboot 0x84000000 <machine name>.dtb | ||
| 27 | U-Boot> bootm 0x85000000 0x86000000 0x84000000 | ||
| 28 | |||
| 29 | For Zynq: | ||
| 30 | U-Boot> tftpboot 0x2000000 uImage | ||
| 31 | U-Boot> tftpboot 0x3000000 core-image-minimal-<machine name>.cpio.gz.u-boot | ||
| 32 | U-Boot> tftpboot 0x2A00000 uImage-<machine name>.dtb | ||
| 33 | U-Boot> bootm 0x2000000 0x3000000 0x2A00000 | ||
| 34 | |||
| 35 | U-Boot will prepare the Kernel for boot and then it will being to initialize. | ||
diff --git a/docs/Rootfs b/docs/Rootfs deleted file mode 100644 index 656b4b36..00000000 --- a/docs/Rootfs +++ /dev/null | |||
| @@ -1,11 +0,0 @@ | |||
| 1 | |||
| 2 | Configuring Additional RootFS Output Images | ||
| 3 | =========================================== | ||
| 4 | |||
| 5 | To configure the build or the machine to output additional rootfs image types | ||
| 6 | the IMAGE_FSTYPES variable can be overridden or appended to. | ||
| 7 | |||
| 8 | e.g. Add ext2 and ext2.gz.u-boot image types to the local.conf | ||
| 9 | |||
| 10 | IMAGE_FSTYPES += "ext2 ext2.gz.u-boot" | ||
| 11 | |||
