Installing and Activating Cross Development Environment Print

 

The Linux Cortex-M development software is distributed as a linux-<mcu>-<release>.tar.bz2 file available for download from the Emcraft site. That file can be installed to an arbitrary directory on your Linux development host, as follows:

[yur@linux-7d45 imx]$ tar -xjf ./linux-IMXRT106X-2.5.2.tar.bz2
[yur@linux-7d45 imx]$ ls -l linux-cortexm-2.5.2/
total 20
drwxr-xr-x 25 yur users 4096 Oct 17 05:26 A2F
-rwxr-xr-x 1 yur users 319 Oct 17 05:26 ACTIVATE.sh
drwxr-xr-x 24 yur users 4096 Oct 10 22:30 linux
-rw-r--r-- 1 yur users 20 Oct 17 05:26 _MANIFEST
drwxr-xr-x 3 yur users 78 Oct 17 05:26 projects
drwxr-xr-x 4 yur users 61 Oct 17 05:28 tools
drwxr-xr-x 23 yur users 4096 Oct 17 05:26 u-boot

You do not need to be the superuser (root) in order to install the Linux Cortex-M distribution. The installation can be performed from an arbitrary unprivileged user account.

As a next step in the installation procedure, you need to download the GNU cross-build tools for Cortex-M. It is recommended that you install the GNU development tools to the tools/ directory in the cross-development tree. Download the arm-v7-linux-uclibceabi-pthreads-xx.tar.bz2 file to your home directory, then unpack it to tools/:

[yur@linux-7d45 imx]$ cd linux-cortexm-2.5.2/tools/
[yur@linux-7d45 tools]$ tar -xjf ~/arm-v7-linux-uclibceabi-pthreads-20181123.tar.bz2

The tools can be installed from an unprivileged account.

It is possible to install the tools to an alternative location, however, should you do that, you will need to modify the ACTIVATE.sh script to provide a correct path to the installed tools (specifically, PATH must include a correct path to the directory where you have installed the cross-tools).

Generally speaking, our customers do not have many issues (if any) with installation and activation of the development environment. For some reason, the most frequently occurring error is that people forget to run the activation script. This obviously results in insufficient path settings and the compiler failing to build sources for Cortex-M.

The activation script needs to be run any time you start a development session. The script resides at the top of the installation directory:

[yur@linux-7d45 linux-cortexm-2.5.2]$ ls
A2F ACTIVATE.sh linux _MANIFEST projects tools u-boot

An alternative way to run the script is to perform the following command:

[yur@linux-7d45 linux-cortexm-2.5.2]$ . ./ACTIVATE.sh

Whichever way you run the script, it sets a number of environment variables that are required for the cross development environment to function correctly. One of those variables is called MCU. The easy way to test if the cross development environment is active is to run the following command:

[yur@linux-7d45 linux-cortexm-2.5.2]$ echo $MCU
IMXRT106X_NXPEVK

If MCU is empty or set to something other than IMXRT106X_NXPEVK, this means that you have forgotten to run the activation script or somehow run it incorrectly.

Some of our customers ask if the cross development environment can be run on a Windows host. We don't support Windows, however some of our customers have been successfully running the development environment on a virtual Linux machine under Windows. Again, we don't support that explicitly so if you want to try that, you are on your own.