1R128(4)                    Kernel Interfaces Manual                    R128(4)
2
3
4

NAME

6       r128 - ATI Rage 128 video driver
7

SYNOPSIS

9       Section "Device"
10         Identifier "devname"
11         Driver "r128"
12         ...
13       EndSection
14

DESCRIPTION

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

SUPPORTED HARDWARE

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

CONFIGURATION DETAILS

30       Please  refer  to xorg.conf(5) for general configuration details.  This
31       section only covers configuration details specific to this driver.
32
33       The driver auto-detects all device information necessary to  initialize
34       the  card.   However, if you have problems with auto-detection, you can
35       specify:
36
37           VideoRam - in kilobytes
38           MemBase  - physical address of the linear framebuffer
39           IOBase   - physical address of the MMIO registers
40           ChipID   - PCI DEVICE ID
41
42       In addition, the following driver Options are supported:
43
44       Option "SWcursor" "boolean"
45              Selects software cursor.  The default is off.
46
47       Option "NoAccel" "boolean"
48              Enables or disables all hardware acceleration.  The  default  is
49              to enable hardware acceleration.
50
51       Option "Dac6Bit" "boolean"
52              Enables  or  disables the use of 6 bits per color component when
53              in 8 bpp mode (emulates VGA mode).  By default, all 8  bits  per
54              color component are used.  The default is off.
55
56       Option "VideoKey" "integer"
57              This overrides the default pixel value for the YUV video overlay
58              key.  The default value is undefined.
59
60       Option "Display" "string"
61              Select display mode for devices which support flat panels.  Sup‐
62              ported modes are:
63
64              "FP" - use flat panel;
65
66              "CRT" - use cathode ray tube;
67
68              "Mirror" - use both FP and CRT;
69
70              "BIOS" - use mode as configured in the BIOS.
71
72              The default is FP.
73
74
75       The following Options are mostly important for non-x86 architectures:
76
77       Option "ProgramFPRegs" "boolean"
78              Enable  or  disable  programming  of  the  flat panel registers.
79              Beware that this may damage your panel, so use this at your  own
80              risk.  The default depends on the device.
81
82       Option "PanelWidth" "integer"
83
84       Option "PanelHeight" "integer"
85              Override  the  flat panel dimensions in pixels. They are used to
86              program the flat panel registers and normally  determined  using
87              the  video card BIOS. If the wrong dimensions are used, the sys‐
88              tem may hang.
89
90       Option "UseFBDev" "boolean"
91              Enable or disable  use  of  an  OS-specific  framebuffer  device
92              interface  (which  is not supported on all OSs).  See fbdevhw(4)
93              for further information.  Default: on for PowerPC, off for other
94              architectures.
95
96       Option "DMAForXv" "boolean"
97              Try  or  don't  try to use DMA for Xv image transfers. This will
98              reduce CPU usage when playing big  videos  like  DVDs,  but  may
99              cause instabilities.  Default: off.
100
101
102       The following additional Options are supported:
103
104       Option "ShowCache" "boolean"
105              Enable or disable viewing offscreen cache memory.  A development
106              debug option.  Default: off.
107
108       Option "VGAAccess" "boolean"
109              Tell the driver if it can do legacy VGA IOs to the card. This is
110              necessary  for properly resuming consoles when in VGA text mode,
111              but shouldn't be if the console is using radeonfb or some  other
112              graphic  mode  driver.  Some  platforms like PowerPC have issues
113              with those, and they aren't necessary unless  you  have  a  real
114              text  mode  in  console. The default is off on PowerPC and SPARC
115              and on on other architectures.
116
117
118       Dualhead Note: The video BIOS on some laptops interacts strangely  with
119       dualhead.  This can result in flickering and problems changing modes on
120       crtc2.  If you experience these problems  try  toggling  your  laptop's
121       video  output  switch (e.g., fn-f7, etc.) prior to starting X or switch
122       to another VT and back.
123
124

SEE ALSO

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

AUTHORS

129       Rickard E. (Rik) Faith   faith@precisioninsight.com
130       Kevin E. Martin          kevin@precisioninsight.com
131
132
133
134X Version 11                 xf86-video-r128 6.8.1                     R128(4)
Impressum