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

NAME

6       radeon - ATI/AMD RADEON video driver
7

SYNOPSIS

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

DESCRIPTION

16       radeon  is an Xorg driver for ATI/AMD RADEON-based video cards with the
17       following features:
18
19       · Full support for 8-, 15-, 16- and 24-bit pixel depths, and for 30-bit
20         depth on Linux 3.16 and later;
21       · RandR 1.2 and RandR 1.3 support;
22       · Full EXA 2D acceleration;
23       · Textured  XVideo acceleration including anti-tearing support (Bicubic
24         filtering  only  available  on  R/RV3xx,  R/RV/RS4xx,  R/RV5xx,   and
25         RS6xx/RS740);
26       · 3D acceleration;
27

SUPPORTED HARDWARE

29       The  radeon driver supports PCI, AGP, and PCIe video cards based on the
30       following ATI/AMD chips (note: list is non-exhaustive):
31
32       R100        Radeon 7200
33       RV100       Radeon 7000(VE), M6, RN50/ES1000
34       RS100       Radeon IGP320(M)
35       RV200       Radeon 7500, M7, FireGL 7800
36       RS200       Radeon IGP330(M)/IGP340(M)
37       RS250       Radeon Mobility 7000 IGP
38       R200        Radeon 8500, 9100, FireGL 8800/8700
39       RV250       Radeon 9000PRO/9000, M9
40       RV280       Radeon 9200PRO/9200/9200SE/9250, M9+
41       RS300       Radeon 9100 IGP
42       RS350       Radeon 9200 IGP
43       RS400/RS480 Radeon XPRESS 200(M)/1100 IGP
44       R300        Radeon 9700PRO/9700/9500PRO/9500/9600TX, FireGL X1/Z1
45       R350        Radeon 9800PRO/9800SE/9800, FireGL X2
46       R360        Radeon 9800XT
47       RV350       Radeon 9600PRO/9600SE/9600/9550, M10/M11, FireGL T2
48       RV360       Radeon 9600XT
49       RV370       Radeon X300, M22
50       RV380       Radeon X600, M24
51       RV410       Radeon X700, M26 PCIe
52       R420        Radeon X800 AGP
53       R423/R430   Radeon X800, M28 PCIe
54       R480/R481   Radeon X850 PCIe/AGP
55       RV505/RV515/RV516/RV550
56                   Radeon X1300/X1400/X1500/X1550/X2300
57       R520        Radeon X1800
58       RV530/RV560 Radeon X1600/X1650/X1700
59       RV570/R580  Radeon X1900/X1950
60       RS600/RS690/RS740
61                   Radeon X1200/X1250/X2100
62       R600        Radeon HD 2900
63       RV610/RV630 Radeon HD 2400/2600/2700/4200/4225/4250
64       RV620/RV635 Radeon HD 3410/3430/3450/3470/3650/3670
65       RV670       Radeon HD 3690/3850/3870
66       RS780/RS880 Radeon HD 3100/3200/3300/4100/4200/4250/4290
67       RV710/RV730 Radeon                                                   HD
68                   4330/4350/4550/4650/4670/5145/5165/530v/545v/560v/565v
69       RV740/RV770/RV790
70                   Radeon HD 4770/4730/4830/4850/4860/4870/4890
71       CEDAR       Radeon HD 5430/5450/6330/6350/6370
72       REDWOOD     Radeon HD 5550/5570/5650/5670/5730/5750/5770/6530/6550/6570
73       JUNIPER     Radeon HD 5750/5770/5830/5850/5870/6750/6770/6830/6850/6870
74       CYPRESS     Radeon HD 5830/5850/5870
75       HEMLOCK     Radeon HD 5970
76       PALM        Radeon HD 6310/6250
77       SUMO/SUMO2  Radeon HD 6370/6380/6410/6480/6520/6530/6550/6620
78       BARTS       Radeon HD 6790/6850/6870/6950/6970/6990
79       TURKS       Radeon HD 6570/6630/6650/6670/6730/6750/6770
80       CAICOS      Radeon HD 6430/6450/6470/6490
81       CAYMAN      Radeon HD 6950/6970/6990
82       ARUBA       Radeon HD 7000 series
83       TAHITI      Radeon HD 7900 series
84       PITCAIRN    Radeon HD 7800 series
85       VERDE       Radeon HD 7700 series
86       OLAND       Radeon HD 8000 series
87       HAINAN      Radeon HD 8000 series
88       BONAIRE     Radeon HD 7790 series
89       KAVERI      KAVERI APUs
90       KABINI      KABINI APUs
91       HAWAII      Radeon R9 series
92       MULLINS     MULLINS APUs
93

CONFIGURATION DETAILS

95       Please  refer  to xorg.conf(5) for general configuration details.  This
96       section only covers configuration details specific to this driver.
97
98       The following driver Options are supported:
99
100       Option "SWcursor" "boolean"
101              Selects software cursor.  The default is off.
102
103       Option "Accel" "boolean"
104              Enables or disables all hardware acceleration.
105              The default is on.
106
107       Option "ZaphodHeads" "string"
108              Specify the RandR output(s) to use with zaphod mode for  a  par‐
109              ticular  driver  instance.   If you use this option you must use
110              this option for all instances of the driver.
111              For  example:  Option  "ZaphodHeads"  "LVDS,VGA-0"  will  assign
112              xrandr outputs LVDS and VGA-0 to this instance of the driver.
113
114       Option "ColorTiling" "boolean"
115              The framebuffer can be addressed either in linear or tiled mode.
116              Tiled mode can provide significant performance benefits with  3D
117              applications.   Tiling will be disabled if the drm module is too
118              old or if the current display configuration does not support it.
119              On R600+ this enables 1D tiling mode.
120              The  default  value  is on for R/RV3XX, R/RV4XX, R/RV5XX, RS6XX,
121              RS740, R/RV6XX, R/RV7XX, RS780, RS880, EVERGREEN, CAYMAN, ARUBA,
122              Southern  Islands,  and  Sea  Islands  and  off  for R/RV/RS1XX,
123              R/RV/RS2XX, RS3XX, and RS690/RS780/RS880 when fast fb feature is
124              enabled.
125
126       Option "ColorTiling2D" "boolean"
127              The  framebuffer  can  be  addressed either in linear, 1D, or 2D
128              tiled modes. 2D tiled mode can provide  significant  performance
129              benefits  over  1D  tiling with 3D applications.  Tiling will be
130              disabled if the drm module is too old or if the current  display
131              configuration  does  not  support  it. KMS ColorTiling2D is only
132              supported on R600 and newer chips and requires Mesa 9.0 or newer
133              for R6xx-ARUBA, Mesa 9.2 or newer for Southern Islands, and Mesa
134              10.1 or newer for Sea Islands.
135              The default value is on  for  R/RV6XX,  R/RV7XX,  RS780,  RS880,
136              EVERGREEN, CAYMAN, ARUBA, Southern Islands, and Sea Islands.
137
138       Option "DRI" "integer"
139              Define  the  maximum  level of DRI to enable. Valid values are 2
140              for DRI2 or 3 for DRI3.  The default is 3 for DRI3 if  the  Xorg
141              version  is  >=  1.18.3  and  glamor is enabled, otherwise 2 for
142              DRI2. Note: DRI3 may not work correctly in all cases  with  EXA,
143              enable at your own risk.
144
145       Option "EnablePageFlip" "boolean"
146              Enable  DRI2 page flipping.  The default is on.  Pageflipping is
147              supported on all radeon hardware.
148
149       Option "TearFree" "boolean"
150              Set the default value of  the  per-output  'TearFree'  property,
151              which  controls tearing prevention using the hardware page flip‐
152              ping mechanism. TearFree is on for any CRTC associated with  one
153              or  more  outputs with TearFree on. Two separate scanout buffers
154              need to be allocated for each CRTC with  TearFree  on.  If  this
155              option  is  set,  the  default  value of the property is 'on' or
156              'off' accordingly. If this option isn't set, the  default  value
157              of  the  property  is  auto, which means that TearFree is on for
158              rotated outputs, outputs with RandR transforms applied  and  for
159              RandR 1.4 slave outputs, otherwise off.
160
161       Option "AccelMethod" "string"
162              Chooses  between  available  acceleration  architectures.  Valid
163              values are EXA (for pre-TAHITI GPUs) and  glamor  (for  R300  or
164              higher).  The default is glamor with R600 or newer (with Xorg >=
165              1.18.3, otherwise with TAHITI or newer), otherwise EXA.
166
167
168       The following driver Options are supported for glamor :
169
170       Option "ShadowPrimary" "boolean"
171              This option enables a so-called "shadow primary" buffer for fast
172              CPU  access to pixel data, and separate scanout buffers for each
173              display controller (CRTC).  This  may  improve  performance  for
174              some 2D workloads, potentially at the expense of other (e.g. 3D,
175              video) workloads.  Note in particular that enabling this  option
176              currently disables page flipping.  The default is off.
177
178
179       The following driver Options are supported for EXA :
180
181       Option "EXAVSync" "boolean"
182              This  option  attempts  to  avoid tearing by stalling the engine
183              until the display controller has passed the destination  region.
184              It reduces tearing at the cost of performance and has been known
185              to cause instability on some chips.  The default is off.
186
187       Option "EXAPixmaps" "boolean"
188              Under KMS, to avoid thrashing pixmaps in/out of VRAM on low mem‐
189              ory  cards, we use a heuristic based on VRAM amount to determine
190              whether to allow EXA to  use  VRAM  for  non-essential  pixmaps.
191              This option allows us to override the heuristic.  The default is
192              on with > 32MB VRAM, off with < 32MB or when fast fb feature  is
193              enabled for RS690/RS780/RS880.
194
195       Option "SwapbuffersWait" "boolean"
196              This option controls the behavior of glXSwapBuffers and glXCopy‐
197              SubBufferMESA calls by GL applications.  If enabled,  the  calls
198              will  avoid  tearing by making sure the display scanline is out‐
199              side of the area to be copied before the copy occurs.   If  dis‐
200              abled, no scanline synchronization is performed, meaning tearing
201              will likely occur.  Note that  when  enabled,  this  option  can
202              adversely  affect  the  framerate  of  applications  that render
203              frames at less than refresh rate.
204
205              The default value is on.
206
207

TEXTURED VIDEO ATTRIBUTES

209       The driver supports the following X11 Xv attributes for Textured Video.
210       You can use the "xvattr" tool to query/set those attributes at runtime.
211
212
213       XV_VSYNC
214              XV_VSYNC  is  used  to control whether textured adapter synchro‐
215              nizes the screen update to the monitor vertical refresh to elim‐
216              inate  tearing.   It  has  two values: 'off'(0) and 'on'(1). The
217              default is 'on'(1).
218
219
220       XV_CRTC
221              XV_CRTC is used to control which display controller  (crtc)  the
222              textured  adapter  synchronizes  the  screen  update  with  when
223              XV_VSYNC is enabled.  The default, 'auto'(-1), will sync to  the
224              display  controller  that  more of the video is on; when this is
225              ambiguous, the display controller associated with the RandR pri‐
226              mary  output  is preferred.  This attribute is useful for things
227              like clone mode where the user can  best  decide  which  display
228              should be synced.  The default is 'auto'(-1).
229
230
231       XV_BICUBIC
232              XV_BICUBIC  is  used  to control whether textured adapter should
233              apply a bicubic filter to smooth the output. It has  three  val‐
234              ues:  'off'(0),  'on'(1)  and 'auto'(2). 'off' means never apply
235              the filter, 'on' means always apply the filter and 'auto'  means
236              apply  the  filter  only if the X and Y sizes are scaled to more
237              than double to avoid blurred output.  Bicubic filtering  is  not
238              currently  compatible  with  other  Xv attributes like hue, con‐
239              trast, and  brightness,  and  must  be  disabled  to  use  those
240              attributes.  The default is 'off'(0).
241
242

SEE ALSO

244       Xorg(1), xorg.conf(5), Xserver(1), X(7)
245
246        1. Wiki page:
247           https://www.x.org/wiki/radeon
248
249        2. Overview about radeon development code:
250           https://cgit.freedesktop.org/xorg/driver/xf86-video-ati/
251
252        3. Mailing list:
253           https://lists.freedesktop.org/mailman/listinfo/amd-gfx
254
255        4. IRC channel:
256           #radeon on irc.freenode.net
257
258        5. Query the bugtracker for radeon bugs:
259           https://bugs.freedesktop.org/query.cgi?product=xorg&compo‐
260           nent=Driver/Radeon
261
262        6. Submit bugs & patches:
263           https://bugs.freedesktop.org/enter_bug.cgi?product=xorg&compo‐
264           nent=Driver/Radeon
265
266

AUTHORS

268       Authors include:
269       Rickard E. (Rik) Faith   faith@precisioninsight.com
270       Kevin E. Martin          kem@freedesktop.org
271       Alan Hourihane           alanh@fairlite.demon.co.uk
272       Marc Aurele La France    tsi@xfree86.org
273       Benjamin Herrenschmidt   benh@kernel.crashing.org
274       Michel Dänzer            michel@daenzer.net
275       Alex Deucher             alexdeucher@gmail.com
276       Bogdan D.                bogdand@users.sourceforge.net
277       Eric Anholt              eric@anholt.net
278
279
280
281X Version 11                 xf86-video-ati 18.1.0                   RADEON(4)
Impressum