#
#  Copyright 2003 by Texas Instruments Incorporated.
#  All rights reserved. Property of Texas Instruments Incorporated.
#  Restricted rights to use, duplicate or disclose this code are
#  granted through contract.
#  
#  Date 11/12/2003
TITLE
-----
VPORT (IOM driver for DM642 VideoPort for Capture & Display)

DOCUMENTATION
-------------
The documenation for this device driver can be found at:
	/ddk/docs/*.pdf

Changes since last release:

* _IIC.c 
    - Added I2C read function.
  
* SAA7115.c 
    -   Added support for detection the disconnection of video input source. 
A new command, SAA7115_DETECT_LOCK_STATUS is added.
    -   Removed the call to powerdown SAA7115 in the SAA7115_close function. 
    -   Added support for QVGA mode (320 x 240).
    -   Corrected the size of SIF to 352 x 240(was 320 x 240).
    -   Fixed a bug in switching between inputs of SAA7115. The previous code 
can only switch inputs of the SAA7115 attached to VP0.

* SAA7105.c 
    -   Modified the OSD configuration code in SAA7105.c so that it does not 
overwrite the previous configurations that may be used by other drivers, such 
as the UART driver.

* VPORTCAP.c
    -   Added support for re-configuring the video port and EDMA w/o requiring 
first close the channel and then open it again.
    -   A bug is fixed related to the use of Video port global interrupt call-back 
function. Previously call-back works only for VP0. 
    -   Added support for automatic detection and correction of field inversion, 
caused by disconnection & reconnection of video source. This is in function 
_autoSync(). 
  
* VPORTDIS.c
    -   A bug is fixed related to the use of Video port global interrupt call-back 
function. Previously call-back works only for VP0. 

*  _VPORT.h
    -   Added THREE new fields: numTotalLinesFld1, interlaced and autoSyncEnable
in the definition of _VPORT_ChanObj to support automatic detection and 
correction of field inversion. 

* FVID.h
    -   Fixed a typo in the definition of the FVID_delete macro.

*  VPORTCAP.h
    -   Corrected the definition of VPORTCAP_EAV_V0 and VPORTCAP_EAV_V1, 
they were swapped in last release.
    -   Added a field in the VPORTCAP_Params structure for the application to 
specify whether automatic field inversion detection and correction mode is 
enabled.

*  SAA7115.h 
    -  Added definition of a new command: SAA7115_DETECT_LOCK_STATUS 
    -  Added the definition of SAA7115_AMuxingMode.
    -  Added SAA7115_MODE_QVGA in the definition of SAA7115_Mode.



USAGE
-----
This device driver is a mini driver for VideoPort peripheral on TMS320DM642
chips. It uses EDMA to do the data transfers. This driver supports Video
Capture & Video Display. It supports BT656 & YC mode for capture. And it 
supports BT656, YC and Raw mode for display. It does not support TSI or Raw 
mode for capture. 

FILES
-----
- vportcap.c: Implementation of capture driver.
- vportdis.c: Implementation of display driver.
- saa7115.c: Implementation of saa7115 video decoder configuration through I2C.
- saa7105.c: Implementation of saa7105 video encoder configuration through I2C.
- _saa7105.c: configuration tables for saa7105. 
- _saa7115.c: configuration tables for saa7115.
_ _iic.c: _IIC_write function.

NOTES
----- 
- Files in the library are compiled with "no optimization switch" turned on, 
  and the same is true for the project files. If you plan to use this module 
  in a project release, you should rebuild the library with optimization 
  turned on.

Known Problems At Release
-------------------------
- None.

Q&A
---
Q1: Where can I find the documentation for writing IOM drivers?

Q1: Where can I find the documentation for writing IOM drivers?
A1: The literature number is SPRU616, DSP/BIOS Device Driver Developer's Guide.
