13.10: post-release updated to INSTALL instructions

ARM have provided some feedback about the installation instructions
post-release.

There was much confusion over the list of artifacts and what each file
was.  I created a simple table to explain this.

Also, the instructions for running the prebuilt images were missing.

Change-Id: I1e0ad797704b3bd9c114a80fc736c9bc4a03728d
Signed-off-by: Ryan Harkin <ryan.harkin@linaro.org>

1 files changed, 35 insertions, 14 deletions

diff --git a/INSTALL.textile b/INSTALL.textile
index 6c1f230..fc26e5c 100644
--- a/INSTALL.textile
+++ b/INSTALL.textile
@@ -1,8 +1,18 @@
 Linaro OpenEmbedded releases are made up of the following components.
 
-* a hardware pack supporting Foundation, VE and FVP Base Models
-* a choice of Root file system (RootFS) images
-* The Linux kernel file with and without boot wrapper shims, depending on the version of the model you are using
+| *.img.gz | pre-built images for minimal, LAMP and LEG root filesystems |
+| hwpack_*.tar.gz | a single hardware pack for the Foundation, VE[1] and FVP Base Models |
+| linaro-image-*.rootfs.tar.gz | a choice of Root file system (RootFS) images |
+| Image | kernel used by UEFI and the FVP Base models |
+| foundation.axf | kernel binary wrapped for the Foundation models |
+| img.axf | kernel binary wrapped for the VE models |
+| [bB]*.bin | ARM Trused Firmware binaries |
+| *.dtb files | Device Tree Binaries for the FVP Base Models |
+| uefi_*.bin | UEFI binaries for the supported models |
+
+Other files such as *.manifest, *.txt and *.html provide information such as package contents or MD5SUMs about the files they share a common filename with.
+
+fn1. Linaro does not provide support for running the VE models.
 
 h2. Using pre-built image
 
@@ -11,8 +21,19 @@ h3. Prerequisites
 * Ubuntu 12.04 64 bit or newer on your desktop PC ("www.ubuntu.com":http://www.ubuntu.com)
 * Foundation, Versatile Express or Base platform fast model ("Linaro ARMv8 Engineering":http://www.linaro.org/engineering/armv8/)
 * Artifacts for this release downloaded from the above list.
+You will need most of the files (*.bin, *.dtb, *.axf, Image, etc.) from the list above in addition to the pre-built image of your choice.
 * 13.10 linaro-image-tools or later
 
+
+h3. Installation Steps
+
+* Unzip the downloaded pre-built image
+
+bc. gunzip vexpress64-openembedded_*-armv8*.img.gz
+
+* Skip to the section below showing how to "Boot the image":#boot_the_image.
+Replace sd.img with the filename of the image unzipped above.
+
 h2. Build Your Own Image
 
 h3. Installing Linaro Image Tools
@@ -45,11 +66,13 @@ h3. Creating a disk image
 * Create the image
 
 bc. linaro-media-create --dev fastmodel --output-directory fastmodel --image_size 2000M --hwpack <hwpack filename> --binary <rootfs filename>
+cd fastmodel
+
+h2(#boot_the_image). Boot the image
 
-h2. Booting the image on the FVP Base AEMv8 model
+h3. Using the FVP Base AEMv8 model
 
-bc. cd fastmodel
-<path to model installation>/models/Linux64_GCC-4.1/FVP_Base_AEMv8A-AEMv8A \
+bc. <path to model installation>/models/Linux64_GCC-4.1/FVP_Base_AEMv8A-AEMv8A \
 -C pctl.startup=0.0.0.0 \
 -C bp.secure_memory=0 \
 -C cluster0.NUM_CORES=4 \
@@ -60,12 +83,11 @@ bc. cd fastmodel
 -C bp.flashloader0.fname=uefi_fvp-base.bin \
 -C bp.virtioblockdevice.image_path=sd.img
 
-h2. Booting the image on the FVP Base Cortex model
+h3. Using the FVP Base Cortex model
 
 To boot the A57x1 + A53x1 model:
 
-bc. cd fastmodel
-<path to model installation>/models/Linux64_GCC-4.1/FVP_Base_Cortex-A57x1-A53x1 \
+bc. <path to model installation>/models/Linux64_GCC-4.1/FVP_Base_Cortex-A57x1-A53x1 \
 -C pctl.startup=0.0.0.0 \
 -C bp.secure_memory=0 \
 -C cache_state_modelled=1 \
@@ -76,8 +98,7 @@ bc. cd fastmodel
 
 To boot the A57x4 + A53x4 model, use the same command, only specify a different model binary:
 
-bc. cd fastmodel
-<path to model installation>/models/Linux64_GCC-4.1/FVP_Base_Cortex-A57x4-A53x4 \
+bc. <path to model installation>/models/Linux64_GCC-4.1/FVP_Base_Cortex-A57x4-A53x4 \
 -C pctl.startup=0.0.0.0 \
 -C bp.secure_memory=0 \
 -C cache_state_modelled=1 \
@@ -86,7 +107,7 @@ bc. cd fastmodel
 -C bp.flashloader0.fname=uefi_fvp-base.bin \
 -C bp.virtioblockdevice.image_path=sd.img
 
-h2. Using Ethernet networking with the FVP Base Models
+h3. Using Ethernet networking with the FVP Base Models
 
 To enable networking in the FVP models, you should install a network TAP on your local machine.  See the Fast Models User Guide for more information on setting up a TAP for use with the models.
 
@@ -96,7 +117,7 @@ bc. -C bp.hostbridge.interfaceName=ARM$USER \
 -C bp.smsc_91c111.enabled=true \
 -C bp.smsc_91c111.mac_address=<MAC address, eg, 00:11:22:33:44:55>
 
-h2. Booting the image on the Foundation Model
+h3. Booting the image on the Foundation Model
 
 If you are using the Foundation Model and wish to use a pre-built image, you can simply unzip the downloaded pre-built image and the img-foundation.axf file and run the following command:
 
@@ -107,5 +128,5 @@ bc. <path to model installation>/Foundation_v8 --image img-foundation.axf \
 To use the image you built with linaro-media-create in the steps above, run this command:
 
 bc. <path to model installation>/Foundation_v8 --image img-foundation.axf \
-  --block-device fastmodel/sd.img \
+  --block-device sd.img \
   --network nat