Skip to contentSkip to conversation

Kernel Manual enhancement to creating a BSP

PATCH Applied [email protected] 2 participants 6 messages Feb 18, 2011 – Feb 22, 2011

lore
Share & tools
lore
#0 lore raw

cover Kernel Manual enhancement to creating a BSP

From: Scott Rifenbark <[email protected]>

I updated the sections on creating a BSP based on an existing similar BSP with and without a local kernel repository. This series of changes were completed in conjunction with Bruce Ashfield reviewing the technical content.

Pull URL: git://git.pokylinux.org/poky-contrib.git
Branch: srifenbark/docs
Browse: http://git.pokylinux.org/cgit.cgi/poky-contrib/log/?h=srifenbark/docs

Thanks,
<[email protected]>
---

Scott Rifenbark (4):
documentation/kernel-manual/kernel-how-to.xml: Fix to step 1 of

    section 3.4.4
  documentation/kernel-manual/kernel-how-to.xml: Fix to step 3 of
    section 3.4.4
  documentation/kernel-manual/kernel-how-to.xml: fix to step 3 and 4 of
    section 3.4.4
  documentation/kernel-manual/kernel-how-to.xml: Changes to section
    3.4.4 and new 3.4.5
 documentation/kernel-manual/kernel-how-to.xml |   43 +++++++++++++++++++++++--
 1 files changed, 40 insertions(+), 3 deletions(-)
#1 lore raw

PATCH 1/4 documentation/kernel-manual/kernel-how-to.xml: Fix to step 1 of section 3.4.4

From: Scott Rifenbark <[email protected]>

Step one states that the linux-yocto_git.bbappend file is left. This file is associated with distro 2.6.37 kernel and the rest of the example is associated with the 2.6.34 kernel. So, I changed the
step to indicate that the directory is left with a linux-yocto-stable_git.bbappend file.

---
 documentation/kernel-manual/kernel-how-to.xml |    3 ++-
 1 files changed, 2 insertions(+), 1 deletions(-)
documentation/kernel-manual/kernel-how-to.xml +2 -1
index c3c9569..efe81e5 100644
@@ -1052,7 +1052,8 @@ That's it. Configure and build.
                         <listitem><para>Copy meta-emenlow</para></listitem>
                         <listitem><para>Fix or remove anything you do not need.  
                         For this example the only thing left was the kernel directory with a 
-                        <filename>linux-yocto_git.bbappend</filename> file (linux-yocto is the kernel listed in 
+                        <filename>linux-yocto-stable_git.bbappend</filename> file 
+                        (linux-yocto-stable is the kernel listed in 
                         <filename>meta-crownbay/conf/machine/crownbay.conf</filename></para></listitem>.
                         <listitem><para>Add a new entry in the <filename>build/conf/bblayers.conf</filename> 
                         so the new layer can be found by Bitbake.</para></listitem>
Signature · 1 line
1.7.1
#2 lore raw

PATCH 2/4 documentation/kernel-manual/kernel-how-to.xml: Fix to step 3 of section 3.4.4

In reply to [email protected]

From: Scott Rifenbark <[email protected]>

Changed 'linux-yocto_git.bbappend' to 'linux-yocto-stable_git.bbappend' in step 3 just before the code example. This makes the code consistent with the rest of the example supporting the 2.6.34 kernel.

---
 documentation/kernel-manual/kernel-how-to.xml |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)
documentation/kernel-manual/kernel-how-to.xml +1 -1
index efe81e5..6d1da06 100644
@@ -1089,7 +1089,7 @@ That's it. Configure and build.
                 </para></listitem>
                 
                 <listitem><para>
-                    In a layer, create a <filename>linux-yocto_git.bbappend</filename> 
+                    In a layer, create a <filename>linux-yocto-stable_git.bbappend</filename> 
                     file with the following:
                 </para>       
                 
Signature · 1 line
1.7.1
#3 lore raw

PATCH 3/4 documentation/kernel-manual/kernel-how-to.xml: fix to step 3 and 4 of section 3.4.4

In reply to [email protected]

From: Scott Rifenbark <[email protected]>

Added text after the sample bbappend file stating that the user needs to update the KSRC assignment statement and also remove its comment. Also they have to remove the comment from the SRC_URI line.

Changed the bitbake command in step 4 to use the linux-yocto-stable file rather than the linux-yocto file.

---
 documentation/kernel-manual/kernel-how-to.xml |    7 ++++++-
 1 files changed, 6 insertions(+), 1 deletions(-)
documentation/kernel-manual/kernel-how-to.xml +6 -1
index 6d1da06..2742611 100644
@@ -1111,6 +1111,11 @@ That's it. Configure and build.
      # SRC_URI = "git://${KSRC};nocheckout=1;branch=${KBRANCH},meta;name=machine,meta"
                     </literallayout>
                 </para>
+
+                <para>
+                    In the previous sample file you need to update and remove the comment from 
+                    the KSRC assignment and also remove the comment from the SRC_URI line.
+                </para>
                 
                 <para>
                     After doing that, select the machine in <filename>build/conf/local.conf</filename>:
@@ -1177,7 +1182,7 @@ That's it. Configure and build.
                     Then, modify the code there, using quilt to save the changes, and recompile until 
                     it works:
                     <literallayout class='monospaced'>
-     $ bitbake -c compile -f linux-yocto
+     $ bitbake -c compile -f linux-yocto-stable
                     </literallayout>
                 </para></listitem>
                 
Signature · 1 line
1.7.1
#4 lore raw

PATCH 4/4 documentation/kernel-manual/kernel-how-to.xml: Changes to section 3.4.4 and new 3.4.5

In reply to [email protected]

From: Scott Rifenbark <[email protected]>

I made some updates to the 3.4.4 section according to Bruce Ashfield's feedback. I also added a new section 3.4.5 (Creating a BSP Based on an Existing Similar BSP Without a Local Kernel Repository).

---
 documentation/kernel-manual/kernel-how-to.xml |   31 +++++++++++++++++++++++++
 1 files changed, 31 insertions(+), 0 deletions(-)
documentation/kernel-manual/kernel-how-to.xml +31 -0
index 2742611..abb19f2 100644
@@ -1198,6 +1198,37 @@ That's it. Configure and build.
             </para>
         </section>
 
+        <section id='bsp-creating-bsp-without-a-local-kernel-repo'>
+        <title>Creating a BSP Based on an Existing Similar BSP Without a Local Kernel Repository</title>
+
+            <para>
+                If you are creating a BSP based on an existing similar BSP but you do not have
+                a local kernel repository, the process is very similar to the process in 
+                the previous section (<xref linkend='bsp-creating'/>). 
+            </para>
+
+            <para>
+                Follow the exact same process as described in the previous section with 
+                these slight modifications:
+            </para>
+            <orderedlist>
+                <listitem><para>Perform Step 1 as is from the previous section.</para></listitem>
+                <listitem><para>Perform Step 2 as is from the previous section.</para></listitem>
+                <listitem><para>Perform Step 3 but do not modify the 
+                    KSRC line in the bbappend file.</para></listitem>
+                <listitem><para>Edit the <filename>local.conf</filename> so 
+                    that it contains the following:
+                    <literallayout class='monospaced'>
+     YOCTO_KERNEL_EXTERNAL_BRANCH="&lt;your-machine&gt;-standard
+                    </literallayout></para>
+                    <para>Adding this statement to the file triggers BSP bootstrapping
+                    to occur and the correct branches and base configuration to be used.
+                </para></listitem>
+                <listitem><para>Perform Step 4 as is from the previous section.</para></listitem>
+                <listitem><para>Perform Step 5 as is from the previous section.</para></listitem>
+            </orderedlist>
+        </section>
+
 
 <!--        <section id='bsp-creating-a-new-bsp'>
             <title>BSP: Creating a New BSP</title>
Signature · 1 line
1.7.1
Applied
#5 lore raw
In reply to [email protected]
Quoted 26 lines · On 02/18/2011 08:57 AM, [email protected] wrote:

From: Scott Rifenbark<[email protected]>

I updated the sections on creating a BSP based on an existing similar BSP with and without a local kernel repository. This series of changes were completed in conjunction with Bruce Ashfield reviewing the technical content.

Pull URL: git://git.pokylinux.org/poky-contrib.git
Branch: srifenbark/docs
Browse: http://git.pokylinux.org/cgit.cgi/poky-contrib/log/?h=srifenbark/docs

Thanks,
<[email protected]>
---

Scott Rifenbark (4):
documentation/kernel-manual/kernel-how-to.xml: Fix to step 1 of

     section 3.4.4
   documentation/kernel-manual/kernel-how-to.xml: Fix to step 3 of
     section 3.4.4
   documentation/kernel-manual/kernel-how-to.xml: fix to step 3 and 4 of
     section 3.4.4
   documentation/kernel-manual/kernel-how-to.xml: Changes to section
     3.4.4 and new 3.4.5
Quoted 8 lines
  documentation/kernel-manual/kernel-how-to.xml |   43 +++++++++++++++++++++++--
  1 files changed, 40 insertions(+), 3 deletions(-)

_______________________________________________
poky mailing list
[email protected]
https://lists.yoctoproject.org/listinfo/poky

Merged into Master

Thanks
Sau!