Skip to content

Commit 171d80a

Browse files
committed
doc: develop: toolchains: add description for Andes toolchain
Add documentation for the Andes toolchain support both GCC and Clang. Signed-off-by: Jimmy Zheng <jimmyzhe@andestech.com>
1 parent 6430902 commit 171d80a

File tree

2 files changed

+45
-0
lines changed

2 files changed

+45
-0
lines changed
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
.. _toolchain_andes:
2+
3+
Andes Toolchain
4+
###############
5+
6+
#. Download and extract a toolchain from `Andes-Development-Kit`_ for your
7+
operating system.
8+
9+
.. note::
10+
11+
The currently supported release is **ast-v5_3_3-release** and later for
12+
Linux and MinGW-based Windows toolchain. Cygwin-based Windows toolchains
13+
(e.g., *ast-v5_3_3-release-windows*) are **not** supported.
14+
15+
#. :ref:`Set these environment variables <env_vars>`:
16+
17+
- Set :envvar:`ZEPHYR_TOOLCHAIN_VARIANT` to ``andes`` or ``andes-clang``.
18+
- Set :envvar:`ANDES_TOOLCHAIN_PATH` to the toolchain installation directory.
19+
20+
#. For example
21+
22+
#. Andes GCC:
23+
24+
.. code-block:: console
25+
26+
# Linux
27+
export ZEPHYR_TOOLCHAIN_VARIANT=andes
28+
export ANDES_TOOLCHAIN_PATH=/path/to/nds32le-elf-mculib-v5
29+
30+
#. Andes Clang:
31+
32+
.. code-block:: console
33+
34+
# Linux
35+
export ZEPHYR_TOOLCHAIN_VARIANT=andes-clang
36+
export ANDES_TOOLCHAIN_PATH=/path/to/nds32le-elf-mculib-v5
37+
38+
Andes Clang toolchain uses LLVM linker by default. You can choose the
39+
linker via Kconfig:
40+
41+
- Set :envvar:`CONFIG_LLVM_USE_LLD=y` to use LLVM linker.
42+
- set :envvar:`CONFIG_LLVM_USE_LD=y` to use the GNU LD linker.
43+
44+
.. _Andes-Development-Kit: https://github.com/andestech/Andes-Development-Kit/releases

doc/develop/toolchains/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ Guides on how to set up toolchains for Zephyr development.
1010

1111
zephyr_sdk.rst
1212

13+
andes_toolchain.rst
1314
arm_compiler_6.rst
1415
arm_toolchain_for_embedded.rst
1516
cadence_xcc.rst

0 commit comments

Comments
 (0)