Linux Quickstart


  1. Verify that you can access the Controller from Linux:

  2. Install CMake if necessary. It is used to build the library and applications

    • $ sudo apt-get install cmake

  3. Install OpenCV (OpenCV is used for application windowing)

    • $ sudo apt-get install libopencv-dev


  1. The Mirrorcle Software Suite - Linux is typically provided as a USB flash drive or FTP download link and contains a folder with all applications and SDKs. It is recommended to extract this to the ~/MirrorcleTech/ directory.

  2. ~/MirrorcleTech/bin/ contains the Applications, specifically “MTIDevice-Demo”

  3. ~/MirrorcleTech/SDK-Linux/ contains the C++ Linux SDK with example projects
    • Source files of the MTIDevice-Demo example can be can be found in src/device_demo within the SDK-Linux directory

    • Makefile can be found in build/ sub-directory

    • Compiled output files will be placed in bin/ sub-directory

Running the Provided Demos

Run the compiled executable from ~/MirrorcleTech/SDK-Linux/bin/

  1. From ~/MirrorcleTech/SDK-Linux/bin/

    • $ ./MTIDevice-Demo


Users should try to preserve the Applications delivered by Mirrorcle in the ~/MirrorcleTech/bin/ directory in original form.

Compiling the SDK Examples

Compile the source using the Makefile in ~/MirrorcleTech/SDK-Linux/build/

  1. From ~/MirrorcleTech/SDK-Linux/build

    • $ make

After the build completes, the MTIDevice-Demo executable will be in the MirrorcleTech/SDK-Linux/bin folder

Creating a New Application

  1. Create a folder in the MirrorcleTech/SDK-Linux/src folder for your application C++ files.

  2. Copy CMakeLists.txt from MirrorcleTech/SDK-Linux/src/device_demo

  3. Create your new application .cpp and .h files, or copy MTIDevice-Demo.cpp to use as your base cpp file

  4. Open CMakeLists.txt and update the source files in the add_executable() section to your source files

  5. Also in CMakeLists.txt, replace ‘MTIDevice-Demo’ with your application name in all locations.

  6. From the MirrorcleTech/SDK-Linux/build folder, run the following commands:

    • $ cmake ..

    • $ make