Software Installation Guide

From David Vernon's Wiki
Revision as of 07:09, 12 March 2015 by Dvernon (Talk | contribs)

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 7.

C/C++ Compiler

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

This is significant because you will be downloading the YARP binaries in the next step and these are version-specific.

You can download the required compiler from here.

Run the installer and follow the instructions.

  • Problem Alert*

Some versions of Windows 7 may need the the Microsoft Visual Studio 2010 Service Pack 1 to be installed. If you have problems with CMake and FLTK (see below) this is almost certainly the cause. To be on the safe side, you can install Service Pack 1 by following the instructions "here":http://www.microsoft.com/en-us/download/details.aspx?id=23691. You can also check to see whether or not you have Service Pack 1 by checking the your version number: from the Microsoft Visual C++ 2010 Express menu, select _Help > About Visual C++ 2010 Express_. You will see a message on the top left of the pop-up window something like the following. 

Microsoft Visual Studio 2010
Version 10.0.40219.1 RTMRel
Microsoft .NET Framework
Version 4.0.30319 RTMRel

The RTMRel means the "Release To Manufacturing Release. If you have Service Pack 1 installed you would see something like the following. 

Microsoft Visual Studio 2010 
Version 10.0.40219.1 SP1Rel
Microsoft .NET Framework
Version 4.0.30319 SP1Rel

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.

You can opt for either the WIN32 installer 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).

OpenCV

Download and install OpenCV from here. Choose the version 2.4.9 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 7 toolbar, select Control Panel > System and Security > System > Advanced System Settings
  • Click Environment Variables
  • Select Path from System Variables
  • Click Edit
  • Add C:\opencv\build\x86\vc10\bin (be sure to separate different paths with a semi-colon)
  • Under User variables, click New
  • Insert OPENCV_DIR in the Variable name box and C:\opencv\build in the Variable value box
  • Click OK

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 7 toolbar, select Control Panel > System and Security > System > Advanced System Settings
  • Click Environment Variables
  • Select Path from System Variables
  • Click Edit
  • Add C:\CINDY\bin (be sure to separate different paths with a semi-colon)
  • Under User variables, click New
  • Insert CINDY_ROOT in the Variable name box and C:\CINDY in the Variable value box
  • Click OK


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.

Retrieved from "http://www.vernon.eu/w/index.php?title=Software_Installation_Guide&oldid=632"