2011-07-15 14:29:18 +00:00
|
|
|
|
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
|
|
|
|
|
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
|
|
|
|
|
|
|
|
|
|
<chapter id='dev-manual-start'>
|
|
|
|
|
|
|
|
|
|
<title>Getting Started with the Yocto Project</title>
|
|
|
|
|
|
2011-07-15 16:23:55 +00:00
|
|
|
|
<para>
|
|
|
|
|
This chapter introduces the Yocto Project and gives you an idea of what you need to get started.
|
|
|
|
|
You can find enough information to set your development host up and build or use images for
|
|
|
|
|
hardware supported by the Yocto Project by reading the
|
|
|
|
|
<ulink url='http://www.yoctoproject.org/docs/yocto-quick-start/yocto-project-qs.html'>
|
|
|
|
|
Yocto Project Quick Start</ulink> located on the <ulink url='http://www.yoctoproject.org'>
|
|
|
|
|
Yocto Project website</ulink>.
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>
|
|
|
|
|
The remainder of this chapter summarizes what is in the Yocto Project Quick Start and provides
|
|
|
|
|
some higher level concepts you might want to consider.
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<section id='introducing-the-yocto-project'>
|
|
|
|
|
<title>Introducing the Yocto Project</title>
|
|
|
|
|
|
2011-07-15 14:29:18 +00:00
|
|
|
|
<para>
|
2011-07-15 16:23:55 +00:00
|
|
|
|
The Yocto Project is an open-source collaboration project focused on embedded Linux developers.
|
|
|
|
|
The project provides a recent Linux kernel along with a set of system commands, libraries,
|
|
|
|
|
and system components suitable for the embedded developer.
|
|
|
|
|
The Yocto Project also features the Sato reference User Interface should you be dealing with
|
|
|
|
|
devices with restricted screens.
|
2011-07-15 14:29:18 +00:00
|
|
|
|
</para>
|
2011-07-15 16:23:55 +00:00
|
|
|
|
|
2011-07-15 14:29:18 +00:00
|
|
|
|
<para>
|
2011-07-15 16:23:55 +00:00
|
|
|
|
You can use the Yocto Project, which uses the BitBake build tool, to develop complete Linux
|
|
|
|
|
images and user-space applications for architectures based on ARM, MIPS, PowerPC, x86 and x86-64.
|
|
|
|
|
You can perform target-level testing and debugging as well as test in a hardware emulated environment.
|
|
|
|
|
And, if you are an Eclipse user, you can install an Eclipse Yocto Plug-in to allow you to
|
|
|
|
|
develop within that familiar environment.
|
2011-07-15 14:29:18 +00:00
|
|
|
|
</para>
|
2011-07-15 16:23:55 +00:00
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section id='getting-setup'>
|
|
|
|
|
<title>Getting Setup</title>
|
|
|
|
|
|
2011-07-15 14:29:18 +00:00
|
|
|
|
<para>
|
2011-07-15 16:23:55 +00:00
|
|
|
|
Here is what you need to get set up to use the Yocto Project:
|
2011-07-15 14:29:18 +00:00
|
|
|
|
<itemizedlist>
|
2011-07-15 16:23:55 +00:00
|
|
|
|
<listitem><para><emphasis>Host System:</emphasis> You need a recent release of Fedora,
|
|
|
|
|
OpenSUSE, Debian, or Ubuntu.
|
|
|
|
|
You should have a reasonably current Linux-based host system.
|
|
|
|
|
You should also have about 100 gigabytes of free disk space if you plan on building
|
|
|
|
|
images.</para></listitem>
|
|
|
|
|
<listitem><para><emphasis>Packages:</emphasis> Depending on your host system (Debian-based or RPM-based),
|
|
|
|
|
you need certain packages.
|
|
|
|
|
See the <ulink url='http://www.yoctoproject.org/docs/yocto-quick-start/yocto-project-qs.html#packages'>
|
2011-07-18 16:09:54 +00:00
|
|
|
|
The Packages</ulink> section in the Yocto Project Quick start for the exact package
|
2011-07-15 16:23:55 +00:00
|
|
|
|
requirements.</para></listitem>
|
|
|
|
|
<listitem><para><emphasis>Yocto Project Release:</emphasis> You need a release of the Yocto Project.
|
|
|
|
|
You can get set up for this one of two ways depending on whether you are going to be contributing
|
|
|
|
|
back into the Yocto Project source repository or not.
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><para><emphasis>Tarball Extraction:</emphasis> If you are not going to contribute
|
|
|
|
|
back into the Yocto Project you can simply download the Yocto Project release you want
|
|
|
|
|
from the website’s <ulink url='http://yoctoproject.org/download'>download page</ulink>.
|
|
|
|
|
Once you have the tarball, just extract it into a directory of your choice.
|
|
|
|
|
If you are interested in supported Board Support Packages (BSPs) you can also download
|
|
|
|
|
these release tarballs from the same site and locate them in a directory of your
|
|
|
|
|
choice.</para></listitem>
|
|
|
|
|
<listitem><para><emphasis>Git Method:</emphasis> If you are going to be contributing
|
|
|
|
|
back into the Yocto Project you should probably use Git commands to set up a local
|
|
|
|
|
Git repository of the Yocto Project.
|
|
|
|
|
Doing so creates a history of changes you might make and allows you to easily submit
|
|
|
|
|
changes upstream to the project.
|
|
|
|
|
For an example of how to set up your own local Git repository of Yocto Project,
|
|
|
|
|
see this
|
|
|
|
|
<ulink url='https://wiki.yoctoproject.org/wiki/Transcript:_from_git_checkout_to_meta-intel_BSP'>
|
|
|
|
|
wiki page</ulink>, which covers checking out the Yocto sources.</para></listitem>
|
|
|
|
|
</itemizedlist></para></listitem>
|
|
|
|
|
<listitem><para><emphasis>Supported Board Support Packages (BSPs):</emphasis> The same considerations
|
|
|
|
|
exist for BSPs.
|
|
|
|
|
You can get set up for BSP development one of two ways:
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><para><emphasis>Tarball Extraction:</emphasis> You can download any released
|
|
|
|
|
BSP tarball from the same
|
|
|
|
|
<ulink url='http://yoctoproject.org/download'>download site</ulink>.
|
|
|
|
|
Once you have the tarball just extract it into a directory of your choice.</para></listitem>
|
|
|
|
|
<listitem><para><emphasis>Git Method:</emphasis> For an example of how to integrate
|
|
|
|
|
the metadata for BSPs into your local Yocto Project Git repository see this
|
|
|
|
|
<ulink url='https://wiki.yoctoproject.org/wiki/Transcript:_from_git_checkout_to_meta-intel_BSP'>
|
|
|
|
|
wiki page</ulink>, which covers how to check out the meta-intel repository.</para></listitem>
|
|
|
|
|
</itemizedlist></para></listitem>
|
|
|
|
|
<listitem><para><emphasis>Eclipse Yocto Plug-in:</emphasis> If you are developing using the
|
|
|
|
|
Eclipse Integrated Development Environment (IDE) you will need this plug-in.
|
|
|
|
|
See the
|
|
|
|
|
<ulink url='http://www.yoctoproject.org/docs/adt-manual/adt-manual.html#setting-up-the-eclipse-ide'>
|
2011-07-18 16:09:54 +00:00
|
|
|
|
Setting up the Eclipse IDE</ulink> section in the Yocto Application Development Toolkit (ADT)
|
2011-07-15 16:23:55 +00:00
|
|
|
|
User’s Guide for more information.</para></listitem>
|
2011-07-15 14:29:18 +00:00
|
|
|
|
</itemizedlist>
|
|
|
|
|
</para>
|
|
|
|
|
</section>
|
|
|
|
|
|
2011-07-15 16:23:55 +00:00
|
|
|
|
<section id='building-images'>
|
|
|
|
|
<title>Building Images</title>
|
2011-07-15 14:29:18 +00:00
|
|
|
|
|
2011-07-15 16:23:55 +00:00
|
|
|
|
<para>
|
|
|
|
|
The build process creates an entire Linux distribution, including the toolchain, from source.
|
|
|
|
|
For more information on this topic, see the
|
|
|
|
|
<ulink url='http://www.yoctoproject.org/docs/yocto-quick-start/yocto-project-qs.html#building-image'>
|
2011-07-18 16:09:54 +00:00
|
|
|
|
Building an Image</ulink> section in the Yocto Project Quick Start.
|
2011-07-15 16:23:55 +00:00
|
|
|
|
</para>
|
2011-07-15 14:29:18 +00:00
|
|
|
|
|
2011-07-15 16:23:55 +00:00
|
|
|
|
<para>
|
|
|
|
|
The build process is as follows:
|
|
|
|
|
<orderedlist>
|
|
|
|
|
<listitem><para>Make sure you have the Yocto Project files as described in the
|
|
|
|
|
previous section.</para></listitem>
|
|
|
|
|
<listitem><para>Initialize the build environment by sourcing a build environment
|
|
|
|
|
script.</para></listitem>
|
|
|
|
|
<listitem><para>Make sure the <filename>conf/local.conf</filename> configuration file is set
|
|
|
|
|
up how you want it.
|
|
|
|
|
This file defines the target machine architecture and and other build configurations.</para></listitem>
|
|
|
|
|
<listitem><para>Build the image using the BitBake command.
|
|
|
|
|
If you want information on Bitbake, see the user manual at
|
|
|
|
|
<ulink url='http://docs.openembedded.org/bitbake/html'></ulink>.</para></listitem>
|
|
|
|
|
<listitem><para>Optionally, you can run the image in the QEMU emulator.</para></listitem>
|
|
|
|
|
</orderedlist>
|
|
|
|
|
</para>
|
|
|
|
|
</section>
|
2011-07-15 14:29:18 +00:00
|
|
|
|
|
2011-07-15 16:23:55 +00:00
|
|
|
|
<section id='using-pre-built-binaries-and-qemu'>
|
|
|
|
|
<title>Using Pre-Built Binaries and QEMU</title>
|
2011-07-15 14:29:18 +00:00
|
|
|
|
|
2011-07-15 16:23:55 +00:00
|
|
|
|
<para>
|
|
|
|
|
Another option you have to get started is to use a pre-built binary.
|
|
|
|
|
This scenario is ideal for developing software applications to run on your target hardware.
|
|
|
|
|
To do this you need to install the stand-alone Yocto toolchain tarball and then download the
|
|
|
|
|
pre-built kernel that you will boot using the QEMU emulator.
|
|
|
|
|
Next, you must download the filesystem for your target machine’s architecture.
|
|
|
|
|
Finally, you set up the environment to emulate the hardware then start the emulator.
|
|
|
|
|
</para>
|
2011-07-15 14:29:18 +00:00
|
|
|
|
|
2011-07-15 16:23:55 +00:00
|
|
|
|
<para>
|
|
|
|
|
You can find details on all these steps in the
|
|
|
|
|
<ulink url='http://www.yoctoproject.org/docs/yocto-quick-start/yocto-project-qs.html#using-pre-built'>
|
2011-07-18 16:09:54 +00:00
|
|
|
|
Using Pre-Built Binaries and QEMU</ulink> section in the Yocto Project Quick Start.
|
2011-07-15 16:23:55 +00:00
|
|
|
|
</para>
|
|
|
|
|
</section>
|
2011-07-15 14:29:18 +00:00
|
|
|
|
</chapter>
|
|
|
|
|
<!--
|
|
|
|
|
vim: expandtab tw=80 ts=4
|
|
|
|
|
-->
|