Software Installation Guide

From David Vernon's Wiki
Jump to: navigation, search

ThIs guide provides a step-by-step guide to downloading, installing, and checking the software required to develop software for the CINDY Cognitive Architecture and write and run CINDY applications.

Operating System

I assume you are running Windows 10.

I strongly recommend you turn on the option in File Explorer to show file extensions. To do this, open File Explorer, click the View tab and click on the file name extensions checkbox so that it shows a tick.  If it is not ticked, you will have problems identifying certain files later on (e.g. invoking the CINDY.sln solution file to launch the C++ compiler).

C/C++ Compiler

Download the Microsoft Visual C++ Express compiler, version 10.0 (also known as Visual C++ 2010 or MSVC++ 2010). It is important to use this version; earlier versions are no longer supported by Microsoft and later versions cause problems with YARP.

You can download the required compiler from here.

Run the installer and follow the instructions.

You will need to register Visual C++ 2010 Express to continue using beyond the initial 30-day evaluation period. To do this, from the Microsoft Visual C++ 2010 Express menu, select Help > Register Product. You will then have to log in to your Microsoft account, if you have one, or create a new one, if you don't. After filling in some forms you will get the product key which you enter into the dialogue box that popped up when you selected Help > Register Product.

YARP

Download the YARP v. 2.3.63 binaries for x86, MSVC v. 10. Here's the link to the instructions and here is the link to the installer itself.

Run the installer and follow the instructions. The installer will do everything for you including updating your path and adding all the necessary environment variables.

CMake

Download CMake binaries from here. At time of writing the latest version is 3.10.1.

You can opt for either the WIN32 installer (cmake-3.10.1-win32-x86.msi) or the Windows zip file. The installer has the advantage that it gives you the option to update your system path automatically (which you should take by clicking the appropriate radio button during the installation process). If you choose the installer option, note that if you already have CMake version 3.4 or earlier you must uninstall it first.

OpenCV

Download and install OpenCV from here. Choose the version 2.4.10 self-installer, download it, and execute it, and extract the library to C:.

Add C:\opencv\build\x86\vc10\bin to the PATH environment variable and add a new environment variable OPENCV_DIR with the value C:\opencv\build, as follows.

  • From Windows 10 toolbar, select Settings.  
  • Type Environment Variables  in the Find a Setting dialogue box. This will bring up a new Systems Properties window. 
  • Click the Environment Variables ... button. This will bring up a new Environment Variables window. 
  • Select Path from System Variables. Click Edit.  Click New and insert C:\opencv\build\x86\vc10\bin. Click OK.  
  • Under User variables, click New. Insert OPENCV_DIR in the Variable name box and C:\opencv\build in the Variable value box. Click OK.  
  • Click OK in the Environment Variables window. 
  • Click OK in the Systems Properties window. 

FLTK

Download the FLTK Library from www.fltk.org:

  • Select the FLTK Library > Download menu item
  • Download the most recent version (1.3.2) fltk-1.3.2-source.tar.gz
  • Unzip to get the .tar file

If you do not have an application to unzip, download and install 7-zip from 7-zip.org. Note that you may have to deselect the localization component to get the English version

The fltk-1.3.2-source.tar file contains a fltk-1.3.2-source directory. This in turn contains a fltk-1.3.2 directory. Move this fltk-1.3.2 directory to C:\ and rename it to C:\FLTK

Go to C:\FLTK\ide\VisualC2010 and launch fltk.sln

  • Select Release from the drop-down Solution Configurations box (you only see this label when you hover over the box)
  • Select Build > Build Solution from the top menu (or press F7)
  • Select Debug from the drop-down option Solution Configurations box
  • Select Build > Build Solution (or press F7)

The CMake files in the CINDY Repository (next section) are configured to use the various FLTK libraries in C:\FLTK\lib and the include files in C:\FLTK\FL.

CINDY Repository

Eventually, the CINDY project will be archived on an SVN repository. For the moment, it is available as a simple .zip file. Unzip it so that you have a directory called C:\CINDY with the various subdirectories in the archive.

The next step is to build a MSVC++ .sln solution file so that you can compile all the CINDY executable components. To do this, you need to run CMake against the C:CINDY directory (where you will find the main CMakeLists.txt file)

  • Launch the CMake GUI from the Windows 7 toolbar.
  • In the Where is the source code: input (browse to) C:\CINDY
  • In the Where to build the binaries: input (browse to) C:\CINDY\build
  • Select File > Delete Cache from the top menu (you must do this the first time in case there is an old invalid configuration in the CINDY directory)
  • Click Configure
  • Select Visual Studio 10 (2010) from the drop-down menu as the generator for the project
  • Click Finish and watch CMake configure your project. The dialogue box will still highlighted in red so ...
  • Click Configure again and everything should be fine (unless you have forgotten to download and install OpenCV, in which case you will get an error and you will have install OpenCV and start this process again)
  • Click Generate to create the MSVC++ CINDY.sln file in C:\CINDY\build


Next, update your environment variables.

  • From Windows 10 toolbar, select Settings.  
  • Type Environment Variables  in the Find a Setting dialogue box. This will bring up a new Systems Properties window. 
  • Click the Environment Variables ... button. This will bring up a new Environment Variables window. 
  • Select Path from System Variables. Click Edit.  Click New and insert C:\CINDY\bin. Click OK.  
  • Under User variables, click New
  • Insert CINDY_ROOT in the Variable name box and C:\CINDY in the Variable value box
  • Click OK
  • Click OK in the Environment Variables window. 
  • Click OK in the Systems Properties window. 

Now you are ready to launch MSVC++ and build the CINDY component executables.

  • Go to the C:\CINDY\build directory and open the CINDY.sln file. This launches Microsoft Visual C++ 2010 Express.
  • Select Release in the Solutions Configuration box.
  • Select Build > Build Solution from the top menu, (if you don't see this and you see Debug > Build Solution instead, it's probably because your IDE is set to basic settings. To change this, select Tools > Settings > Expert Settings).


This will compile and link the components in the the C:\CINDY\bin directory. Check to see that both component executables are there. If it is not, then select Build > Configuration Manager from the menu and make sure the INSTALL check-box is ticked. Now rebuild the project again.

You are now ready to run the test applications that are included in each component directory (see directory structure below) and to begin developing your own components.

To run the test applications for the protoComponent and protoComponentGUI examples that are provided with the CINDY release, follow the instructions on the Software Users Guide.



Return to The CINDY Cognitive Architecture main page.