diff options
Diffstat (limited to 'openembedded/juno-lsk/INSTALL.textile')
| -rw-r--r-- | openembedded/juno-lsk/INSTALL.textile | 99 |
1 files changed, 99 insertions, 0 deletions
diff --git a/openembedded/juno-lsk/INSTALL.textile b/openembedded/juno-lsk/INSTALL.textile new file mode 100644 index 0000000..6f419b7 --- /dev/null +++ b/openembedded/juno-lsk/INSTALL.textile @@ -0,0 +1,99 @@ +h2. Disclaimer + +The use of Juno software is subject to the terms of the Juno "End User License Agreement":https://releases.linaro.org/14.06/openembedded/juno-lsk/#tabs-5. + +h2. Installation + +Linaro OpenEmbedded releases are made up of the following components. + +| *.img.gz | pre-built images for minimal, LAMP and LEG root filesystems | +| hwpack_*.tar.gz | hardware pack | +| linaro-image-*.rootfs.tar.gz | a choice of Root file system (RootFS) images | +| Image | kernel used by UEFI | +| juno_bl1.bin | ARM Trused Firmware BL1 binary | +| juno_fip.bin | ARM Trused Firmware Firmware Image Package (FIP) binary | +| juno.dtb | Device Tree Binary | + +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. + +Linaro OpenEmbedded images are made up of two components. The "Hardware Pack":https://wiki.linaro.org/HardwarePacks, which contains the kernel, boot loader and/or Device Tree blob and a Root file system (RootFS) of your choice to generate an image. + +Linaro provides two methods for installing Linaro binary builds: + +# Using a pre-built image, which you can download +# Assembling your own image using provided components + +h2. Pre-Installation Steps + +Before any installation begins, it is important that you ensure your board has the latest firmware installed. Please check the "Firmware Update tab":https://releases.linaro.org/14.06/openembedded/juno-lsk/#tabs-4 on this page 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. + +h2. Using pre-built image + +h3. Prerequisites + +* Ubuntu 12.04 64 bit or newer on your desktop PC ("www.ubuntu.com":http://www.ubuntu.com) +* 2GB USB drive or larger +* Latest firmware installed onto the board. Please see "Firmware Update tab":https://releases.linaro.org/14.06/openembedded/juno-lsk/#tabs-4. +* Download the pre-built image for this release +bc. wget http://releases.linaro.org/14.06/openembedded/juno-lsk/*minimal*.img.gz + +h3. Installation Steps + +* Unzip the downloaded pre-built image +* Insert USB drive into your PC and note the assigned @'/dev/sdX'@ + +bc. dmesg +DISK=/dev/sdX # USB drive found from dmesg above +zcat http://releases.linaro.org/14.06/openembedded/juno-lsk/*minimal*.img.gz | sudo dd bs=64k of=$DISK + +When the image is created, skip down to the section "Booting the image". + +*Note:* Windows users may use the "Image Writer for Windows.":https://launchpad.net/win32-image-writer/+download + +<hr> + +h2. Building a custom image using pre-built components + +Sometimes, you may wish to build your own custom image for a 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. + +Using components to generate the image will yield the same functionality found in the pre-built image of the same release. + +h3. Prerequisites + +* Ubuntu 12.04 64 bit or newer on your desktop PC ("www.ubuntu.com":http://www.ubuntu.com) +* Download Artifacts from above +* Get "Linaro image tools":https://wiki.linaro.org/Linaro-Image-Tools. There are multiple ways you can get the latest Linaro Image Tools: + +** Method 1: Install them from the Linaro Image Tools "PPA":https://launchpad.net/~linaro-maintainers/+archive/tools + +bc. sudo add-apt-repository ppa:linaro-maintainers/tools +sudo apt-get update +sudo apt-get install linaro-image-tools + +** Method 2: Building from source + +bc. wget http://releases.linaro.org/14.06/components/platform/linaro-image-tools/linaro-image-tools-2014.06.tar.gz + +* Insert USB drive and note the assigned @'/dev/sdX'@ or @'/dev/mmcblk0'@ + +bc. dmesg | less + +Look for a line that looks like the following at the end of the log + +@[288582.790722] sdc: sdc1 sdc2 sdc3 sdc4 <sdc5 sdc6 >@ + +Or, if your machine uses '/dev/mmcblkX', you may see a line line this: + +@[10770.938042] mmcblk0: p1 p2 p3 p4 < p5 p6 >@ + +*WARNING:* In the next step, make sure you use /dev/"whatever you see above". *You can erase your hard drive* with the wrong parameter. + +* Create media + +bc. sudo linaro-media-create --mmc /dev/sdX --dev juno --hwpack <hwpack filename> --binary <rootfs filename> + +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 on the Firmware Update tab provide information on how to do this and how to configure UEFI to specify the USB drive as a boot device. |