By 
Alan Kamas, for Sonics, Inc.
Herve Alexandrian, Sonics, Inc.
James Aldis, Texas Instruments
Tim Kogel, CoWare, Inc.
Anssi Haverinen, Texas Instruments, Inc.
Robert Guenzel, for Greensocs Ltd.
and Amit Garg, CoWare, Inc.

12-Nov-2007

Code Revision 2.2.1

---------------
Support
---------------

OCP-IP members may contact techsupport@ocpip.org for any support questions.

---------------
Description
---------------

The OCP channels, the examples and the underlaying concepts are
described in the (Pdf) document ocp/OCP_TL_Channel.pdf.

---------------
Installation
---------------

- Untar the 'tar.gz' archive
- run:

    make PREFIX=/path/to/distribution

    where /path/to/distribution represents the full path of the directory 
    where you want to install the package.  Note that some versions of "make"
    will have difficulties if there is a "~" (tilde) or "*" (asterix) in the
    path name.

- This step will also install all the examples in your "/path/to/distribution"
  directory.


---------------------------------
Building and running the examples
---------------------------------

Once you have installed the distribution, you can run the different examples:
    * '<PREFIX>/examples/ocp_tl1' directory contains OCP TL1 examples coded with the 
      OCP specific TL1 channel 
    * '<PREFIX>/examples/ocp_tl2' directory contains OCP TL2 examples coded with the 
      OCP specific TL2 channel 
    * '<PREFIX>/examples/supplementary' directory contains additional, undocumented
      simple examples for generic and OCP channels
    
Top level instructions for running examples:
    * Go to "/path/to/distribution" direrctory. 

    * Edit the Makedefs in "/path/to/distribution" direrctory to define the 
      correct path for SYSTEMC and boost headers and also for any monitor 
      defines if needed. 
	  
	* Over-write the examples/Makedefs in the install path 
      with this file also.
	  --------------------------------------------------------------------------
	  This overrides the steps defined in README.txt for setting the various top
	  level variables.
	  --------------------------------------------------------------------------

    * Follow the instructions prescribed in the individual README.txt in each
	* example directory.

Notes
---------------
- See KNOWN_ISSUES.TXT for the latest issue reports.
- unsigned long long has been replaced by uint64 to increase portability
- support for OCP2.2 2D-bursts has been added to both TL1 and TL2 channel implementations
- New examples have been added for TL1 and TL2
- Using more than one monitor on a TL1 channel has been ennabled
- GetDataCl and GetParamCl interface methods for TL1 channel are deprecated
- comprehensive documentation updates

