diff options
Diffstat (limited to 'documentation/dev-manual')
| -rw-r--r-- | documentation/dev-manual/external-toolchain.rst | 28 |
1 files changed, 20 insertions, 8 deletions
diff --git a/documentation/dev-manual/external-toolchain.rst b/documentation/dev-manual/external-toolchain.rst index e1fabbed22..238f8cf467 100644 --- a/documentation/dev-manual/external-toolchain.rst +++ b/documentation/dev-manual/external-toolchain.rst | |||
| @@ -15,14 +15,26 @@ follows: | |||
| 15 | ``bblayers.conf`` file through the | 15 | ``bblayers.conf`` file through the |
| 16 | :term:`BBLAYERS` variable. | 16 | :term:`BBLAYERS` variable. |
| 17 | 17 | ||
| 18 | - Set the ``EXTERNAL_TOOLCHAIN`` variable in your ``local.conf`` file | 18 | - Set the :term:`EXTERNAL_TOOLCHAIN` variable in your ``local.conf`` file |
| 19 | to the location in which you installed the toolchain. | 19 | to the location in which you installed the toolchain. |
| 20 | 20 | ||
| 21 | A good example of an external toolchain used with the Yocto Project is | 21 | The toolchain configuration is very flexible and customizable. It |
| 22 | Mentor Graphics Sourcery G++ Toolchain. You can see information on how | 22 | is primarily controlled with the :term:`TCMODE` variable. This variable |
| 23 | to use that particular layer in the ``README`` file at | 23 | controls which ``tcmode-*.inc`` file to include from the |
| 24 | https://github.com/MentorEmbedded/meta-sourcery/. You can find | 24 | ``meta/conf/distro/include`` directory within the :term:`Source Directory`. |
| 25 | further information by reading about the | ||
| 26 | :term:`TCMODE` variable in the Yocto | ||
| 27 | Project Reference Manual's variable glossary. | ||
| 28 | 25 | ||
| 26 | The default value of :term:`TCMODE` is "default", which tells the | ||
| 27 | OpenEmbedded build system to use its internally built toolchain (i.e. | ||
| 28 | ``tcmode-default.inc``). However, other patterns are accepted. In | ||
| 29 | particular, "external-\*" refers to external toolchains. One example is | ||
| 30 | the Mentor Graphics Sourcery G++ Toolchain. Support for this toolchain resides | ||
| 31 | in the separate ``meta-sourcery`` layer at | ||
| 32 | https://github.com/MentorEmbedded/meta-sourcery/. | ||
| 33 | See its ``README`` file for details about how to use this layer. | ||
| 34 | |||
| 35 | Another example of external toolchain layer is | ||
| 36 | :yocto_git:`meta-arm-toolchain </meta-arm/tree/meta-arm-toolchain/>` | ||
| 37 | supporting GNU toolchains released by ARM. | ||
| 38 | |||
| 39 | You can find further information by reading about the :term:`TCMODE` variable | ||
| 40 | in the Yocto Project Reference Manual's variable glossary. | ||