diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2017-07-28 16:40:30 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2017-07-30 16:23:51 +0100 |
commit | 2f25c9b56c84b9999dadec52088d2e95787d8e36 (patch) | |
tree | 2c3e7d0597898a60d49fcfacc09725fbe9924fc6 /documentation/yocto-project-qs | |
parent | b9a3edf6ce02c5968ec4b1378dedb80b7ed3f0ca (diff) | |
download | poky-2f25c9b56c84b9999dadec52088d2e95787d8e36.tar.gz |
yocto-project-qs: Added section for CROPS.
(From yocto-docs rev: 0d6fba532e0247db2cce4e94466f4476114d3e13)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/yocto-project-qs')
-rw-r--r-- | documentation/yocto-project-qs/yocto-project-qs.xml | 418 |
1 files changed, 253 insertions, 165 deletions
diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml index 6064f96cc4..9eaaea5501 100644 --- a/documentation/yocto-project-qs/yocto-project-qs.xml +++ b/documentation/yocto-project-qs/yocto-project-qs.xml | |||
@@ -44,7 +44,6 @@ | |||
44 | </note> | 44 | </note> |
45 | </legalnotice> | 45 | </legalnotice> |
46 | 46 | ||
47 | |||
48 | <abstract> | 47 | <abstract> |
49 | <imagedata fileref="figures/yocto-project-transp.png" | 48 | <imagedata fileref="figures/yocto-project-transp.png" |
50 | width="6in" depth="1in" | 49 | width="6in" depth="1in" |
@@ -180,163 +179,234 @@ | |||
180 | <title>Setting Up to Use the Yocto Project</title> | 179 | <title>Setting Up to Use the Yocto Project</title> |
181 | 180 | ||
182 | <para> | 181 | <para> |
183 | The following list shows what you need in order to use a | 182 | Setting up to use the Yocto Project involves getting your build |
184 | Linux-based build host to use the Yocto Project to build images: | 183 | host ready. |
184 | If you have a native Linux machine that runs a Yocto Project | ||
185 | supported distribution as described by the | ||
186 | "<ulink url='&YOCTO_DOCS_REF_URL;#detailed-supported-distros'>Supported Linux Distributions</ulink>" | ||
187 | section in the Yocto Project Reference Manual, you can prepare | ||
188 | that machine as your build host. | ||
189 | See the | ||
190 | "<link linkend='qs-native-linux-build-host'>Using a Native Linux Machine</link>" | ||
191 | section for more information. | ||
185 | </para> | 192 | </para> |
186 | 193 | ||
187 | <itemizedlist> | 194 | <para> |
188 | <listitem><para><emphasis>Build Host</emphasis> | 195 | If you do not want to use the Yocto Project on a native Linux |
189 | A build host with a minimum of 50 Gbytes of free disk | 196 | machine, you can prepare your build host to use |
190 | space that is running a supported Linux distribution (i.e. | 197 | <ulink url='https://git.yoctoproject.org/cgit/cgit.cgi/crops/about/'>CROPS</ulink>, |
191 | recent releases of Fedora, openSUSE, CentOS, Debian, or | 198 | which leverages |
192 | Ubuntu). | 199 | <ulink url='https://www.docker.com/'>Docker Containers</ulink>. |
193 | </para></listitem> | 200 | You can set up a build host for Windows, Mac, and Linux |
194 | <listitem><para><emphasis>Build Host Packages</emphasis> | 201 | machines. |
195 | Appropriate packages installed on the build host. | 202 | See the |
196 | </para></listitem> | 203 | "<link linkend='qs-crops-build-host'>Using CROPS and Containers</link>" |
197 | <listitem><para><emphasis>The Yocto Project</emphasis> | 204 | section for more information. |
198 | A release of the Yocto Project. | 205 | </para> |
199 | </para></listitem> | ||
200 | </itemizedlist> | ||
201 | |||
202 | <section id='the-linux-distro'> | ||
203 | <title>The Linux Distribution</title> | ||
204 | 206 | ||
205 | <para> | 207 | <section id='qs-crops-build-host'> |
206 | The Yocto Project team verifies each release against recent | 208 | <title>Using CROPS and Containers</title> |
207 | versions of the most popular Linux distributions that | ||
208 | provide stable releases. | ||
209 | In general, if you have the current release minus one of the | ||
210 | following distributions, you should have no problems. | ||
211 | <itemizedlist> | ||
212 | <listitem><para> | ||
213 | Ubuntu | ||
214 | </para></listitem> | ||
215 | <listitem><para> | ||
216 | Fedora | ||
217 | </para></listitem> | ||
218 | <listitem><para> | ||
219 | openSUSE | ||
220 | </para></listitem> | ||
221 | <listitem><para> | ||
222 | CentOS | ||
223 | </para></listitem> | ||
224 | <listitem><para> | ||
225 | Debian | ||
226 | </para></listitem> | ||
227 | </itemizedlist> | ||
228 | For a more detailed list of distributions that support the | ||
229 | Yocto Project, see the | ||
230 | "<ulink url='&YOCTO_DOCS_REF_URL;#detailed-supported-distros'>Supported Linux Distributions</ulink>" | ||
231 | section in the Yocto Project Reference Manual. | ||
232 | </para> | ||
233 | 209 | ||
234 | <para> | 210 | <para> |
235 | The OpenEmbedded build system should be able to run on any | 211 | Follow these steps to get your build host set up with a |
236 | modern distribution that has the following versions for | 212 | Poky container that you can use to complete the build |
237 | Git, tar, and Python. | 213 | examples further down in the Quick Start: |
238 | <itemizedlist> | 214 | <orderedlist> |
239 | <listitem><para> | ||
240 | Git 1.8.3.1 or greater | ||
241 | </para></listitem> | ||
242 | <listitem><para> | 215 | <listitem><para> |
243 | tar 1.27 or greater | 216 | <emphasis>Reference the Procedure:</emphasis> |
217 | Work through the first six steps of the procedure | ||
218 | in the | ||
219 | "<ulink url='&YOCTO_DOCS_DEV_URL;#setting-up-to-use-crops'>Setting Up to Use CROss PlatformS (CROPS)</ulink>" | ||
220 | section of the Yocto Project Development Manual. | ||
244 | </para></listitem> | 221 | </para></listitem> |
245 | <listitem><para> | 222 | <listitem><para> |
246 | Python 3.4.0 or greater. | 223 | <emphasis>Set Up the Poky Container to Use the Yocto Project:</emphasis> |
224 | Go to | ||
225 | <ulink url='https://github.com/crops/poky-container/blob/master/README.md'></ulink> | ||
226 | and follow the directions to set up the Poky container | ||
227 | on your build host.</para> | ||
228 | |||
229 | <para>Once you complete the setup instructions for your | ||
230 | machine, you need to get a copy of the | ||
231 | <filename>poky</filename> repository on your build | ||
232 | host. | ||
233 | See the | ||
234 | "<link linkend='releases'>Yocto Project Release</link>" | ||
235 | section to continue. | ||
247 | </para></listitem> | 236 | </para></listitem> |
248 | </itemizedlist> | 237 | </orderedlist> |
249 | If your build host does not meet any of these three listed | ||
250 | version requirements, you can take steps to prepare the | ||
251 | system so that you can still use the Yocto Project. | ||
252 | See the | ||
253 | "<ulink url='&YOCTO_DOCS_REF_URL;#required-git-tar-and-python-versions'>Required Git, tar, and Python Versions</ulink>" | ||
254 | section in the Yocto Project Reference Manual for information. | ||
255 | </para> | 238 | </para> |
256 | </section> | 239 | </section> |
257 | 240 | ||
258 | <section id='packages'> | 241 | <section id='qs-native-linux-build-host'> |
259 | <title>The Build Host Packages</title> | 242 | <title>Using a Native Linux Machine</title> |
260 | 243 | ||
261 | <para> | 244 | <para> |
262 | Required build host packages vary depending on your | 245 | The following list shows what you need in order to use a |
263 | build machine and what you want to do with the Yocto Project. | 246 | Linux-based build host to use the Yocto Project to build images: |
264 | For example, if you want to build an image that can run | ||
265 | on QEMU in graphical mode (a minimal, basic build | ||
266 | requirement), then the build host package requirements | ||
267 | are different than if you want to build an image on a headless | ||
268 | system or build out the Yocto Project documentation set. | ||
269 | </para> | 247 | </para> |
270 | 248 | ||
271 | <para> | 249 | <itemizedlist> |
272 | Collectively, the number of required packages is large | 250 | <listitem><para><emphasis>Build Host</emphasis> |
273 | if you want to be able to cover all cases. | 251 | A build host with a minimum of 50 Gbytes of free disk |
274 | <note> | 252 | space that is running a supported Linux distribution (i.e. |
275 | In general, you need to have root access and then install | 253 | recent releases of Fedora, openSUSE, CentOS, Debian, or |
276 | the required packages. | 254 | Ubuntu). |
277 | Thus, the commands in the following section may or may | 255 | </para></listitem> |
278 | not work depending on whether or not your Linux | 256 | <listitem><para><emphasis>Build Host Packages</emphasis> |
279 | distribution has <filename>sudo</filename> installed. | 257 | Appropriate packages installed on the build host. |
280 | </note> | 258 | </para></listitem> |
281 | </para> | 259 | </itemizedlist> |
282 | 260 | ||
283 | <para> | 261 | <section id='the-linux-distro'> |
284 | The following list shows the required packages needed to build | 262 | <title>The Linux Distribution</title> |
285 | an image that runs on QEMU in graphical mode (e.g. essential | 263 | |
286 | plus graphics support). | 264 | <para> |
287 | For lists of required packages for other scenarios, see the | 265 | The Yocto Project team verifies each release against recent |
288 | "<ulink url='&YOCTO_DOCS_REF_URL;#required-packages-for-the-host-development-system'>Required Packages for the Host Development System</ulink>" | 266 | versions of the most popular Linux distributions that |
289 | section in the Yocto Project Reference Manual. | 267 | provide stable releases. |
290 | <itemizedlist> | 268 | In general, if you have the current release minus one of the |
291 | <listitem><para><emphasis>Ubuntu and Debian</emphasis> | 269 | following distributions, you should have no problems. |
292 | <literallayout class='monospaced'> | 270 | <itemizedlist> |
271 | <listitem><para> | ||
272 | Ubuntu | ||
273 | </para></listitem> | ||
274 | <listitem><para> | ||
275 | Fedora | ||
276 | </para></listitem> | ||
277 | <listitem><para> | ||
278 | openSUSE | ||
279 | </para></listitem> | ||
280 | <listitem><para> | ||
281 | CentOS | ||
282 | </para></listitem> | ||
283 | <listitem><para> | ||
284 | Debian | ||
285 | </para></listitem> | ||
286 | </itemizedlist> | ||
287 | For a more detailed list of distributions that support the | ||
288 | Yocto Project, see the | ||
289 | "<ulink url='&YOCTO_DOCS_REF_URL;#detailed-supported-distros'>Supported Linux Distributions</ulink>" | ||
290 | section in the Yocto Project Reference Manual. | ||
291 | </para> | ||
292 | |||
293 | <para> | ||
294 | The OpenEmbedded build system should be able to run on any | ||
295 | modern distribution that has the following versions for | ||
296 | Git, tar, and Python. | ||
297 | <itemizedlist> | ||
298 | <listitem><para> | ||
299 | Git 1.8.3.1 or greater | ||
300 | </para></listitem> | ||
301 | <listitem><para> | ||
302 | tar 1.27 or greater | ||
303 | </para></listitem> | ||
304 | <listitem><para> | ||
305 | Python 3.4.0 or greater. | ||
306 | </para></listitem> | ||
307 | </itemizedlist> | ||
308 | If your build host does not meet any of these three listed | ||
309 | version requirements, you can take steps to prepare the | ||
310 | system so that you can still use the Yocto Project. | ||
311 | See the | ||
312 | "<ulink url='&YOCTO_DOCS_REF_URL;#required-git-tar-and-python-versions'>Required Git, tar, and Python Versions</ulink>" | ||
313 | section in the Yocto Project Reference Manual for information. | ||
314 | </para> | ||
315 | </section> | ||
316 | |||
317 | <section id='packages'> | ||
318 | <title>The Build Host Packages</title> | ||
319 | |||
320 | <para> | ||
321 | Required build host packages vary depending on your | ||
322 | build machine and what you want to do with the Yocto Project. | ||
323 | For example, if you want to build an image that can run | ||
324 | on QEMU in graphical mode (a minimal, basic build | ||
325 | requirement), then the build host package requirements | ||
326 | are different than if you want to build an image on a headless | ||
327 | system or build out the Yocto Project documentation set. | ||
328 | </para> | ||
329 | |||
330 | <para> | ||
331 | Collectively, the number of required packages is large | ||
332 | if you want to be able to cover all cases. | ||
333 | <note> | ||
334 | In general, you need to have root access and then install | ||
335 | the required packages. | ||
336 | Thus, the commands in the following section may or may | ||
337 | not work depending on whether or not your Linux | ||
338 | distribution has <filename>sudo</filename> installed. | ||
339 | </note> | ||
340 | </para> | ||
341 | |||
342 | <para> | ||
343 | The following list shows the required packages needed to build | ||
344 | an image that runs on QEMU in graphical mode (e.g. essential | ||
345 | plus graphics support). | ||
346 | For lists of required packages for other scenarios, see the | ||
347 | "<ulink url='&YOCTO_DOCS_REF_URL;#required-packages-for-the-host-development-system'>Required Packages for the Host Development System</ulink>" | ||
348 | section in the Yocto Project Reference Manual. | ||
349 | <itemizedlist> | ||
350 | <listitem><para><emphasis>Ubuntu and Debian</emphasis> | ||
351 | <literallayout class='monospaced'> | ||
293 | $ sudo apt-get install &UBUNTU_HOST_PACKAGES_ESSENTIAL; libsdl1.2-dev xterm | 352 | $ sudo apt-get install &UBUNTU_HOST_PACKAGES_ESSENTIAL; libsdl1.2-dev xterm |
294 | </literallayout> | 353 | </literallayout> |
295 | </para></listitem> | 354 | </para></listitem> |
296 | <listitem><para><emphasis>Fedora</emphasis> | 355 | <listitem><para><emphasis>Fedora</emphasis> |
297 | <literallayout class='monospaced'> | 356 | <literallayout class='monospaced'> |
298 | $ sudo dnf install &FEDORA_HOST_PACKAGES_ESSENTIAL; SDL-devel xterm | 357 | $ sudo dnf install &FEDORA_HOST_PACKAGES_ESSENTIAL; SDL-devel xterm |
299 | </literallayout> | 358 | </literallayout> |
300 | </para></listitem> | 359 | </para></listitem> |
301 | <listitem><para><emphasis>OpenSUSE</emphasis> | 360 | <listitem><para><emphasis>OpenSUSE</emphasis> |
302 | <literallayout class='monospaced'> | 361 | <literallayout class='monospaced'> |
303 | $ sudo zypper install &OPENSUSE_HOST_PACKAGES_ESSENTIAL; libSDL-devel xterm | 362 | $ sudo zypper install &OPENSUSE_HOST_PACKAGES_ESSENTIAL; libSDL-devel xterm |
304 | </literallayout> | 363 | </literallayout> |
305 | </para></listitem> | 364 | </para></listitem> |
306 | <listitem><para><emphasis>CentOS</emphasis> | 365 | <listitem><para><emphasis>CentOS</emphasis> |
307 | <literallayout class='monospaced'> | 366 | <literallayout class='monospaced'> |
308 | $ sudo yum install &CENTOS_HOST_PACKAGES_ESSENTIAL; SDL-devel xterm | 367 | $ sudo yum install &CENTOS_HOST_PACKAGES_ESSENTIAL; SDL-devel xterm |
309 | </literallayout> | 368 | </literallayout> |
310 | <note><title>Notes</title> | 369 | <note><title>Notes</title> |
311 | <itemizedlist> | 370 | <itemizedlist> |
312 | <listitem><para> | 371 | <listitem><para> |
313 | CentOS 6.x users need to ensure that the | 372 | CentOS 6.x users need to ensure that the |
314 | required versions of Git, tar and Python | 373 | required versions of Git, tar and Python |
315 | are available. | 374 | are available. |
316 | For details, See the | 375 | For details, See the |
317 | "<ulink url='&YOCTO_DOCS_REF_URL;#required-git-tar-and-python-versions'>Required Git, tar, and Python Versions</ulink>" | 376 | "<ulink url='&YOCTO_DOCS_REF_URL;#required-git-tar-and-python-versions'>Required Git, tar, and Python Versions</ulink>" |
318 | section in the Yocto Project Reference | 377 | section in the Yocto Project Reference |
319 | Manual for information. | 378 | Manual for information. |
320 | </para></listitem> | 379 | </para></listitem> |
321 | <listitem><para> | 380 | <listitem><para> |
322 | Extra Packages for Enterprise Linux | 381 | Extra Packages for Enterprise Linux |
323 | (i.e. <filename>epel-release</filename>) | 382 | (i.e. <filename>epel-release</filename>) |
324 | is a collection of packages from Fedora | 383 | is a collection of packages from Fedora |
325 | built on RHEL/CentOS for easy installation | 384 | built on RHEL/CentOS for easy installation |
326 | of packages not included in enterprise | 385 | of packages not included in enterprise |
327 | Linux by default. | 386 | Linux by default. |
328 | You need to install these packages | 387 | You need to install these packages |
329 | separately. | 388 | separately. |
330 | </para></listitem> | 389 | </para></listitem> |
331 | <listitem><para> | 390 | <listitem><para> |
332 | The <filename>makecache</filename> command | 391 | The <filename>makecache</filename> command |
333 | consumes additional Metadata from | 392 | consumes additional Metadata from |
334 | <filename>epel-release</filename>. | 393 | <filename>epel-release</filename>. |
335 | </para></listitem> | 394 | </para></listitem> |
336 | </itemizedlist> | 395 | </itemizedlist> |
337 | </note> | 396 | </note> |
338 | </para></listitem> | 397 | </para></listitem> |
339 | </itemizedlist> | 398 | </itemizedlist> |
399 | </para> | ||
400 | </section> | ||
401 | |||
402 | <para> | ||
403 | Once you complete the setup instructions for your | ||
404 | machine, you need to get a copy of the | ||
405 | <filename>poky</filename> repository on your build | ||
406 | host. | ||
407 | Continue with the | ||
408 | "<link linkend='releases'>Yocto Project Release</link>" | ||
409 | section. | ||
340 | </para> | 410 | </para> |
341 | </section> | 411 | </section> |
342 | 412 | ||
@@ -344,8 +414,9 @@ | |||
344 | <title>Yocto Project Release</title> | 414 | <title>Yocto Project Release</title> |
345 | 415 | ||
346 | <para> | 416 | <para> |
347 | The last requirement you need to meet before using the | 417 | Now that your build host has the right packages (native |
348 | Yocto Project is getting a Yocto Project release. | 418 | Linux machine) or you have the Poky container set up |
419 | (CROPS), you need to get a copy of the Yocto Project. | ||
349 | It is recommended that you get the latest Yocto Project release | 420 | It is recommended that you get the latest Yocto Project release |
350 | by setting up (cloning in | 421 | by setting up (cloning in |
351 | <ulink url='&YOCTO_DOCS_REF_URL;#git'>Git</ulink> terms) a | 422 | <ulink url='&YOCTO_DOCS_REF_URL;#git'>Git</ulink> terms) a |
@@ -356,9 +427,14 @@ | |||
356 | </para> | 427 | </para> |
357 | 428 | ||
358 | <para> | 429 | <para> |
359 | Here is an example from an Ubuntu build host that clones the | 430 | Here is an example from a native Linux machine that is |
360 | <filename>poky</filename> repository and then checks out the | 431 | running Ubuntu. |
361 | latest Yocto Project Release by tag | 432 | <note> |
433 | If your build host is using a Poky container, you can | ||
434 | use the same Git commands. | ||
435 | </note> | ||
436 | The example clones the <filename>poky</filename> repository | ||
437 | and then checks out the latest Yocto Project Release by tag | ||
362 | (i.e. <filename>&DISTRO_REL_TAG;</filename>): | 438 | (i.e. <filename>&DISTRO_REL_TAG;</filename>): |
363 | <literallayout class='monospaced'> | 439 | <literallayout class='monospaced'> |
364 | $ git clone git://git.yoctoproject.org/poky | 440 | $ git clone git://git.yoctoproject.org/poky |
@@ -404,20 +480,21 @@ | |||
404 | <title>Building Images</title> | 480 | <title>Building Images</title> |
405 | 481 | ||
406 | <para> | 482 | <para> |
407 | Now that you have your system requirements in order, you can give | 483 | You are now ready to give the Yocto Project a try. |
408 | Yocto Project a try. | 484 | For this example, you will be using the command line to build |
409 | You can try out Yocto Project using either the command-line | 485 | your images. |
410 | interface or using Toaster, which uses a graphical user | 486 | <note> |
411 | interface. | 487 | A graphical user interface to the Yocto Project is available |
412 | If you want to try out the Yocto Project using a GUI, see the | 488 | through Toaster. |
413 | <ulink url='&YOCTO_DOCS_TOAST_URL;'>Toaster User Manual</ulink> | 489 | See the |
414 | for information on how to install and set up Toaster. | 490 | <ulink url='&YOCTO_DOCS_TOAST_URL;'>Toaster User Manual</ulink> |
491 | for more information. | ||
492 | </note> | ||
415 | </para> | 493 | </para> |
416 | 494 | ||
417 | <para> | 495 | <para> |
418 | To use the Yocto Project through the command-line interface, | 496 | The remainder of this quick start steps you through the |
419 | finish this quick start, which presents steps that let you | 497 | following: |
420 | do the following: | ||
421 | <itemizedlist> | 498 | <itemizedlist> |
422 | <listitem><para> | 499 | <listitem><para> |
423 | Build a <filename>qemux86</filename> reference image | 500 | Build a <filename>qemux86</filename> reference image |
@@ -477,7 +554,8 @@ | |||
477 | 554 | ||
478 | <para> | 555 | <para> |
479 | <orderedlist> | 556 | <orderedlist> |
480 | <listitem><para><emphasis>Be Sure Your Build Host is Set Up:</emphasis> | 557 | <listitem><para> |
558 | <emphasis>Be Sure Your Build Host is Set Up:</emphasis> | ||
481 | The steps to build an image in this section depend on | 559 | The steps to build an image in this section depend on |
482 | your build host being properly set up. | 560 | your build host being properly set up. |
483 | Be sure you have worked through the requirements | 561 | Be sure you have worked through the requirements |
@@ -485,7 +563,8 @@ | |||
485 | "<link linkend='yp-resources'>Setting Up to Use the Yocto Project</link>" | 563 | "<link linkend='yp-resources'>Setting Up to Use the Yocto Project</link>" |
486 | section. | 564 | section. |
487 | </para></listitem> | 565 | </para></listitem> |
488 | <listitem><para><emphasis>Check Out Your Branch:</emphasis> | 566 | <listitem><para> |
567 | <emphasis>Check Out Your Branch:</emphasis> | ||
489 | Be sure you are in the | 568 | Be sure you are in the |
490 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink> | 569 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink> |
491 | (e.g. <filename>poky</filename>) and then check out | 570 | (e.g. <filename>poky</filename>) and then check out |
@@ -505,7 +584,8 @@ | |||
505 | branch ensures you are using the latest files for | 584 | branch ensures you are using the latest files for |
506 | that release. | 585 | that release. |
507 | </para></listitem> | 586 | </para></listitem> |
508 | <listitem><para><emphasis>Initialize the Build Environment:</emphasis> | 587 | <listitem><para> |
588 | <emphasis>Initialize the Build Environment:</emphasis> | ||
509 | Run the | 589 | Run the |
510 | <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink> | 590 | <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink> |
511 | environment setup script to define the OpenEmbedded | 591 | environment setup script to define the OpenEmbedded |
@@ -530,7 +610,8 @@ | |||
530 | setup script. | 610 | setup script. |
531 | </note> | 611 | </note> |
532 | </para></listitem> | 612 | </para></listitem> |
533 | <listitem><para><emphasis>Examine Your Local Configuration File:</emphasis> | 613 | <listitem><para> |
614 | <emphasis>Examine Your Local Configuration File:</emphasis> | ||
534 | When you set up the build environment, a local | 615 | When you set up the build environment, a local |
535 | configuration file named | 616 | configuration file named |
536 | <filename>local.conf</filename> becomes available in | 617 | <filename>local.conf</filename> becomes available in |
@@ -584,7 +665,8 @@ | |||
584 | </para></listitem> | 665 | </para></listitem> |
585 | </itemizedlist> | 666 | </itemizedlist> |
586 | </para></listitem> | 667 | </para></listitem> |
587 | <listitem><para><emphasis>Start the Build:</emphasis> | 668 | <listitem><para> |
669 | <emphasis>Start the Build:</emphasis> | ||
588 | Continue with the following command to build an OS image | 670 | Continue with the following command to build an OS image |
589 | for the target, which is | 671 | for the target, which is |
590 | <filename>core-image-sato</filename> in this example: | 672 | <filename>core-image-sato</filename> in this example: |
@@ -642,7 +724,8 @@ | |||
642 | "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>" | 724 | "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>" |
643 | chapter in the Yocto Project Reference Manual. | 725 | chapter in the Yocto Project Reference Manual. |
644 | </para></listitem> | 726 | </para></listitem> |
645 | <listitem><para><emphasis>Simulate Your Image Using QEMU:</emphasis> | 727 | <listitem><para> |
728 | <emphasis>Simulate Your Image Using QEMU:</emphasis> | ||
646 | Once this particular image is built, you can start QEMU | 729 | Once this particular image is built, you can start QEMU |
647 | and run the image: | 730 | and run the image: |
648 | <literallayout class='monospaced'> | 731 | <literallayout class='monospaced'> |
@@ -652,7 +735,8 @@ | |||
652 | "<ulink url="&YOCTO_DOCS_DEV_URL;#dev-manual-qemu">Using the Quick EMUlator (QEMU)</ulink>" | 735 | "<ulink url="&YOCTO_DOCS_DEV_URL;#dev-manual-qemu">Using the Quick EMUlator (QEMU)</ulink>" |
653 | chapter in the Yocto Project Development Manual. | 736 | chapter in the Yocto Project Development Manual. |
654 | </para></listitem> | 737 | </para></listitem> |
655 | <listitem><para><emphasis>Exit QEMU:</emphasis> | 738 | <listitem><para> |
739 | <emphasis>Exit QEMU:</emphasis> | ||
656 | Exit QEMU by either clicking on the shutdown icon or by | 740 | Exit QEMU by either clicking on the shutdown icon or by |
657 | typing <filename>Ctrl-C</filename> in the QEMU | 741 | typing <filename>Ctrl-C</filename> in the QEMU |
658 | transcript window from which you evoked QEMU. | 742 | transcript window from which you evoked QEMU. |
@@ -682,7 +766,8 @@ | |||
682 | 766 | ||
683 | <para> | 767 | <para> |
684 | <orderedlist> | 768 | <orderedlist> |
685 | <listitem><para><emphasis>Create a Local Copy of the | 769 | <listitem><para> |
770 | <emphasis>Create a Local Copy of the | ||
686 | <filename>meta-intel</filename> Repository:</emphasis> | 771 | <filename>meta-intel</filename> Repository:</emphasis> |
687 | Building an image for the MinnowBoard Turbot requires | 772 | Building an image for the MinnowBoard Turbot requires |
688 | the | 773 | the |
@@ -731,7 +816,8 @@ | |||
731 | "meta-intel-&DISTRO_NAME_NO_CAP;-&YOCTO_DOC_VERSION;" | 816 | "meta-intel-&DISTRO_NAME_NO_CAP;-&YOCTO_DOC_VERSION;" |
732 | in the above example. | 817 | in the above example. |
733 | </para></listitem> | 818 | </para></listitem> |
734 | <listitem><para><emphasis>Configure the Build:</emphasis> | 819 | <listitem><para> |
820 | <emphasis>Configure the Build:</emphasis> | ||
735 | To configure the build, you edit the | 821 | To configure the build, you edit the |
736 | <filename>bblayers.conf</filename> and | 822 | <filename>bblayers.conf</filename> and |
737 | <filename>local.conf</filename> files, both of which are | 823 | <filename>local.conf</filename> files, both of which are |
@@ -836,7 +922,8 @@ | |||
836 | tmp/deploy/images/intel-corei7-64/core-image-base-intel-corei7-64.wic | 922 | tmp/deploy/images/intel-corei7-64/core-image-base-intel-corei7-64.wic |
837 | </literallayout> | 923 | </literallayout> |
838 | </para></listitem> | 924 | </para></listitem> |
839 | <listitem><para><emphasis>Write the Image:</emphasis> | 925 | <listitem><para> |
926 | <emphasis>Write the Image:</emphasis> | ||
840 | You can write the image just built to a bootable media | 927 | You can write the image just built to a bootable media |
841 | (e.g. a USB key, SATA drive, SD card, etc.) using the | 928 | (e.g. a USB key, SATA drive, SD card, etc.) using the |
842 | <filename>dd</filename> utility: | 929 | <filename>dd</filename> utility: |
@@ -850,7 +937,8 @@ | |||
850 | <filename>/dev/mmcblk0</filename>, which is most likely an | 937 | <filename>/dev/mmcblk0</filename>, which is most likely an |
851 | SD card). | 938 | SD card). |
852 | </para></listitem> | 939 | </para></listitem> |
853 | <listitem><para><emphasis>Boot the Hardware:</emphasis> | 940 | <listitem><para> |
941 | <emphasis>Boot the Hardware:</emphasis> | ||
854 | With the boot device provisioned, you can insert the | 942 | With the boot device provisioned, you can insert the |
855 | media into the MinnowBoard Turbot and boot the hardware. | 943 | media into the MinnowBoard Turbot and boot the hardware. |
856 | The board should automatically detect the media and boot to | 944 | The board should automatically detect the media and boot to |
@@ -914,7 +1002,7 @@ | |||
914 | <ulink url='&YOCTO_DOCS_SDK_URL;#sdk-extensible'>extensible SDK</ulink>, | 1002 | <ulink url='&YOCTO_DOCS_SDK_URL;#sdk-extensible'>extensible SDK</ulink>, |
915 | which are used primarily for application development. | 1003 | which are used primarily for application development. |
916 | This manual also provides example workflows | 1004 | This manual also provides example workflows |
917 | that use the popular <trademark class='trad'>Eclipse</trademark> | 1005 | that use the popular <trademark class='trade'>Eclipse</trademark> |
918 | development environment and that use <filename>devtool</filename>. | 1006 | development environment and that use <filename>devtool</filename>. |
919 | See the | 1007 | See the |
920 | "<ulink url='&YOCTO_DOCS_SDK_URL;#workflow-using-eclipse'>Workflow using Eclipse™</ulink>" | 1008 | "<ulink url='&YOCTO_DOCS_SDK_URL;#workflow-using-eclipse'>Workflow using Eclipse™</ulink>" |