diff options
Diffstat (limited to 'documentation')
| -rw-r--r-- | documentation/sdk-manual/sdk-extensible.xml | 63 |
1 files changed, 36 insertions, 27 deletions
diff --git a/documentation/sdk-manual/sdk-extensible.xml b/documentation/sdk-manual/sdk-extensible.xml index 3a99b3791b..0389cb4448 100644 --- a/documentation/sdk-manual/sdk-extensible.xml +++ b/documentation/sdk-manual/sdk-extensible.xml | |||
| @@ -54,29 +54,29 @@ | |||
| 54 | </para> | 54 | </para> |
| 55 | </section> | 55 | </section> |
| 56 | 56 | ||
| 57 | <section id='sdk-setting-up-to-use-the-extensible-sdk'> | 57 | <section id='sdk-installing-the-extensible-sdk'> |
| 58 | <title>Setting Up to Use the Extensible SDK</title> | 58 | <title>Installing the Extensible SDK</title> |
| 59 | 59 | ||
| 60 | <para> | 60 | <para> |
| 61 | The first thing you need to do is install the SDK on your host | 61 | The first thing you need to do is install the SDK on your |
| 62 | development machine by running the <filename>*.sh</filename> | 62 | <ulink url='&YOCTO_DOCS_REF_URL;#hardware-build-system-term'>Build Host</ulink> |
| 63 | installation script. | 63 | by running the <filename>*.sh</filename> installation script. |
| 64 | </para> | 64 | </para> |
| 65 | 65 | ||
| 66 | <para> | 66 | <para> |
| 67 | You can download a tarball installer, which includes the | 67 | You can download a tarball installer, which includes the |
| 68 | pre-built toolchain, the <filename>runqemu</filename> | 68 | pre-built toolchain, the <filename>runqemu</filename> |
| 69 | script, the internal build system, <filename>devtool</filename>, | 69 | script, the internal build system, <filename>devtool</filename>, |
| 70 | and support files from the appropriate directory under | 70 | and support files from the appropriate |
| 71 | <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink>. | 71 | <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'>toolchain</ulink> |
| 72 | Toolchains are available for 32-bit and 64-bit x86 development | 72 | directory within the Index of Releases. |
| 73 | systems from the <filename>i686</filename> and | 73 | Toolchains are available for several 32-bit and 64-bit |
| 74 | <filename>x86_64</filename> directories, respectively. | 74 | architectures with the <filename>x86_64</filename> directories, |
| 75 | respectively. | ||
| 75 | The toolchains the Yocto Project provides are based off the | 76 | The toolchains the Yocto Project provides are based off the |
| 76 | <filename>core-image-sato</filename> image and contain | 77 | <filename>core-image-sato</filename> and |
| 78 | <filename>core-image-minimal</filename> images and contain | ||
| 77 | libraries appropriate for developing against that image. | 79 | libraries appropriate for developing against that image. |
| 78 | Each type of development system supports five or more target | ||
| 79 | architectures. | ||
| 80 | </para> | 80 | </para> |
| 81 | 81 | ||
| 82 | <para> | 82 | <para> |
| @@ -85,6 +85,7 @@ | |||
| 85 | filename and then is immediately followed by a string | 85 | filename and then is immediately followed by a string |
| 86 | representing the target architecture. | 86 | representing the target architecture. |
| 87 | An extensible SDK has the string "-ext" as part of the name. | 87 | An extensible SDK has the string "-ext" as part of the name. |
| 88 | Following is the general form: | ||
| 88 | <literallayout class='monospaced'> | 89 | <literallayout class='monospaced'> |
| 89 | poky-glibc-<replaceable>host_system</replaceable>-<replaceable>image_type</replaceable>-<replaceable>arch</replaceable>-toolchain-ext-<replaceable>release_version</replaceable>.sh | 90 | poky-glibc-<replaceable>host_system</replaceable>-<replaceable>image_type</replaceable>-<replaceable>arch</replaceable>-toolchain-ext-<replaceable>release_version</replaceable>.sh |
| 90 | 91 | ||
| @@ -93,14 +94,15 @@ | |||
| 93 | 94 | ||
| 94 | i686 or x86_64. | 95 | i686 or x86_64. |
| 95 | 96 | ||
| 96 | <replaceable>image_type</replaceable> is the image for which the SDK was built. | 97 | <replaceable>image_type</replaceable> is the image for which the SDK was built: |
| 98 | |||
| 99 | core-image-sato or core-image-minimal | ||
| 97 | 100 | ||
| 98 | <replaceable>arch</replaceable> is a string representing the tuned target architecture: | 101 | <replaceable>arch</replaceable> is a string representing the tuned target architecture: |
| 99 | 102 | ||
| 100 | i586, x86_64, powerpc, mips, armv7a or armv5te | 103 | aarch64, armv5e, core2-64, i586, mips32r2, mips64, ppc7400, or cortexa8hf-neon |
| 101 | 104 | ||
| 102 | <replaceable>release_version</replaceable> is a string representing the release number of the | 105 | <replaceable>release_version</replaceable> is a string representing the release number of the Yocto Project: |
| 103 | Yocto Project: | ||
| 104 | 106 | ||
| 105 | &DISTRO;, &DISTRO;+snapshot | 107 | &DISTRO;, &DISTRO;+snapshot |
| 106 | </literallayout> | 108 | </literallayout> |
| @@ -131,9 +133,10 @@ | |||
| 131 | home directory. | 133 | home directory. |
| 132 | You can choose to install the extensible SDK in any location when | 134 | You can choose to install the extensible SDK in any location when |
| 133 | you run the installer. | 135 | you run the installer. |
| 134 | However, the location you choose needs to be writable for whichever | 136 | However, because files need to be written under that directory |
| 135 | users need to use the SDK, since files will need to be written | 137 | during the normal course of operation, the location you choose |
| 136 | under that directory during the normal course of operation. | 138 | for installation must be writable for whichever |
| 139 | users need to use the SDK. | ||
| 137 | </para> | 140 | </para> |
| 138 | 141 | ||
| 139 | <para> | 142 | <para> |
| @@ -141,28 +144,34 @@ | |||
| 141 | toolchain tarball for a 64-bit x86 development host system and | 144 | toolchain tarball for a 64-bit x86 development host system and |
| 142 | a 64-bit x86 target architecture. | 145 | a 64-bit x86 target architecture. |
| 143 | The example assumes the SDK installer is located in | 146 | The example assumes the SDK installer is located in |
| 144 | <filename>~/Downloads/</filename>. | 147 | <filename>~/Downloads/</filename> and has execution rights. |
| 145 | <note> | 148 | <note> |
| 146 | If you do not have write permissions for the directory | 149 | If you do not have write permissions for the directory |
| 147 | into which you are installing the SDK, the installer | 150 | into which you are installing the SDK, the installer |
| 148 | notifies you and exits. | 151 | notifies you and exits. |
| 149 | Be sure you have write permissions in the directory and | 152 | For that case, set up the proper permissions in the directory |
| 150 | run the installer again. | 153 | and run the installer again. |
| 151 | </note> | 154 | </note> |
| 152 | <literallayout class='monospaced'> | 155 | <literallayout class='monospaced'> |
| 153 | $ ./poky-glibc-x86_64-core-image-minimal-core2-64-toolchain-ext-&DISTRO;.sh | 156 | $ ./Downloads/poky-glibc-x86_64-core-image-minimal-core2-64-toolchain-ext-2.5.sh |
| 154 | Poky (Yocto Project Reference Distro) Extensible SDK installer version &DISTRO; | 157 | Poky (Yocto Project Reference Distro) Extensible SDK installer version 2.5 |
| 155 | =================================================================================== | 158 | ========================================================================== |
| 156 | Enter target directory for SDK (default: ~/poky_sdk): | 159 | Enter target directory for SDK (default: ~/poky_sdk): |
| 157 | You are about to install the SDK to "/home/scottrif/poky_sdk". Proceed[Y/n]? Y | 160 | You are about to install the SDK to "/home/scottrif/poky_sdk". Proceed[Y/n]? Y |
| 158 | Extracting SDK......................................................................done | 161 | Extracting SDK..............done |
| 159 | Setting it up... | 162 | Setting it up... |
| 160 | Extracting buildtools... | 163 | Extracting buildtools... |
| 161 | Preparing build system... | 164 | Preparing build system... |
| 165 | Parsing recipes: 100% |##################################################################| Time: 0:00:52 | ||
| 166 | Initialising tasks: 100% |###############################################################| Time: 0:00:00 | ||
| 167 | Checking sstate mirror object availability: 100% |#######################################| Time: 0:00:00 | ||
| 168 | Loading cache: 100% |####################################################################| Time: 0:00:00 | ||
| 169 | Initialising tasks: 100% |###############################################################| Time: 0:00:00 | ||
| 162 | done | 170 | done |
| 163 | SDK has been successfully set up and is ready to be used. | 171 | SDK has been successfully set up and is ready to be used. |
| 164 | Each time you wish to use the SDK in a new shell session, you need to source the environment setup script e.g. | 172 | Each time you wish to use the SDK in a new shell session, you need to source the environment setup script e.g. |
| 165 | $ . /home/scottrif/poky_sdk/environment-setup-core2-64-poky-linux | 173 | $ . /home/scottrif/poky_sdk/environment-setup-core2-64-poky-linux |
| 174 | |||
| 166 | </literallayout> | 175 | </literallayout> |
| 167 | </para> | 176 | </para> |
| 168 | </section> | 177 | </section> |
