NEC startWARE-GHS-Ravin-E, User Manual

Page: 19 / 40

19 User’s Manual U17316EE1V0UM00
Chapter 4 Software Description
We have written a few demo programs, which can be found in the “Software\Ravin-E” directory of the
startWARE-GHS-Ravin-E CD. The programs can be compiled for MIPS RISC devices or for V850E
devices. Build files for each of these environments are supplied. We have used Green Hills version
3.5.1 for V850 and version 3.6.1 for MIPS. Make sure to issue a “build all” command, if you change
between these tool chains. Otherwise the tools may mix modules of different architectures, which may
lead to some weird error messages.
Here is the directory structure of Software\Ravin-E:
Animation
Benchmarks
Bin2C
Datalogger
HW-Test
Include
LibV850
LibVR
MyLib
png
rgl
StartupVR
The individual demo programs and their build files are found in Animation, Benchmarks, Datalogger
and HW-Test. Bin2C contains a Windows application program, which converts a file to C-Source code.
These programs are described later in this chapter. The Include directory contains a few include files,
which are required by the demo programs and the libraries. LibV850 and LibVR contain the compiled
libraries for the respective tool chain. MyLib holds the sources of the CPU initialization code and the
interface code for the PNG library. png contains the sources of the png library (libpng) and the zlib,
which is required for libpng. Both are third party software packages. See http://www.libpng.org/ for the
latest sources. rgl contains the Ravin Graphics Library and StartupVR contains startup code for MIPS
devices and defines for the V
R
4131.
All libraries can be built automatically by the build files in LibVR or LibV850. The libraries are supplied
on the CD and ready to use, but it may be useful to download the latest libpng and zlib sources from the
internet and recompile them.
All temporary files during the build process are stored in the Tmp subdirectories of the respective mod-
ule. The files in this path can be deleted after the build process.
4.1 Ravin-E Graphics Library
The Ravin-E graphics library (RGL) provides higher level functions to initialize and operate Ravin-E.
Only the function ghs\rgl_custom.c needs to be adapted, when rgl is ported to another target. It defines
the addresses of the Ravin-E registers (PhysReg) and of the Ravin-E frame buffer (PhysFB). An
os_sleep(n) function is required for delays and timeouts, which delays by roughly n milliseconds. It
needs not be very precise. For the V850E/ME2, we have implemented a simple active delay, which
delays roundabout 1 ms for a 150 MHz device. If the CPU core frequency differs much from that, it
should be adapted accordingly. A built-in timer is used for the V
R
4131, which generates 1 ms interrupts.
The respective code is located in StartupVR\iqueue.c, start.mip and isr.mip.
A detailed description of the RGL can be found in the “Ravin-E Graphics Library Manual” in the rgl\doc
directory.