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:
parent
f11e479b17
commit
5ef65bd112
|
@ -83,7 +83,7 @@ meta-<bsp_name>/conf/layer.conf
|
||||||
meta-<bsp_name>/conf/machine/*.conf
|
meta-<bsp_name>/conf/machine/*.conf
|
||||||
meta-<bsp_name>/recipes-bsp/*
|
meta-<bsp_name>/recipes-bsp/*
|
||||||
meta-<bsp_name>/recipes-graphics/*
|
meta-<bsp_name>/recipes-graphics/*
|
||||||
meta-<bsp_name>/recipes-kernel/linux/linux-yocto-stable.bbappend
|
meta-<bsp_name>/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-<bsp_name>/recipes-kernel/linux/linux-yocto-stable.bbappend
|
meta-<bsp_name>/recipes-kernel/linux/linux-yocto_git.bbappend
|
||||||
</programlisting>
|
</programlisting>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
|
@ -330,27 +330,27 @@ meta-<bsp_name>/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><bsp_name>.conf</filename> file by adding the following statement:
|
<filename><bsp_name>.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
|
||||||
|
|
Loading…
Reference in New Issue