This the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Setup Development Environment

The main tool of use for building, testing and deploying software is CMake Cmake is widely accepted and supported by many IDEs, which means that the user is free to choose his/her own development environment.

To make things more convenient, there are Motorcortex plugins for CLion ( CLion is an advanced IDE (Integrated Development Environment) with many tools that make programming a Motorcortex application more easy, this IDE is available across platforms and is capable to cross-compile and deploy Motorcortex applications straight to the controller with a click of a button. This guide will show you how to install CLion, Motorcortex plugins from the CLion Marketplace and get started with developing Motorcortex applications.

The Motorcortex development toolchain

There are two options when developing Motorcortex applications:

  • Use remote development and compile the application on the Motorcortex Target System;
  • Cross-compile on your development PC and deploy the executable to the Motorcortex Target System

The first method is easy to set up, it does not require additional dependencies however the downside is that a compile time for the large projects may be significant. The second method overcomes this problem, but requires a cross-compilation tool-chain to be set up.

1 - Install Development Environment

Installing your development environment for creating control applications is different for every PC. Please select the operating system you are u using:

Linux Windows MacOS

Install Build Tools

Before Installing Clion it is important to install build-essential tools

   sudo apt-get install build-essential

Installing CLion For Linux

Installing CLion has be done by downloading Clion directly from the Jetbrains website Download CLion from:

How to Install CLion is explained in their documentation:

To use Clion you will have to create a Jetbrains account and start with a free trail.

Installing Motorcortex Templates Plugin (for clion)

After installing Clion the first step is to install a the Motorcortex Templates plugin. This plugin will provide you the option to create a new Motorcortex project.

  1. In the Main Menu on the top left corner open: File → Settings, then find the Plugins menu.

  2. In the plugins menu search for Motorcortex.

  1. Install the Motorcortex Templates plugin and Restart IDE.

After installing the Motorcortex templates and restarting the Clion, you can create new Motorcortex projects in the main menu.

  1. In the main menu open: File → New Project, in the pop-up under C++ choose C++ Motorcortex select the location where you want to save your project and press the Create.

  1. Congratulations now you can start developing your Motorcotex application.

2 - Setup Remote Development

Set-up Remote Development (In CLion)

The most simple way to develope control applications is to use remote development. With remote development you compile the application and put it on your controller.

Check Connection

Connect your controller to your PC and make sure you have a connection. If you don’t know to connect to a Motorcortex controller make sure to check out Connect your PC.

  1. Before we start we have to make sure our connection works. open the Terminal located on the bottom of your IDE or press Alt+F12.

  1. In the terminal ping to your controller with the following command.
   ping -c 3
  1. The terminal should look something similar to this.

If you are unable to ping your controller make sure to check out Connection troubleshooting before you continue. If you have a connection with your controller it is time to setup your toolchain.

  1. In the Main Menu open File → Settings under Build, Execution, Deployment you will find the Toolchains menu.

  2. Add a new toolchain by pressing the + button and select Remote Host.

  1. In the Credentials press the ⚙️ button to enter the SSH configuration menu. Add a new configuration by pressing the + button and fill in the following data:
  • Host:
  • Port:22
  • User name: admin
  • Password: vectioneer

  1. Press the Test Connection button to make sure your connection is ok. If not re-check your controller connection.

  2. If the connection is good you can press OK to close the SSH Configurations menu.

  3. Wait for Make and the C/C++ Compiler to be detected then press the Apply button to save the Toolchain settings.

  4. Go CMake in the Settings menu and press the + button.

  1. Set the Build type to Debug and Toolchain to Remote Host.

  1. Press the OK button to save the CMake settings and close the settings window.

  2. Wait for +/- 20 seconds while a connection is being established, data is transferred and cmake is configured.

  3. Make sure that your controller is not running a Motorcortex application. Open the Terminal in Clion and run the the following command.

   ssh admin@ 'echo vectioneer | sudo -S motorcortex stop'
  1. In Clion set your Run/Debug Configuration to Debug-Remote Host.

  1. Press play to build and run the application.

  1. Congratulations you are now ready to start remote developing your Motorcortex application.

3 - Setup Cross Compilation

Set-up Cross Compilation (In Clion)

For cross compilation you use … (with remote device libraries).

Install Motorcortex toolchain on your system

For Cross compilation you will need a Motorcortex SDK you can download the SDK (Software Developement Kit) from the store by pressing the download button below.

  1. Extract the archive and place the .sh file in a folder of your preference.

  2. In the terminal browse to the folder and run the .sh file from the terminal, for example:

   sh ./
  1. You will be asked to enter the target directory where to install the SDK to. It is a good idea to keep the SDK in the home folder, where administrative rights are not required for example:

Mounting Sysroot on your system

The first step to Cross Compilation is to mount a Sysroot directory to your system that is used for cross-compilation. A `Sysroot is a directory which is considered to be the root directory for the purpose of locating headers and libraries of your application.

  1. Generate a new key pair with the following command.
   ssh-keygen -t rsa

  1. Use ssh-copy-id to provide a temporary access without a password to the remote Motorcortex host. If you are asked to fill in a password use vectioneer.
   ssh-copy-id admin@

  1. Create a folder to mount the remote Motorcortex file system on with the following command.
   mkdir ~/mcx-sysroot
  1. Ensure that sshfs is installed with the following command:
   sudo apt-get install sshfs
  1. Mount the Motorcortex file system with the following command:
   sshfs admin@ ~/mcx-sysroot/

Configure toolchain in clion.

Configure the compiler paths to use the Motorcortex cross-compilation toolchain.

  1. Open File → Settings → Build Execution Deployment → Toolchains.

  2. Create a new System Toolchain with the name motorcortex.

  3. Fill in Make, C Compiler and C++ Compiler paths to point the Motorcortex SDK as shown below.

  • Make:
  • C Compiler:
  • C++ Compiler

  1. Press Apply to save the changes.

Setup toolchain plugin

Configure sysroot path to use the headers and libraries from the remote host.

  1. Open File → Settings → Build, Execution, Deployment → **Motorcortex SDK and fill in the Sysroot path path the mounted folder (mcx-sysroot).

Add deployment connection to remote host (IS THIS STILL NEEDED IN THE NEW VERSION ALEXEY!!??)

  1. Add the connection to the remote Motorcortex host. Open Tools → Deployment → Configuration, add a new SFTP connection named mcx-host.

  2. select or add ssh configuration.

Press the Test Connection button to make sure that the filled data is correct.

Press the Autodetect button to set the root path. Uncheck the Visible only for this project checkbox make this host visible in all the projects.

press ok

Cross-compiling Motorcortex applications.

edit configurations.

select mcx dingie

save password checkbox

name cross-mcx-example

deployment profile to mxc-host

press ok

  1. In CLion open the project configuration menu.

  1. Click on + and select Motorcortex Remote Application. In the deployment profile field select Motorcortex remote host.

copy config folder

  1. In the Run/Debug configuration select the just created cross-compiled application with CrossDebug/CrossRelease build profile.

  2. Press the hammer button to cross-compile, play to copy and run on the remote Motorcortex host and the bug button to start a remote debug session.

Note if CMake CrossDebug/CrossRelease don’t work remove the “Motorcortex Remote Application” from Run/Debug Configurations and try again

4 - Install Integrated Development Environment

5 - Install Integrated Development Environment

6 - Setup Cross Compilation

7 - Setup Cross Compilation

8 - Setup Remote Development

9 - Setup Remote Development