14.06: sync and update firmware and UEFI instructions

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

2 files changed, 50 insertions, 26 deletions

diff --git a/android/images/armv8-android-juno-lsk/HOWTO_install.txt b/android/images/armv8-android-juno-lsk/HOWTO_install.txt
index 89106c8..8f86ff9 100644
--- a/android/images/armv8-android-juno-lsk/HOWTO_install.txt
+++ b/android/images/armv8-android-juno-lsk/HOWTO_install.txt
@@ -14,6 +14,7 @@ Linaro Android releases are made up of the following components.
 | ramdisk.img | Ramdisk image |
 | linaro_android_build_cmds.sh | Build script for the complete Android release |
 | linaro_kernel_build_cmds.sh | Build script for the Linux kernel |
+| board_recovery_image_0.7.5.zip | Juno board firmware recovery image |
 
 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.
 
@@ -24,16 +25,16 @@ Linaro provides two methods for installing Linaro binary builds:
 
 h2. Pre-Installation Steps
 
-Before any installation begins, it is important that you ensure your board has the latest firmware installed. Please see "Juno Board Recovery Image and MCC firmware update" below for the latest updates and installation instructions.  The 14.06 release has been tested with Firmware version 0.7.1, but we always recommend that users install the latest version available.
+Before any installation begins, it is important that you ensure your board has the latest "firmware":#firmware installed. Please see "Juno Board Recovery Image and MCC firmware update":#firmware below for the latest updates and installation instructions.  The 14.06 release has been formally QA tested with Firmware version 0.7.1 and sanity tested with Firmware version 0.7.5, but we always recommend that users install the latest version available.
 
 h2. Using pre-built image
 
 h3. Prerequisites
 
-* Ubuntu 12.04 64 bit or newer on your desktop PC, which you can download from "www.ubuntu.com":http://www.ubuntu.com
+* Ubuntu 12.04 64 bit or newer on your desktop PC ("www.ubuntu.com":http://www.ubuntu.com)
 * 4GB USB drive or larger
-* Latest firmware installed onto the board. Please see "Firmware Update tab":https://releases.linaro.org/14.06/android/images/armv8-android-juno-lsk/#tabs-4
-* This release pre-built image (vexpress.img.bz2), which you can downloaded from the above list of artifacts or just click "here":http://releases.linaro.org/14.06/android/images/armv8-android-juno-lsk/vexpress.img.bz2
+* Latest firmware installed onto the board. Please see "Juno Board Recovery Image and MCC firmware update":#firmware section below
+* This release pre-built image, which you can download from the above list of artifacts
 
 h3. Installation Steps
 
@@ -50,7 +51,7 @@ When the image is created, skip down to the section "Booting the image".
 
 <hr>
 
-h2. Building a custom image using pre-built components.
+h2. Building a custom image using pre-built components
 
 Sometimes, you may wish to build your own custom image for your board. Perhaps you wish to use a more recent snapshot of the "hardware pack":https://wiki.linaro.org/HardwarePacks or take the latest Android build. Whatever the reason, you will want to use the "Linaro Image Tools":https://wiki.linaro.org/Linaro-Image-Tools to create a custom image.
 
@@ -99,13 +100,22 @@ h2. Booting the image
 
 After the media create tool has finished executing, remove the USB drive from your PC and insert it into the board.
 
-Before you can boot the image you will need to install the latest firmware on the board. The instructions below provide information on how to do this.  See the "UEFI wiki":https://wiki.linaro.org/ARM/UEFI#Configure_UEFI for more information on how to configure UEFI to boot disk images.
+Before you can boot the image you will need to install the latest "firmware":#firmware on the board. The "instructions below":#firmware provide information on how to do this.
+
+See the "UEFI wiki":https://wiki.linaro.org/ARM/UEFI#Configure_UEFI for more information on how to configure UEFI to boot disk images.
 
 In general terms, you use the UEFI Boot Manager to configure the "Boot Device":
-* select USB device's boot partition after selecting "Add Boot Device Entry".
-* use "kernel" when prompted for the file path of the EFI application or then kernel
-* use "ramdisk.img" when prompted for the file path of the initrd
-* change the arguments to pass to the binary to "console=ttyAMA0,115200 earlyprintk=pl011,0x7ff80000 root=/dev/ram0 verbose debug"
+* select USB device's boot partition after selecting option "@[1] Add Boot Device Entry@", then:
+
+bc. File path of the EFI Application or the kernel: kernel
+Has FDT support? [y/n] y
+Add an initrd: [y/n] y
+File path of the initrd: ramdisk.img
+Arguments to pass to the binary: console=ttyAMA0,115200 earlyprintk=pl011,0x7ff80000 root=/dev/ram0 verbose debug
+
+* select option @"[4] Update FDT path"@ from the Boot Menu, choose the boot partition, then:
+
+bc. File path of the FDT blob: juno.dtb
 
 
 h2. DS-5 Configuration Files for Juno
@@ -130,7 +140,7 @@ b.      Location, which must be the directory that you extracted the DS-5 c
 
  
 
-h2. Juno Board Recovery Image and MCC firmware update
+h2(#firmware). Juno Board Recovery Image and MCC firmware update
 
 This section describes how to reset all firmware images to their factory default state. This procedure is also the only way that you can install updates to the MCC firmware.
 
@@ -160,9 +170,11 @@ The configuration flash memory should now be visible on the host computer as a m
 
 6.      If you wish to update the MCC firmware only then skip to step 7. Otherwise, for a full system recovery, format the configuration flash memory (FAT16).
 
-7.      Extract the board recovery image to the root directory of the configuration flash memory, preserving the directory structure.
+7.      Extract the board recovery image ("board_recovery_image_0.7.5.zip":http://releases.linaro.org/14.06/android/images/armv8-android-juno-lsk/board_recovery_image_0.7.5.zip) to the root directory of the configuration flash memory, preserving the directory structure.
+
+8.      Safely eject the mass storage device, giving it time to write the files to the internal storage.
 
-8.      Press the red ON/OFF button on the rear panel of the board and wait for reprogramming to complete.
+9.      Press the red ON/OFF button on the rear panel of the board and wait for reprogramming to complete.
 
 The board will load the default configuration and boot up.
 
diff --git a/android/images/armv8-juice-juno-lsk/HOWTO_install.txt b/android/images/armv8-juice-juno-lsk/HOWTO_install.txt
index 90fad88..a4969a3 100644
--- a/android/images/armv8-juice-juno-lsk/HOWTO_install.txt
+++ b/android/images/armv8-juice-juno-lsk/HOWTO_install.txt
@@ -14,6 +14,7 @@ Linaro Android releases are made up of the following components.
 | ramdisk.img | Ramdisk image |
 | linaro_android_build_cmds.sh | Build script for the complete Android release |
 | linaro_kernel_build_cmds.sh | Build script for the Linux kernel |
+| board_recovery_image_0.7.5.zip | Juno board firmware recovery image |
 
 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.
 
@@ -24,16 +25,16 @@ Linaro provides two methods for installing Linaro binary builds:
 
 h2. Pre-Installation Steps
 
-Before any installation begins, it is important that you ensure your board has the latest firmware installed. Please see "Juno Board Recovery Image and MCC firmware update" below for the latest updates and installation instructions.  The 14.06 release has been tested with Firmware version 0.7.1, but we always recommend that users install the latest version available.
+Before any installation begins, it is important that you ensure your board has the latest "firmware":#firmware installed. Please see "Juno Board Recovery Image and MCC firmware update":#firmware below for the latest updates and installation instructions.  The 14.06 release has been formally QA tested with Firmware version 0.7.1 and sanity tested with Firmware version 0.7.5, but we always recommend that users install the latest version available.
 
 h2. Using pre-built image
 
 h3. Prerequisites
 
-* Ubuntu 12.04 64 bit or newer on your desktop PC, which you can download from "www.ubuntu.com":http://www.ubuntu.com
+* Ubuntu 12.04 64 bit or newer on your desktop PC ("www.ubuntu.com":http://www.ubuntu.com)
 * 4GB USB drive or larger
-* Latest firmware installed onto the board. Please see "Firmware Update tab":https://releases.linaro.org/14.06/android/images/armv8-juice-juno-lsk/#tabs-4
-* This release pre-built image (vexpress.img.bz2), which you can downloaded from the above list of artifacts or just click "here":http://releases.linaro.org/14.06/android/images/armv8-juice-juno-lsk/vexpress.img.bz2
+* Latest firmware installed onto the board. Please see "Juno Board Recovery Image and MCC firmware update":#firmware section below
+* This release pre-built image, which you can download from the above list of artifacts
 
 h3. Installation Steps
 
@@ -50,7 +51,7 @@ When the image is created, skip down to the section "Booting the image".
 
 <hr>
 
-h2. Building a custom image using pre-built components.
+h2. Building a custom image using pre-built components
 
 Sometimes, you may wish to build your own custom image for your board. Perhaps you wish to use a more recent snapshot of the "hardware pack":https://wiki.linaro.org/HardwarePacks or take the latest Android build. Whatever the reason, you will want to use the "Linaro Image Tools":https://wiki.linaro.org/Linaro-Image-Tools to create a custom image.
 
@@ -99,13 +100,22 @@ h2. Booting the image
 
 After the media create tool has finished executing, remove the USB drive from your PC and insert it into the board.
 
-Before you can boot the image you will need to install the latest firmware on the board. The instructions below provide information on how to do this.  See the "UEFI wiki":https://wiki.linaro.org/ARM/UEFI#Configure_UEFI for more information on how to configure UEFI to boot disk images.
+Before you can boot the image you will need to install the latest "firmware":#firmware on the board. The "instructions below":#firmware provide information on how to do this.
+
+See the "UEFI wiki":https://wiki.linaro.org/ARM/UEFI#Configure_UEFI for more information on how to configure UEFI to boot disk images.
 
 In general terms, you use the UEFI Boot Manager to configure the "Boot Device":
-* select USB device's boot partition after selecting "Add Boot Device Entry".
-* use "kernel" when prompted for the file path of the EFI application or then kernel
-* use "ramdisk.img" when prompted for the file path of the initrd
-* change the arguments to pass to the binary to "console=ttyAMA0,115200 earlyprintk=pl011,0x7ff80000 root=/dev/ram0 verbose debug"
+* select USB device's boot partition after selecting option "@[1] Add Boot Device Entry@", then:
+
+bc. File path of the EFI Application or the kernel: kernel
+Has FDT support? [y/n] y
+Add an initrd: [y/n] y
+File path of the initrd: ramdisk.img
+Arguments to pass to the binary: console=ttyAMA0,115200 earlyprintk=pl011,0x7ff80000 root=/dev/ram0 verbose debug
+
+* select option @"[4] Update FDT path"@ from the Boot Menu, choose the boot partition, then:
+
+bc. File path of the FDT blob: juno.dtb
 
 
 h2. DS-5 Configuration Files for Juno
@@ -130,7 +140,7 @@ b.      Location, which must be the directory that you extracted the DS-5 c
 
  
 
-h2. Juno Board Recovery Image and MCC firmware update
+h2(#firmware). Juno Board Recovery Image and MCC firmware update
 
 This section describes how to reset all firmware images to their factory default state. This procedure is also the only way that you can install updates to the MCC firmware.
 
@@ -160,9 +170,11 @@ The configuration flash memory should now be visible on the host computer as a m
 
 6.      If you wish to update the MCC firmware only then skip to step 7. Otherwise, for a full system recovery, format the configuration flash memory (FAT16).
 
-7.      Extract the board recovery image to the root directory of the configuration flash memory, preserving the directory structure.
+7.      Extract the board recovery image ("board_recovery_image_0.7.5.zip":http://releases.linaro.org/14.06/android/images/armv8-android-juno-lsk/board_recovery_image_0.7.5.zip) to the root directory of the configuration flash memory, preserving the directory structure.
+
+8.      Safely eject the mass storage device, giving it time to write the files to the internal storage.
 
-8.      Press the red ON/OFF button on the rear panel of the board and wait for reprogramming to complete.
+9.      Press the red ON/OFF button on the rear panel of the board and wait for reprogramming to complete.
 
 The board will load the default configuration and boot up.