Creating a snappy SD card image for the Parallella Development board
=====================================================================

Preparation
-----------

To be able to boot on the parallella you need to boot once into the u-boot serial prompt (via FTDI) and issue the following commands
(to switch the pre-installed u-boot to support uEnv.txt files out of the box)

setenv bootenv 'uEnv.txt'
setenv loadbootenv 'fatload mmc 0 0x4000000 ${bootenv}'
setenv importbootenv 'echo Importing environment from mmc ...;env import -t 0x4000000 $filesize'
setenv qspiboot 'echo Loading uEnv.txt...;mmcinfo;run loadbootenv;run importbootenv;run uenvcmd'
saveenv

Downloading
-----------

First download the device tarball from the URL below.

    wget http://people.canonical.com/~ogra/snappy/parallella/device_part_parallella.tar.xz

Building an image
-----------------

Install the latest ubuntu-device-flash from the snappy-dev beta PPA.

    sudo add-apt-repository ppa:snappy-dev/beta
    sudo apt-get update
    sudo apt-get install ubuntu-device-flash

Now use the example below to create your own img file that you can then 
write with dd to an SD card. In the example below we build a 3GB big "mysnappy.img" file.

    sudo ubuntu-device-flash core --size 3 -o mysnappy.img --channel ubuntu-core/devel-proposed --device generic_armhf --device-part device_part_parallella.tar.xz --developer-mode

Writing the image
-----------------

Write the created mysnappy.img to an SD card. 
In the example below we write to a card that sits in the SD Card Reader at /dev/sdc

    sudo dd if=mysnappy.img of=/dev/sdc bs=4k

Booting
-------

Attach your serial cable to the Parallella board, plug the SD card into the SD slot 
and power up the board. After snappy is done doing the initial configuration 
with cloud-init you will be presented with a serial login prompt at which you can
log in with the user "ubuntu" using the password "ubuntu".