15.05: add new platforms release note

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

1 files changed, 150 insertions, 0 deletions

diff --git a/members/arm/platforms/README.textile b/members/arm/platforms/README.textile
new file mode 100644
index 0000000..493d401
--- /dev/null
+++ b/members/arm/platforms/README.textile
@@ -0,0 +1,150 @@
+h1. ARM Juno Development Platform Software
+
+This page describes the monthly ARM landing team software release for Juno
+
+TABLE OF CONTENTS
+
+"1. Preface":#preface
+
+"2. Software":#sw
+
+"2.1 Prerequisites":#pre
+
+"2.2 Downloading the software and binaries":#down
+
+"2.3 Building the software":#build
+
+"2.4 Installing on your Juno":#install
+
+"2.4 Installing prebuilt binaries your Juno":#prebuilt
+
+"3. Validation":#validation
+
+
+h2(#preface). 1. Preface
+
+The ARM software images contained in this released are distributed according to the "EULA":#https://releases.linaro.org/15.04/members/arm/android/images/armv8-android-juno-lsk#tabs-5
+
+This release page describes how to download the source code and binaries, build the code and install the generated binaries on your Juno platform. There are also links below to download Linaro prebuilt binaries in section "Installing on your Juno":#install.
+
+For a description of the Juno hardware and how to get started with the platform see the "Juno getting started guide":#http://community.arm.com/docs/DOC-8393
+
+h2(#sw). 2. Software
+
+This release supports 3 different software stacks which have been validated on the Juno platform. All include board firmware, System Power Controller firmware, ARM Trusted firmware and a choice of UEFI or u-boot loader. The options are:
+
+* Linaro Stable Kernel (v3.10) + Android LCR
+* Linaro Stable Kernel (v3.10) + OpenEmbedded Filesystem
+* Linaro Tracking Kernel (latest) + OpenEmbedded Filesystem
+
+For each option the instructions here use prebuilt binaries for the filesystem.
+
+h3(#pre). 2.1 Prerequisites
+
+* To be run on an Ubuntu 14.04 LTS system
+
+* Preinstall the following packages:
+                bc
+                bison
+                build-essential
+                curl
+                flex
+                g++-multilib
+                gcc-multilib
+                genext2fs
+                git
+                gperf
+                iasl
+                libc6:i386
+                libstdc++6:i386,
+                libncurses5:i386
+                libxml2-utils
+                linaro-image-tools
+                make
+                openjdk-7-jdk
+                python
+                python-mako
+                uuid-dev
+                wget
+                zlib1g:i386
+                zlib1g-dev:i386
+                zip
+
+* Install the 'Repo' tool as per "Installing Repo":#https://source.android.com/source/downloading.html. Do not initialize the Repo client
+
+* If necessary, also register for authenticated access by following the instructions in the "Using Authentication" section of "Installing Repo":#https://source.android.com/source/downloading.html
+
+* Configure Git's user.email and user.name attributes before using repo.
+
+h3(#down). 2.2 Downloading the software and binaries
+
+* Create a workspace directory and cd into it
+* Use the repo tool to sync all the software GITs
+For a LSK kernel:
+repo init -u https://git.linaro.org/landing-teams/working/arm/manifest -b juno -m lsk.xml
+For the latest tracking kernel:
+repo init -u https://git.linaro.org/landing-teams/working/arm/manifest -b juno -m latest.xml
+Then in both cases:
+repo sync -j8
+
+* Download the filesystem binaries into the root directory of your workspace
+For Android, download system.img, userdata.img and ramdisk.img from "here":#https://releases.linaro.org/15.04/android/lcr/armv8-android-juno-lsk
+For OE, download your preferred filesystem image from "here":#https://releases.linaro.org/15.04/openembedded/juno-lsk
+
+
+h3(#build). 2.3 Building the software
+
+* From the root directory of your workspace execute the following commands to build the software components and package them into an output folder:
+
+* For Linaro Stable Kernel (v3.10) + Android LCR
+
+./build-scripts/build-all.sh juno-lsk-android
+./build-scripts/build-all.sh juno-lsk-android package
+
+* For Linaro Stable Kernel (v3.10) + OpenEmbedded Filesystem
+
+./build-scripts/build-all.sh juno-lsk-oe
+./build-scripts/build-all.sh juno-lsk-oe package
+
+* For Linaro Tracking Kernel (latest) + OpenEmbedded Filesystem
+
+./build-scripts/build-all.sh juno-latest-oe
+./build-scripts/build-all.sh juno-latest-oe package
+
+The build will create binaries for ARM Trusted Firmware, UEFI, u-boot, Linux and a DTB. The Firmware components will then be packaged into a FIP and all the binaries copied under the "output" folder.
+Running a different build will overwrite derived objects in the source tree, but will not overwrite the output folder created by the package step.
+
+h3(#install). 2.4 Installing on your Juno
+
+* Copy the NOR flash binaries to your Juno
+
+Connect up the USB configuration port to your build system whereby the NOR flash will be mounted as a new drive (ref to getting started)
+For UEFI copy the contents of output/<variant>/uefi to the SOFTWARE folder
+For u-boot copy the contents of output/<variant>/uboot to the SOFTWARE folder
+Where <variant> is one of juno-lsk-android, juno-lsk-oe or juno-latest-oe
+
+* Create a USB stick containing your filesystem
+
+Insert a USB stick (minimum 4GB) into your build system and run from your workspace output folder:
+
+sudo linaro-android-media-create --mmc /dev/sdX --dev vexpress --systemimage system.img --userdataimage userdata.img
+
+Eject the USB stick and insert into your Juno
+
+Power cycle your Juno and it will run the new software
+
+h3(#prebuilt). 2.4 Installing prebuilt binaries your Juno
+
+If you want to use prebuilt binaries rather than download and build the software as described above, they can be downloaded from:
+
+* "Linaro Stable Kernel (v3.10) + Android LCR":#https://releases.linaro.org/15.04/android/lcr/armv8-android-juno-lsk
+* "Linaro Stable Kernel (v3.10) + OpenEmbedded Filesystem":#https://releases.linaro.org/15.04/openembedded/juno-lsk
+* "Linaro Tracking Kernel (latest) + OpenEmbedded Filesystem":#https://releases.linaro.org/15.04/openembedded/aarch64
+
+In each case follow the instructions in the Binary Image Installation tab to install
+
+h2(#validation). 3. Validation
+
+TODO ***** List some Linaro testing - probably just boots....
+
+