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