docs: Improve documentation of Zynq and MicroBlaze boot flows

* Add BOOT.jtag to cover booting u-boot for Zynq and MicroBlaze
* Add BOOT.tftp to cover booting the kernel for Zynq and MicroBlaze
* Add BOOT.sdcard to cover booting Zynq (using BOOT.BIN)

Signed-off-by: Nathan Rossi <nathan.rossi@xilinx.com>

3 files changed, 82 insertions, 0 deletions

diff --git a/docs/BOOT.jtag b/docs/BOOT.jtag
new file mode 100644
index 00000000..0588e822
--- /dev/null
+++ b/docs/BOOT.jtag
@@ -0,0 +1,30 @@
+
+Loading U-Boot via JTAG
+=======================
+
+Note: This boot flow requires access to Xilinx tools (for JTAG programming).
+
+Download the bitstream for the target machine using JTAG (The pre-built
+bitstream provided in the reference design files should be used).
+
+(MicroBlaze) Download the 'u-boot.elf' to the target CPU via the use of XMD.
+        $ xmd
+        XMD% connect mb mdm
+        XMD% rst
+        XMD% dow u-boot.elf
+        XMD% con
+
+(Zynq) Download the 'u-boot.elf' to the target CPU via the use of XMD.
+(Note: Ensure to have the boot mode pins/switches configured in JTAG mode)
+        $ xmd
+        XMD% connect arm hw
+        XMD% rst
+        XMD% dow zynq_fsbl_0.elf
+        XMD% con; sleep 1; stop
+        XMD% dow u-boot.elf
+        XMD% con
+
+U-Boot will load and the console will be avaliable on the UART interface.
+        ...
+        Hit any key to stop autoboot: 0
+        U-Boot> 
diff --git a/docs/BOOT.sdcard b/docs/BOOT.sdcard
new file mode 100644
index 00000000..5afaff47
--- /dev/null
+++ b/docs/BOOT.sdcard
@@ -0,0 +1,17 @@
+
+SD Card Boot (Zynq Only)
+========================
+
+Note: This boot flow requires access to Xilinx tools (for BOOT.BIN generation).
+
+Copy the following to the SD card (ensure to rename the files where appropriate):
+        Kernel: uImage
+        RootFS: uramdisk.image.gz (core-image-minimal-<machine name>.ext2.gz.u-boot)
+        DTB:    devicetree.dtb (uImage-<machine name>.dtb)
+
+Using the Xilinx tools, package 'zynq_fsbl_0.elf' and 'u-boot.elf' into a 
+'BOOT.BIN' (See http://www.wiki.xilinx.com/Prepare+Boot+Image for details). Once
+created copy 'BOOT.BIN' onto the SD Card.
+
+Insert SD Card, connect UART to Terminal program and boot board (Ensure the
+board is configured for SD Boot).
diff --git a/docs/BOOT.tftp b/docs/BOOT.tftp
new file mode 100644
index 00000000..3c6b98cf
--- /dev/null
+++ b/docs/BOOT.tftp
@@ -0,0 +1,35 @@
+
+Boot Linux via TFTP (using U-Boot)
+==================================
+
+Note: This boot flow requires a TFTP server.
+
+Boot your system into U-Boot, using an alternative boot method (e.g. JTAG, SD).
+
+Place the following images into the root of the TFTP server directory:
+        * core-image-minimal-<machine name>.ext2.gz.u-boot (RootFS)
+        * linux.bin.ub or uImage (Linux Kernel)
+        * <kernel binary>-<machine name>.dtb (DTB)
+
+The serial console of the target board will display the U-Boot console.
+Configure the 'ipaddr' and 'serverip' of the U-Boot environment.
+        U-Boot> set serverip <server ip>
+        U-Boot> set ipaddr <board ip>
+
+Using the U-Boot console; load the Kernel, RootFS and the DTB into memory.
+And then boot Linux using the 'bootm' command. (Note the load addresses will
+be dependant on machine used)
+
+For MicroBlaze (kc705-trd-microblazeel):
+        U-Boot> tftp 0x86000000 linux.bin.ub
+        U-Boot> tftp 0x85000000 core-image-minimal-<machine name>.ext2.gz.u-boot
+        U-Boot> tftp 0x84000000 linux.bin.ub-<machine name>.dtb
+        U-Boot> bootm 0x86000000 0x85000000 0x84000000
+
+For Zynq:
+        U-Boot> tftp 0x3000000 uImage
+        U-Boot> tftp 0x2000000 core-image-minimal-<machine name>.ext2.gz.u-boot
+        U-Boot> tftp 0x2A00000 uImage-<machine name>.dtb
+        U-Boot> bootm 0x3000000 0x2000000 0x2A00000
+
+U-Boot will prepare the Kernel for boot and then it will being to initialize.