home *** CD-ROM | disk | FTP | other *** search
/ BURKS 2 / BURKS_AUG97.ISO / BURKS / LINUX / HOWTO / mini / xntbook.txt < prev    next >
Text File  |  1997-07-07  |  46KB  |  1,094 lines
  1. ===============================================================================
  2. ======                                                             ============
  3. ======  XFree86 3.1 and WD90C24 Notebook Video Chipset mini-HOWTO  ============
  4. ======                                                             ============
  5. ===============================================================================
  6.  
  7.  
  8.         author: Darin Ernst (dernst@pppl.gov, darin@castle.net)     
  9.  
  10.                       version: 0.96  8/10/95
  11.                       first version: 1/95
  12.  
  13.  
  14.  
  15.   For more info and updates, see the WEB site 
  16.                       http://www.castle.net/~darin
  17.  
  18. Applicability: 
  19.  
  20.   This version of the HOWTO applies to XFree86 3.1.2  and earlier. 
  21.   New versions will be available for new versions of XFree86 
  22.   when necessary.  
  23.  
  24. Acknowledgement:
  25.  
  26.   Thanks to all those who have emailed me and posted messages on 
  27.   this topic! It is now possible run X-Windows on notebook computers 
  28.   and take full advantage of the hardware (at least at 8 bits 
  29.   per pixel). 
  30.  
  31. Purpose: 
  32.  
  33.   This document gives instructions for configuring XFree86 
  34.   on notebooks with the WD90C24 family chipsets.  It also describes 
  35.   known bugs and workarounds if available.  The content comes 
  36.   from communication with other users and my participation in the 
  37.   development of the new WD90C24 driver.
  38.  
  39. Special Note:  
  40.  
  41.   A driver developed specifically for the WD90C24 is available for 
  42.   the first time in XFree86 release 3.1.2 (released around July 31).
  43.   The sections of this  HOWTO are labelled according to whether or 
  44.   not they apply to:
  45.  
  46.       (OLD) 3.1.1 and earlier; and  
  47.       (NEW) 3.1.2 and later.  
  48.  
  49.   Most of the FAQ on workarounds for old problems is now obsolete, 
  50.   but instructions are provided for taking advantage of new features in 
  51.   XFree86 3.1.2 in the (NEW) sections.
  52.  
  53.  
  54. Copyright D. Ernst, 1995:                                      
  55.  
  56.    Permission to redistribute this file *UNCHANGED* is granted for 
  57.    non-commercial use only. No permission is granted for the use of this 
  58.    file in sales promotions or for purposes of profit. In addition, any 
  59.    translations, derivative, or aggregate works that make use of information 
  60.    in this file must contain this copyright notice and be accompanied by this 
  61.    file unchanged.
  62.  
  63.    All translations, derivative works, or aggregate works incorporating this 
  64.    document must be covered under this copyright notice. That is, you may not 
  65.    produce a derivative work from this document and impose additional 
  66.    restrictions on its distribution. Exceptions to these rules may be granted 
  67.    under certain circumstances only by written permission of the author.
  68.  
  69.    If this copyright notice is not included with translations, derivative works,
  70.    or aggregate works, then no permission to use information in this file is 
  71.    granted for any purpose. Permission is granted for the redistribution of 
  72.    this file in whole and complete distributions of the Linux operating system 
  73.    provided it remains unchanged.  Commercial entities wishing to redistribute
  74.    this file or the information contained in it for any other purpose must 
  75.    obtain the written permission of its author.  Any translations, derivative
  76.    works, or aggregate works must be submitted to the author for approval.
  77.  
  78.    All derivative works must also contain the words: "Information provided 
  79.    by the "X-Notebook mini-HOWTO", copyright D. Ernst, 1995.            
  80.  
  81.  
  82. Frequently asked questions:
  83.  
  84. 1) Does XFree86 have a driver for the WD90C24[A,A2] available?
  85.  
  86.    Yes, but only in release 3.1.2 and later. Prior to this, we used
  87.    the driver for the wd90c31 chip to fake it, with a lot of problems
  88.    that are described below.
  89.  
  90.    The long-awaited support for the WD90C24 has been added to the pvga1 driver
  91.    in the XF86_SVGA server by Brad Bosch, during July, 1995.  Extensive testing
  92.    during the developement and suggestions were provided by D. Ernst. The 
  93.    new server has  full support, including programmable clocks, and solves 
  94.    most, if not all of the problems mentioned here for the old server.
  95.   
  96.    The new server was released around July 31, 1995 in version 3.1.2 of of 
  97.    XFree86.  It is  capable of 1152x900 interlaced as well as 1024x768 
  98.    non-interlaced VESA at 72Hz refresh, automatically utilizing the 
  99.    full 1MB of VRAM.  It also provides users with the ability to program
  100.    the dotclocks. The new driver does not support 16bpp, however, which
  101.    is possible at low resolutions. Someone is working on this.
  102.  
  103.    The following is an excerpt from the file /usr/lib/X11/doc/README.WstDig 
  104.    that describes the new driver (sections written by B. Bosch and D. Ernst):
  105.  
  106.   New WD90C24 features
  107.  
  108.   These next three sections apply only if you have a WD90C24, WD90C24a,
  109.   or WD90C24a2 and don't specify some other chipset in your XF86Config
  110.   file.  The SVGA pvga1 driver now recognizes the wd90c24 family as
  111.   different from the WD90C30 and seems to resolve most of the problems
  112.   people encountered when these chips were treated as WD90C3X.  The new
  113.   code has the following features:
  114.  
  115.      o  Locks the shadow registers at appropriate times; This should
  116.         prevent scrambled displays after exiting X with dual scan
  117.         screens when simultaneous or LCD display mode is selected.  The
  118.         code does depend somewhat on the behavior of the BIOS regarding
  119.         when it locks the shadow registers, etc.
  120.  
  121.      o  Allows (forces) the use of a full 1 Meg VRAM for dual scan
  122.         systems when the server is started while external CRT only
  123.         display is in operation.  This allows 1024x768x8 resolution.
  124.  
  125.      o  If the XF86Config file specifies a virtual screen size which
  126.         requires more than 512 K VRAM when the server is started on a
  127.         Dual Scan LCD, the driver will force the virtual size to
  128.         640x480.  This eliminates the need to edit the XF86Config file
  129.         when you switch from 1024x resolution on the CRT, to or from the
  130.         LCD screen.  If no virtual size is specified, the result will be
  131.         800x600 virtual in LCD modes and 1024x768 in CRT only mode (so
  132.         you have a choice).
  133.  
  134.      o  Note that on dual scan systems, you must still exit X, switch
  135.         displays, and restart X to change to/from CRT only with 1 Meg
  136.         videoram.  This is because once the server starts, you can't
  137.         change the virtual screen size.  There is no way around this
  138.         with the current server and the WD90C24 with dual scan displays.
  139.         The WD90C24 requires half the videoram be used for a ``Frame
  140.         buffer'' when the dual scan LCD is in use.
  141.  
  142.      o  The new server uses the accelerated features of the WD90C24a.
  143.         It is not clear from the data book if the WD90C24 also supports
  144.         ALL the required features.  Several people have stated that the
  145.         WD90C24 is not accelerated, but the differences section of the
  146.         WD90c24a data book implies that they ARE all three accelerated.
  147.         The differences documented with regard to acceleration are with
  148.         the type of line drawing the hardware does; Only the newer chips
  149.         support the type of line drawing that MS windows wants.  This
  150.         may be what has caused the confusion since the accelerated
  151.         windows drivers may only support the WD90c24a chips.  If this
  152.         turns out to be a problem with the WD90C24, acceleration can be
  153.         disabled by adding the line:
  154.               Option "noaccel"
  155.          to the Device section of the XF86Config file.
  156.  
  157.      o  Although the new server does not support programmable clocks in
  158.         the same way as some of the other servers, 8 of the 17 clocks
  159.         may be set to (almost) any value via the Clocks line. It also
  160.         supports options for adjusting the VRAM clock.
  161.  
  162.  
  163.  
  164. 2)(OLD) How can I use the XF86_SVGA server under XFree 86 3.1.1 and earlier?
  165.  
  166.    Most of us fake it by selecting the WD90C31 (or 30) accelerated chipset
  167.    using the XF86_SVGA server.  X -probeonly detects the WD90C24, but
  168.    this is not implemented with accelerated features in XFree86 3.1.1. and 
  169.    earlier.  The WD90C24A and A2 are sort of compatible with the WD