[meta-lsi] [PATCH 09/24] update README for linux-yocto-3.10 and 3.14

[Daniel Dragomir]

From: Cristian Bercaru <cristian.bercaru at windriver.com>

This patch adapts the building instructions for 3.10 and 3.14 kernel
versions.

Signed-off-by: Cristian Bercaru <cristian.bercaru at windriver.com>
---
 README | 67 ++++++++++++++++++++++++++++++++++++++++++++++++------------------
 1 file changed, 49 insertions(+), 18 deletions(-)

diff --git a/README b/README
index 7b2e842..ef15e30 100644
--- a/README
+++ b/README
@@ -55,12 +55,12 @@ Dependencies
 This layer depends on:
 Poky
 URI: git://git.yoctoproject.org/poky.git
-branch: dora
+branch: dizzy
 revision: HEAD
 
 OpenEmbedded
 URI: git://git.openembedded.org/openembedded-core
-branch: dora
+branch: dizzy
 revision: HEAD
 
 
@@ -92,15 +92,15 @@ device-tree-compiler (dtc)
    $ cd $YOCTO
    $ git clone git://git.yoctoproject.org/poky.git
    $ cd poky
-   $ git checkout dora
+   $ git checkout dizzy
 
 3. Clone the LSI meta layer. This provides meta data for building images for the
 LSI specific board types.
 
    $ cd $YOCTO/poky
-   $ git clone git://git.yoctoproject.org/meta-axxia.git
-   $ cd meta-axxia
-   $ git checkout dora
+   $ git clone git at github.com:lsigithub/meta-axxia-private
+   $ cd meta-axxia-private
+   $ git checkout dizzy
 
 4. The Open Embedded project provides many useful layers and packages such as
 networking. Download the Open Embedded Yocto Project hosted repository with the
@@ -109,7 +109,7 @@ following.
    $ cd $YOCTO/poky
    $ git clone https://github.com/openembedded/meta-oe.git
    $ cd meta-oe
-   $ git checkout dora
+   $ git checkout dizzy
 
 5. Create the build directory. The name is optional and will default to 'build',
 however it helps to choose a name to match the board type. For example, we will
@@ -131,6 +131,7 @@ actual value you provided in step 1.
             $YOCTO/poky/meta-yocto \
             $YOCTO/poky/meta-yocto-bsp \
             $YOCTO/poky/meta-oe/meta-oe \
+            $YOCTO/poky/meta-oe/meta-python \
             $YOCTO/poky/meta-oe/meta-networking \
             $YOCTO/poky/meta-axxia \
             "
@@ -167,11 +168,13 @@ parallelism BitBake should use:
    PREFERRED_PROVIDER_virtual/kernel = "linux-yocto-rt"
 
 7.6 Select the KERNEL version:
-   for 3.4
-   PREFERRED_VERSION_linux-yocto = "3.4%"
-
-   for 3.10
+   for 3.10, depending on PREFERRED_PROVIDER_virtual/kernel
    PREFERRED_VERSION_linux-yocto = "3.10%"
+   PREFERRED_VERSION_linux-yocto-rt = "3.10%"
+
+   for 3.14, depending on PREFERRED_PROVIDER_virtual/kernel
+   PREFERRED_VERSION_linux-yocto = "3.14%"
+   PREFERRED_VERSION_linux-yocto-rt = "3.14%"
   
 7.7 Select the KERNEL repository to use. Meta-lsi is able to build the kernel 
 from 3 sources: LSI GITHUB public, LSI GITHUB private and YOCTO kernel repo 
@@ -184,22 +187,50 @@ a. by default (missing to set LSI_SRC) or setting
    will build from Yocto (axxia) repos:
    3.10: http://git.yoctoproject.org/git/linux-yocto-3.10 
         standard/axxia/base branch
-   3.4: http://git.yoctoproject.org/git/linux-yocto-3.14 
+   3.14: http://git.yoctoproject.org/git/linux-yocto-3.14
         standard/axxia/base branch
 
-b. LSI_SRC = "lsi-public"
+b. LSI_SRC = "lsi-public" (3.10 only)
 
    will build kernel from GitHub public repos:
    3.10: https://github.com/lsigithub/lsi_axxia_yocto_public_3.10
-   3.4: https://github.com/lsigithub/lsi_axxia_yocto_public
 
 c. LSI_SRC = "lsi-tip"
    
    will build kernel from GitHub private repos (require authentication):
    3.10: https://github.com/lsigithub/lsi_axxia_yocto_3.10
-   3.4: https://github.com/lsigithub/lsi_axxia_yocto
-
-7.8 Other optional settings for saving disk space and build time:
+   3.14: git at github.com:lsigithub/axxia_yocto_linux_3.14_private.git
+
+7.8 Customizing the Kernel .config file
+When building the kernel from the Yocto repositories, the final .config is built
+using configuration fragments. Otherwise, a pre-built defconfig is used.
+Besides the options specific to the standard and preempt-rt kernel, you are able
+to add extra kernel fragments by setting the following options
+
+a. Power management scheme (3.10 and 3.14)
+   - POWER_MANAGEMENT = "low-power" (DEFAULT)
+     to keep the core low power when is shut down
+   - POWER_MANAGEMENT = "full-power"
+     to complete power down the core when is shut down
+   - POWER_MANAGEMENT = "full-power-L2"
+     to complete power down the core and L2 cache when is shut down
+
+b. Big-endian or little-endian (3.10, ARM only)
+Set the order in which a sequence of bytes are stored in computer memory.
+   - BIG_ENDIAN = "no" (DEFAULT)
+     Little-endien is the default settings.
+   - BIG_ENDIAN = "yes"
+     Kernel will be built with CONFIG_CPU_BIG_ENDIAN enabled.
+
+c. Debug options(3.10, ARM and POWERPC)
+   - DBG = "no" (DEFAULT)
+   - DBG = "yes"
+     Will enable options for debug in the Kernel config.
+
+d. Regression testing (3.10 and 3.14)
+    TESTING = "yes"
+
+7.9 Other optional settings for saving disk space and build time:
    
    DL_DIR = "/<some-shared-location>/downloads"
    SSTATE_DIR = "/<some-shared-location>/sstate-cache
@@ -258,7 +289,7 @@ When sending patches, please use something like:
 Maintenance
 -----------
 
-Maintainers: Daniel Dragomir <daniel.dragomir at windriver.com>
+Maintainers: Cristian Bercaru <cristian.bercaru at windriver.com>
 	     Lucian Creanga <lucian.creanga at windriver.com>
 
 Please see the meta-axxia/MAINTAINERS file for more details.
-- 
1.9.1