2011-03-14 20:19:44 +00:00
|
|
|
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
|
2012-03-06 23:06:44 +00:00
|
|
|
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
|
|
|
|
[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
|
2011-03-14 20:19:44 +00:00
|
|
|
|
2011-03-14 21:27:51 +00:00
|
|
|
<chapter id='adt-prepare'>
|
2011-03-14 20:19:44 +00:00
|
|
|
|
2012-07-17 21:03:51 +00:00
|
|
|
<title>Preparing for Application Development</title>
|
2011-03-14 20:19:44 +00:00
|
|
|
|
2011-03-14 23:47:21 +00:00
|
|
|
<para>
|
2012-07-17 21:03:51 +00:00
|
|
|
In order to develop applications, you need set up your host development system.
|
|
|
|
Several ways exist that allow you to install cross-development tools, QEMU, the
|
|
|
|
Eclipse Yocto Plug-in, and other tools.
|
|
|
|
This chapter describes how to prepare for application development.
|
2011-06-23 14:24:43 +00:00
|
|
|
</para>
|
|
|
|
|
2011-03-14 23:47:21 +00:00
|
|
|
<section id='installing-the-adt'>
|
2012-07-17 21:03:51 +00:00
|
|
|
<title>Installing the ADT and Toolchains</title>
|
2011-06-23 14:24:43 +00:00
|
|
|
|
2011-03-14 20:19:44 +00:00
|
|
|
<para>
|
2012-07-17 21:03:51 +00:00
|
|
|
The following list describes installation methods that set up varying degrees of tool
|
|
|
|
availabiltiy on your system.
|
|
|
|
Regardless of the installation method you choose,
|
|
|
|
you must <filename>source</filename> the cross-toolchain
|
|
|
|
environment setup script before you use a toolchain.
|
2011-09-15 19:51:05 +00:00
|
|
|
See the "<link linkend='setting-up-the-cross-development-environment'>Setting Up the
|
2012-07-17 21:03:51 +00:00
|
|
|
Cross-Development Environment</link>" section for more information.
|
2012-06-26 20:29:31 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<note>
|
2012-07-17 21:03:51 +00:00
|
|
|
<para>Avoid mixing installation methods when installing toolchains for different architectures.
|
2012-06-26 20:29:31 +00:00
|
|
|
For example, avoid using the ADT Installer to install some toolchains and then hand-installing
|
|
|
|
cross-development toolchains from downloaded tarballs to install toolchains
|
|
|
|
for different architectures.
|
|
|
|
Mixing installation methods can result in situations where the ADT Installer becomes
|
|
|
|
unreliable and might not install the toolchain.</para>
|
|
|
|
<para>If you must mix installation methods, you might avoid problems by deleting
|
|
|
|
<filename>/var/lib/opkg</filename>, thus purging the <filename>opkg</filename> package
|
|
|
|
metadata</para>
|
|
|
|
</note>
|
|
|
|
|
|
|
|
<para>
|
2011-06-23 14:24:43 +00:00
|
|
|
<itemizedlist>
|
|
|
|
<listitem><para><emphasis>Use the ADT Installer Script:</emphasis>
|
2011-09-01 16:18:33 +00:00
|
|
|
This method is the recommended way to install the ADT because it
|
|
|
|
automates much of the process for you.
|
|
|
|
For example, you can configure the installation to install the QEMU emulator
|
|
|
|
and the user-space NFS, specify which root filesystem profiles to download,
|
|
|
|
and define the target sysroot location.</para></listitem>
|
2011-06-23 14:24:43 +00:00
|
|
|
<listitem><para><emphasis>Use an Existing Toolchain Tarball:</emphasis>
|
2011-09-01 16:18:33 +00:00
|
|
|
Using this method, you select and download an architecture-specific
|
|
|
|
toolchain tarball and then hand-install the toolchain.
|
|
|
|
If you use this method, you just get the cross-toolchain and QEMU - you do not
|
|
|
|
get any of the other mentioned benefits had you run the ADT Installer script.</para></listitem>
|
2012-07-17 21:03:51 +00:00
|
|
|
<listitem><para><emphasis>Use the Toolchain from within the Build Directory:</emphasis>
|
|
|
|
If you already have a
|
|
|
|
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>,
|
|
|
|
you can build the cross-toolchain within the directory.
|
2011-09-01 16:18:33 +00:00
|
|
|
However, like the previous method mentioned, you only get the cross-toolchain and QEMU - you
|
|
|
|
do not get any of the other benefits without taking separate steps.</para></listitem>
|
2011-06-23 14:24:43 +00:00
|
|
|
</itemizedlist>
|
2011-03-14 20:19:44 +00:00
|
|
|
</para>
|
2011-03-14 23:47:21 +00:00
|
|
|
|
2011-06-23 14:24:43 +00:00
|
|
|
<section id='using-the-adt-installer'>
|
|
|
|
<title>Using the ADT Installer</title>
|
|
|
|
|
2011-03-14 23:47:21 +00:00
|
|
|
<para>
|
2011-08-15 14:38:02 +00:00
|
|
|
To run the ADT Installer, you need to first get the ADT Installer tarball and then run the ADT
|
2011-06-23 14:24:43 +00:00
|
|
|
Installer Script.
|
2011-03-14 20:19:44 +00:00
|
|
|
</para>
|
|
|
|
|
2011-06-23 14:24:43 +00:00
|
|
|
<section id='getting-the-adt-installer-tarball'>
|
|
|
|
<title>Getting the ADT Installer Tarball</title>
|
2011-03-14 23:47:21 +00:00
|
|
|
|
2011-06-23 14:24:43 +00:00
|
|
|
<para>
|
|
|
|
The ADT Installer is contained in the ADT Installer tarball.
|
2012-01-13 14:12:39 +00:00
|
|
|
You can download the tarball into any directory from the
|
2012-03-06 23:06:44 +00:00
|
|
|
<ulink url='&YOCTO_DL_URL;/releases'>Index of Releases</ulink>, specifically
|
2012-01-13 14:12:39 +00:00
|
|
|
at
|
2012-03-06 23:06:44 +00:00
|
|
|
<ulink url='&YOCTO_ADTINSTALLER_DL_URL;'></ulink>.
|
2012-07-17 21:03:51 +00:00
|
|
|
Or, you can use BitBake to generate the tarball inside the existing
|
|
|
|
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>.
|
2011-06-23 14:24:43 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2011-07-14 14:00:42 +00:00
|
|
|
If you use BitBake to generate the ADT Installer tarball, you must
|
2012-06-28 22:02:25 +00:00
|
|
|
<filename>source</filename> the environment setup script
|
2011-09-15 19:12:06 +00:00
|
|
|
(<filename>oe-init-build-env</filename>) located
|
2012-06-28 22:02:25 +00:00
|
|
|
in the source directory before running the <filename>bitbake</filename>
|
2011-09-01 16:18:33 +00:00
|
|
|
command that creates the tarball.
|
2011-06-23 14:24:43 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2012-07-17 21:03:51 +00:00
|
|
|
The following example commands download the Poky tarball, set up the
|
|
|
|
<ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>source directory</ulink>,
|
|
|
|
set up the environment while also creating the default build directory,
|
2011-09-01 16:18:33 +00:00
|
|
|
and run the <filename>bitbake</filename> command that results in the tarball
|
2011-06-23 14:24:43 +00:00
|
|
|
<filename>~/yocto-project/build/tmp/deploy/sdk/adt_installer.tar.bz2</filename>:
|
|
|
|
<literallayout class='monospaced'>
|
|
|
|
$ cd ~
|
|
|
|
$ mkdir yocto-project
|
|
|
|
$ cd yocto-project
|
2012-03-06 23:06:44 +00:00
|
|
|
$ wget &YOCTO_RELEASE_DL_URL;/&YOCTO_POKY_TARBALL;
|
|
|
|
$ tar xjf &YOCTO_POKY_TARBALL;
|
|
|
|
$ source &OE_INIT_PATH;
|
2011-06-23 14:24:43 +00:00
|
|
|
$ bitbake adt-installer
|
|
|
|
</literallayout>
|
|
|
|
</para>
|
|
|
|
</section>
|
|
|
|
|
|
|
|
<section id='configuring-and-running-the-adt-installer-script'>
|
|
|
|
<title>Configuring and Running the ADT Installer Script</title>
|
|
|
|
|
|
|
|
<para>
|
2011-08-15 14:38:02 +00:00
|
|
|
Before running the ADT Installer script, you need to unpack the tarball.
|
2011-06-23 14:24:43 +00:00
|
|
|
You can unpack the tarball in any directory you wish.
|
2012-01-13 15:02:31 +00:00
|
|
|
For example, this command copies the ADT Installer tarball from where
|
|
|
|
it was built into the home directory and then unpacks the tarball into
|
|
|
|
a top-level directory named <filename>adt-installer</filename>:
|
|
|
|
<literallayout class='monospaced'>
|
|
|
|
$ cd ~
|
|
|
|
$ cp ~/poky/build/tmp/deploy/sdk/adt_installer.tar.bz2 $HOME
|
|
|
|
$ tar -xjf adt_installer.tar.bz2
|
|
|
|
</literallayout>
|
2011-06-23 14:24:43 +00:00
|
|
|
Unpacking it creates the directory <filename>adt-installer</filename>,
|
2011-09-02 18:51:55 +00:00
|
|
|
which contains the ADT Installer script (<filename>adt_installer</filename>)
|
|
|
|
and its configuration file (<filename>adt_installer.conf</filename>).
|
2011-06-23 14:24:43 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Before you run the script, however, you should examine the ADT Installer configuration
|
2011-09-02 18:51:55 +00:00
|
|
|
file and be sure you are going to get what you want.
|
2011-06-23 14:24:43 +00:00
|
|
|
Your configurations determine which kernel and filesystem image are downloaded.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
The following list describes the configurations you can define for the ADT Installer.
|
2011-09-01 16:18:33 +00:00
|
|
|
For configuration values and restrictions, see the comments in
|
2011-06-23 14:24:43 +00:00
|
|
|
the <filename>adt-installer.conf</filename> file:
|
|
|
|
|
|
|
|
<itemizedlist>
|
2011-09-02 18:51:55 +00:00
|
|
|
<listitem><para><filename>YOCTOADT_REPO</filename>: This area
|
2011-09-01 16:18:33 +00:00
|
|
|
includes the IPKG-based packages and the root filesystem upon which
|
|
|
|
the installation is based.
|
|
|
|
If you want to set up your own IPKG repository pointed to by
|
2011-09-02 18:51:55 +00:00
|
|
|
<filename>YOCTOADT_REPO</filename>, you need to be sure that the
|
2011-09-01 16:18:33 +00:00
|
|
|
directory structure follows the same layout as the reference directory
|
|
|
|
set up at <ulink url='http://adtrepo.yoctoproject.org'></ulink>.
|
|
|
|
Also, your repository needs to be accessible through HTTP.</para></listitem>
|
2011-09-02 18:51:55 +00:00
|
|
|
<listitem><para><filename>YOCTOADT_TARGETS</filename>: The machine
|
2011-09-01 16:18:33 +00:00
|
|
|
target architectures for which you want to set up cross-development
|
|
|
|
environments.</para></listitem>
|
|
|
|
<listitem><para><filename>YOCTOADT_QEMU</filename>: Indicates whether
|
|
|
|
or not to install the emulator QEMU.</para></listitem>
|
|
|
|
<listitem><para><filename>YOCTOADT_NFS_UTIL</filename>: Indicates whether
|
|
|
|
or not to install user-mode NFS.
|
2012-06-28 22:02:25 +00:00
|
|
|
If you plan to use the Eclipse IDE Yocto plug-in against QEMU,
|
2011-09-01 16:18:33 +00:00
|
|
|
you should install NFS.
|
|
|
|
<note>To boot QEMU images using our userspace NFS server, you need
|
|
|
|
to be running <filename>portmap</filename> or <filename>rpcbind</filename>.
|
|
|
|
If you are running <filename>rpcbind</filename>, you will also need to add the
|
|
|
|
<filename>-i</filename> option when <filename>rpcbind</filename> starts up.
|
|
|
|
Please make sure you understand the security implications of doing this.
|
|
|
|
You might also have to modify your firewall settings to allow
|
|
|
|
NFS booting to work.</note></para></listitem>
|
|
|
|
<listitem><para><filename>YOCTOADT_ROOTFS_<arch></filename>: The root
|
|
|
|
filesystem images you want to download from the
|
|
|
|
<filename>YOCTOADT_IPKG_REPO</filename> repository.</para></listitem>
|
|
|
|
<listitem><para><filename>YOCTOADT_TARGET_SYSROOT_IMAGE_<arch></filename>: The
|
|
|
|
particular root filesystem used to extract and create the target sysroot.
|
|
|
|
The value of this variable must have been specified with
|
|
|
|
<filename>YOCTOADT_ROOTFS_<arch></filename>.
|
|
|
|
For example, if you downloaded both <filename>minimal</filename> and
|
|
|
|
<filename>sato-sdk</filename> images by setting
|
|
|
|
<filename>YOCTOADT_ROOTFS_<arch></filename>
|
|
|
|
to "minimal sato-sdk", then <filename>YOCTOADT_ROOTFS_<arch></filename>
|
|
|
|
must be set to either <filename>minimal</filename> or
|
|
|
|
<filename>sato-sdk</filename>.</para></listitem>
|
|
|
|
<listitem><para><filename>YOCTOADT_TARGET_SYSROOT_LOC_<arch></filename>: The
|
|
|
|
location on the development host where the target sysroot is created.
|
|
|
|
</para></listitem>
|
2011-06-23 14:24:43 +00:00
|
|
|
</itemizedlist>
|
|
|
|
</para>
|
2011-03-14 23:47:21 +00:00
|
|
|
|
2011-06-23 14:24:43 +00:00
|
|
|
<para>
|
|
|
|
After you have configured the <filename>adt_installer.conf</filename> file,
|
2012-06-20 20:23:06 +00:00
|
|
|
run the installer using the following command.
|
|
|
|
Be sure that you are not trying to use cross-compilation tools.
|
|
|
|
When you run the installer, the environment must use a
|
|
|
|
host <filename>gcc</filename>:
|
2011-06-23 14:24:43 +00:00
|
|
|
<literallayout class='monospaced'>
|
2012-09-07 17:56:54 +00:00
|
|
|
$ cd ~/adt-installer
|
2012-03-23 18:23:09 +00:00
|
|
|
$ ./adt_installer
|
2011-06-23 14:24:43 +00:00
|
|
|
</literallayout>
|
|
|
|
</para>
|
2011-03-14 23:47:21 +00:00
|
|
|
|
2011-06-23 14:24:43 +00:00
|
|
|
<note>
|
|
|
|
The ADT Installer requires the <filename>libtool</filename> package to complete.
|
2012-03-06 23:06:44 +00:00
|
|
|
If you install the recommended packages as described in
|
|
|
|
"<ulink url='&YOCTO_DOCS_QS_URL;#packages'>The Packages</ulink>"
|
2012-08-21 23:37:15 +00:00
|
|
|
section of the Yocto Project Quick Start, then you will have libtool installed.
|
2011-06-23 14:24:43 +00:00
|
|
|
</note>
|
2011-03-14 20:19:44 +00:00
|
|
|
|
2011-06-23 14:24:43 +00:00
|
|
|
<para>
|
2012-09-07 18:19:13 +00:00
|
|
|
Once the installer begins to run, you are asked to confirm the location for
|
|
|
|
cross-toolchain installation, which is <filename>/opt/poky/<release></filename>.
|
|
|
|
After confirming the location, you are prompted to run in
|
2011-06-23 14:24:43 +00:00
|
|
|
interactive or silent mode.
|
2011-09-01 16:18:33 +00:00
|
|
|
If you want to closely monitor the installation, choose “I” for interactive
|
2011-06-23 14:24:43 +00:00
|
|
|
mode rather than “S” for silent mode.
|
|
|
|
Follow the prompts from the script to complete the installation.
|
|
|
|
</para>
|
2011-03-14 20:19:44 +00:00
|
|
|
|
2011-06-23 14:24:43 +00:00
|
|
|
<para>
|
|
|
|
Once the installation completes, the ADT, which includes the cross-toolchain, is installed.
|
|
|
|
You will notice environment setup files for the cross-toolchain in
|
2012-03-06 23:06:44 +00:00
|
|
|
<filename>&YOCTO_ADTPATH_DIR;</filename>,
|
2011-06-23 14:24:43 +00:00
|
|
|
and image tarballs in the <filename>adt-installer</filename>
|
|
|
|
directory according to your installer configurations, and the target sysroot located
|
|
|
|
according to the <filename>YOCTOADT_TARGET_SYSROOT_LOC_<arch></filename> variable
|
|
|
|
also in your configuration file.
|
|
|
|
</para>
|
2011-09-01 16:18:33 +00:00
|
|
|
</section>
|
2011-03-14 23:47:21 +00:00
|
|
|
</section>
|
2011-03-14 20:19:44 +00:00
|
|
|
|
2011-03-14 23:47:21 +00:00
|
|
|
<section id='using-an-existing-toolchain-tarball'>
|
2011-06-23 14:24:43 +00:00
|
|
|
<title>Using a Cross-Toolchain Tarball</title>
|
2011-09-01 16:18:33 +00:00
|
|
|
|
2011-06-23 14:24:43 +00:00
|
|
|
<para>
|
2011-08-15 14:38:02 +00:00
|
|
|
If you want to simply install the cross-toolchain by hand, you can do so by using an existing
|
2011-06-23 14:24:43 +00:00
|
|
|
cross-toolchain tarball.
|
2011-09-15 17:17:08 +00:00
|
|
|
If you use this method to install the cross-toolchain and you still need to install the target
|
2012-09-07 21:03:23 +00:00
|
|
|
sysroot, you will have to extract and install sysroot separately.
|
|
|
|
For information on how to do this, see the
|
|
|
|
"<link linkend='extracting-the-root-filesystem'>Extracting the Root Filesystem</link>" section.
|
2011-06-23 14:24:43 +00:00
|
|
|
</para>
|
|
|
|
|
2011-03-14 23:47:21 +00:00
|
|
|
<para>
|
|
|
|
Follow these steps:
|
|
|
|
<orderedlist>
|
2011-06-23 14:24:43 +00:00
|
|
|
<listitem><para>Go to
|
2012-03-06 23:06:44 +00:00
|
|
|
<ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink>
|
2011-09-01 16:18:33 +00:00
|
|
|
and find the folder that matches your host development system
|
2011-11-15 21:23:12 +00:00
|
|
|
(i.e. <filename>i686</filename> for 32-bit machines or
|
2012-03-06 23:06:44 +00:00
|
|
|
<filename>x86-64</filename> for 64-bit machines).</para></listitem>
|
2011-06-23 14:24:43 +00:00
|
|
|
<listitem><para>Go into that folder and download the toolchain tarball whose name
|
2011-09-01 16:18:33 +00:00
|
|
|
includes the appropriate target architecture.
|
|
|
|
For example, if your host development system is an Intel-based 64-bit system and
|
2011-09-15 19:12:06 +00:00
|
|
|
you are going to use your cross-toolchain for an Intel-based 32-bit target, go into the
|
2011-09-01 16:18:33 +00:00
|
|
|
<filename>x86_64</filename> folder and download the following tarball:
|
|
|
|
<literallayout class='monospaced'>
|
2012-03-06 23:06:44 +00:00
|
|
|
poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.tar.bz2
|
2011-10-03 19:07:21 +00:00
|
|
|
</literallayout>
|
2011-09-15 17:17:08 +00:00
|
|
|
<note><para>As an alternative to steps one and two, you can build the toolchain tarball
|
2012-07-17 21:03:51 +00:00
|
|
|
if you have a <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>.
|
2011-09-15 17:17:08 +00:00
|
|
|
If you need GMAE, you should use the <filename>bitbake meta-toolchain-gmae</filename>
|
|
|
|
command.
|
|
|
|
The resulting tarball will support such development.
|
2011-09-15 19:12:06 +00:00
|
|
|
However, if you are not concerned with GMAE,
|
2011-09-15 17:17:08 +00:00
|
|
|
you can generate the tarball using <filename>bitbake meta-toolchain</filename>.</para>
|
|
|
|
<para>Use the appropriate <filename>bitbake</filename> command only after you have
|
2012-06-28 22:02:25 +00:00
|
|
|
sourced the <filename>oe-build-init-env</filename> script located in the source
|
|
|
|
directory.
|
2011-09-15 19:12:06 +00:00
|
|
|
When the <filename>bitbake</filename> command completes, the tarball will
|
2012-06-28 22:02:25 +00:00
|
|
|
be in <filename>tmp/deploy/sdk</filename> in the build directory.
|
2011-09-15 17:17:08 +00:00
|
|
|
</para></note></para></listitem>
|
2011-09-02 18:51:55 +00:00
|
|
|
<listitem><para>Make sure you are in the root directory with root privileges and then expand
|
2011-09-01 16:18:33 +00:00
|
|
|
the tarball.
|
2012-03-06 23:06:44 +00:00
|
|
|
The tarball expands into <filename>&YOCTO_ADTPATH_DIR;</filename>.
|
2011-09-15 19:12:06 +00:00
|
|
|
Once the tarball is expanded, the cross-toolchain is installed.
|
2011-09-01 16:18:33 +00:00
|
|
|
You will notice environment setup files for the cross-toolchain in the directory.
|
|
|
|
</para></listitem>
|
2011-03-14 23:47:21 +00:00
|
|
|
</orderedlist>
|
|
|
|
</para>
|
|
|
|
</section>
|
2011-03-14 20:19:44 +00:00
|
|
|
|
2011-03-14 23:47:21 +00:00
|
|
|
<section id='using-the-toolchain-from-within-the-build-tree'>
|
2012-06-28 22:02:25 +00:00
|
|
|
<title>Using BitBake and the Build Directory</title>
|
2011-09-01 16:18:33 +00:00
|
|
|
|
2011-03-14 23:47:21 +00:00
|
|
|
<para>
|
2012-06-22 16:36:48 +00:00
|
|
|
A final way of making the cross-toolchain available is to use BitBake
|
2012-07-17 21:03:51 +00:00
|
|
|
to generate the toolchain within an existing
|
|
|
|
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>.
|
2012-06-22 16:36:48 +00:00
|
|
|
This method does not install the toolchain into the
|
|
|
|
<filename>/opt</filename> directory.
|
2011-09-15 17:17:08 +00:00
|
|
|
As with the previous method, if you need to install the target sysroot, you must
|
2012-07-17 21:03:51 +00:00
|
|
|
do that separately as well.
|
2011-09-15 17:17:08 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2012-07-17 21:03:51 +00:00
|
|
|
Follow these steps to generate the toolchain into the build directory:
|
2011-06-23 14:24:43 +00:00
|
|
|
<orderedlist>
|
2011-09-15 19:12:06 +00:00
|
|
|
<listitem><para>Source the environment setup script
|
2012-07-17 21:03:51 +00:00
|
|
|
<filename>oe-init-build-env</filename> located in the
|
|
|
|
<ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>source directory</ulink>.
|
2012-06-28 22:02:25 +00:00
|
|
|
</para></listitem>
|
2011-09-01 16:18:33 +00:00
|
|
|
<listitem><para>At this point, you should be sure that the
|
2012-07-17 21:03:51 +00:00
|
|
|
<ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink> variable
|
2011-10-03 19:07:21 +00:00
|
|
|
in the <filename>local.conf</filename> file found in the
|
2012-06-28 22:02:25 +00:00
|
|
|
<filename>conf</filename> directory of the build directory
|
2011-09-01 16:18:33 +00:00
|
|
|
is set for the target architecture.
|
|
|
|
Comments within the <filename>local.conf</filename> file list the values you
|
|
|
|
can use for the <filename>MACHINE</filename> variable.
|
2012-07-17 21:03:51 +00:00
|
|
|
<note>You can populate the build directory with the cross-toolchains for more
|
2011-09-01 16:18:33 +00:00
|
|
|
than a single architecture.
|
|
|
|
You just need to edit the <filename>MACHINE</filename> variable in the
|
|
|
|
<filename>local.conf</filename> file and re-run the BitBake
|
|
|
|
command.</note></para></listitem>
|
2011-06-23 14:24:43 +00:00
|
|
|
<listitem><para>Run <filename>bitbake meta-ide-support</filename> to complete the
|
2012-06-22 16:36:48 +00:00
|
|
|
cross-toolchain generation.
|
2012-06-22 14:41:57 +00:00
|
|
|
<note>If you change out of your working directory after you
|
2011-09-01 16:18:33 +00:00
|
|
|
<filename>source</filename> the environment setup script and before you run
|
2011-10-03 19:07:21 +00:00
|
|
|
the <filename>bitbake</filename> command, the command might not work.
|
2011-09-01 16:18:33 +00:00
|
|
|
Be sure to run the <filename>bitbake</filename> command immediately
|
|
|
|
after checking or editing the <filename>local.conf</filename> but without
|
2011-09-15 19:12:06 +00:00
|
|
|
changing out of your working directory.</note>
|
2011-10-03 19:07:21 +00:00
|
|
|
Once the <filename>bitbake</filename> command finishes,
|
2012-06-28 22:02:25 +00:00
|
|
|
the cross-toolchain is generated and populated within the build directory.
|
2011-09-01 16:18:33 +00:00
|
|
|
You will notice environment setup files for the cross-toolchain in the
|
2012-06-28 22:02:25 +00:00
|
|
|
build directory in the <filename>tmp</filename> directory.
|
2012-09-07 21:03:23 +00:00
|
|
|
Setup script filenames contain the strings <filename>environment-setup</filename>.</para>
|
|
|
|
<para>Be aware that when you use this method to install the toolchain you still need
|
|
|
|
to separately extract and install the sysroot filesystem.
|
|
|
|
For information on how to do this, see the
|
|
|
|
"<link linkend='extracting-the-root-filesystem'>Extracting the Root Filesystem</link>" section.
|
2011-09-01 16:18:33 +00:00
|
|
|
</para></listitem>
|
2011-06-23 14:24:43 +00:00
|
|
|
</orderedlist>
|
2011-03-14 23:47:21 +00:00
|
|
|
</para>
|
|
|
|
</section>
|
|
|
|
</section>
|
|
|
|
|
2011-09-15 19:12:06 +00:00
|
|
|
<section id='setting-up-the-cross-development-environment'>
|
|
|
|
<title>Setting Up the Cross-Development Environment</title>
|
2011-09-01 16:18:33 +00:00
|
|
|
|
2011-03-14 23:47:21 +00:00
|
|
|
<para>
|
2011-09-15 19:12:06 +00:00
|
|
|
Before you can develop using the cross-toolchain, you need to set up the
|
2011-10-03 19:07:21 +00:00
|
|
|
cross-development environment by sourcing the toolchain's environment setup script.
|
2012-07-17 21:03:51 +00:00
|
|
|
If you used the ADT Installer or hand-installed cross-toolchain,
|
2012-03-06 23:06:44 +00:00
|
|
|
then you can find this script in the <filename>&YOCTO_ADTPATH_DIR;</filename>
|
2011-03-14 23:47:21 +00:00
|
|
|
directory.
|
2012-07-17 21:03:51 +00:00
|
|
|
If you installed the toolchain in the
|
|
|
|
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>,
|
|
|
|
you can find the environment setup
|
2012-06-28 22:02:25 +00:00
|
|
|
script for the toolchain in the build directory's <filename>tmp</filename> directory.
|
2011-03-14 23:47:21 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Be sure to run the environment setup script that matches the architecture for
|
|
|
|
which you are developing.
|
2011-09-01 16:18:33 +00:00
|
|
|
Environment setup scripts begin with the string “<filename>environment-setup</filename>”
|
|
|
|
and include as part of their name the architecture.
|
2011-10-03 19:07:21 +00:00
|
|
|
For example, the toolchain environment setup script for a 64-bit IA-based architecture would
|
2011-03-14 23:47:21 +00:00
|
|
|
be the following:
|
|
|
|
<literallayout class='monospaced'>
|
2012-03-06 23:06:44 +00:00
|
|
|
&YOCTO_ADTPATH_DIR;/environment-setup-x86_64-poky-linux
|
2011-03-14 23:47:21 +00:00
|
|
|
</literallayout>
|
|
|
|
</para>
|
|
|
|
</section>
|
|
|
|
|
2011-09-15 17:42:21 +00:00
|
|
|
<section id='securing-kernel-and-filesystem-images'>
|
|
|
|
<title>Securing Kernel and Filesystem Images</title>
|
2011-09-01 16:18:33 +00:00
|
|
|
|
2011-03-14 23:47:21 +00:00
|
|
|
<para>
|
|
|
|
You will need to have a kernel and filesystem image to boot using your
|
2011-09-15 17:17:08 +00:00
|
|
|
hardware or the QEMU emulator.
|
|
|
|
Furthermore, if you plan on booting your image using NFS or you want to use the root filesystem
|
|
|
|
as the target sysroot, you need to extract the root filesystem.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<section id='getting-the-images'>
|
|
|
|
<title>Getting the Images</title>
|
|
|
|
|
|
|
|
<para>
|
2011-09-15 19:12:06 +00:00
|
|
|
To get the kernel and filesystem images, you either have to build them or download
|
2011-09-15 17:17:08 +00:00
|
|
|
pre-built versions.
|
|
|
|
You can find examples for both these situations in the
|
2012-03-06 23:06:44 +00:00
|
|
|
"<ulink url='&YOCTO_DOCS_QS_URL;#test-run'>A Quick Test Run</ulink>" section of
|
2012-07-17 21:03:51 +00:00
|
|
|
the Yocto Project Quick Start.
|
2011-09-30 15:34:48 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2012-06-28 22:02:25 +00:00
|
|
|
The Yocto Project ships basic kernel and filesystem images for several
|
2011-08-15 14:38:02 +00:00
|
|
|
architectures (<filename>x86</filename>, <filename>x86-64</filename>,
|
|
|
|
<filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>)
|
|
|
|
that you can use unaltered in the QEMU emulator.
|
2012-06-28 22:02:25 +00:00
|
|
|
These kernel images reside in the release
|
2012-03-06 23:06:44 +00:00
|
|
|
area - <ulink url='&YOCTO_MACHINES_DL_URL;'></ulink>
|
2012-06-28 22:02:25 +00:00
|
|
|
and are ideal for experimentation using Yocto Project.
|
|
|
|
For information on the image types you can build using the OpenEmbedded build system,
|
|
|
|
see the
|
2012-07-16 17:53:16 +00:00
|
|
|
"<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>" chapter in
|
2012-07-17 21:03:51 +00:00
|
|
|
the Yocto Project Reference Manual.
|
2011-09-30 15:34:48 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
If you plan on remotely deploying and debugging your application from within the
|
|
|
|
Eclipse IDE, you must have an image that contains the Yocto Target Communication
|
|
|
|
Framework (TCF) agent (<filename>tcf-agent</filename>).
|
2011-09-30 16:02:18 +00:00
|
|
|
By default, the Yocto Project provides only one type pre-built image that contains the
|
2011-09-30 15:34:48 +00:00
|
|
|
<filename>tcf-agent</filename>.
|
2011-09-30 16:02:18 +00:00
|
|
|
And, those images are SDK (e.g.<filename>core-image-sato-sdk</filename>).
|
2011-09-30 15:34:48 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
If you want to use a different image type that contains the <filename>tcf-agent</filename>,
|
|
|
|
you can do so one of two ways:
|
|
|
|
<itemizedlist>
|
|
|
|
<listitem><para>Modify the <filename>conf/local.conf</filename> configuration in
|
2012-07-17 21:03:51 +00:00
|
|
|
the <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>
|
|
|
|
and then rebuild the image.
|
|
|
|
With this method, you need to modify the
|
|
|
|
<ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_IMAGE_FEATURES'><filename>EXTRA_IMAGE_FEATURES</filename></ulink>
|
2011-09-30 15:34:48 +00:00
|
|
|
variable to have the value of "tools-debug" before rebuilding the image.
|
|
|
|
Once the image is rebuilt, the <filename>tcf-agent</filename> will be included
|
|
|
|
in the image and is launched automatically after the boot.</para></listitem>
|
|
|
|
<listitem><para>Manually build the <filename>tcf-agent</filename>.
|
|
|
|
To build the agent, follow these steps:
|
|
|
|
<orderedlist>
|
|
|
|
<listitem><para>Be sure the ADT is installed as described in the
|
2012-07-17 21:03:51 +00:00
|
|
|
"<link linkend='installing-the-adt'>Installing the ADT and Toolchains</link>" section.
|
2011-09-30 15:34:48 +00:00
|
|
|
</para></listitem>
|
|
|
|
<listitem><para>Set up the cross-development environment as described in the
|
|
|
|
"<link linkend='setting-up-the-cross-development-environment'>Setting
|
|
|
|
Up the Cross-Development Environment</link>" section.</para></listitem>
|
2012-03-23 18:23:09 +00:00
|
|
|
<listitem><para>Get the <filename>tcf-agent</filename> source code using
|
|
|
|
the following commands:
|
2011-09-30 15:34:48 +00:00
|
|
|
<literallayout class='monospaced'>
|
2012-03-23 18:23:09 +00:00
|
|
|
$ git clone http://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.agent.git
|
|
|
|
$ cd agent
|
2011-09-30 15:34:48 +00:00
|
|
|
</literallayout></para></listitem>
|
|
|
|
<listitem><para>Modify the <filename>Makefile.inc</filename> file
|
|
|
|
for the cross-compilation environment by setting the
|
2012-07-17 21:03:51 +00:00
|
|
|
<filename>OPSYS</filename> and
|
|
|
|
<ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>
|
2011-09-30 15:34:48 +00:00
|
|
|
variables according to your target.</para></listitem>
|
|
|
|
<listitem><para>Use the cross-development tools to build the
|
|
|
|
<filename>tcf-agent</filename>.
|
|
|
|
Before you "Make" the file, be sure your cross-tools are set up first.
|
|
|
|
See the "<link linkend='makefile-based-projects'>Makefile-Based Projects</link>"
|
|
|
|
section for information on how to make sure the cross-tools are set up
|
|
|
|
correctly.</para>
|
|
|
|
<para>If the build is successful, the <filename>tcf-agent</filename> output will
|
|
|
|
be <filename>obj/$(OPSYS)/$(MACHINE)/Debug/agent</filename>.</para></listitem>
|
|
|
|
<listitem><para>Deploy the agent into the image's root filesystem.</para></listitem>
|
|
|
|
</orderedlist>
|
|
|
|
</para></listitem>
|
|
|
|
</itemizedlist>
|
2011-09-15 17:17:08 +00:00
|
|
|
</para>
|
|
|
|
</section>
|
2011-09-15 12:52:25 +00:00
|
|
|
|
2011-09-15 17:17:08 +00:00
|
|
|
<section id='extracting-the-root-filesystem'>
|
|
|
|
<title>Extracting the Root Filesystem</title>
|
|
|
|
|
|
|
|
<para>
|
2011-09-15 19:12:06 +00:00
|
|
|
You must extract the root filesystem if you want to boot the image using NFS
|
|
|
|
or you want to use the root filesystem as the target sysroot.
|
2011-09-15 17:17:08 +00:00
|
|
|
For example, the Eclipse IDE environment with the Eclipse Yocto Plug-in installed allows you
|
2011-09-15 19:12:06 +00:00
|
|
|
to use QEMU to boot under NFS.
|
|
|
|
Another example is if you want to develop your target application using the
|
2011-09-15 17:17:08 +00:00
|
|
|
root filesystem as the target sysroot.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2011-09-15 19:12:06 +00:00
|
|
|
To extract the root filesystem, first <filename>source</filename>
|
|
|
|
the cross-development environment setup script and then
|
|
|
|
use the <filename>runqemu-extract-sdk</filename> command on the
|
2011-09-15 17:17:08 +00:00
|
|
|
filesystem image.
|
2011-09-15 19:12:06 +00:00
|
|
|
For example, the following commands set up the environment and then extract
|
|
|
|
the root filesystem from a previously built filesystem image tarball named
|
2011-09-15 17:17:08 +00:00
|
|
|
<filename>core-image-sato-sdk-qemux86-2011091411831.rootfs.tar.bz2</filename>.
|
|
|
|
The example extracts the root filesystem into the <filename>$HOME/qemux86-sato</filename>
|
|
|
|
directory:
|
|
|
|
<literallayout class='monospaced'>
|
2011-09-15 19:12:06 +00:00
|
|
|
$ source $HOME/poky/build/tmp/environment-setup-i586-poky-linux
|
2011-09-15 17:17:08 +00:00
|
|
|
$ runqemu-extract-sdk \
|
|
|
|
tmp/deploy/images/core-image-sato-sdk-qemux86-2011091411831.rootfs.tar.bz2 \
|
|
|
|
$HOME/qemux86-sato
|
|
|
|
</literallayout>
|
|
|
|
In this case, you could now point to the target sysroot at
|
|
|
|
<filename>$HOME/qemux86-sato</filename>.
|
|
|
|
</para>
|
|
|
|
</section>
|
2011-03-14 23:47:21 +00:00
|
|
|
</section>
|
2011-03-14 20:19:44 +00:00
|
|
|
|
|
|
|
</chapter>
|
|
|
|
<!--
|
|
|
|
vim: expandtab tw=80 ts=4
|
|
|
|
-->
|