summaryrefslogtreecommitdiffstats
path: root/documentation/bsp-guide
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2012-04-04 14:56:57 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2012-04-10 13:32:44 +0100
commit273e05bb0db2d3723429e47523deee1c8b302471 (patch)
tree03ccf626e3f01ae3928e3417e4301e4892e44cd1 /documentation/bsp-guide
parentadc13fc9254244be7d6be16623b0420b64ef7814 (diff)
downloadpoky-273e05bb0db2d3723429e47523deee1c8b302471.tar.gz
documentation/bsp-guide/bsp.xml: Added new section
Fixes [YOCTO #1962] Added a new section called "Customizing a Recipe for a BSP". The text was rooted in Darren Hart's comments. I implemented them and then we iterated a bit on it. Reported-by: Joshua Lock <joshua.lock@intel.com> (From yocto-docs rev: f5e51d60312d9335a790023f193cae1ba76277ae) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/bsp-guide')
-rw-r--r--documentation/bsp-guide/bsp.xml36
1 files changed, 36 insertions, 0 deletions
diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
index 14a7197f34..d15abe027d 100644
--- a/documentation/bsp-guide/bsp.xml
+++ b/documentation/bsp-guide/bsp.xml
@@ -638,6 +638,42 @@
638 </section> 638 </section>
639 </section> 639 </section>
640 640
641 <section id='customizing-a-recipe-for-a-bsp'>
642 <title>Customizing a Recipe for a BSP</title>
643
644 <para>
645 If you plan on customizing a recipe for a particular BSP, you need to do the
646 following:
647 <itemizedlist>
648 <listitem><para>Include within the BSP layer a <filename>.bbappend</filename>
649 file for the modified recipe.</para></listitem>
650 <listitem><para>Place the BSP-specific file in the BSP's recipe
651 <filename>.bbappend</filename> file path under a directory named
652 after the machine.</para></listitem>
653 </itemizedlist>
654 </para>
655
656 <para>
657 To better understand this, consider an example that customizes a recipe by adding
658 a BSP-specific configuration file named <filename>interfaces</filename> to the
659 <filename>netbase_4.47.bb</filename> recipe for machine "xyz".
660 Do the following:
661 <orderedlist>
662 <listitem><para>Edit the <filename>netbase_4.47.bbappend</filename> file so that it
663 contains the following:
664 <literallayout class='monospaced'>
665 FILESEXTRAPATHS_prepend := "${THISDIR}/files:"
666 PRINC := "${@int(PRINC) + 2}"
667 </literallayout></para></listitem>
668 <listitem><para>Create and place the new <filename>interfaces</filename>
669 configuration file in the BSP's layer here:
670 <literallayout class='monospaced'>
671 meta-xyz/recipes-core/netbase/files/xyz/interfaces
672 </literallayout></para></listitem>
673 </orderedlist>
674 </para>
675 </section>
676
641 <section id='bsp-licensing-considerations'> 677 <section id='bsp-licensing-considerations'>
642 <title>BSP Licensing Considerations</title> 678 <title>BSP Licensing Considerations</title>
643 679