savage(4) - NetBSD Manual Pages

SAVAGE(4)                                                            SAVAGE(4)




NAME

       savage - S3 Savage video driver


SYNOPSIS

       Section "Device"
         Identifier "devname"
         Driver "savage"
         ...
       EndSection


DESCRIPTION

       savage  is an XFree86 driver for the S3 Savage family video accelerator
       chips.  The savage driver supports PCI and AGP boards with the  follow-
       ing chips:

       Savage3D        (8a20 and 8a21)

       Savage4         (8a22)

       Savage2000      (9102)

       Savage/MX       (8c10 and 8c11)

       Savage/IX       (8c12 and 8c13)

       ProSavage PM133 (8a25)

       ProSavage KM133 (8a26)

       Twister (ProSavage PN133)
                       (8d01)

       TwisterK (ProSavage KN133)
                       (8d02)

       ProSavage DDR   (8d03)

       ProSavage DDR-K (8d04)


CONFIGURATION DETAILS

       Please  refer to XF86Config(5) for general configuration details.  This
       section only covers configuration details specific to this driver.

       The following driver Options are supported:

       Option "HWCursor" "boolean"

       Option "SWCursor" "boolean"
              These two options interact to specify hardware or software  cur-
              sor.   If the SWCursor option is specified, any HWCursor setting
              is ignored.  Thus, either "HWCursor off" or "SWCursor  on"  will
              force  the  use  of  the software cursor.  On Savage/MX and Sav-
              age/IX chips which are connected to LCDs, a software cursor will
              be forced, because the Savage hardware cursor does not correctly
              track the automatic panel expansion feature.  Default:  hardware
              cursor.

       Option "NoAccel" "boolean"
              Disable   or  enable  acceleration.   Default:  acceleration  is
              enabled.

       Option "Rotate" "CW"

       Option "Rotate" "CCW"
              Rotate the desktop 90  degrees  clockwise  or  counterclockwise.
              This option forces the ShadowFB option on, and disables acceler-
              ation.  Default: no rotation.

       Option "ShadowFB" "boolean"
              Enable or disable use of the  shadow  framebuffer  layer.   This
              option disables acceleration.  Default: off.

       Option "LCDClock" "frequency"
              Override  the maximum dot clock.  Some LCD panels produce incor-
              rect results if they are driven at too fast of a frequency.   If
              UseBIOS  is  on, the BIOS will usually restrict the clock to the
              correct range.  If not, it might be  necessary  to  override  it
              here.  The frequency parameter may be specified as an integer in
              Hz (135750000), or with standard suffixes like "k", "kHz",  "M",
              or "MHz" (as in 135.75MHz).

       Option "UseBIOS" "boolean"
              Enable  or disable use of the video BIOS to change modes.  Ordi-
              narily, the savage driver tries to use the video BIOS to do mode
              switches.   This  generally  produces  the best results with the
              mobile chips (/MX and /IX), since the BIOS knows how  to  handle
              the  critical but unusual timing requirements of the various LCD
              panels supported by the chip.  To do this, the  driver  searches
              through  the  BIOS  mode  list,  looking for the mode which most
              closely matches the XF86Config mode  line.   Some  purists  find
              this  scheme objectionable.  If you would rather have the savage
              driver use your mode line timing exactly, turn off  the  UseBios
              option.  Default: on (use the BIOS).

       Option "ShadowStatus" "boolean"
              Enables  the  use  of a shadow status register.  There is a chip
              bug in the Savage graphics engine that can cause a bus lock when
              reading  the  engine  status  register under heavy load, such as
              when scrolling text or dragging windows.  The bug affects  about
              4%  of  all  Savage users.  If your system hangs regularly while
              scrolling text or dragging windows, try turning this option  on.
              This uses an alternate method of reading the engine status which
              is slightly more expensive, but avoids  the  problem.   Default:
              off (use normal status register).


FILES

       savage_drv.o


SEE ALSO

       XFree86(1), XF86Config(5), xf86config(1), Xserver(1), X(7)


AUTHORS

       Authors   include   Tim   Roberts   (timr@probo.com)   and   Ani  Joshi
       (ajoshi@unixbox.com) for the  4.0  version,  and  Tim  Roberts  and  S.
       Marineau for the 3.3 driver from which this was derived.



4.5.0                               XFree86                          SAVAGE(4)