summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-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