******************************************************************************
*                                DM6437 Edge Detection Enhanced Encode Decode
Demo                                        *
*                               readme.txt                                                                                                         
*
*                                                                                                                                                       
*
*                              26 August 2009                                                                                                   
*
******************************************************************************

Description
===========
DM6437 edge detection enhanced encode decode demo source code & host GUI

This software package extends the standard DM6437 demo with imaging
capabilities. It can be used to demo and benchmark IMGLIB2 functions. It will
also serve as a generic customer example how to easily extend the DM6437 demo.

The extensions can be mainly seen in app_block_image_proc.c. This block
implements edge detection algorithms (Sobel 3x3 or 5x5) based on IMGLIB2
provided functions. The camera frames are received from video_input and then
sent to video_output blocks. Additionaly hostapp was modified to include new
options for Image processing and selection of the algorithm.

In order to enable the new flow of data frames it was required to setup a new
'channel' in app_block_control.c.

In addition to sobel algos the user may also select two types of 'copy' algos
for data frames. One is just a standard for() loop and the other copy is
implemented using the EDMA3 API. This example was just used to demo the
different CPU loading of the two copy modes. The Demo hostapp does display the
CPU load on the GUI. No additional code was required to implement htis
capability as it is already provided by the original demo software.


Tests & Dependencies
====================
This software is based on the following components:

CCS 3.3 SR9 (or later)
C6000 CGT 6.1.2 (or higher)
DM6437 DVSDK 1.01.00.15
Spectrum Digital Board Support Package for DM6437 EVM V2 (dated 18.09.2007)
C6400 IMGLIB2 (v2.0.1 of May 2008)

General instructions
====================
- Make sure that the above requirements are satisified and all packages are
installed at default locations.
- Make sure the xdcpaths.mak and xdcpaths_evmDM6437.dat and other DVSDK files
are properly programmed according to getting started guide.
- Also make sure the ccs component manager and PC environment variables are set
accordingly (follow the DVDP getting started guide).
- This demo package MUST be placed in the \dvsdk\ (eg c:\dvsdk_1_01_00_15\)
directory.

How to build/run
================
- Open the pjt file in the CCS window and build it.
- The first time this demo project is opened in CCS, an error message showing
"xdc\std.h missing" might occur. If that is the case, go to
\xdc_2_95_02\packages\xdc\ to find the header file. The error should go away the
second time the pjt is built.
- During run time, in order to set up the communication between host app and
EVM, the EVM IP address must be properly programmed. It's easier if the address
is kept as static IP (The Gateway, Subnet, and DNS server IP in app_main.c will
need to be modified).

The host application GUI is included in the hostapp sub-directory inside this
package.

******************************************************************************
                      Release History Table of Contents
******************************************************************************
==============================================================================
Version 1546 Table of Contents
==============================================================================
- Demostration purpose only. No known bugs