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.