This is the documentation for the latest (main) development branch of Zephyr. If you are looking for the documentation of previous releases, use the drop-down menu on the left and select the desired version.

Crosstool-NG (Deprecated)


xtools toolchain variant is deprecated. The cross-compile toolchain variant should be used when using a custom toolchain built with Crosstool-NG.

You can build toolchains from source code using crosstool-NG.

  1. Follow the steps on the crosstool-NG website to prepare your host.

  2. Follow the Zephyr SDK with Crosstool NG instructions to build your toolchain. Repeat as necessary to build toolchains for multiple target architectures.

    You will need to clone the sdk-ng repo and run the following command:

    ./ <arch>


    Currently, only i586 and Arm toolchain builds are verified.

  3. Set these environment variables:

  4. To check that you have set these variables correctly in your current environment, follow these example shell sessions (the XTOOLS_TOOLCHAIN_PATH values may be different on your system):

    # Linux, macOS: