Table of Contents
r128 - ATI Rage 128 video driver
r128 is an XFree86 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.
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.
Please refer to XF86Config(5)
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 "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
- Option "Display" "string"
- Select display mode for devices which
support flat panels. Supported modes are:
"FP" - use flat panel;
- 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 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"
- Enable or disable use of an OS-specific framebuffer device interface
(which is not supported on all OSs). See fbdevhw(4)
for further information.
- 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.
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.
Rickard E. (Rik) Faith email@example.com
Kevin E. Martin firstname.lastname@example.org