common: Add additional HOWTOs

Added HOWTO_prebuilts.txt for:
  nexus7-jb-gcc47-aosp-blob
  origen-jb-gcc47-samsunglt-tracking-blob
  panda-jb-gcctrunk-tilt-tracking-blob
  panda-master-gcc44-aosp-stable-blob
  snowball-jb-gcc47-linaro-tracking-open

Change-Id: I9c40d1b7f00ecf1d676b152090e9511100e8c305
Signed-off-by: Zach Pfeffer <zach.pfeffer@linaro.org>

5 files changed, 434 insertions, 0 deletions

diff --git a/howto/nexus7-jb-gcc47-aosp-blob/HOWTO_prebuilt.txt b/howto/nexus7-jb-gcc47-aosp-blob/HOWTO_prebuilt.txt
new file mode 100644
index 0000000..4a17d09
--- /dev/null
+++ b/howto/nexus7-jb-gcc47-aosp-blob/HOWTO_prebuilt.txt
@@ -0,0 +1,86 @@
+Instructions for https://android-build.linaro.org/builds/~berolinux/nexus7-jb-gcc47-aosp-blob/
+
+These instructios are meant to be published at android-build.linaro.org. 'Downloads' and other instructions refer to this.
+
+= Get artifacts =
+
+  (You don't need the artifacts if you wish to build from source)
+
+  Scroll down to the 'Downloads' section
+
+  Click on each link to download:
+    target/product/grouper/boot.img
+    target/product/grouper/system.img
+    target/product/grouper/userdata.img
+
+= Get and build source =
+
+  (You don't need the source if you wish to install from the binaries)
+
+  $ mkdir linaro-nexus7
+  $ cd linaro-nexus7
+  $ repo init -u git://android.git.linaro.org/ -b linaro-playground -m staging-nexus7.git
+  $ repo sync
+  $ make TARGET_PRODUCT=full_grouper TARGET_TOOLS_PREFIX=/path/to/your/linaro/android/toolchain/bin/arm-linux-androideabi- droidcore -j4
+
+= Get merge-nexus7-blobs script =
+
+  The script is available from:
+
+  http://android.git.linaro.org/gitweb?p=device/asus/grouper.git;a=blob_plain;f=merge-nexus7-blobs;hb=linaro-playground
+
+  or from git:
+
+  $ git clone git://android.git.linaro.org/device/asus/grouper.git
+  $ cd grouper
+  $ git checkout -b linaro-playground origin/linaro-playground
+
+  Make sure your computer is connected to the Internet, since
+  the script downloads non-free binaries and tools to extract images.
+
+  Run merge-nexus7-blobs script, giving the directory containing the .img files
+  as its sole argument.
+
+  The script will do the remaining bits for you, including flashing the tablet.
+
+  WARNING: There is no guarantee whatsoever that the build will work.
+           If it breaks your tablet, you get to keep both pieces.
+
+= Install Google Apps =
+
+If you wish to use the device as a real tablet rather than a pure development
+device, chances are that you want to install the Google Apps on it:
+
+  * Install the Linaro Android build as described above
+
+  * Grab the current Google Apps zip for JellyBean from http://goo.im/gapps
+    At the time of the writing, the current version is:
+    http://goo.im/gapps/gapps-jb-20120726-signed.zip
+
+  * If you downloaded from a device other than your Nexus 7, transfer
+    the file to your Nexus 7 using:
+
+    mtp-sendfile gapps-jb*.zip 8
+
+  * Turn your Nexus 7 off completely
+
+  * Hold down the Volume Up and Volume Down buttons at the same time, and turn
+    on the device
+
+  * Use the Volume Up button to select "Recovery mode", then press the power
+    button to launch it. Wait for recovery to come up.
+
+  * Select "install zip from sdcard"
+
+  * Select "choose zip from sdcard"
+
+  * Choose the gapps-jb zip file you downloaded earlier (it should be in the
+    Download/ folder)
+
+  * Select "Yes - Install gapps-jb-*-signed.zip"
+
+  * Select "+++++Go Back+++++"
+
+  * Select "reboot system now"
+
+  * Enjoy your Google Apps enabled Linaro Android build!
diff --git a/howto/origen-jb-gcc47-samsunglt-tracking-blob/HOWTO_prebuilt.txt b/howto/origen-jb-gcc47-samsunglt-tracking-blob/HOWTO_prebuilt.txt
new file mode 100644
index 0000000..8598c62
--- /dev/null
+++ b/howto/origen-jb-gcc47-samsunglt-tracking-blob/HOWTO_prebuilt.txt
@@ -0,0 +1,69 @@
+Instructions for https://android-build.linaro.org/builds/~linaro-android/origen-jb-gcc47-samsunglt-tracking-blob/
+
+These instructios are meant to be published at android-build.linaro.org. 'Downloads' and other instructions refer to this.
+
+= Get artifacts =
+
+  Scroll down to the 'Downloads' section
+
+  Click on each link to download:
+    target/product/origen/boot.tar.bz2
+    target/product/origen/system.tar.bz2
+    target/product/origen/userdata.tar.bz2
+
+= Get linaro image tools =
+
+  Run these commands to get all the dependencies for linaro-image-tools and the tip of linaro-image-tools
+
+  $ sudo add-apt-repository ppa:linaro-maintainers/tools
+  $ sudo apt-get update
+  $ sudo apt-get install linaro-image-tools
+
+  If you're using a released build (with a -release or from releases.linaro.org), skip this step.
+  If you're using a "tip" build do not skip the step and do the following:
+
+  $ sudo apt-get install bzr
+  $ bzr branch lp:linaro-image-tools
+
+= Create media (SD card) =
+
+  Disable automount (instructions provided for Gnome)
+
+  $ TMP1=$(dconf read /org/gnome/desktop/media-handling/automount)
+  $ TMP2=$(dconf read /org/gnome/desktop/media-handling/automount-open)
+  $ dconf write /org/gnome/desktop/media-handling/automount false
+  $ dconf write /org/gnome/desktop/media-handling/automount-open false
+
+  Insert an SD card
+
+  Run 'dmesg'
+
+  $ dmesg
+
+  Look for a line that looks like the following at the end of the log
+
+  [288582.790722]  sdc: sdc1 sdc2 sdc3 sdc4 < sdc5 sdc6 >
+
+  WARNING: In the next step, make sure you use /dev/"whatever you see above".
+           You can erase your hard drive with the wrong parameter.
+
+  Run linaro image tools
+
+  $ linaro-android-media-create --mmc /dev/sdc --dev origen --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
+
+  If you're using tip of linaro image tools
+
+  $ ./linaro-image-tools/linaro-android-media-create --mmc /dev/sdc --dev origen --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
+
+  Restore automount
+
+  $ dconf write /org/gnome/desktop/media-handling/automount $TMP1
+  $ dconf write /org/gnome/desktop/media-handling/automount-open $TMP2
+
+  Remove the SD card from the device writer and plug it into the board.
+
+= Check console output =
+
+  Plug in an USB-to-serial converter and run minicom
+
+  $ minicom -D /dev/ttyUSB0 -w -C minicom.txt
diff --git a/howto/panda-jb-gcctrunk-tilt-tracking-blob/HOWTO_prebuilt.txt b/howto/panda-jb-gcctrunk-tilt-tracking-blob/HOWTO_prebuilt.txt
new file mode 100644
index 0000000..8400022
--- /dev/null
+++ b/howto/panda-jb-gcctrunk-tilt-tracking-blob/HOWTO_prebuilt.txt
@@ -0,0 +1,69 @@
+Instructions for https://android-build.linaro.org/builds/~linaro-android/panda-jb-gcctrunk-tilt-tracking-blob/
+
+These instructios are meant to be published at android-build.linaro.org. 'Downloads' and other instructions refer to this.
+
+= Get artifacts =
+
+  Scroll down to the 'Downloads' section
+
+  Click on each link to download:
+    target/product/panda/boot.tar.bz2
+    target/product/panda/system.tar.bz2
+    target/product/panda/userdata.tar.bz2
+
+= Get linaro image tools =
+
+  Run these commands to get all the dependencies for linaro-image-tools and the tip of linaro-image-tools
+
+  $ sudo add-apt-repository ppa:linaro-maintainers/tools
+  $ sudo apt-get update
+  $ sudo apt-get install linaro-image-tools
+
+  If you're using a released build (with a -release or from releases.linaro.org), skip this step.
+  If you're using a "tip" build do not skip the step and do the following:
+
+  $ sudo apt-get install bzr
+  $ bzr branch lp:linaro-image-tools
+
+= Create media (SD card) =
+
+  Disable automount (instructions provided for Gnome)
+
+  $ TMP1=$(dconf read /org/gnome/desktop/media-handling/automount)
+  $ TMP2=$(dconf read /org/gnome/desktop/media-handling/automount-open)
+  $ dconf write /org/gnome/desktop/media-handling/automount false
+  $ dconf write /org/gnome/desktop/media-handling/automount-open false
+
+  Insert an SD card
+
+  Run 'dmesg'
+
+  $ dmesg
+
+  Look for a line that looks like the following at the end of the log
+
+  [288582.790722]  sdc: sdc1 sdc2 sdc3 sdc4 < sdc5 sdc6 >
+
+  WARNING: In the next step, make sure you use /dev/"whatever you see above".
+           You can erase your hard drive with the wrong parameter.
+
+  Run linaro image tools
+
+  $ linaro-android-media-create --mmc /dev/sdc --dev panda --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
+
+  If you're using tip of linaro image tools
+
+  $ ./linaro-image-tools/linaro-android-media-create --mmc /dev/sdc --dev panda --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
+
+  Restore automount
+
+  $ dconf write /org/gnome/desktop/media-handling/automount $TMP1
+  $ dconf write /org/gnome/desktop/media-handling/automount-open $TMP2
+
+  Remove the SD card from the device writer and plug it into the board.
+
+= Check console output =
+
+  Plug in an USB-to-serial converter and run minicom
+
+  $ minicom -D /dev/ttyUSB0 -w -C minicom.txt
diff --git a/howto/panda-master-gcc44-aosp-stable-blob/HOWTO_prebuilt.txt b/howto/panda-master-gcc44-aosp-stable-blob/HOWTO_prebuilt.txt
new file mode 100644
index 0000000..8adf624
--- /dev/null
+++ b/howto/panda-master-gcc44-aosp-stable-blob/HOWTO_prebuilt.txt
@@ -0,0 +1,75 @@
+Instructions for https://android-build.linaro.org/builds/~linaro-android/panda-master-gcc44-aosp-stable-blob/
+
+These instructios are meant to be published at android-build.linaro.org. 'Downloads' and other instructions refer to this.
+
+= Get artifacts =
+
+  Scroll down to the 'Downloads' section
+
+  Click on each link to download:
+    target/product/panda/boot.tar.bz2
+    target/product/panda/system.tar.bz2
+    target/product/panda/userdata.tar.bz2
+
+= Get linaro image tools =
+
+  Run these commands to get all the dependencies for linaro-image-tools and the tip of linaro-image-tools
+
+  $ sudo add-apt-repository ppa:linaro-maintainers/tools
+  $ sudo apt-get update
+  $ sudo apt-get install linaro-image-tools
+
+  If you're using a released build (with a -release or from releases.linaro.org), skip this step.
+  If you're using a "tip" build do not skip the step and do the following:
+
+  $ sudo apt-get install bzr
+  $ bzr branch lp:linaro-image-tools
+
+= Create media (SD card) =
+
+  Disable automount (instructions provided for Gnome)
+
+  $ TMP1=$(dconf read /org/gnome/desktop/media-handling/automount)
+  $ TMP2=$(dconf read /org/gnome/desktop/media-handling/automount-open)
+  $ dconf write /org/gnome/desktop/media-handling/automount false
+  $ dconf write /org/gnome/desktop/media-handling/automount-open false
+
+  Insert an SD card
+
+  Run 'dmesg'
+
+  $ dmesg
+
+  Look for a line that looks like the following at the end of the log
+
+  [288582.790722]  sdc: sdc1 sdc2 sdc3 sdc4 < sdc5 sdc6 >
+
+  WARNING: In the next step, make sure you use /dev/"whatever you see above".
+           You can erase your hard drive with the wrong parameter.
+
+  Run linaro image tools
+
+  $ linaro-android-media-create --mmc /dev/sdc --dev panda --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
+
+  If you're using tip of linaro image tools
+
+  $ ./linaro-image-tools/linaro-android-media-create --mmc /dev/sdc --dev origen --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
+
+  Install graphics libraries
+
+  $ wget http://people.linaro.org/~vishalbhoj/install-binaries-4.0.4.sh
+  $ chmod a+x install-binaries-4.0.4.sh
+  $ ./install-binaries-4.0.4.sh
+
+  Restore automount
+
+  $ dconf write /org/gnome/desktop/media-handling/automount $TMP1
+  $ dconf write /org/gnome/desktop/media-handling/automount-open $TMP2
+
+  Remove the SD card from the device writer and plug it into the board.
+
+= Check console output =
+
+  Plug in an USB-to-serial converter and run minicom
+
+  $ minicom -D /dev/ttyUSB0 -w -C minicom.txt
diff --git a/howto/snowball-jb-gcc47-linaro-tracking-open/HOWTO_prebuilt.txt b/howto/snowball-jb-gcc47-linaro-tracking-open/HOWTO_prebuilt.txt
new file mode 100644
index 0000000..348ba69
--- /dev/null
+++ b/howto/snowball-jb-gcc47-linaro-tracking-open/HOWTO_prebuilt.txt
@@ -0,0 +1,135 @@
+Instructions for https://android-build.linaro.org/builds/~linaro-android_snowball-jb-gcc47-linaro-tracking-open/
+
+These instructios are meant to be published at android-build.linaro.org. 'Downloads' and other instructions refer to this.
+
+This build is just a TINY Android. It will only boot to a prompt. (No GUI)
+
+= Get artifacts =
+
+  Scroll down to the 'Downloads' section
+
+  Click on each link to download:
+    target/product/snowball/boot.tar.bz2
+    target/product/snowball/system.tar.bz2
+    target/product/snowball/userdata.tar.bz2
+
+= Get linaro image tools =
+
+  This build requires at least version 12.09 of linaro-image-tools to work correctly.
+
+  Run these commands to get all the dependencies for linaro-image-tools and the tip of linaro-image-tools.
+
+  $ sudo add-apt-repository ppa:linaro-maintainers/tools
+  $ sudo apt-get update
+  $ sudo apt-get install linaro-image-tools
+
+  If you're using a released build (with a -release or from releases.linaro.org), skip this step.
+  If you're using a "tip" build do not skip the step and do the following:
+
+  $ sudo apt-get install bzr
+  $ bzr branch lp:linaro-image-tools
+
+= Create media (SD card) =
+
+  Disable automount (instructions provided for Gnome)
+
+  $ TMP1=$(dconf read /org/gnome/desktop/media-handling/automount)
+  $ TMP2=$(dconf read /org/gnome/desktop/media-handling/automount-open)
+  $ dconf write /org/gnome/desktop/media-handling/automount false
+  $ dconf write /org/gnome/desktop/media-handling/automount-open false
+
+  Insert an SD card
+
+  Run 'dmesg'
+
+  $ dmesg
+
+  Look for a line that looks like the following at the end of the log
+
+  [288582.790722]  sdc: sdc1 sdc2 sdc3 sdc4 < sdc5 sdc6 >
+
+  WARNING: In the next step, make sure you use /dev/"whatever you see above".
+           You can erase your hard drive with the wrong parameter.
+
+  Run linaro image tools
+
+  $ linaro-android-media-create --mmc /dev/sdc --dev snowball_sd --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
+
+  If you're using tip of linaro image tools
+
+  $ ./linaro-image-tools/linaro-android-media-create --mmc /dev/sdc --dev snowball_sd --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
+
+  Restore automount
+
+  $ dconf write /org/gnome/desktop/media-handling/automount $TMP1
+  $ dconf write /org/gnome/desktop/media-handling/automount-open $TMP2
+
+  As long as we are waiting for https://bugs.launchpad.net/linaro-image-tools/+bug/1055644 to be solve we need to do a small work around and replace the
+  boot.scr file on the SD card.
+
+  Remove the SD card and insert it again.
+
+  Fetch mpoirier's boot.scr file
+
+  $ wget http://people.canonical.com/~mpoirier/android/linaro-tracking-open/boot.scr
+  $ cp boot.src /media/boot/.
+  $ umount /media/*
+
+  Remove the SD card from the device writer and plug it into the board.
+
+= Update U-Boot =
+
+  U-Boot must pass the device tree to the kernel to boot. This code was not enabled before the end of September 2012. If the U-Boot in your Snowballs EMMC is
+  older you must update it to be able to boot the snowball with this build.
+
+  The instructions below will take the same tarballs that was use for preparing the SD card and create an image that will be written to the EMMC of the Snowball.
+  It is not possible to boot from the EMMC in this case. We just write an image to get U-Boot updated.
+
+   Download startupfiles from
+   http://www.igloocommunity.org/download/linaro/startupfiles/latest
+
+   $ tar -xvf startupfiles_3.0.8-0.tar.gz
+   $ linaro-android-media-create --image-file snowball.img --image-size 1500M --dev snowball_emmc --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
+
+   $ sudo add-apt-repository ppa:igloocommunity-maintainers/snowball-tools
+   $ sudo apt-get update
+   $ sudo apt-get install riff
+
+   (OPTIONAL) Remove the PPA
+
+   $ sudo add-apt-repository --remove ppa:igloocommunity-maintainers/snowball-tools
+
+   Turn off the board
+
+   $ sudo riff -f snowball.img
+
+   Connect your board using the OTG USB port (next to power supply port) to
+   your PC
+   Turn on the board
+   Riff will detect the board and start the execution
+   When execution is finalized riff will exit
+
+= Check console output =
+
+  Plug in an USB-to-serial converter and run minicom
+
+  $ minicom -D /dev/ttyUSB0 -w -C minicom.txt
+
+= Notes =
+
+ * Note 1 - ADB only works over IP
+
+   In the console type:
+     stop adbd
+     setprop service.adb.tcp.port 6565
+     start adbd
+     ifconfig eth0 # to get boardsIP
+
+   On the host type:
+     adb connect boardsIP:6565
+
+ * Note 2 - Using a DVI monitor
+
+   If you are using a HDMI to DVI converter or cable then you should wait for about 10 seconds when booting
+   and when you see "av8100_hdmi av8100_hdmi.3: Framebuffer created (av8100_hdmi)" in the log press enter
+   and type "echo 2 > /sys/devices/av8100_hdmi.3/hdmisdtvswitch".