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 | ||
