Project Name: VideoInEdgeDetection_BF561.dpj

Project Type:
    ADSP-BF533 [ ]
    ADSP-BF537 [ ]
    ADSP-BF561 [X]

Hardware Used:

    **************************************
    **************************************
    ***  PLEASE READ THE RELEASE NOTE  ***
    ***  FOR SPECIFIC HARDWARE AND     ***
    ***  SOFTWARE CONFIGURATIONS       ***
    ***  SUPPORTED BY THIS APPLICATION ***
    **************************************
    **************************************

    ADSP-BF561 EZ-Kit Lite
    Analog Devices VisualDSP++
    VisualDSP++ Emulator
    Video monitor with ITU-656 NTSC/PAL AV input
    DVD player with ITU-656 NTSC/PAL Output

System Services Components Used:
    DMA Manager                         [X]   Deferred Callback Manager   [X]
    Interrupt Manager                   [X]   Timer Module                [X]
    Power Management Module             [X]   Flag Module                 [X]
    External Bus Interface Unit Module  [X]   Port Module                 [X]

OVERVIEW
=========

    This application can capture a video frame from a video stream, perform
    edge detection on the captured video frame and render the edge detected output
    to a video monitor.

    Pressing push button SW6 on the Ez-Kit to pauses incoming video.
    Pressing SW6 again resumes video streaming.

    Pressing and releasing push button SW7 on the Ez-Kit toggles display between
    video stream/paused frame and edge detected output on video stream/paused frame.

    Pressing and releasing push button SW8 on the Ez-Kit will automatically synchronise
    the system to present input video mode.
    i.e, switching between NTSC and PAL modes can be done on-the-fly.

Supported Video inputs:
-----------------------
    ITU-656 NTSC Interlaced
    ITU-656 PAL Interlaced

Edge detection algorithms used:
-------------------------------
    SOBEL Method

Supported Video In/Out combinations:
------------------------------------
    ITU656 NTSC Input, Video Stream/Paused Frame/Edge Detected output in ITU656 NTSC format (rendered to TV monitor)
    ITU656 PAL  Input, Video Stream/Paused Frame/Edge Detected output in ITU656 PAL format (rendered to TV monitor)

RUNNING THE APPLICATION
=======================

1. Hardware settings
--------------------
Video interface with ADSP-BF561 EZ-KIT Lite codecs
--------------------------------------------------

-- BF561 Ez Kit --

SW2:  1-OFF 2-OFF 3-OFF 4-OFF 5-OFF 6-ON
SW3:  1-OFF 2-ON  3-ON  4-OFF
SW4:  1-ON  2-ON  3-ON  4-ON  5-OFF 6-OFF
SW5:  1-OFF 2-ON  3-ON  4-ON
SW10: 1-OFF 2-OFF 3-OFF 4-OFF 5-OFF 6-OFF
SW11: 1-OFF 2-OFF 3-OFF 4-OFF
SW12: 1-ON  2-ON  3-ON  4-ON
SW13: 1-ON  2-ON


2. ADSP-BF561 EZ-KIT Lite - Push Button functions
-------------------------------------------------

Push Button 1 (SW6): Pauses/Resumes video streaming
Push Button 2 (SW7): Toggles display between paused video frame/streaming video and
                     edge detected output on paused video frame/streaming video
Push Button 3 (SW8): Synchronises Input/Output Video Mode
Push Button 4 (SW9): Terminates Application

3. External Connections
-----------------------
Connect a monitor to the EZ-Kit video-out connector and a video source
to the EZ-Kit video-in. The video connectors are the bank of 6 RCA-style jacks

Video interface with onboard video codecs in ADSP-BF561 EZ-Kit Lite

RCA-style jacks labeled J6

    +---------------------------------------------------+
    |          O          O < Video Out  O              |       (White)
    |          O          O              O < Video In   |       (Red)
    +---------------------------------------------------+ J6


4. Operational Description
---------------------------

- Open the "VideoInEdgeDetection_BF561.dpg" project in the VisualDSP
  Integrated Development Environment (IDDE).

- Build the project by selecting "rebuild all" from the project menu.
  The project gets automatically loaded in to DSP

- Connect a video display monitor (Television) to the video output jack
  (white coloured RCA-style jack)

- Connect an ITU656 NTSC/PAL video source (DVD player) to video input jack
  (red coloured RCA-style jack)

- Run the executables by pressing "multiprocessor run" (CTRL-F5) on the toolbar.
  Edge detected output of incoming video will be displayed in the video monitor

- Use Push Buttons on ADSP-BF561 EZ-KIT Lite to switch functionality

REFERENCES
==========
Multiformat SDTV Video Decoder ADV7183B Reference Manual
ADV7179 Video Encoder Reference Manual
ADSP-BF561 Hardware Reference Manual
ADSP-BF561 EZ-Kit Lite Evaluation system manual
David J.Katz, Rick Gentile, "Embedded Media Processing", 2d ed. New York:Elsevier Inc., 2006, ISBN:0750679123

SOFTWARE HIERARCHY
==================

This application consists of the following files:

\---BlackfinSDK
    |
    +---Algorithms
    |   |
    |   +---EdgeDetection
    |   |   |
    |   |   +---include
    |   |   |       sobel.h
    |   |   |
    |   |   +---src
    |   |           sobel_fast.asm
    |   |
    +---BFinUtils
    |   |   adi_itu656.c
    |   |   SDK-ezkitutilities.c
    |   |
    +---Include
    |   |   adi_itu656.h
    |   |   SDK-ezkitutilities.h
    |   |
    +---Multimedia
        |
        +---VideoInEdgeDetection
            |   VideoInEdgeDetection.h
            |   VideoInEdgeDetection_Buffers.c
            |   VideoInEdgeDetection_Callbacks.c
            |   VideoInEdgeDetection_System.c
            |   VideoInEdgeDetection_System.h
            |
            +---ADSP-BF561
                    Readme_VideoInEdgeDetection_BF561.txt
                    VideoInEdgeDetection_BF561.dpj
                    VideoInEdgeDetection_BF561.ldf
                    VideoInEdgeDetection_BF561_main.c

Device Drivers:

\---VisualDSP
    |
    +---Blackfin
        |
        +---lib
            |
            +---src
                |
                +---drivers
                    |   adi_dev.c
                    |
                    +---decoder
                    |       adi_adv7183.c
                    |
                    +---deviceaccess
                    |       adi_device_access.c
                    |       adi_device_access_twi.c
                    |
                    +---encoder
                    |       adi_adv7179.c
                    |       adi_adv717x.c
                    |
                    +---ppi
                    |       adi_ppi.c
                    |
                    +---twi
                            adi_twi.c
                            adi_twi_pseudo.c