home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / vpic / config.doc < prev    next >
Text File  |  1993-08-13  |  13KB  |  208 lines
  1.     CONFIGURING VPIC
  2.  
  3.     VPIC must be configured to run correctly with your display board.  The  con-
  4.     figuration process tells VPIC:
  5.     1. The title you want for the menu.
  6.     2. What VGA chip you have, so it can use the proper bank switching routine.
  7.     3. How much memory you have (in 64K banks).
  8.     4. The menu color you want (background:foreground).
  9.     5. How to set the various modes you want to use.
  10.  
  11.     This method is used instead of trying to autodetect the VGA chip and  memory
  12.     (unless you have a board that supports VESA) because:
  13.     1. Some chips are very hard to detect, and memory on board is even harder.
  14.     2. As new VGA chips are released, there is a delay before the detection is
  15.        implemented in the program.
  16.     3. The WHICHVGA program is provided to autodetect the VGA chip and memory,
  17.        but it fails on some chips.
  18.     4. The config file provides more user control than automatic means.
  19.  
  20.     If you aren't sure which VGA chip your board uses,  you  can  run  WHICHVGA,
  21.     which will try to identify your VGA chip and the amount of memory you  have.
  22.     WHICHVGA now tries to identify your SuperVGA chip and memory three ways;  by
  23.     reading ports, checking for VESA, and reading the first 640 bytes  of  Video
  24.     BIOS. The info is saved in a file called WHICHVGA.TXT,  which you can  read.
  25.     If this doesn't work, you can try to compare the graphics  mode  numbers  in
  26.     your manual to the mode numbers in the various  configuration  files.  As  a
  27.     last resort, you can remove the display board and look at the label  on  the
  28.     large chip with leads coming out all four sides. 
  29.  
  30.     If WHICHVGA comes back with VESA, that means that your  board  supports  the
  31.     VESA standard, which offers a standard interface for VPIC to  your  SuperVGA
  32.     display adapter. It defines the SuperVGA extended modes that your card  will
  33.     do, and has a standard interface for setting the mode  and  bank  switching,
  34.     etc. You  may  have  received  a  VESA  `Terminate and Stay Resident'  (TSR)
  35.     program with your VGA board. If so, you are encouraged to use it,  since  it
  36.     more or less guarantees that VPIC will work with your display card. The only
  37.     disadvantage of VESA is concerned with scrolling the VGA screen, since there
  38.     is no standard interface for setting the top of screen beyond 16 bits  (line
  39.     81 at 800x600x256, line 102 at 640x480x256, or  line  204  at  320x200x256).
  40.     This version of VPIC automatically reads the VESA  info  from  your  display
  41.     BIOS, and uses the VESA interface. If you enter VPIC  with  the  /v  option,
  42.     VESA info is ignored and VPIC uses the  configuration  file  info;  this  is
  43.     helpful when VESA returns info VPIC isn't expecting or wrong info; the older
  44.     S3 cards (Orchid Fahrenheit 1280, Diamond Stealth, etc)  return  wrong  VESA
  45.     info, and need the /v option so they use  the  configuration  file  info.  A
  46.     generic VESA.CFG file is supplied for you to play with  to  try  to get your
  47.     VESA card to work; see below on what each entry means;  again,  you  have to
  48.     use the /v option to enable this configuration info. The CIRRUS54.CFG config
  49.     file is an example of how to modify the generic VESA.CFG.
  50.  
  51.     If the top line in VPIC says VESA,  then VPIC is using VESA info returned by
  52.     your SVGA card.  If the only resolution listed is 320x200, there is probably
  53.     a problem with your memory manager.  To verify this, try booting with from a
  54.     DOS floppy with no memory manager. I only exclude B000-B7FF (used by Windows)
  55.     and C000-C7FF (Video ROM),  and  I found that stealth mode confuses the SVGA
  56.     VESA routines, so I don't use stealth.  On the other hand, the Trident 8900c
  57.     returns VESA hi-color modes which it cannot do, so you have to lock (Alt F7)
  58.     it into 256 colors.
  59.  
  60.     The current VPIC config file VGA chips and the VGA chip manufacturers are:
  61.     VGA Chip    Manufacturer/version        Comments
  62.     =================================================================
  63.     ACUMOS     Acumos                  Voltane, No. 9 GXiTC, others
  64.     AHEADA     Ahead ver A             Older Ahead cards.
  65.     AHEADB     Ahead ver B             Ahead VGA Wizard/Deluxe.
  66.    *ATIOLD     ATI, 1024x768x16 mode 65h   ATI ver 1 chip, VGAWonder.
  67.    *ATINEW     ATI, 1024x768x16 mode 55h   ATI ver 2 up chip, VGAWonder+.
  68.                For the ATI Ultra, be sure to run ATI's HDILOAD program first to
  69.                activate the 8514A interface for the 1024x768x256 mode.
  70.     CIRRUS     Cirrus CL-GD 500/600    MaxLogic MaxVGA boards NOT SUPPORTED YET.
  71.     CHIPSTECH  Chips & Technology 82C452   Cardinal, Older Boca.
  72.     EVEREX     Original Everex chip
  73.     EVBIOS     Everex 673, etc         Has bank switching built into BIOS.
  74.     GENOA      Genoa (Sim ET 3000)     5300/6300 = 256K, others = 512K.
  75.     HEADLAND   Headland HT-208         Used on VGA-1024i.
  76.     NCR        NCR                     Boca, PVGA 1024i, etc
  77.     OAK        Oak
  78.     PARADISE   Paradise                Older Paradise cards.
  79.     PRIMUS     Primus                  Used in Galaxy 2000 cards.
  80.     REALTEK    Realtek                 Used in RTVGA boards.
  81.    *S3         S3 GUI Accelerator      Used on Orchid Fahr 1280, Diamond Stealth,
  82.                                         Genoa Windows VGA, etc.
  83.     TRI88BR    Trident TVGA 8800BR     Used on older Trident boards, 128K banks.
  84.     TRI88CS    Trident TVGA 8800CS     Used on older Trident boards (Maxxon)
  85.     TRI89      Trident TVGA 8900       Latest Trident VGA chip, 1M memory avail.
  86.     TS3000     Tseng ET 3000           Used on early Genoa, Orchid, others.
  87.     TS4000     Tseng ET 4000           Recent Orchid, STB, other, 1M memory.
  88.     TS4000HI   Tseng ET 4000 HiColor   Does 32K colors to 800x600, 1M memory.
  89.     WD90C      Western Digital WD90C00  Recent Paradise cards, same operation.
  90.     VIDEO7     Video 7                 Earlier Video 7 boards, BIOS bank switch.
  91.                                         Hewlett Packard SVGA.
  92.     ZYMOS      Zymos Poach 51          True Tech HiRes and others.
  93.     VESA       VESA Standard           For boards which have VESA in BIOS.
  94.     * For ATI boards, certain modes may not be enabled (such as 800x600)  unless
  95.       you choose the proper (or custom) monitor in ATI's INSTALL program. On the
  96.       older S3 cards, VESA returned the wrong info, so use the /v option.
  97.  
  98.     As new chips become available, they will be added to this list. Run WHICHVGA
  99.     to find your VGA chip (works most of the time), and then run CONFIG and find
  100.     a CFG file using that VGA chip. Check that the modes agree with the graphics
  101.     modes in your manual (16 and 256 color modes only); if they match your  card
  102.     exactly, use that CFG file by pressing ENTER. If not, copy the closest  file
  103.     to a new filename with extension CFG and change the modes to agree with your
  104.     manual. Make the title and menu color whatever you like  (see  CONFIGURATION
  105.     FILE FORMAT). Then  rerun  CONFIG,  pick  that  file,  and  press  ENTER  to
  106.     configure VPIC. There are numerous configuration files which come with VPIC,
  107.     but there are so many boards out there that I can't list all of them.
  108.  
  109.     MENU CONFIGURATION
  110.     To configure VPIC, make sure that VPIC, CVPIC,  CONFIG,  and  all  the  .CFG
  111.     files are in the current directory. By running the CONFIG program, VPIC  can
  112.     be configured from a menu. CONFIG lists all the configuration files (with  a
  113.     .cfg extension) in the current directory, and shows you the contents of each
  114.     as you move around the list using the cursor keys. ESCape aborts the  CONFIG
  115.     program without changing VPIC, and ENTER configures VPIC for the highlighted
  116.     file. Pressing a letter key jumps to next filename starting with that letter
  117.     (or number). The mode descriptions include ax, bx, cx, dx, X, Y,  and  color
  118.     fields from the config file; see below. You can try to match these with your
  119.     manual if you aren't sure which SuperVGA card you have.
  120.  
  121.     MANUAL CONFIGURATION
  122.     You can use CVPIC to configure VPIC manually by entering:
  123.          CVPIC config_file[.ext]
  124.     where the default extension is .cfg and  config_file  is  the  configuration
  125.     file you want to use. This is what CONFIG does when you press ENTER from the
  126.     menu.
  127.  
  128.  
  129.  
  130.  
  131.     CONFIGURATION FILE (.CFG) FORMAT
  132.     CVPIC ignores leading spaces and blank lines in the file, and all characters
  133.     after a semicolon are considered comments and ignored. The .CFG file contains
  134.     the following lines, which can be up to 150 characters in length each:
  135.  
  136.         1. Board name, which will appear in the VPIC menu. This is user  define-
  137.            able, and could be something like 'Joe's VGA Board'.
  138.  
  139.         2. VGA CHIP should be one of the names supported  by  VPIC;  see  above.
  140.            Upper or lower case is OK.
  141.  
  142.         3. The number of 64K banks of display ram usable  for  pictures  (1  for
  143.            standard VGA (no extended modes), 4 for 256K, 8 for 512K, 16 for 1M).
  144.  
  145.         4. Menu text color. A number whose value is  background*16 + foreground.
  146.            The allowable background colors are  0  thru  7,  and  the  allowable
  147.            foreground colors are 0 thru 15. This number is easiest to figure  if
  148.            entered in hex (prefixed by 0x); then the 1st digit is the background
  149.            color (0-7) and the 2nd digit is  the  foreground  color  (0-F).  The
  150.            digits correspond to black (0), blue (1),  green (2),  aqua (3),  red
  151.            (4), violet (5), brown (6), and white (7), and  the  digits  8-F  are
  152.            intensified versions of the 0-7. For example, 0x3E would tell VPIC to
  153.            use bright yellow text on an aqua background. CONFIG gives the  value
  154.            in hex, and the corresponding foreground-background colors.
  155.  
  156.         5 thru n. The following lines describe the modes supported by the board.
  157.           Each line is of the form: F1 F2 AX BX CX DX W H C BPL MR G P B
  158.           where:
  159.             *  F1 = 0 or 1 for normal SuperVGA modes, > 1 for hi-color DAC
  160.                modes as follows:
  161.                     0 => 16 color modes
  162.                     1 => 256 color modes
  163.                     2 => 15 bits/pixel (32,768 colors)
  164.                     3 => 16 bits/pixel (65,536 colors)
  165.                     4 => 24 bits/pixel (16,777,216 colors)
  166.             *  F2 = 0 for EGA (640x350x16) with 64 colors to choose from, and 1
  167.                for all others modes (which have 256,000 colors to choose from).
  168.             *  AX,BX,CX,DX  register values used to set this mode. Preceding the
  169.                numbers by 0x indicates hex; ie., 0x10 = 16. Using 8514 for AX
  170.                indicates an 8514A interface, where BX is the mode.
  171.             *  W, H, C  are width, height, colors in this mode. For 24 bit modes
  172.                the colors field has the color order; 123=>BGR, 321=>RGB.
  173.           Additional Information if known
  174.             *  BPL is the bytes per scan line for this mode.
  175.             *  MR is the maximum row for this mode; 0 => calculate from banks.
  176.             *  G is the bank granularity in Kbytes; for instance,  the  Paradise
  177.                has 4K banks.
  178.             *  P is the number of color planes; usually 1 for  256  color  modes
  179.                and 4 for 16 color modes. However, the ATI in 1024x768x16 and the
  180.                S3 in 800x600x16 thru 1280x1024x16 uses 1 plane and 2 pixels/byte;
  181.                this is sensed when colors=16 and planes=1.
  182.             *  B is the number of 64K banks this mode can use; 0 => use banks
  183.                from 3 above.
  184.             *  WinA, WinB apply only to config files with VESA chip. Generally
  185.                only WinA is used, but a few boards use both.
  186.  
  187.           The modes may be entered in any order, but listing all  the  VGA  (256
  188.           color) modes followed by the EGA (16 color)  modes,  followed  by  the
  189.           Sierra DAC modes makes sense, and the mode numbers can  be  determined
  190.           by looking at the configuration file.
  191.  
  192.           For specifying the mode N from the command line (/mN option for VPIC),
  193.           the mode numbers increase with increasing resolution and can be  found
  194.           from the menu screen as follows:
  195.             *  The 256 color modes are numbered 1 thru 10 starting at 320x200.
  196.             *  The 16 color modes are numbered 11 thru 20 starting at 640x350.
  197.             *  For hi-color modes use 21, 31, 41 for 15, 16 and 24 bits/pixel.
  198.           If you are configured with a hi-color DAC, 16-32 bits/pixel  pictures
  199.           will be shown in hi-color if you pick a resolution supported  by  the
  200.           board for hi-color.  As an example,  the Cirrus 54xx boards can  show
  201.           640x480 in 32K, 64K, or 16.7M colors,  and  800x600  in  32K  or  64K
  202.           colors. If you view a 640x480 TIFF 24 file,  it will be shown in 16.7
  203.           million colors (24 bits/pixel), but you can use Alt F7 from the  menu
  204.           to lock 32K or 64K colors or even 256 colors (using color reduction).
  205.           Alt F6 lists the graphics modes VPIC thinks  you  have,  either  from
  206.           VESA or the configuration file info.
  207.  
  208.