The following material assumes that you have already install Orcc on your computer and set up a bunch of applications in the workspace of your eclipse.
Simulating an application is only a couple of mouse clicks away!
Now, because the simulation of complex application can take a very long time, the next section describe the way to generate source code from your description.
The primary goal of Orcc is to generate code for any platform, including hardware (VHDL), software (C, Java), reconfigurable software (with the JIT Adaptive Engine, based on LLVM), and heterogeneous platforms (multi-softcore platform or hardware/software co-design) from a platform-agnostic, high-level design. We are still working towards that goal, and at the moment Orcc is capable of generating code with the following code generators (called back-ends):
Generate an application from a RVC-CAL description is quite easy:
That's it! If you have gotten so far (and nothing bad happened), you have just generate your first application with Orcc.
Now, because Orcc generates source code, you will need to compile/synthesize/interpret this code with another toolchain. For instance, if you have chosen the C back-end, you are likely to need a C compiler in the next couple of minutes.
The C backend can be considered as the main backend of Orcc. In fact, this backend is used by the most part of the developpers for the development of new application.
First, be sure that SDL library is installed on your system:
sudo apt-get install libsdl-dev
Then, build your project by graphical or command-line interface using CMake. CMake is a unified build system that is able to generate Makefiles for most platforms as well as project files for major IDEs, including Eclipse CDT, KDevelop, Microsoft Visual Studio, Xcode. You can get the latest version from the website or from your package manager. On ubuntu, just run the command
sudo apt-get install cmake
If you prefer the graphical interface, known as cmake-gui, launch it and:
If you prefer the commande line,
cmake .. -DCMAKE_BUILD_TYPE=Debugor
cmake .. -DCMAKE_BUILD_TYPE=Release
The executable file of your application should be available in <your working folder>/bin. You can execute it like any program on your computer. The following parameters are available:
-i <path to input file>to set an input file to your application, such as a video sequence in case of a video decoder.
-o <path to YUV file>to check the validity of a decoded video.
-m <path to mapping file>to use the multi-core ability of your processor, the mapping file corresponds to an XCF file associating each core of your processor to a set of actors (an example of mapping file is generated in the source folder).
-l <number_of_loops>the number of times the input file is read. This option prevent application to run infinitely.
Install Orcc from the update site http://orcc.sf.net/eclipse/
Whether you need (or want to offer) help or advice, or if you just want to discuss/chat about Orcc, feel free to contact us!
Most of the team is based in Europe, so you might expect people to be connected and answer mail during the day (GMT+1).