[meta-freescale] [Documentation][PATCH] Include rootfs.tar.gz Method In Build and boot steps

[Thomas.Thorne at Net2Edge.com]

From: Thomas Thorne <Thomas.Thorne at Net2Edge.com>

Many Yocto build systems, including the one for the ls1021a-twr do not
generate .sdcard bianry images.  This changeset adds some instructions
on inflaiting a tar'ed and gzip'ed root filesystem image onto an SD card
and then copying over the kernel and device tree bianry files too.

I think this also reflects the more recent documentation from the Yocto
project.

Signed-off-by: Thomas Thorne <Thomas.Thorne at Net2Edge.com>
---
 user-guide/source/nsteps.rst | 52 +++++++++++++++++++++++++++++++++-----------
 1 file changed, 39 insertions(+), 13 deletions(-)

diff --git a/user-guide/source/nsteps.rst b/user-guide/source/nsteps.rst
index a64cca7..63b2f6b 100644
--- a/user-guide/source/nsteps.rst
+++ b/user-guide/source/nsteps.rst
@@ -29,19 +29,45 @@ Build and boot in *N*-steps
     build $ bitbake-layers show-recipes "*image*" | grep ':'  # To list all possible images
     build $ bitbake <selected image>	# Bake! The first time can take several hours
 
-6. Flash your SD card::
-
-    # Insert your SD Card
-    # Type '$ dmesg | tail' to see the device node being used, e.g /dev/sdb
-    # In case the SD to be flashed has already some partitions, the host system may have 
-    # mounted these, so unmount them, e.g. '$ sudo umount /dev/sdb?'.
-    build $ ls -la 'tmp/deploy/images/<selected machine>/*.sdcard'
-
-    # Flash the soft link one
-    build $ sudo dd if=tmp/deploy/images/<selected machine>/<selected image>-<selected machine>.sdcard \
-                    of=/dev/sdX \
-                    bs=1M \
-                    conv=fsync
+6. Flash your SD card:
+
+    a) With a pre-formed sdcard image::
+
+        # Insert your SD Card
+        # Type '$ dmesg | tail' to see the device node being used, e.g /dev/sdb
+        # In case the SD to be flashed has already some partitions, the host system may have 
+        # mounted these, so unmount them, e.g. '$ sudo umount /dev/sdb?'.
+        build $ ls -la 'tmp/deploy/images/<selected machine>/*.sdcard'
+        
+        # Flash the soft link .sdcard image
+        build $ sudo dd \
+                  if=tmp/deploy/images/<selected machine>/<selected image>-<selected machine>.sdcard \
+                  of=/dev/sdX \
+                  bs=1M \
+                  conv=fsync
+
+    b) With a pre-formed root filesystem archive, kernel and device tree binary image::
+
+        # Insert your SD Card
+        # Check your card is mounted ls /media/<user name>/<mounted filesystem name>
+        build $ ls -la 'tmp/deploy/images/<selected machine>/*.tar.gz'
+        
+        # Inflate the the soft link .tar.gz onto the cards filesystem
+        build $ sudo tar -zxvf \
+                  tmp/deploy/images/<selected machine>/<selected image>-<selected machine>.tar.gz \
+                  -C /media/<user name>/<mounted filesystem name>
+        
+        # Copy over the kernel
+        build $ ls -la 'tmp/deploy/images/<selected machine>/uImage*.bin'
+        build $ sudo cp \
+                  'tmp/deploy/images/<selected machine>/uImage-<selected machine>.bin' \
+                  /media/<user name>/<mounted filesystem name>/boot/
+        
+        # Copy over the device tree binary
+        build $ ls -la 'tmp/deploy/images/<selected machine>/uImage*.dtb'
+        build $ sudo cp \
+                  'tmp/deploy/images/<selected machine>/uImage-<selected machine>.dtb' \
+                  /media/<user name>/<mounted filesystem name>/boot/
 
 7. Place your SD Card in the correct board's slot and boot!
 
-- 
2.7.4