summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorNathan Rossi <nathan.rossi@xilinx.com>2014-11-28 13:57:23 +1000
committerNathan Rossi <nathan.rossi@xilinx.com>2014-12-03 17:45:43 +1000
commitff7609762e100824abcb2faf518c346d07e1a815 (patch)
treed633c4da03e501447e535f92566fc761b7342bac /README
parent4d6683a504e3aefba33774567aa633620d440736 (diff)
downloadmeta-xilinx-ff7609762e100824abcb2faf518c346d07e1a815.tar.gz
Documentation Updates
* Clean up documentation around ext2/cpio * Split out some of the documentation in the README file into some docs/* files * Moved MAINTAINERS information into the README Signed-off-by: Nathan Rossi <nathan.rossi@xilinx.com>
Diffstat (limited to 'README')
-rw-r--r--README54
1 files changed, 15 insertions, 39 deletions
diff --git a/README b/README
index c5c548e6..6e56caf4 100644
--- a/README
+++ b/README
@@ -11,17 +11,23 @@ Boards Supported by this layer (Please refer to the associate .conf for more
11information): 11information):
12 * Xilinx KC705 Embedded TRD (MicroBlaze) 12 * Xilinx KC705 Embedded TRD (MicroBlaze)
13 * Xilinx ZC702 (Zynq) 13 * Xilinx ZC702 (Zynq)
14 * Xilinx ZC706 (Zynq)
14 * Avnet/Digilent ZedBoard (Zynq) 15 * Avnet/Digilent ZedBoard (Zynq)
15 16
16Additional information on the MicroBlaze or Zynq architectures can be found at: 17Additional information on the MicroBlaze or Zynq architectures can be found at:
17 http://www.xilinx.com/support/index.htm 18 http://www.xilinx.com/support/index.htm
18 19
19Patches 20Maintainers, Patches/Submissions, Community
20======= 21===========================================
21 22
22Please submit any patches for this layer to: meta-xilinx@lists.yoctoproject.org. 23Please send any patches, pull requests, comments or questions for this layer to:
23 24
24Please see the MAINTAINERS file for more details. 25 meta-xilinx@lists.yoctoproject.org
26
27Maintainers:
28
29 Nathan Rossi <nathan.rossi@xilinx.com>
30 Sipke Vriend <sipke.vriend@xilinx.com>
25 31
26Dependencies 32Dependencies
27============ 33============
@@ -54,41 +60,11 @@ Build the target file system image using bitbake:
54 60
55 $ bitbake core-image-minimal 61 $ bitbake core-image-minimal
56 62
57Build additional targets, including U-Boot:
58
59 $ bitbake u-boot-xlnx
60
61Once complete the images for the target machine will be available in the output 63Once complete the images for the target machine will be available in the output
62directory 'tmp/deploy/images'. 64directory 'tmp/deploy/images'.
63 65
64Images generated: 66Additional Documentation
65 * core-image-minimal-<machine name>.tar.gz (rootfs tar+GZIP) 67========================
66 * core-image-minimal-<machine name>.cpio (rootfs in CPIO format) 68
67 * core-image-minimal-<machine name>.ext2.gz.u-boot (rootfs in EXT2+GZIP, u-boot wrapped format) 69Additional documentation can be found in the 'docs/*' directory of this layer.
68 * u-boot.elf (U-Boot ELF) 70
69 * For Zynq:
70 * uImage (Linux Kernel binary, in u-boot wrapped format)
71 * uImage-<machine name>.dtb (DTB for target machine)
72 * For MicroBlaze:
73 * linux.bin.ub (Linux Kernel binary, in u-boot wrapped format)
74 * linux.bin.ub-<machine name>.dtb (DTB for target machine)
75
76Booting
77=======
78
79Please see the associated README file for each avaliable boot method in the
80'docs/BOOT.*' files of this layer.
81
82Configuring External Toolchain
83==============================
84
85In order to build with an external toolchain some additional configuration must
86be set in the build environments local.conf. First configure the use of an
87external toolchain, including the location to the toolchain:
88
89 TCMODE = "external-xilinx"
90 EXTERNAL_TOOLCHAIN = "<path to toolchain>"
91
92WARNING: There is a known issue with the MicroBlaze Linux toolchain provided by
93XSDK 2013.3 where certain shift instructions are not generated correctly, avoid
94using this toolchain. Use the newer XSDK 2013.4 or PetaLinux 2013.10 toolchains.