6e5554b383
This update changes the filename from 'arm_compiler.rst' to 'arm_compiler_6.rst' to accurately reflects its focus on AC6. Recently, Arm introduced the Arm Toolchain for Embedded (ATfE), which is distinct from AC6. This 7th generation compiler is entirely open source for the first time. To distinguish it from AC6 and highlight it's a complete toolchain rather than just a compiler, this new version will be named Arm Toolchain for Embedded (ATfE). Signed-off-by: Alex Fabre <alex.fabre@rtone.fr>
55 lines
2.2 KiB
ReStructuredText
55 lines
2.2 KiB
ReStructuredText
.. _toolchain_armclang:
|
|
|
|
Arm Compiler 6
|
|
##############
|
|
|
|
#. Download and install a development suite containing the `Arm Compiler 6`_
|
|
for your operating system.
|
|
|
|
#. :ref:`Set these environment variables <env_vars>`:
|
|
|
|
- Set :envvar:`ZEPHYR_TOOLCHAIN_VARIANT` to ``armclang``.
|
|
- Set :envvar:`ARMCLANG_TOOLCHAIN_PATH` to the toolchain installation
|
|
directory.
|
|
|
|
#. The Arm Compiler 6 needs the :envvar:`ARMLMD_LICENSE_FILE` environment
|
|
variable to point to your license file or server.
|
|
|
|
For example:
|
|
|
|
.. code-block:: bash
|
|
|
|
# Linux, macOS, license file:
|
|
export ARMLMD_LICENSE_FILE=/<path>/license_armds.dat
|
|
# Linux, macOS, license server:
|
|
export ARMLMD_LICENSE_FILE=8224@myserver
|
|
|
|
.. code-block:: batch
|
|
|
|
# Windows, license file:
|
|
set ARMLMD_LICENSE_FILE=c:\<path>\license_armds.dat
|
|
# Windows, license server:
|
|
set ARMLMD_LICENSE_FILE=8224@myserver
|
|
|
|
#. If the Arm Compiler 6 was installed as part of an Arm Development Studio, then
|
|
you must set the :envvar:`ARM_PRODUCT_DEF` to point to the product definition file:
|
|
See also: `Product and toolkit configuration <https://developer.arm.com/tools-and-software/software-development-tools/license-management/resources/product-and-toolkit-configuration>`_.
|
|
For example if the Arm Development Studio is installed in:
|
|
``/opt/armds-2020-1`` with a Gold license, then set :envvar:`ARM_PRODUCT_DEF`
|
|
to point to ``/opt/armds-2020-1/gold.elmap``.
|
|
|
|
.. note::
|
|
|
|
The Arm Compiler 6 uses ``armlink`` for linking. This is incompatible
|
|
with Zephyr's linker script template, which works with GNU ld. Zephyr's
|
|
Arm Compiler 6 support Zephyr's CMake linker script generator, which
|
|
supports generating scatter files. Basic scatter file support is in
|
|
place, but there are still areas covered in ld templates which are not
|
|
fully supported by the CMake linker script generator.
|
|
|
|
Some Zephyr subsystems or modules may also contain C or assembly code
|
|
that relies on GNU intrinsics and have not yet been updated to work fully
|
|
with ``armclang``.
|
|
|
|
.. _Arm Compiler 6: https://developer.arm.com/tools-and-software/embedded/arm-compiler/downloads/version-6
|