readme.txt

ADSP 地层驱动

Project Name: Streaming

Project Type:
	ADSP-BF533 [X]
	ADSP-BF537 [ ]
	ADSP-BF561 [ ]
	
Hardware Used:
	ADV7171 - Video Encoder (Video Output)  
	
System Services Components Used:
	DMA Manager                         [X]   Deferred Callback Manager   [ ]
	Interrupt Manager                   [X]   Timer Module                [ ]
	Power Management Module             [X]   Flag Module                 [ ]
	External Bus Interface Unit Module  [X]   Port Module                 [ ]
	
Example Overview:
	This program displays alternating video frames on a video monitor.  To do this, 
	the device driver is configured for streaming operation.  When streaming is 
	enabled, the device driver operates at maximum speed, never halting the 
	transmission or reception of data.  To meet the system requirements of the 
	streaming sub-mode, the application must ensure the following:

		- the device driver must be kept loaded with buffers to process and never
		  starved for data.
		- when buffers are using callbacks, the callback for one buffer must be 
		  processed before another buffer, on that same device driver and on that
		  same inbound or outbound direction,  generates another callback.  

	(When using "live" callbacks, the callback function must execute before another 
	buffer generates a callback.  When using "deferred" callbacks, the callback must  
	only be posted to the deferred callback service, before another callback is 
	generated.)
	  
	This program creates two frames in SDRAM, each frame (named PingFrame and PongFrame) 
	is a different color. Two buffer chains are created that are used to send data to the 
	PPI driver; one chain points to the Ping frame while the other points to the Pong 
	frame.  Only the last buffer in each chain is configured to generate a callback, no 
	other callbacks are generated.  This makes it easy to guarantee that the latter of
	the two streaming requirements are met.  

	In order to satisfy the first streaming requirement, two options are provided, 
	selectable by the user-configurable macro below.  One option is to enable the 
	loopback sub-mode of the device driver.  When loopback is enabled, once buffers 
	have been provided to a device driver, the device driver automatically and 
	continually reuses the buffers, without any further interaction from the 
	application.  When loopback is not enabled, when the callback function is 
	invoked after the last buffer in either the Ping or Pong chain has completed, 
	the callback function requeues the chain that just completed to the device 
	driver via the 'adi_dev_Write' function.  


File  Structure:

	"Streaming.dpj"    -  Main project file
	"Streaming.c"   -  Main source file
	"ezkitutilities.c" - EZ-Kit utilities file for Blackfin procesors
	"video.c" - NTSC video utilities file for Blackfin procesors	
	"video.h" - NTSC video utilities include file for Blackfin procesors		
	"ezkitutilities.h" - EZ-Kit utilities	include file for Blackfin procesors


System Configuration:
	Jumpers: SW3 > 1:OFF, 2:OFF, 3:OFF, 4:OFF, 5:OFF, 6:ON

	External connections:
		Connect a monitor to the EZ-Kit video-out connector.  The video connectors
		are the bank of 6 RCA-style jacks nearest the serial cable connector on the
		EZ-Kit labeled as J6.
		
         J6 -----------------------------------------------------
            |          O          O < Video Out  O              |	        	
            |          O          O              O              |
            -----------------------------------------------------

Getting Started:

	1)	Load Project file "Streaming.dpj"
	2)	Build Project by selecting "Project->Rebuild Project"
	3)	Select "Debug->Run"
	4)	Observe video output on monitor
	5)	Select "Debug->Halt" to stop the program, when finished.