r128(4)

NAME

   r128 - ATI Rage 128 video driver

SYNOPSIS

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

DESCRIPTION

   r128 is an Xorg driver for ATI Rage 128 based video cards.  It contains
   full  support  for  8,  15,  16  and  24  bit  pixel  depths,  hardware
   acceleration  of drawing primitives, hardware cursor, video modes up to
   1800x1440 @ 70Hz, doublescan modes (e.g., 320x200 and  320x240),  gamma
   correction  at  all  pixel  depths,  a  fully programming dot clock and
   robust text mode restoration for VT switching.  Dualhead  is  supported
   on M3/M4 mobile chips.

SUPPORTED HARDWARE

   The  r128  driver supports all ATI Rage 128 based video cards including
   the Rage Fury AGP 32MB, the XPERT 128 AGP 16MB and  the  XPERT  99  AGP
   8MB.

CONFIGURATION DETAILS

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

   The driver auto-detects all device information necessary to  initialize
   the  card.   However, if you have problems with auto-detection, you can
   specify:

       VideoRam - in kilobytes
       MemBase  - physical address of the linear framebuffer
       IOBase   - physical address of the MMIO registers
       ChipID   - PCI DEVICE ID

   In addition, the following driver Options are supported:

   Option "SWcursor" "boolean"
          Selects software cursor.  The default is off.

   Option "NoAccel" "boolean"
          Enables or disables all hardware acceleration.  The  default  is
          to enable hardware acceleration.

   Option "EnablePageFlip" "boolean"
          Enable  page  flipping  for  3D acceleration. This will increase
          performance but not work correctly in some rare cases, hence the
          default is off.

   Option "RenderAccel" "boolean"
          Enables  or  disables  hardware Render acceleration.  It is only
          supported when using EXA acceleration and DRI.  The  default  is
          to enable Render acceleration.

   Option "AccelMethod" "string"
          Chooses  between  available  acceleration  architectures.  Valid
          options are XAA and EXA.  XAA is  the  traditional  acceleration
          architecture  and support for it is very stable.  EXA is a newer
          acceleration architecture with better performance for the Render
          and Composite extensions.  The default is XAA.

   Option "Dac6Bit" "boolean"
          Enables  or  disables the use of 6 bits per color component when
          in 8 bpp mode (emulates VGA mode).  By default, all 8  bits  per
          color component are used.  The default is off.

   Option "VideoKey" "integer"
          This overrides the default pixel value for the YUV video overlay
          key.  The default value is undefined.

   The following Options are mostly important for non-x86 architectures:

   Option "ProgramFPRegs" "boolean"
          Enable or disable  programming  of  the  flat  panel  registers.
          Beware  that this may damage your panel, so use this at your own
          risk.  The default depends on the device.

   Option "PanelWidth" "integer"

   Option "PanelHeight" "integer"
          Override the flat panel dimensions in pixels. They are  used  to
          program  the  flat panel registers and normally determined using
          the video card BIOS. If  the  wrong  dimensions  are  used,  the
          system may hang.

   Option "UseFBDev" "boolean"
          Enable  or  disable  use  of  an  OS-specific framebuffer device
          interface (which is not supported on all OSs).   See  fbdevhw(4)
          for further information.  Default: on for PowerPC, off for other
          architectures.

   Option "DMAForXv" "boolean"
          Try or don't try to use DMA for Xv image  transfers.  This  will
          reduce  CPU  usage  when  playing  big videos like DVDs, but may
          cause instabilities.  Default: off.

   The following additional Options are supported:

   Option "ShowCache" "boolean"
          Enable or disable viewing offscreen cache memory.  A development
          debug option.  Default: off.

   Option "VGAAccess" "boolean"
          Tell the driver if it can do legacy VGA IOs to the card. This is
          necessary for properly resuming consoles when in VGA text  mode,
          but  shouldn't be if the console is using radeonfb or some other
          graphic mode driver. Some platforms  like  PowerPC  have  issues
          with  those,  and  they  aren't necessary unless you have a real
          text mode in console. The default is off on  PowerPC  and  SPARC
          and on on other architectures.

   Dualhead  Note: The video BIOS on some laptops interacts strangely with
   dualhead.  This can result in flickering and problems changing modes on
   crtc2.   If  you  experience  these problems try toggling your laptop's
   video output switch (e.g., fn-f7, etc.) prior to starting X  or  switch
   to another VT and back.

SEE ALSO

   Xorg(1), xorg.conf(5), Xserver(1), X(7)

AUTHORS

   Rickard E. (Rik) Faith   faith@precisioninsight.com
   Kevin E. Martin          kevin@precisioninsight.com

---

Free and Open Source Software