summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2017-08-18 12:48:44 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2017-09-02 00:52:48 +0100
commit2b93720cfcd7832d38ccf557cc54fc7565db1f24 (patch)
treedb5069a5e2c6aa9409e61b0bffbc45b5a6e3d874 /documentation/dev-manual
parenta99c2c5581f8847fa3d95696f0f985ea87f9da9d (diff)
downloadpoky-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.xml109
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