Linux-2.6.12-rc2
[linux-flexiantxendom0-natty.git] / drivers / char / drm / r128_drv.h
1 /* r128_drv.h -- Private header for r128 driver -*- linux-c -*-
2  * Created: Mon Dec 13 09:51:11 1999 by faith@precisioninsight.com
3  *
4  * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
5  * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
6  * All rights reserved.
7  *
8  * Permission is hereby granted, free of charge, to any person obtaining a
9  * copy of this software and associated documentation files (the "Software"),
10  * to deal in the Software without restriction, including without limitation
11  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12  * and/or sell copies of the Software, and to permit persons to whom the
13  * Software is furnished to do so, subject to the following conditions:
14  *
15  * The above copyright notice and this permission notice (including the next
16  * paragraph) shall be included in all copies or substantial portions of the
17  * Software.
18  *
19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
22  * PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
23  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
24  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
25  * DEALINGS IN THE SOFTWARE.
26  *
27  * Authors:
28  *    Rickard E. (Rik) Faith <faith@valinux.com>
29  *    Kevin E. Martin <martin@valinux.com>
30  *    Gareth Hughes <gareth@valinux.com>
31  *    Michel D�zer <daenzerm@student.ethz.ch>
32  */
33
34 #ifndef __R128_DRV_H__
35 #define __R128_DRV_H__
36
37 /* General customization:
38  */
39 #define DRIVER_AUTHOR           "Gareth Hughes, VA Linux Systems Inc."
40
41 #define DRIVER_NAME             "r128"
42 #define DRIVER_DESC             "ATI Rage 128"
43 #define DRIVER_DATE             "20030725"
44
45 /* Interface history:
46  *
47  * ??  - ??
48  * 2.4 - Add support for ycbcr textures (no new ioctls)
49  * 2.5 - Add FLIP ioctl, disable FULLSCREEN.
50  */
51 #define DRIVER_MAJOR            2
52 #define DRIVER_MINOR            5
53 #define DRIVER_PATCHLEVEL       0
54
55
56 #define GET_RING_HEAD(dev_priv)         R128_READ( R128_PM4_BUFFER_DL_RPTR )
57
58 typedef struct drm_r128_freelist {
59         unsigned int age;
60         drm_buf_t *buf;
61         struct drm_r128_freelist *next;
62         struct drm_r128_freelist *prev;
63 } drm_r128_freelist_t;
64
65 typedef struct drm_r128_ring_buffer {
66         u32 *start;
67         u32 *end;
68         int size;
69         int size_l2qw;
70
71         u32 tail;
72         u32 tail_mask;
73         int space;
74
75         int high_mark;
76 } drm_r128_ring_buffer_t;
77
78 typedef struct drm_r128_private {
79         drm_r128_ring_buffer_t ring;
80         drm_r128_sarea_t *sarea_priv;
81
82         int cce_mode;
83         int cce_fifo_size;
84         int cce_running;
85
86         drm_r128_freelist_t *head;
87         drm_r128_freelist_t *tail;
88
89         int usec_timeout;
90         int is_pci;
91         unsigned long phys_pci_gart;
92         dma_addr_t bus_pci_gart;
93         unsigned long cce_buffers_offset;
94
95         atomic_t idle_count;
96
97         int page_flipping;
98         int current_page;
99         u32 crtc_offset;
100         u32 crtc_offset_cntl;
101
102         u32 color_fmt;
103         unsigned int front_offset;
104         unsigned int front_pitch;
105         unsigned int back_offset;
106         unsigned int back_pitch;
107
108         u32 depth_fmt;
109         unsigned int depth_offset;
110         unsigned int depth_pitch;
111         unsigned int span_offset;
112
113         u32 front_pitch_offset_c;
114         u32 back_pitch_offset_c;
115         u32 depth_pitch_offset_c;
116         u32 span_pitch_offset_c;
117
118         drm_local_map_t *sarea;
119         drm_local_map_t *mmio;
120         drm_local_map_t *cce_ring;
121         drm_local_map_t *ring_rptr;
122         drm_local_map_t *agp_textures;
123 } drm_r128_private_t;
124
125 typedef struct drm_r128_buf_priv {
126         u32 age;
127         int prim;
128         int discard;
129         int dispatched;
130         drm_r128_freelist_t *list_entry;
131 } drm_r128_buf_priv_t;
132
133                                 /* r128_cce.c */
134 extern int r128_cce_init( DRM_IOCTL_ARGS );
135 extern int r128_cce_start( DRM_IOCTL_ARGS );
136 extern int r128_cce_stop( DRM_IOCTL_ARGS );
137 extern int r128_cce_reset( DRM_IOCTL_ARGS );
138 extern int r128_cce_idle( DRM_IOCTL_ARGS );
139 extern int r128_engine_reset( DRM_IOCTL_ARGS );
140 extern int r128_fullscreen( DRM_IOCTL_ARGS );
141 extern int r128_cce_buffers( DRM_IOCTL_ARGS );
142
143 extern void r128_freelist_reset( drm_device_t *dev );
144
145 extern int r128_wait_ring( drm_r128_private_t *dev_priv, int n );
146
147 extern int r128_do_cce_idle( drm_r128_private_t *dev_priv );
148 extern int r128_do_cleanup_cce( drm_device_t *dev );
149
150 extern int r128_driver_vblank_wait(drm_device_t *dev, unsigned int *sequence);
151
152 extern irqreturn_t r128_driver_irq_handler( DRM_IRQ_ARGS );
153 extern void r128_driver_irq_preinstall( drm_device_t *dev );
154 extern void r128_driver_irq_postinstall( drm_device_t *dev );
155 extern void r128_driver_irq_uninstall( drm_device_t *dev );
156 extern void r128_driver_pretakedown(drm_device_t *dev);
157 extern void r128_driver_prerelease(drm_device_t *dev, DRMFILE filp);
158
159 /* Register definitions, register access macros and drmAddMap constants
160  * for Rage 128 kernel driver.
161  */
162
163 #define R128_AUX_SC_CNTL                0x1660
164 #       define R128_AUX1_SC_EN                  (1 << 0)
165 #       define R128_AUX1_SC_MODE_OR             (0 << 1)
166 #       define R128_AUX1_SC_MODE_NAND           (1 << 1)
167 #       define R128_AUX2_SC_EN                  (1 << 2)
168 #       define R128_AUX2_SC_MODE_OR             (0 << 3)
169 #       define R128_AUX2_SC_MODE_NAND           (1 << 3)
170 #       define R128_AUX3_SC_EN                  (1 << 4)
171 #       define R128_AUX3_SC_MODE_OR             (0 << 5)
172 #       define R128_AUX3_SC_MODE_NAND           (1 << 5)
173 #define R128_AUX1_SC_LEFT               0x1664
174 #define R128_AUX1_SC_RIGHT              0x1668
175 #define R128_AUX1_SC_TOP                0x166c
176 #define R128_AUX1_SC_BOTTOM             0x1670
177 #define R128_AUX2_SC_LEFT               0x1674
178 #define R128_AUX2_SC_RIGHT              0x1678
179 #define R128_AUX2_SC_TOP                0x167c
180 #define R128_AUX2_SC_BOTTOM             0x1680
181 #define R128_AUX3_SC_LEFT               0x1684
182 #define R128_AUX3_SC_RIGHT              0x1688
183 #define R128_AUX3_SC_TOP                0x168c
184 #define R128_AUX3_SC_BOTTOM             0x1690
185
186 #define R128_BRUSH_DATA0                0x1480
187 #define R128_BUS_CNTL                   0x0030
188 #       define R128_BUS_MASTER_DIS              (1 << 6)
189
190 #define R128_CLOCK_CNTL_INDEX           0x0008
191 #define R128_CLOCK_CNTL_DATA            0x000c
192 #       define R128_PLL_WR_EN                   (1 << 7)
193 #define R128_CONSTANT_COLOR_C           0x1d34
194 #define R128_CRTC_OFFSET                0x0224
195 #define R128_CRTC_OFFSET_CNTL           0x0228
196 #       define R128_CRTC_OFFSET_FLIP_CNTL       (1 << 16)
197
198 #define R128_DP_GUI_MASTER_CNTL         0x146c
199 #       define R128_GMC_SRC_PITCH_OFFSET_CNTL   (1    <<  0)
200 #       define R128_GMC_DST_PITCH_OFFSET_CNTL   (1    <<  1)
201 #       define R128_GMC_BRUSH_SOLID_COLOR       (13   <<  4)
202 #       define R128_GMC_BRUSH_NONE              (15   <<  4)
203 #       define R128_GMC_DST_16BPP               (4    <<  8)
204 #       define R128_GMC_DST_24BPP               (5    <<  8)
205 #       define R128_GMC_DST_32BPP               (6    <<  8)
206 #       define R128_GMC_DST_DATATYPE_SHIFT      8
207 #       define R128_GMC_SRC_DATATYPE_COLOR      (3    << 12)
208 #       define R128_DP_SRC_SOURCE_MEMORY        (2    << 24)
209 #       define R128_DP_SRC_SOURCE_HOST_DATA     (3    << 24)
210 #       define R128_GMC_CLR_CMP_CNTL_DIS        (1    << 28)
211 #       define R128_GMC_AUX_CLIP_DIS            (1    << 29)
212 #       define R128_GMC_WR_MSK_DIS              (1    << 30)
213 #       define R128_ROP3_S                      0x00cc0000
214 #       define R128_ROP3_P                      0x00f00000
215 #define R128_DP_WRITE_MASK              0x16cc
216 #define R128_DST_PITCH_OFFSET_C         0x1c80
217 #       define R128_DST_TILE                    (1 << 31)
218
219 #define R128_GEN_INT_CNTL               0x0040
220 #       define R128_CRTC_VBLANK_INT_EN          (1 <<  0)
221 #define R128_GEN_INT_STATUS             0x0044
222 #       define R128_CRTC_VBLANK_INT             (1 <<  0)
223 #       define R128_CRTC_VBLANK_INT_AK          (1 <<  0)
224 #define R128_GEN_RESET_CNTL             0x00f0
225 #       define R128_SOFT_RESET_GUI              (1 <<  0)
226
227 #define R128_GUI_SCRATCH_REG0           0x15e0
228 #define R128_GUI_SCRATCH_REG1           0x15e4
229 #define R128_GUI_SCRATCH_REG2           0x15e8
230 #define R128_GUI_SCRATCH_REG3           0x15ec
231 #define R128_GUI_SCRATCH_REG4           0x15f0
232 #define R128_GUI_SCRATCH_REG5           0x15f4
233
234 #define R128_GUI_STAT                   0x1740
235 #       define R128_GUI_FIFOCNT_MASK            0x0fff
236 #       define R128_GUI_ACTIVE                  (1 << 31)
237
238 #define R128_MCLK_CNTL                  0x000f
239 #       define R128_FORCE_GCP                   (1 << 16)
240 #       define R128_FORCE_PIPE3D_CP             (1 << 17)
241 #       define R128_FORCE_RCP                   (1 << 18)
242
243 #define R128_PC_GUI_CTLSTAT             0x1748
244 #define R128_PC_NGUI_CTLSTAT            0x0184
245 #       define R128_PC_FLUSH_GUI                (3 << 0)
246 #       define R128_PC_RI_GUI                   (1 << 2)
247 #       define R128_PC_FLUSH_ALL                0x00ff
248 #       define R128_PC_BUSY                     (1 << 31)
249
250 #define R128_PCI_GART_PAGE              0x017c
251 #define R128_PRIM_TEX_CNTL_C            0x1cb0
252
253 #define R128_SCALE_3D_CNTL              0x1a00
254 #define R128_SEC_TEX_CNTL_C             0x1d00
255 #define R128_SEC_TEXTURE_BORDER_COLOR_C 0x1d3c
256 #define R128_SETUP_CNTL                 0x1bc4
257 #define R128_STEN_REF_MASK_C            0x1d40
258
259 #define R128_TEX_CNTL_C                 0x1c9c
260 #       define R128_TEX_CACHE_FLUSH             (1 << 23)
261
262 #define R128_WAIT_UNTIL                 0x1720
263 #       define R128_EVENT_CRTC_OFFSET           (1 << 0)
264 #define R128_WINDOW_XY_OFFSET           0x1bcc
265
266
267 /* CCE registers
268  */
269 #define R128_PM4_BUFFER_OFFSET          0x0700
270 #define R128_PM4_BUFFER_CNTL            0x0704
271 #       define R128_PM4_MASK                    (15 << 28)
272 #       define R128_PM4_NONPM4                  (0  << 28)
273 #       define R128_PM4_192PIO                  (1  << 28)
274 #       define R128_PM4_192BM                   (2  << 28)
275 #       define R128_PM4_128PIO_64INDBM          (3  << 28)
276 #       define R128_PM4_128BM_64INDBM           (4  << 28)
277 #       define R128_PM4_64PIO_128INDBM          (5  << 28)
278 #       define R128_PM4_64BM_128INDBM           (6  << 28)
279 #       define R128_PM4_64PIO_64VCBM_64INDBM    (7  << 28)
280 #       define R128_PM4_64BM_64VCBM_64INDBM     (8  << 28)
281 #       define R128_PM4_64PIO_64VCPIO_64INDPIO  (15 << 28)
282 #       define R128_PM4_BUFFER_CNTL_NOUPDATE    (1  << 27)
283
284 #define R128_PM4_BUFFER_WM_CNTL         0x0708
285 #       define R128_WMA_SHIFT                   0
286 #       define R128_WMB_SHIFT                   8
287 #       define R128_WMC_SHIFT                   16
288 #       define R128_WB_WM_SHIFT                 24
289
290 #define R128_PM4_BUFFER_DL_RPTR_ADDR    0x070c
291 #define R128_PM4_BUFFER_DL_RPTR         0x0710
292 #define R128_PM4_BUFFER_DL_WPTR         0x0714
293 #       define R128_PM4_BUFFER_DL_DONE          (1 << 31)
294
295 #define R128_PM4_VC_FPU_SETUP           0x071c
296
297 #define R128_PM4_IW_INDOFF              0x0738
298 #define R128_PM4_IW_INDSIZE             0x073c
299
300 #define R128_PM4_STAT                   0x07b8
301 #       define R128_PM4_FIFOCNT_MASK            0x0fff
302 #       define R128_PM4_BUSY                    (1 << 16)
303 #       define R128_PM4_GUI_ACTIVE              (1 << 31)
304
305 #define R128_PM4_MICROCODE_ADDR         0x07d4
306 #define R128_PM4_MICROCODE_RADDR        0x07d8
307 #define R128_PM4_MICROCODE_DATAH        0x07dc
308 #define R128_PM4_MICROCODE_DATAL        0x07e0
309
310 #define R128_PM4_BUFFER_ADDR            0x07f0
311 #define R128_PM4_MICRO_CNTL             0x07fc
312 #       define R128_PM4_MICRO_FREERUN           (1 << 30)
313
314 #define R128_PM4_FIFO_DATA_EVEN         0x1000
315 #define R128_PM4_FIFO_DATA_ODD          0x1004
316
317
318 /* CCE command packets
319  */
320 #define R128_CCE_PACKET0                0x00000000
321 #define R128_CCE_PACKET1                0x40000000
322 #define R128_CCE_PACKET2                0x80000000
323 #define R128_CCE_PACKET3                0xC0000000
324 #       define R128_CNTL_HOSTDATA_BLT           0x00009400
325 #       define R128_CNTL_PAINT_MULTI            0x00009A00
326 #       define R128_CNTL_BITBLT_MULTI           0x00009B00
327 #       define R128_3D_RNDR_GEN_INDX_PRIM       0x00002300
328
329 #define R128_CCE_PACKET_MASK            0xC0000000
330 #define R128_CCE_PACKET_COUNT_MASK      0x3fff0000
331 #define R128_CCE_PACKET0_REG_MASK       0x000007ff
332 #define R128_CCE_PACKET1_REG0_MASK      0x000007ff
333 #define R128_CCE_PACKET1_REG1_MASK      0x003ff800
334
335 #define R128_CCE_VC_CNTL_PRIM_TYPE_NONE         0x00000000
336 #define R128_CCE_VC_CNTL_PRIM_TYPE_POINT        0x00000001
337 #define R128_CCE_VC_CNTL_PRIM_TYPE_LINE         0x00000002
338 #define R128_CCE_VC_CNTL_PRIM_TYPE_POLY_LINE    0x00000003
339 #define R128_CCE_VC_CNTL_PRIM_TYPE_TRI_LIST     0x00000004
340 #define R128_CCE_VC_CNTL_PRIM_TYPE_TRI_FAN      0x00000005
341 #define R128_CCE_VC_CNTL_PRIM_TYPE_TRI_STRIP    0x00000006
342 #define R128_CCE_VC_CNTL_PRIM_TYPE_TRI_TYPE2    0x00000007
343 #define R128_CCE_VC_CNTL_PRIM_WALK_IND          0x00000010
344 #define R128_CCE_VC_CNTL_PRIM_WALK_LIST         0x00000020
345 #define R128_CCE_VC_CNTL_PRIM_WALK_RING         0x00000030
346 #define R128_CCE_VC_CNTL_NUM_SHIFT              16
347
348 #define R128_DATATYPE_VQ                0
349 #define R128_DATATYPE_CI4               1
350 #define R128_DATATYPE_CI8               2
351 #define R128_DATATYPE_ARGB1555          3
352 #define R128_DATATYPE_RGB565            4
353 #define R128_DATATYPE_RGB888            5
354 #define R128_DATATYPE_ARGB8888          6
355 #define R128_DATATYPE_RGB332            7
356 #define R128_DATATYPE_Y8                8
357 #define R128_DATATYPE_RGB8              9
358 #define R128_DATATYPE_CI16              10
359 #define R128_DATATYPE_YVYU422           11
360 #define R128_DATATYPE_VYUY422           12
361 #define R128_DATATYPE_AYUV444           14
362 #define R128_DATATYPE_ARGB4444          15
363
364 /* Constants */
365 #define R128_AGP_OFFSET                 0x02000000
366
367 #define R128_WATERMARK_L                16
368 #define R128_WATERMARK_M                8
369 #define R128_WATERMARK_N                8
370 #define R128_WATERMARK_K                128
371
372 #define R128_MAX_USEC_TIMEOUT           100000  /* 100 ms */
373
374 #define R128_LAST_FRAME_REG             R128_GUI_SCRATCH_REG0
375 #define R128_LAST_DISPATCH_REG          R128_GUI_SCRATCH_REG1
376 #define R128_MAX_VB_AGE                 0x7fffffff
377 #define R128_MAX_VB_VERTS               (0xffff)
378
379 #define R128_RING_HIGH_MARK             128
380
381 #define R128_PERFORMANCE_BOXES          0
382
383 #define R128_READ(reg)          DRM_READ32(  dev_priv->mmio, (reg) )
384 #define R128_WRITE(reg,val)     DRM_WRITE32( dev_priv->mmio, (reg), (val) )
385 #define R128_READ8(reg)         DRM_READ8(   dev_priv->mmio, (reg) )
386 #define R128_WRITE8(reg,val)    DRM_WRITE8(  dev_priv->mmio, (reg), (val) )
387
388 #define R128_WRITE_PLL(addr,val)                                        \
389 do {                                                                    \
390         R128_WRITE8(R128_CLOCK_CNTL_INDEX,                              \
391                     ((addr) & 0x1f) | R128_PLL_WR_EN);                  \
392         R128_WRITE(R128_CLOCK_CNTL_DATA, (val));                        \
393 } while (0)
394
395
396 #define CCE_PACKET0( reg, n )           (R128_CCE_PACKET0 |             \
397                                          ((n) << 16) | ((reg) >> 2))
398 #define CCE_PACKET1( reg0, reg1 )       (R128_CCE_PACKET1 |             \
399                                          (((reg1) >> 2) << 11) | ((reg0) >> 2))
400 #define CCE_PACKET2()                   (R128_CCE_PACKET2)
401 #define CCE_PACKET3( pkt, n )           (R128_CCE_PACKET3 |             \
402                                          (pkt) | ((n) << 16))
403
404
405 static __inline__ void
406 r128_update_ring_snapshot( drm_r128_private_t *dev_priv )
407 {
408         drm_r128_ring_buffer_t *ring = &dev_priv->ring;
409         ring->space = (GET_RING_HEAD( dev_priv ) - ring->tail) * sizeof(u32);
410         if ( ring->space <= 0 )
411                 ring->space += ring->size;
412 }
413
414 /* ================================================================
415  * Misc helper macros
416  */
417
418 #define RING_SPACE_TEST_WITH_RETURN( dev_priv )                         \
419 do {                                                                    \
420         drm_r128_ring_buffer_t *ring = &dev_priv->ring; int i;          \
421         if ( ring->space < ring->high_mark ) {                          \
422                 for ( i = 0 ; i < dev_priv->usec_timeout ; i++ ) {      \
423                         r128_update_ring_snapshot( dev_priv );          \
424                         if ( ring->space >= ring->high_mark )           \
425                                 goto __ring_space_done;                 \
426                         DRM_UDELAY(1);                          \
427                 }                                                       \
428                 DRM_ERROR( "ring space check failed!\n" );              \
429                 return DRM_ERR(EBUSY);                          \
430         }                                                               \
431  __ring_space_done:                                                     \
432         ;                                                               \
433 } while (0)
434
435 #define VB_AGE_TEST_WITH_RETURN( dev_priv )                             \
436 do {                                                                    \
437         drm_r128_sarea_t *sarea_priv = dev_priv->sarea_priv;            \
438         if ( sarea_priv->last_dispatch >= R128_MAX_VB_AGE ) {           \
439                 int __ret = r128_do_cce_idle( dev_priv );               \
440                 if ( __ret ) return __ret;                              \
441                 sarea_priv->last_dispatch = 0;                          \
442                 r128_freelist_reset( dev );                             \
443         }                                                               \
444 } while (0)
445
446 #define R128_WAIT_UNTIL_PAGE_FLIPPED() do {                             \
447         OUT_RING( CCE_PACKET0( R128_WAIT_UNTIL, 0 ) );                  \
448         OUT_RING( R128_EVENT_CRTC_OFFSET );                             \
449 } while (0)
450
451
452 /* ================================================================
453  * Ring control
454  */
455
456 #define R128_VERBOSE    0
457
458 #define RING_LOCALS                                                     \
459         int write, _nr; unsigned int tail_mask; volatile u32 *ring;
460
461 #define BEGIN_RING( n ) do {                                            \
462         if ( R128_VERBOSE ) {                                           \
463                 DRM_INFO( "BEGIN_RING( %d ) in %s\n",                   \
464                            (n), __FUNCTION__ );                         \
465         }                                                               \
466         if ( dev_priv->ring.space <= (n) * sizeof(u32) ) {              \
467                 COMMIT_RING();                                          \
468                 r128_wait_ring( dev_priv, (n) * sizeof(u32) );          \
469         }                                                               \
470         _nr = n; dev_priv->ring.space -= (n) * sizeof(u32);             \
471         ring = dev_priv->ring.start;                                    \
472         write = dev_priv->ring.tail;                                    \
473         tail_mask = dev_priv->ring.tail_mask;                           \
474 } while (0)
475
476 /* You can set this to zero if you want.  If the card locks up, you'll
477  * need to keep this set.  It works around a bug in early revs of the
478  * Rage 128 chipset, where the CCE would read 32 dwords past the end of
479  * the ring buffer before wrapping around.
480  */
481 #define R128_BROKEN_CCE 1
482
483 #define ADVANCE_RING() do {                                             \
484         if ( R128_VERBOSE ) {                                           \
485                 DRM_INFO( "ADVANCE_RING() wr=0x%06x tail=0x%06x\n",     \
486                           write, dev_priv->ring.tail );                 \
487         }                                                               \
488         if ( R128_BROKEN_CCE && write < 32 ) {                          \
489                 memcpy( dev_priv->ring.end,                             \
490                         dev_priv->ring.start,                           \
491                         write * sizeof(u32) );                          \
492         }                                                               \
493         if (((dev_priv->ring.tail + _nr) & tail_mask) != write) {       \
494                 DRM_ERROR(                                              \
495                         "ADVANCE_RING(): mismatch: nr: %x write: %x line: %d\n",        \
496                         ((dev_priv->ring.tail + _nr) & tail_mask),      \
497                         write, __LINE__);                               \
498         } else                                                          \
499                 dev_priv->ring.tail = write;                            \
500 } while (0)
501
502 #define COMMIT_RING() do {                                              \
503         if ( R128_VERBOSE ) {                                           \
504                 DRM_INFO( "COMMIT_RING() tail=0x%06x\n",                \
505                         dev_priv->ring.tail );                          \
506         }                                                               \
507         DRM_MEMORYBARRIER();                                            \
508         R128_WRITE( R128_PM4_BUFFER_DL_WPTR, dev_priv->ring.tail );     \
509         R128_READ( R128_PM4_BUFFER_DL_WPTR );                           \
510 } while (0)
511
512 #define OUT_RING( x ) do {                                              \
513         if ( R128_VERBOSE ) {                                           \
514                 DRM_INFO( "   OUT_RING( 0x%08x ) at 0x%x\n",            \
515                            (unsigned int)(x), write );                  \
516         }                                                               \
517         ring[write++] = cpu_to_le32( x );                               \
518         write &= tail_mask;                                             \
519 } while (0)
520
521 #endif /* __R128_DRV_H__ */