documentation: BSP Developer's Guide fixes

- use linux-yocto instead of linux-yocto-stable in examples
- change branch names to match linux-yocto usage
- remove outdated 'wrs' where it appears

(From OE-Core rev: 7f1662ef01b383c9fecb2b30ade50de97f17529a)

Signed-off-by: Tom Zanussi <tom.zanussi@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Tom Zanussi 2011-03-13 00:01:51 -06:00 committed by Richard Purdie
parent f11e479b17
commit 5ef65bd112
1 changed files with 11 additions and 11 deletions

View File

@ -83,7 +83,7 @@ meta-&lt;bsp_name&gt;/conf/layer.conf
meta-&lt;bsp_name&gt;/conf/machine/*.conf meta-&lt;bsp_name&gt;/conf/machine/*.conf
meta-&lt;bsp_name&gt;/recipes-bsp/* meta-&lt;bsp_name&gt;/recipes-bsp/*
meta-&lt;bsp_name&gt;/recipes-graphics/* meta-&lt;bsp_name&gt;/recipes-graphics/*
meta-&lt;bsp_name&gt;/recipes-kernel/linux/linux-yocto-stable.bbappend meta-&lt;bsp_name&gt;/recipes-kernel/linux/linux-yocto_git.bbappend
</programlisting> </programlisting>
</para> </para>
@ -107,7 +107,7 @@ meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-emgd/fix_open_max_prepr
meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-emgd/macro_tweak.patch meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-emgd/macro_tweak.patch
meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-emgd/nodolt.patch meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-emgd/nodolt.patch
meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-emgd_1.7.99.2.bb meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-emgd_1.7.99.2.bb
meta-crownbay/recipes-kernel/linux/linux-wrs_git.bbappend meta-crownbay/recipes-kernel/linux/linux-yocto_git.bbappend
</programlisting> </programlisting>
</para> </para>
@ -315,7 +315,7 @@ meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-emgd_1.7.99.2.bb
<section id='bsp-filelayout-kernel'> <section id='bsp-filelayout-kernel'>
<title>Linux Kernel Configuration</title> <title>Linux Kernel Configuration</title>
<programlisting> <programlisting>
meta-&lt;bsp_name&gt;/recipes-kernel/linux/linux-yocto-stable.bbappend meta-&lt;bsp_name&gt;/recipes-kernel/linux/linux-yocto_git.bbappend
</programlisting> </programlisting>
<para> <para>
@ -330,27 +330,27 @@ meta-&lt;bsp_name&gt;/recipes-kernel/linux/linux-yocto-stable.bbappend
directory. directory.
</para> </para>
<para> <para>
Suppose you use a BSP that uses the <filename>linux-yocto-stable_git.bb</filename> kernel, Suppose you use a BSP that uses the <filename>linux-yocto_git.bb</filename> kernel,
which is the preferred kernel to use for developing a new BSP using the Yocto Project. which is the preferred kernel to use for developing a new BSP using the Yocto Project.
In other words, you have selected the kernel in your In other words, you have selected the kernel in your
<filename>&lt;bsp_name&gt;.conf</filename> file by adding the following statement: <filename>&lt;bsp_name&gt;.conf</filename> file by adding the following statement:
<programlisting> <programlisting>
PREFERRED_PROVIDER_virtual/kernel ?= "linux-yocto-stable" PREFERRED_PROVIDER_virtual/kernel ?= "linux-yocto"
</programlisting> </programlisting>
You would use the <filename>linux-yocto-stable_git.bbappend</filename> file to append You would use the <filename>linux-yocto_git.bbappend</filename> file to append
specific BSP settings to the kernel, thus configuring the kernel for your particular BSP. specific BSP settings to the kernel, thus configuring the kernel for your particular BSP.
</para> </para>
<para> <para>
Now take a look at the existing "crownbay" BSP. Now take a look at the existing "crownbay" BSP.
The append file used is: The append file used is:
<programlisting> <programlisting>
meta-crownbay/recipes-kernel/linux/linux-yocto-stable_git.bbappend meta-crownbay/recipes-kernel/linux/linux-yocto_git.bbappend
</programlisting> </programlisting>
The file contains the following: The file contains the following:
<programlisting> <programlisting>
FILESEXTRAPATHS := "${THISDIR}/${PN}" FILESEXTRAPATHS := "${THISDIR}/${PN}"
COMPATIBLE_MACHINE_crownbay = "crownbay" COMPATIBLE_MACHINE_crownbay = "crownbay"
KMACHINE_crownbay = "crownbay" KMACHINE_crownbay = "yocto/standard/crownbay"
</programlisting> </programlisting>
This append file adds "crownbay" as a compatible machine, This append file adds "crownbay" as a compatible machine,
and additionally sets a Yocto Kernel-specific variable that identifies the name of the and additionally sets a Yocto Kernel-specific variable that identifies the name of the
@ -371,7 +371,7 @@ KMACHINE_crownbay = "crownbay"
For example, suppose you had a set of configuration options in a file called For example, suppose you had a set of configuration options in a file called
<filename>defconfig</filename>. <filename>defconfig</filename>.
If you put that file inside a directory named If you put that file inside a directory named
<filename class='directory'>/linux-yocto-stable</filename> and then added <filename class='directory'>/linux-yocto</filename> and then added
a SRC_URI statement such as the following to the append file, those configuration a SRC_URI statement such as the following to the append file, those configuration
options will be picked up and applied when the kernel is built. options will be picked up and applied when the kernel is built.
<programlisting> <programlisting>
@ -397,7 +397,7 @@ SRC_URI += "file://defconfig \
<note><para> <note><para>
Other methods exist to accomplish grouping and defining configuration options. Other methods exist to accomplish grouping and defining configuration options.
For example, you could directly add configuration options to the Yocto kernel For example, you could directly add configuration options to the Yocto kernel
<filename class='directory'>wrs_meta</filename> branch for your BSP. <filename class='directory'>meta</filename> branch for your BSP.
The configuration options will likely end up in that location anyway if the BSP gets The configuration options will likely end up in that location anyway if the BSP gets
added to the Yocto Project. added to the Yocto Project.
For information on how to add these configurations directly, see the For information on how to add these configurations directly, see the
@ -407,7 +407,7 @@ SRC_URI += "file://defconfig \
</para> </para>
<para> <para>
In general, however, the Yocto Project maintainers take care of moving the SRC_URI-specified In general, however, the Yocto Project maintainers take care of moving the SRC_URI-specified
configuration options to the <filename class='directory'>wrs_meta</filename> branch. configuration options to the <filename class='directory'>meta</filename> branch.
Not only is it easier for BSP developers to not have to worry about putting those Not only is it easier for BSP developers to not have to worry about putting those
configurations in the branch, but having the maintainers do it allows them to apply configurations in the branch, but having the maintainers do it allows them to apply
'global' knowledge about the kinds of common configuration options multiple BSPs in 'global' knowledge about the kinds of common configuration options multiple BSPs in