mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-05-30 00:20:08 +00:00
Code Issues Projects Releases Wiki Activity

dev-manual: Updates to the section on creating a layer

Browse Source 
Provided some key links to help clarify content.

(From yocto-docs rev: 8d27b9946dad89729d30497bcc4de26b9a5c87d9)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2018-03-20 11:25:07 -07:00
committed by Richard Purdie
parent c0c1befbe9
commit 4fda1ea353
1 changed files with 15 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/dev-manual/dev-manual-common-tasks.xml
+15 -11
View File
@@ -37,7 +37,7 @@
The Yocto Project ships with tools that speed up creating The Yocto Project ships with tools that speed up creating
layers. layers.
This section describes the steps you perform by hand to create This section describes the steps you perform by hand to create
a layer so that you can better understand them. layers so that you can better understand them.
For information about the layer-creation tools, see the For information about the layer-creation tools, see the
"<ulink url='&YOCTO_DOCS_BSP_URL;#creating-a-new-bsp-layer-using-the-bitbake-layers-script'>Creating a New BSP Layer Using the <filename>bitbake-layers</filename> Script</ulink>" "<ulink url='&YOCTO_DOCS_BSP_URL;#creating-a-new-bsp-layer-using-the-bitbake-layers-script'>Creating a New BSP Layer Using the <filename>bitbake-layers</filename> Script</ulink>"
section in the Yocto Project Board Support Package (BSP) section in the Yocto Project Board Support Package (BSP)
@@ -95,7 +95,7 @@
<para>The <para>The
<filename>meta-yocto-bsp/conf/layer.conf</filename> file <filename>meta-yocto-bsp/conf/layer.conf</filename> file
in the Yocto Project in the Yocto Project
<ulink url='&YOCTO_GIT_URL;'>Source Repositories</ulink> <ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/poky/tree/meta-yocto-bsp/conf'>Source Repositories</ulink>
demonstrates the required syntax. demonstrates the required syntax.
For your layer, you need to replace "yoctobsp" with the For your layer, you need to replace "yoctobsp" with the
root name of your layer: root name of your layer:
@@ -121,16 +121,17 @@
appended to appended to
<ulink url='&YOCTO_DOCS_REF_URL;#var-BBPATH'><filename>BBPATH</filename></ulink>. <ulink url='&YOCTO_DOCS_REF_URL;#var-BBPATH'><filename>BBPATH</filename></ulink>.
<note> <note>
All non-distro layers, which include all BSP All non-distro layers are expected to
layers, are expected to append the layer append the layer directory to
directory to <filename>BBPATH</filename>. <filename>BBPATH</filename>.
On the other hand, distro layers, such as On the other hand, distro layers, such as
<filename>meta-poky</filename>, can choose <filename>meta-poky</filename>, can choose
to enforce their own precedence over to enforce their own precedence over
<filename>BBPATH</filename>. <filename>BBPATH</filename>.
For an example of that syntax, see the For an example of that syntax, see the
<filename>meta-poky/conf/layer.conf</filename> <filename>meta-poky/conf/layer.conf</filename>
file for in the Source Repositories. file for in the
<ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/poky/tree/meta-poky/conf'>Source Repositories</ulink>.
</note> </note>
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
@@ -140,7 +141,7 @@
<listitem><para> <listitem><para>
The The
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-BBFILE_COLLECTIONS'>BBFILE_COLLECTIONS</ulink></filename> <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-BBFILE_COLLECTIONS'>BBFILE_COLLECTIONS</ulink></filename>
variable is then appended with the layer name, variable is appended with the layer name,
which is "yoctobsp" in this example. which is "yoctobsp" in this example.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
@@ -159,7 +160,7 @@
<listitem><para> <listitem><para>
The The
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-BBFILE_PRIORITY'>BBFILE_PRIORITY</ulink></filename> <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-BBFILE_PRIORITY'>BBFILE_PRIORITY</ulink></filename>
variable then assigns a priority to the layer. variable assigns a priority to the layer.
Applying priorities is useful in situations Applying priorities is useful in situations
where the same recipe might appear in multiple where the same recipe might appear in multiple
layers. layers.
@@ -206,9 +207,12 @@
you need in <filename>recipes-*</filename> you need in <filename>recipes-*</filename>
subdirectories within the layer. subdirectories within the layer.
<note> <note>
In order to be compliant with the Yocto Project, For an explanation of layer hierarchy that
a layer must contain a is compliant with the Yocto Project, see
<ulink url='&YOCTO_DOCS_BSP_URL;#bsp-filelayout-readme'>README file.</ulink> the
"<ulink url='&YOCTO_DOCS_BSP_URL;#bsp-filelayout'>Example Filesystem Layout</ulink>"
section in the Yocto Project Board
Support Package (BSP) Developer's Guide.
</note> </note>
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>