tvoset utility
Release 1.1.0
Linux Kernels used: 2.4.0 and 2.4.17
Jan 22, 2003
Developer - Keshavardhana Gandla 

-----------------------------------------------------------------------------
PRODUCT INFORMATION
-----------------------------------------------------------------------------
This version of the utility works with the new linux graphics driver 
architecture followed by National. This driver has been tested with 
Linux Kernels 2.4.0 and 2.4.17. 
This utility has been tested with Cygnus, Dorado, Centaraus platforms.
This utility can be used to set the TV Overscan On NSC TV supported platforms 
wiht option "-tvo" for platforms.
This utility can be used to set the CRT modes and other framebuffer geometry for all 
Cygnus, Dorado, Centaraus platforms. For details of all the options look into the manual page of
tvoset.( Run "man tvoset")
-----------------------------------------------------------------------------
INSTALLATION INSTRUCTIONS	
----------------------------------------------------------------------------- 

Change the current directory to the "/usr/src/tvoset/" directory containing 
the TV OverScan utility sources and
-Run make clean
-Run make install, this is required only once.
-If you are installing  new version of tvoset utility run the above two commands.

This will create the tvoset binary and install it, together with the manual
Pages. It also creates the standard frame buffer special device nodes.
Run "man tvoset" to get manual page.

Usage of tvoset utility:
-Run "tvoset -tvo xx yy ww hh tvo-flag"
	Or
-Run  "tvoset -TVO xx yy ww hh tvo-flag" at root.

e.g in NTSC-720x480 MODE

-Run "tvoset -TVO 20 15 700 440 1". This will enable the TV Overscan.
-Run "tvoset -TVO 20 15 700 440 0". 
	or 
-Run "tvoset -TVO 0 0 0 0 0" This will disable the TV Overscan.

In this option 	xx is the X-offset value( positive value only).
		yy is the y-offset value.( positive value only).
		ww is the Width of the Screen.( positive value only).
		hh is the Height of the screen.( positive value only).
		tvo-flag is either 0 or 1. 

	If tvo-flag is 0 TV Overscan will be disabled irrespective of the parameters 
	xx,yy,ww and hh values.
	If tvo-flag is 1 "tvoset" will enable the 
	TV Overscan if above conditions are passed. 
 
	All the values should be >=0. 
	ww + xx <= resolution width 
	hh + yy <= resolution height
	If any of the above conditions fails TVOverscan will be disabled.

	

The etc subdirectory contains sample frame buffer mode definitions files. 
Copy one of them to /etc/fb.modes and edit it to your needs.

-----------------------------------------------------------------------------
BUILD INSTRUCTIONS					
----------------------------------------------------------------------------- 
- If installing for the first time.
- Create a directory "tvoset" by the command 
  "mkdir /usr/src/tvoset". 

- Extract all files from supplied TVOset directory
  to /usr/src/tvoset/ directory.


- Build and install crlf utility. For more information look at readme.txt in 
  crlf provided.

- Run "cd /usr/src/tvoset/" 

- Run "/root/crlf/crlf -r" in the directory "/usr/src/tvoset/".

- Run "make clean"

- Run "make install" 


-----------------------------------------------------------------------------
UNIT TEST
-----------------------------------------------------------------------------
- Test the TV Overscan feature using the utility "tvoset" in the following ways 
  on TV supported platforms.
  
  On CRT/FlatPanel

  1. Set two different consoles with different modes without TVO.
	 Console 1:	Run tvoset -g 800 600 800 600 16
	 Console 2: Run tvoset -g 1024 768 1024 768 8
     Switch between consoles.
  2. In the same setup as above. Switch modes in the same consoles 
	 Console 1:	Run tvoset -g 640 480 640 480 8
	 Console 2: Run tvoset -g 800 600 800 600 16
     Switch between consoles.

  ON TV Platforms.
  NOTE: Only on TV supported platforms, TVOverscan is supported.
        Non TV modes cannot be displayed on TV.TV out put will be disabled for Non Tv modes.

  3. Set two different TV consoles. 
	 Console 1:	Run tvoset -g 640 480 640 480 16
	 Console 2: Run tvoset -g 720 480 720 480 16
     Switch between consoles.
  4. Enable TV Overscan on one console with TV mode. 
	 Console 1:	Run tvoset -g 640 480 640 480 16 -tvo 50 50 500 300 1
	 Console 2: Run tvoset -g 720 480 720 480 16
     Switch between consoles.
  5. Enable TV Overscan on each console with TV mode.
	 Console 1:	Run tvoset -g 640 480 640 480 16 -tvo 50 50 500 300 1
	 Console 2:	Run tvoset -g 720 480 720 480 16 -tvo 50 50 500 300 1
     Switch between consoles.
  6. Switch to one console and change TVO parameters. 
	 Console 1:	Run tvoset -tvo 100 30 500 400 1
     Switch between consoles.
     Repeat this towards lower values and higher values on each console.
     The same can be done on the other console too.
-----------------------------------------------------------------------------
REVISION HISTORY
-----------------------------------------------------------------------------
version 1.1.0 - (Jan 22nd, 2003)  TV OverScan utility. 
Dependencies :
		    crlf v1.0.1o
			
-----------------------------------------------------------------------------
FUNCTIONAL CHANGES
-----------------------------------------------------------------------------
- None.
-----------------------------------------------------------------------------
DEFECTS CORRECTED
-----------------------------------------------------------------------------
- #169.4 tvoset application accepts negative value and responds incorrectly.
-----------------------------------------------------------------------------
FILE CHANGES
-----------------------------------------------------------------------------
- tvoset.c
-----------------------------------------------------------------------------
KNOWN ERRATA
-----------------------------------------------------------------------------
- None listed
-----------------------------------------------------------------------------
version 1.0.4 - (Sep 19th, 2002)  TV OverScan utility. 
Dependencies :
		    crlf v1.0.1o
			
-----------------------------------------------------------------------------
FUNCTIONAL CHANGES
-----------------------------------------------------------------------------
- Added runtime debug feature to KFB.
-----------------------------------------------------------------------------
DEFECTS CORRECTED
-----------------------------------------------------------------------------
- None.
-----------------------------------------------------------------------------
FILE CHANGES
-----------------------------------------------------------------------------
- tvoset.c
- tvoset.h
- Makefile
-----------------------------------------------------------------------------
KNOWN ERRATA
-----------------------------------------------------------------------------
- None listed
-----------------------------------------------------------------------------
version 1.0.3 - (Sep 16th, 2002)  TV OverScan utility. 
Dependencies :
		    crlf v1.0.1o
			
-----------------------------------------------------------------------------
FUNCTIONAL CHANGES
-----------------------------------------------------------------------------
- Use a local variable for the tvoset flag and then updated reserved[0].
-----------------------------------------------------------------------------
DEFECTS CORRECTED
-----------------------------------------------------------------------------
- None.
-----------------------------------------------------------------------------
FILE CHANGES
-----------------------------------------------------------------------------
- tvoset.c
-----------------------------------------------------------------------------
KNOWN ERRATA
-----------------------------------------------------------------------------
- None listed
-----------------------------------------------------------------------------
version 1.0.2 - (Sep 11th, 2002)  TV OverScan utility. 
Dependencies :
		    crlf v1.0.1o
			
-----------------------------------------------------------------------------
FUNCTIONAL CHANGES
-----------------------------------------------------------------------------
- Changes in the KFB driver have forced changes to the usage of var structure.
-----------------------------------------------------------------------------
DEFECTS CORRECTED
-----------------------------------------------------------------------------
- None.
-----------------------------------------------------------------------------
FILE CHANGES
-----------------------------------------------------------------------------
- Makefile
-----------------------------------------------------------------------------
KNOWN ERRATA
-----------------------------------------------------------------------------
- None listed
-----------------------------------------------------------------------------
version 1.0.1 - (May 17th, 2002)  TV OverScan utility. 
Dependencies :
		    crlf v1.0.1o
			
-----------------------------------------------------------------------------
FUNCTIONAL CHANGES
-----------------------------------------------------------------------------
- None listed
-----------------------------------------------------------------------------
DEFECTS CORRECTED
-----------------------------------------------------------------------------
- Corrected the Makefile to compile for the tvoset.
-----------------------------------------------------------------------------
FILE CHANGES
-----------------------------------------------------------------------------
- Makefile
-----------------------------------------------------------------------------
KNOWN ERRATA
-----------------------------------------------------------------------------
- None listed
-----------------------------------------------------------------------------
version 1.0.0 - (Jan 21, 2002)  TV OverScan utility. 
Dependencies :
		    crlf v1.0.1o
			
-----------------------------------------------------------------------------
FUNCTIONAL CHANGES
-----------------------------------------------------------------------------
- None listed
-----------------------------------------------------------------------------
DEFECTS CORRECTED
-----------------------------------------------------------------------------
- None listed
-----------------------------------------------------------------------------
FILE CHANGES

- None listed
-----------------------------------------------------------------------------
KNOWN ERRATA
-----------------------------------------------------------------------------
- None listed
-----------------------------------------------------------------------------

