Environment variables¶
The XTC Tools require the followiong environment variables to be set in order to operate.
When an environment variable contains multiple paths,m these are separated by an OS-specific path separator
(’;
’ for Windows, ‘:
’ for Mac and Linux).
- XMOS_TOOL_PATH¶
The path to the root of the installation, for example:
XMOS_TOOL_PATH=C:\Program Files\XMOS\XTC\15.3.1
- PATH¶
The directories searched by the command processor or shell for the XTC tools must contain the bin and lib subdirectories of the root of the installation
For example:
Path=C:\Program Files\XMOS\XTC\15.3.1\bin;C:\Program Files\XMOS\XTC\15.3.1\lib;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Windows\System32\OpenSSH
- XMOS_HOME¶
The path to a user’s directory in which custom target and device configuration files may be placed. For example, additional target (.xn) files may be placed under a subdirectory under XMOS_HOME called targets.
XMOS_HOME=C:\Users\joesmith\.xmos
- XMOS_CMAKE_PATH¶
The path to the XMOS build system (known as Xcommon CMake)
XMOS_CMAKE_PATH=C:\Program Files\XMOS\XTC\15.3.1\build\xcommon_cmake
- XCC_INCLUDE_PATH¶
A list of directories to be searched as if specified with
-I
, but after any paths given with-I
options on the command line.
- XCC_XC_INCLUDE_PATH¶
- XCC_C_INCLUDE_PATH¶
- XCC_CPLUS_INCLUDE_PATH¶
- XCC_ASSEMBLER_INCLUDE_PATH¶
Each of these environment variables applies only when preprocessing files of the named language. The variables specify lists of directories to be searched as if specified with
-isystem
, but after any paths given with-isystem
options on the command line.
- XCC_LIBRARY_PATH¶
A list of directories to be searched as if specified with
-L
, but after any paths given with-L
on the command line.
- XCC_DEVICE_PATH¶
A list of directories to be searched for device configuration files.
- XCC_TARGET_PATH¶
A list of directories to be searched for target configuration files. See
-target
,-print-targets
and-print-boards
.
- XCC_EXEC_PREFIX¶
If set, subprograms executed by the compiler are prefixed with the value of this environment variable. No directory seperater is added when the prefix is combined with the name of a subprogram. The prefix is not applied when executing the assembler or the mapper.
- XCC_DEFAULT_TARGET¶
The default target platform, to be located as if specified with
-target
. The default target platform is used if no target is specified with-target
and no XN file is provided as an input file.