The following links will help you set up your environment for compiling the various components of the CableLabs OpenCable Reference Implementation
To date, only the following build environments are supported:
- Windows (Cygwin, MinGW)
- When building under this environment, ensure that your OCAPHOST and PLATFORMHOST environment variables are set to Win32-Cygwin.
- Linux
- When building under this environment, ensure that your OCAPHOST and PLATFORMHOST environment variables are set to Linux.
Environment Variables
The RI Stack and RI Platform require several environment variables be set for proper compilation and execution.
RI Stack Variables
Environment Variable | Description |
|---|
OCAPROOT | Root directory of the stack |
OCAPTC | Target configuration directory |
OCAPHOST | Host environment identifier.
You will find host-specific build settings
in $OCAPROOT/hostconfig/$OCAPHOST |
JAVA_HOME | Location of a Java 1.4 or higher Java
Development Kit (JDK) installation. |
ANT_HOME | Location of Ant 1.6 or higher installation |
RI Platform Variables
Environment Variable | Description |
|---|
PLATFORMROOT | Root directory of the platform source |
PLATFORMTC | Target configuration directory |
PLATFORMHOST | Host environment identifier.
You will find host-specific build settings
in $PLATFORMROOT/hostconfig/$PLATFORMHOST |
RI Platform Target Configurations
The Reference Implemenation Platform (RI Platform) is a set-top box emulator that is the primary target for the Reference Implementation OCAP Stack. The RI Platform can be compiled to run on any number of operating systems. Currently the following targets are supported:
- Win32
- To compile the RI Platform to the Win32 target, set PLATFORMTC to Win32/debug
- At this time, there is no support for building a release version of the RI Platform on Win32
- Linux
- To compile the RI Platform to the Linux target, set PLATFORMTC to Linux/debug
- At this time, there is no support for building a release version of the RI Platform on Linux
OCAP Stack Target Configurations
The Reference Implementation OCAP Stack can be compiled to run on any number of target platforms and in either debug or release mode. The target-specific build files for the RI Stack are located in $OCAPROOT/target. From there, the OCAPTC environment variable describes the location of the build files. The OCAPTC environment variable is formatted like this:
<organization>/<target platform>/<target OS>/<debug|release>
Currently, the project supports the following targets:
- RI Platform (Windows) - The RI Platform is a set-top box emulator ported to the Win32 operating system.
- To compile the stack to the Windows RI Platform target, set OCAPTC to CableLabs/simulator/Win32/debug
- At this time, there is no support for building a release version of the RI Platform Win32 target
- RI Platform (Linux) - The RI Platform is a set-top box emulator ported to the Linux operating system.
- To compile the stack to the Linux RI Platform target, set OCAPTC to CableLabs/simulator/Linux/debug
- At this time, there is no support for building a release version of the RI Platform Linux target