sdk-manual: Updated section to locate and install pre-built SDK

The section "Locating Pre-Built SDK Installers" was turned into
a procedure.  I also added some information on the actual names
of the *.sh files.

(From yocto-docs rev: 548886d5a392164783596c0c04779aaffd6ac930)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2017-07-10 14:05:51 -07:00
committed by Richard Purdie
parent 5ffec4ad91
commit 8b04dca455

View File

@@ -18,37 +18,71 @@
</para>
<para>
You can find SDK installers here:
<itemizedlist>
<listitem><para><emphasis>Standard SDK Installers:</emphasis>
Follow these steps to locate and hand-install the toolchain:
<orderedlist>
<listitem><para>
<emphasis>Go to the Installers Directory:</emphasis>
Go to <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink>
and find the folder that matches your host development system
(i.e. <filename>i686</filename> for 32-bit machines or
<filename>x86_64</filename> for 64-bit machines).</para>
<para>Go into that folder and download the SDK installer
whose name includes the appropriate target architecture.
The toolchains provided by the Yocto Project are based off of
the <filename>core-image-sato</filename> image and contain
libraries appropriate for developing against that image.
For example, if your host development system is a 64-bit x86
system and you are going to use your cross-toolchain for a
32-bit x86 target, go into the <filename>x86_64</filename>
folder and download the following installer:
<literallayout class='monospaced'>
poky-glibc-x86_64-core-image-sato-i586-toolchain-&DISTRO;.sh
</literallayout>
</para></listitem>
<listitem><para><emphasis>Extensible SDK Installers:</emphasis>
Installers for the extensible SDK are also located in
<ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink>.
These installers have the string
<filename>ext</filename> as part of their names:
<listitem><para>
<emphasis>Open the Folder for Your Development System:</emphasis>
Open the folder that matches your host development system
(i.e. <filename>i686</filename> for 32-bit machines or
<filename>x86_64</filename> for 64-bit machines).
</para></listitem>
<listitem><para>
<emphasis>Locate and Download the SDK Installer:</emphasis>
You need to find and download the installer appropriate for
your development system, target hardware, and image type.
</para>
<para>The installer files (<filename>*.sh</filename>) follow
this naming convention:
<literallayout class='monospaced'>
poky-eglibc-<replaceable>host_system</replaceable>-core-image-<replaceable>type</replaceable>-<replaceable>arch</replaceable>-toolchain-ext-<replaceable>release</replaceable>.sh
Where:
<replaceable>host_system</replaceable> is a string representing your development system:
i686 or x86_64.
<replaceable>type</replaceable> is a string representing either a "sato" or "minimal"
image.
<replaceable>arch</replaceable> is a string representing the target architecture:
aarch64, armv5e, core2-64, coretexa8hf-neon, i586, mips3242,
mips64, or ppc7400.
<replaceable>release</replaceable> is the version of Yocto Project.
NOTE:
The standard SDK installer does not have the "-ext" string as
part of the filename.
</literallayout>
The toolchains provided by the Yocto Project are based off of
the <filename>core-image-sato</filename> and
<filename>core-image-minimal</filename> images and contain
libraries appropriate for developing against those images.
</para>
<para>For example, if your host development system is a
64-bit x86 system and you are need an extended SDK for a
64-bit core2 target, go into the <filename>x86_64</filename>
folder and download the following installer:
<literallayout class='monospaced'>
poky-glibc-x86_64-core-image-sato-core2-64-toolchain-ext-&DISTRO;.sh
</literallayout>
</para></listitem>
</itemizedlist>
<listitem><para>
<emphasis>Run the Installer:</emphasis>
Be sure you have execution privileges and run the installer.
Following is an example from the <filename>Downloads</filename>
directory:
<literallayout class='monospaced'>
$ ~/Downloads/poky-glibc-x86_64-core-image-sato-core2-64-toolchain-ext-&DISTRO;.sh
</literallayout>
</para></listitem>
</orderedlist>
</para>
</section>