diff options
Diffstat (limited to 'documentation')
| -rw-r--r-- | documentation/bsp-guide/bsp.xml | 25 |
1 files changed, 21 insertions, 4 deletions
diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml index e2262a41f8..3cda0f6b70 100644 --- a/documentation/bsp-guide/bsp.xml +++ b/documentation/bsp-guide/bsp.xml | |||
| @@ -902,8 +902,15 @@ | |||
| 902 | <filename>recipes-bsp</filename>, <filename>recipes-graphics</filename>, | 902 | <filename>recipes-bsp</filename>, <filename>recipes-graphics</filename>, |
| 903 | <filename>recipes-core</filename>, and so forth). | 903 | <filename>recipes-core</filename>, and so forth). |
| 904 | </para></listitem> | 904 | </para></listitem> |
| 905 | <listitem><para>Place the BSP-specific files in the directory named for | 905 | <listitem><para>Place the BSP-specific files in the proper directory |
| 906 | your machine inside the BSP layer. | 906 | inside the BSP layer. |
| 907 | How expansive the layer is affects where you must place these files. | ||
| 908 | For example, if your layer supports several different machine types, | ||
| 909 | you need to be sure your layer's directory structure includes hierarchy | ||
| 910 | that separates the files out according to machine. | ||
| 911 | If your layer does not support multiple machines, the layer would not | ||
| 912 | have that additional hierarchy and the files would obviously not be | ||
| 913 | able to reside in a machine-specific directory. | ||
| 907 | </para></listitem> | 914 | </para></listitem> |
| 908 | </itemizedlist> | 915 | </itemizedlist> |
| 909 | </para> | 916 | </para> |
| @@ -912,7 +919,8 @@ | |||
| 912 | Following is a specific example to help you better understand the process. | 919 | Following is a specific example to help you better understand the process. |
| 913 | Consider an example that customizes a recipe by adding | 920 | Consider an example that customizes a recipe by adding |
| 914 | a BSP-specific configuration file named <filename>interfaces</filename> to the | 921 | a BSP-specific configuration file named <filename>interfaces</filename> to the |
| 915 | <filename>init-ifupdown_1.0.bb</filename> recipe for machine "xyz". | 922 | <filename>init-ifupdown_1.0.bb</filename> recipe for machine "xyz" where the |
| 923 | BSP layer also supports several other machines. | ||
| 916 | Do the following: | 924 | Do the following: |
| 917 | <orderedlist> | 925 | <orderedlist> |
| 918 | <listitem><para>Edit the <filename>init-ifupdown_1.0.bbappend</filename> file so that it | 926 | <listitem><para>Edit the <filename>init-ifupdown_1.0.bbappend</filename> file so that it |
| @@ -926,8 +934,17 @@ | |||
| 926 | <listitem><para>Create and place the new <filename>interfaces</filename> | 934 | <listitem><para>Create and place the new <filename>interfaces</filename> |
| 927 | configuration file in the BSP's layer here: | 935 | configuration file in the BSP's layer here: |
| 928 | <literallayout class='monospaced'> | 936 | <literallayout class='monospaced'> |
| 929 | meta-xyz/recipes-core/init-ifupdown/files/xyz/interfaces | 937 | meta-xyz/recipes-core/init-ifupdown/files/xyz-machine-one/interfaces |
| 930 | </literallayout> | 938 | </literallayout> |
| 939 | <note> | ||
| 940 | If the <filename>meta-xyz</filename> layer did not support | ||
| 941 | multiple machines, you would place the | ||
| 942 | <filename>interfaces</filename> configuration file in the | ||
| 943 | layer here: | ||
| 944 | <literallayout class='monospaced'> | ||
| 945 | meta-xyz/recipes-core/init-ifupdown/files/interfaces | ||
| 946 | </literallayout> | ||
| 947 | </note> | ||
| 931 | The | 948 | The |
| 932 | <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></ulink> | 949 | <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></ulink> |
| 933 | variable in the append files extends the search path | 950 | variable in the append files extends the search path |