Installing ROCCC 2.0

Before installing ROCCC, make sure you have the necessary dependent programs installed on your computer which are listed here.

Once you have all of those dependencies taken care of, download the latest ROCCC distribution tar file. This tar file will contain all the scripts and plugins needed to be able to run ROCCC. Once you have downloaded this file, untar it onto your computer. Inside the uncompressed folder you should find the following directories and files:

  • Documentation – The location of the user manual and developer’s manual.
  • Examples – The packaged ROCCC examples that will be imported into Eclipse.
  • GUI - The location of the Eclipse GUI plugins for ROCCC.
  • Install - The default location where ROCCC will be installed.
  • ReferenceFiles – A directory containing the files necessary for platform generations.
  • Scripts – The directory containing all the scripts used in the install process.
  • README – Brief explanation on installing the ROCCC compiler.
  • rocccInstall.sh – The script to be run to install the ROCCC compiler.

Installing the ROCCC 2.0 Compiler

In order to install ROCCC, run the bash script file rocccInstall.sh in a terminal. This script will untar, compile, and initialize all the packages necessary for ROCCC to run. If your system is missing an essential element for the compilation of ROCCC, an error message will be displayed and ROCCC will not be installed. If you wish to install ROCCC into a directory other than the current directory, you can specify the directory by using the -t flag. For example:

rocccInstall.sh -t /home/user/ROCCC

Once ROCCC is done compiling, it will output that it is all set up and what values to set in Eclipse.

Note: The green highlight does not actually appear.

This step will take a decent amount of time to finish so in the mean time we can begin setting up Eclipse to work with ROCCC.

Installing the Eclipse Plugins

To use the ROCCC GUI plugins, you need to download the Eclipse IDE. Eclipse 3.5.1 or higher is required for the ROCCC plugins to work correctly. The ROCCC GUI supports both the C++ and Java versions of Eclipse, however, it is suggested to use the C++ version since the ROCCC code will be written in C.

Eclipse can be downloaded for free at www.eclipse.org

Once you have downloaded and uncompressed Eclipse, open the resulting uncompressed “eclipse” folder. Inside of there, you should see a folder name “plugins.” This is where we need to copy the ROCCC GUI plugins into. The ROCCC plugins are located inside the “GUI” folder of the uncompressed ROCCC distribution folder.

Once you have moved the ROCCC plugins into the “plugins” folders inside eclipse, ROCCC should be ready to run on Eclipse. Before running Eclipse, make sure ROCCC has finished compiling and installing.

Running ROCCC 2.0 in Eclipse

Once you have seen that ROCCC finished installing and you have installed the GUI plugins, it is time to run Eclipse. The first time you run Eclipse with the ROCCC plugins installed, ROCCC will set up the perspective best used for working with ROCCC. It will also open up a page welcoming you to ROCCC 2.0 and asking if you would like to register for updates and news.

Upon filling this information out, ROCCC will open up the welcome webpage that should direct you to some helpful content for learning how to use ROCCC.

Before we can begin using ROCCC, we have to point Eclipse to where we installed ROCCC so it knows where to find the necessary binary files and scripts. To do this, open “ROCCC->Settings->Preferences” on the Eclipse menu.

Next you should see a preference window pop up that asks for the “ROCCC Distribution Directory.” All we need to do to begin using ROCCC is set this field properly. Click “Browse” and select the folder you installed ROCCC into. Once you have done that press “OK” and click “Verify ROCCC Distribution Folder” to make sure you have set the correct directory and everything installed properly. If you get a success message, then everything is ready to go. Press “OK” and you should be set.

If this is the first time you have set this field, ROCCC will ask you if you would like the examples loaded. Pressing yes will open the distributed examples in the project explorer and open the ROCCC examples webpage inside Eclipse.

Tutorials Home GUI Overview >>