

	      **********************************************
	      * 					   *
	      *        TMS340 Graphics Library Port	   *
	      *     to TMS34010 TIGA Development Board	   *
	      *        (Full Memory Configuration)	   *
	      * 					   *
	      **********************************************


  This directory contains the OEM-specific TMS340 Graphics Library files
  that have been ported to Texas Instrument's TMS34010 TIGA Development
  Board (TDB).	A full memory configuration (1 megabyte of VRAM and 1
  megabyte of DRAM) is assumed.  This is the configuration in which the
  TMS34010 TDB is shipped.

    TMS34010 TIGA Development Board with full memory configuration:
	1 megabyte of VRAM (2 banks)
	1 megabyte of DRAM
	Monitor:     SONY Multi Scan HG (Model no. CPD-1304)
	Dot clocks:  OSC0 = 63.960 Mhz for 1024x768 noninterlaced
		     OSC1 = 25.175 MHz for 640x480 noninterlaced
		     OSC3 = 44.900 MHz for 1024x768 interlaced

  The current port of the TMS340 Graphics Library to the full-
  configuration TMS34010 TDB supports the following 15 graphics modes:

     mode #   resolution   # colors   # pages	display
     ------   ----------   --------   -------	-------
	0      640x480x8     256	 1	noninterlaced
	1      640x480x4      16	 2	noninterlaced
	2      640x480x2       4	 2	noninterlaced
	3      640x480x1       2	 2	noninterlaced
	4      320x240x8     256	 2	noninterlaced
	5     1024x768x8     256	 1	noninterlaced
	6     1024x768x4      16	 2	noninterlaced
	7     1024x768x2       4	 2	noninterlaced
	8     1024x768x1       2	 2	noninterlaced
	9      512x384x8     256	 2	noninterlaced
       10     1024x768x8     256	 1	interlaced
       11     1024x768x4      16	 2	interlaced
       12     1024x768x2       4	 2	interlaced
       13     1024x768x1       2	 2	interlaced
       14      512x384x8     256	 2	interlaced

  Subdirectory \oemprims contains the OEM-specific TMS340 Graphics
  Library functions that have been ported to the TMS34010 TDB.
  Subdirectory \demos contains a series of demonstration programs that
  run on the TMS34010 TDB.  Once you have installed the TMS34010 TDB in
  your system, you may view the demos by changing to the \demos
  subdirectory and running the demo.bat batch file.

  Note that the gspl.exe COFF loader utility program in the \demos
  subdirectory has been configured for a TDB residing in PC I/O addresses
  0x0290 through 0x0298.  (This is the default.)  If your system is
  configured differently, you need to reconfigure the gspl utility by
  invoking it with the "-c" command-line option.  For more information on
  the gspl utility, refer to the gspl.doc text file in the main library
  directory.

  The ported library routines assume that the TDB is configured to use a
  25.175-MHz dot clock for its 640x480 and 320x240 resolutions.  (This is
  how the TMS34010 TDB is configured when it is shipped.)  If your board
  has been configured to use TMS34010's 50.35-MHz input clock (INCLK)
  divided by 2 as its dot clock at these resolutions, you will have to
  modify the video initialization data specified in the oemdata.c source
  file in the \oemprims directory.  The only edit you will have to make
  to this file is to change the value of constant CLK25MHZ from 1 to 0.
  This causes bit 10 of the TDB's Control Register #1 to be set to 0
  rather than to 1.  The object library can then be automatically updated
  by running the makelib.bat batch file contained in the main library
  directory.

---- end of file ----
