diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2017-08-18 12:48:44 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2017-09-02 00:52:48 +0100 |
commit | 2b93720cfcd7832d38ccf557cc54fc7565db1f24 (patch) | |
tree | db5069a5e2c6aa9409e61b0bffbc45b5a6e3d874 /documentation/dev-manual | |
parent | a99c2c5581f8847fa3d95696f0f985ea87f9da9d (diff) | |
download | poky-2b93720cfcd7832d38ccf557cc54fc7565db1f24.tar.gz |
bsp-guide, dev-manual: Moved BSP Layer prep steps to bsp-guide
The YP Development Manual had some build host preparation steps
as part of the chapter that talks about getting a host ready
for using YP. These steps are better suited in the BSP Guide.
I moved them there and filled out the steps to be more complete.
(From yocto-docs rev: 2277812d0dd411a103a4a4252d4cb90c471901c9)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r-- | documentation/dev-manual/dev-manual-start.xml | 109 |
1 files changed, 0 insertions, 109 deletions
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index 01a18942fc..e840385c25 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml | |||
@@ -203,115 +203,6 @@ | |||
203 | </para> | 203 | </para> |
204 | </section> | 204 | </section> |
205 | 205 | ||
206 | <section id='setting-up-bsp-layers'> | ||
207 | <title>Setting Up BSP Layers</title> | ||
208 | |||
209 | <para> | ||
210 | This section describes how to set up a layer for a Board Support | ||
211 | Package (BSP). | ||
212 | For structural information on BSPs, see the | ||
213 | <ulink url='&YOCTO_DOCS_BSP_URL;#bsp-guide'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>. | ||
214 | <orderedlist> | ||
215 | <listitem><para> | ||
216 | <emphasis>Determine the BSP Layer You Want:</emphasis> | ||
217 | The Yocto Project supports many BSPs, which are maintained in | ||
218 | their own layers or in layers designed to contain several | ||
219 | BSPs. | ||
220 | To get an idea of machine support through BSP layers, you can | ||
221 | look at the | ||
222 | <ulink url='&YOCTO_RELEASE_DL_URL;/machines'>index of machines</ulink> | ||
223 | for the release. | ||
224 | <note> | ||
225 | The Yocto Project uses the following BSP layer naming | ||
226 | scheme: | ||
227 | <literallayout class='monospaced'> | ||
228 | meta-<replaceable>bsp_name</replaceable> | ||
229 | </literallayout> | ||
230 | where <replaceable>bsp_name</replaceable> is the recognized | ||
231 | BSP name. | ||
232 | Here is an example: | ||
233 | <literallayout class='monospaced'> | ||
234 | meta-raspberrypi | ||
235 | </literallayout> | ||
236 | See the | ||
237 | "<ulink url='&YOCTO_DOCS_BSP_URL;#bsp-layers'>BSP Layers</ulink>" | ||
238 | section in the Yocto Project Board Support Package (BSP) | ||
239 | Developer's Guide for more information on BSP Layers. | ||
240 | </note> | ||
241 | </para></listitem> | ||
242 | <listitem><para> | ||
243 | <emphasis>Optionally Set Up the <filename>meta-intel</filename> BSP Layer:</emphasis> | ||
244 | If your hardware is based on current Intel CPUs and devices, | ||
245 | you can leverage this BSP layer. | ||
246 | For details on the <filename>meta-intel</filename> BSP layer, | ||
247 | see the layer's | ||
248 | <ulink url='http://git.yoctoproject.org/cgit/cgit.cgi/meta-intel/tree/README'><filename>README</filename></ulink> | ||
249 | file. | ||
250 | <orderedlist> | ||
251 | <listitem><para> | ||
252 | <emphasis>Navigate to Your Source Directory:</emphasis> | ||
253 | Typically, you set up the | ||
254 | <filename>meta-intel</filename> Git repository | ||
255 | inside the | ||
256 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> | ||
257 | (e.g. <filename>poky</filename>). | ||
258 | </para></listitem> | ||
259 | <listitem><para> | ||
260 | <emphasis>Clone the Layer:</emphasis> | ||
261 | <literallayout class='monospaced'> | ||
262 | $ git clone git://git.yoctoproject.org/meta-intel.git | ||
263 | Cloning into 'meta-intel'... | ||
264 | remote: Counting objects: 14224, done. | ||
265 | remote: Compressing objects: 100% (4591/4591), done. | ||
266 | remote: Total 14224 (delta 8245), reused 13985 (delta 8006) | ||
267 | Receiving objects: 100% (14224/14224), 4.29 MiB | 2.90 MiB/s, done. | ||
268 | Resolving deltas: 100% (8245/8245), done. | ||
269 | Checking connectivity... done. | ||
270 | </literallayout> | ||
271 | </para></listitem> | ||
272 | <listitem><para> | ||
273 | <emphasis>Check Out the Proper Branch:</emphasis> | ||
274 | The branch you check out for | ||
275 | <filename>meta-intel</filename> must match the same | ||
276 | branch you are using for the Yocto Project release | ||
277 | (e.g. &DISTRO_NAME_NO_CAP;): | ||
278 | <literallayout class='monospaced'> | ||
279 | $ git checkout <replaceable>branch_name</replaceable> | ||
280 | </literallayout> | ||
281 | For an example on how to discover branch names and | ||
282 | checkout on a branch, see the | ||
283 | "<link linkend='checking-out-by-branch-in-poky'>Checking Out By Branch in Poky</link>" | ||
284 | section. | ||
285 | </para></listitem> | ||
286 | </orderedlist> | ||
287 | </para></listitem> | ||
288 | <listitem><para> | ||
289 | <emphasis>Optionally Set Up an Alternative BSP Layer:</emphasis> | ||
290 | If your hardware can be more closely leveraged to an | ||
291 | existing BSP not within the <filename>meta-intel</filename> | ||
292 | BSP layer, you can clone that BSP layer.</para> | ||
293 | |||
294 | <para>The process is identical to the process used for the | ||
295 | <filename>meta-intel</filename> layer except for the layer's | ||
296 | name. | ||
297 | For example, if you determine that your hardware most | ||
298 | closely matches the <filename>meta-minnow</filename>, | ||
299 | clone that layer: | ||
300 | <literallayout class='monospaced'> | ||
301 | $ git clone git://git.yoctoproject.org/meta-minnow | ||
302 | Cloning into 'meta-minnow'... | ||
303 | remote: Counting objects: 456, done. | ||
304 | remote: Compressing objects: 100% (283/283), done. | ||
305 | remote: Total 456 (delta 163), reused 384 (delta 91) | ||
306 | Receiving objects: 100% (456/456), 96.74 KiB | 0 bytes/s, done. | ||
307 | Resolving deltas: 100% (163/163), done. | ||
308 | Checking connectivity... done. | ||
309 | </literallayout> | ||
310 | </para></listitem> | ||
311 | </orderedlist> | ||
312 | </para> | ||
313 | </section> | ||
314 | |||
315 | <section id='local-kernel-files'> | 206 | <section id='local-kernel-files'> |
316 | <title>Setting Up to Work on a Kernel</title> | 207 | <title>Setting Up to Work on a Kernel</title> |
317 | 208 | ||