Search by Tags

Configure Toolchain - Colibri iMX7


Your progress


Attention: the Quickstart Guide for BSP 2.8, based on the Ångström distribution, is not being updated anymore. Depending on your SoM, you have different options:

Vybrid and Tegra: the information is provided as-is and still accurate, since newer Toradex BSPs are not ported to those SoMs. Just keep in mind that the Guides are not being maintained anymore, even if we find bugs or outdated instructions.

Apalis TK1 (all variants), Colibri iMX6ULL (all variants), Colibri iMX7S 256MB and Colibri iMX7D 512MB: these computer on modules are still regularly maintained in our BSPs and, to get started, you must check the software page Toradex BSP Layers and Reference Images for Yocto Project. Since Torizon is not supported, at the moment a Quickstart Guide is not available.

All other i.MX-based SoMs: you have two options to get started with embedded Linux: the first is to follow the Quickstart Guide for Torizon, which provides the greatest out-of-the-box experience, or if you choose to use Yocto, check the software page Toradex BSP Layers and Reference Images for Yocto Project.


In this lesson, you will go through the process of configuring the Toradex Software Development Kit (SDK) for cross-compilation of C/C++ code to the ARM architecture, which uses the GNU C Compiler (GCC).

In this lesson you will:

  • Download and setup the Toradex SDK.


  • Host computer running the regular 64-bit installation of Ubuntu 16.04 LTS, as stated in the module 1 cover page.

Step 1

Download the Toradex SDK to the home directory of your computer.

Download the 64-bit SDK from here.

It includes the cross toolchain for building applications on the host machine, as well as the target root filesystem with development headers.

Warning: Make sure to use a matching SDK version (e.g. for Linux version 2.7, download SDK version 2.7). All available SDK versions are found here.

Step 2

Open the Linux terminal and go to the home directory. Install the SDK using the following commands. Use the default installation directory:

Note: This assumes that you downloaded your toolchain file in your home folder! Make sure to check where you downloaded the toolchain file and navigate accordingly using the cd command.

user@host:~$ cd
user@host:~$ chmod +x
user@host:~$ ./
Angstrom SDK installer version nodistro.0
Enter target directory for SDK (default: /usr/local/oecore-x86_64):
You are about to install the SDK to "/usr/local/oecore-x86_64". Proceed[Y/n]? y

Note: The lib paths are hard-coded in the moment of the installation-extraction. If you use a custom directory path and by any circumstance, you need to move it to another location afterward, make sure to re-install the SDK.

Step 3

Export the variables for cross-compilation.

Attention: You must execute this step every time you open a new terminal window or tab for cross-compilation.
If you are using the bash shell, you can add the command to the file .bashrc in your user home directory, so it gets executed each time you start a new bash shell.

. /usr/local/oecore-x86_64/environment-setup-armv7at2hf-neon-angstrom-linux-gnueabi

Warning: In the command above, notice that there is a dot and a space before the path to the script.