home | help 
R128(4x)								R128(4x)

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 sec-
     tion 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 "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 com-
	    ponent 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.

     Option "Display" "string"
	    Select display mode for devices which support flat panels. Supported
	    modes are:

	    "FP" - use flat panel;

	    "CRT" - use cathode ray tube;

	    "Mirror" - use both FP and CRT;

	    "BIOS" - use mode as configured in the BIOS.

	    The default is FP.

     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  pro-
	    gram  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(4x) 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 instabil-
	    ities.  Default: off.

     The following additional Options are supported:

     Option "ShowCache" "boolean"
	    Enable or disable viewing offscreen cache memory.  A development de-
	    bug 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  architec-
	    tures.

     Dualhead  Note: The video BIOS on some laptops interacts strangely with du-
     alhead.  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), xorgconfig(1), Xserver(1), X(7)

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

X Version 11		      xf86-video-r128 6.8.0			R128(4x)
home | help