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 "EnablePageFlip" "boolean"
52              Enable  page  flipping  for  3D acceleration. This will increase
53              performance but not work correctly in some rare cases, hence the
54              default is off.
55
56       Option "RenderAccel" "boolean"
57              Enables  or  disables  hardware Render acceleration.  It is only
58              supported when using EXA acceleration and DRI.  The  default  is
59              to enable Render acceleration.
60
61       Option "AccelMethod" "string"
62              Chooses  between  available  acceleration  architectures.  Valid
63              options are XAA and EXA.  XAA is  the  traditional  acceleration
64              architecture  and support for it is very stable.  EXA is a newer
65              acceleration architecture with better performance for the Render
66              and Composite extensions.  The default is XAA.
67
68       Option "Dac6Bit" "boolean"
69              Enables  or  disables the use of 6 bits per color component when
70              in 8 bpp mode (emulates VGA mode).  By default, all 8  bits  per
71              color component are used.  The default is off.
72
73       Option "VideoKey" "integer"
74              This overrides the default pixel value for the YUV video overlay
75              key.  The default value is undefined.
76
77
78       The following Options are mostly important for non-x86 architectures:
79
80       Option "ProgramFPRegs" "boolean"
81              Enable or disable  programming  of  the  flat  panel  registers.
82              Beware  that this may damage your panel, so use this at your own
83              risk.  The default depends on the device.
84
85       Option "PanelWidth" "integer"
86
87       Option "PanelHeight" "integer"
88              Override the flat panel dimensions in pixels. They are  used  to
89              program  the  flat panel registers and normally determined using
90              the video card BIOS. If the wrong dimensions are used, the  sys‐
91              tem may hang.
92
93       Option "UseFBDev" "boolean"
94              Enable  or  disable  use  of  an  OS-specific framebuffer device
95              interface (which is not supported on all OSs).   See  fbdevhw(4)
96              for further information.  Default: on for PowerPC, off for other
97              architectures.
98
99       Option "DMAForXv" "boolean"
100              Try or don't try to use DMA for Xv image  transfers.  This  will
101              reduce  CPU  usage  when  playing  big videos like DVDs, but may
102              cause instabilities.  Default: off.
103
104
105       The following additional Options are supported:
106
107       Option "ShowCache" "boolean"
108              Enable or disable viewing offscreen cache memory.  A development
109              debug option.  Default: off.
110
111       Option "VGAAccess" "boolean"
112              Tell the driver if it can do legacy VGA IOs to the card. This is
113              necessary for properly resuming consoles when in VGA text  mode,
114              but  shouldn't be if the console is using radeonfb or some other
115              graphic mode driver. Some platforms  like  PowerPC  have  issues
116              with  those,  and  they  aren't necessary unless you have a real
117              text mode in console. The default is off on  PowerPC  and  SPARC
118              and on on other architectures.
119
120
121       Dualhead  Note: The video BIOS on some laptops interacts strangely with
122       dualhead.  This can result in flickering and problems changing modes on
123       crtc2.   If  you  experience  these problems try toggling your laptop's
124       video output switch (e.g., fn-f7, etc.) prior to starting X  or  switch
125       to another VT and back.
126
127

SEE ALSO

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

AUTHORS

132       Rickard E. (Rik) Faith   faith@precisioninsight.com
133       Kevin E. Martin          kevin@precisioninsight.com
134
135
136
137X Version 11                xf86-video-r128 6.10.0                     R128(4)
Impressum