1 /* mga_drv.h -- Private header for the Matrox G200/G400 driver -*- linux-c -*-
2 * Created: Mon Dec 13 01:50:01 1999 by jhartmann@precisioninsight.com
4 * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
5 * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
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:
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
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 * VA LINUX SYSTEMS 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
25 * OTHER DEALINGS IN THE SOFTWARE.
28 * Gareth Hughes <gareth@valinux.com>
30 * $FreeBSD: src/sys/dev/drm/mga_drv.h,v 1.5.2.1 2003/04/26 07:05:29 anholt Exp $
31 * $DragonFly: src/sys/dev/drm/mga/Attic/mga_drv.h,v 1.4 2005/06/10 20:16:32 swildner Exp $
37 typedef struct drm_mga_primary_buffer {
44 volatile long wrapped;
52 } drm_mga_primary_buffer_t;
54 typedef struct drm_mga_freelist {
55 struct drm_mga_freelist *next;
56 struct drm_mga_freelist *prev;
62 drm_mga_freelist_t *list_entry;
67 typedef struct drm_mga_private {
68 drm_mga_primary_buffer_t prim;
69 drm_mga_sarea_t *sarea_priv;
71 drm_mga_freelist_t *head;
72 drm_mga_freelist_t *tail;
74 unsigned int warp_pipe;
75 unsigned long warp_pipe_phys[MGA_MAX_WARP_PIPES];
84 unsigned int front_offset;
85 unsigned int front_pitch;
86 unsigned int back_offset;
87 unsigned int back_pitch;
89 unsigned int depth_cpp;
90 unsigned int depth_offset;
91 unsigned int depth_pitch;
93 unsigned int texture_offset;
94 unsigned int texture_size;
96 drm_local_map_t *sarea;
98 drm_local_map_t *mmio;
99 drm_local_map_t *status;
100 drm_local_map_t *warp;
101 drm_local_map_t *primary;
102 drm_local_map_t *buffers;
103 drm_local_map_t *agp_textures;
107 extern int mga_dma_init( DRM_IOCTL_ARGS );
108 extern int mga_dma_flush( DRM_IOCTL_ARGS );
109 extern int mga_dma_reset( DRM_IOCTL_ARGS );
110 extern int mga_dma_buffers( DRM_IOCTL_ARGS );
112 extern int mga_do_wait_for_idle( drm_mga_private_t *dev_priv );
113 extern int mga_do_dma_idle( drm_mga_private_t *dev_priv );
114 extern int mga_do_dma_reset( drm_mga_private_t *dev_priv );
115 extern int mga_do_engine_reset( drm_mga_private_t *dev_priv );
116 extern int mga_do_cleanup_dma( drm_device_t *dev );
118 extern void mga_do_dma_flush( drm_mga_private_t *dev_priv );
119 extern void mga_do_dma_wrap_start( drm_mga_private_t *dev_priv );
120 extern void mga_do_dma_wrap_end( drm_mga_private_t *dev_priv );
122 extern int mga_freelist_put( drm_device_t *dev, drm_buf_t *buf );
125 extern int mga_dma_clear( DRM_IOCTL_ARGS );
126 extern int mga_dma_swap( DRM_IOCTL_ARGS );
127 extern int mga_dma_vertex( DRM_IOCTL_ARGS );
128 extern int mga_dma_indices( DRM_IOCTL_ARGS );
129 extern int mga_dma_iload( DRM_IOCTL_ARGS );
130 extern int mga_dma_blit( DRM_IOCTL_ARGS );
131 extern int mga_getparam( DRM_IOCTL_ARGS );
134 extern int mga_warp_install_microcode( drm_mga_private_t *dev_priv );
135 extern int mga_warp_init( drm_mga_private_t *dev_priv );
137 #define mga_flush_write_combine() DRM_WRITEMEMORYBARRIER(dev_priv->primary)
139 #define MGA_READ8( reg ) DRM_READ8(dev_priv->mmio, (reg))
140 #define MGA_READ( reg ) DRM_READ32(dev_priv->mmio, (reg))
141 #define MGA_WRITE8( reg, val ) DRM_WRITE8(dev_priv->mmio, (reg), (val))
142 #define MGA_WRITE( reg, val ) DRM_WRITE32(dev_priv->mmio, (reg), (val))
144 #define DWGREG0 0x1c00
145 #define DWGREG0_END 0x1dff
146 #define DWGREG1 0x2c00
147 #define DWGREG1_END 0x2dff
149 #define ISREG0(r) (r >= DWGREG0 && r <= DWGREG0_END)
150 #define DMAREG0(r) (u8)((r - DWGREG0) >> 2)
151 #define DMAREG1(r) (u8)(((r - DWGREG1) >> 2) | 0x80)
152 #define DMAREG(r) (ISREG0(r) ? DMAREG0(r) : DMAREG1(r))
156 /* ================================================================
160 #define MGA_EMIT_STATE( dev_priv, dirty ) \
162 if ( (dirty) & ~MGA_UPLOAD_CLIPRECTS ) { \
163 if ( dev_priv->chipset == MGA_CARD_TYPE_G400 ) { \
164 mga_g400_emit_state( dev_priv ); \
166 mga_g200_emit_state( dev_priv ); \
171 #define WRAP_TEST_WITH_RETURN( dev_priv ) \
173 if ( test_bit( 0, &dev_priv->prim.wrapped ) ) { \
174 if ( mga_is_idle( dev_priv ) ) { \
175 mga_do_dma_wrap_end( dev_priv ); \
176 } else if ( dev_priv->prim.space < \
177 dev_priv->prim.high_mark ) { \
178 if ( MGA_DMA_DEBUG ) \
179 DRM_INFO( "%s: wrap...\n", __func__ ); \
180 return DRM_ERR(EBUSY); \
185 #define WRAP_WAIT_WITH_RETURN( dev_priv ) \
187 if ( test_bit( 0, &dev_priv->prim.wrapped ) ) { \
188 if ( mga_do_wait_for_idle( dev_priv ) < 0 ) { \
189 if ( MGA_DMA_DEBUG ) \
190 DRM_INFO( "%s: wrap...\n", __func__ ); \
191 return DRM_ERR(EBUSY); \
193 mga_do_dma_wrap_end( dev_priv ); \
198 /* ================================================================
199 * Primary DMA command stream
202 #define MGA_VERBOSE 0
204 #define DMA_LOCALS unsigned int write; volatile u8 *prim;
206 #define DMA_BLOCK_SIZE (5 * sizeof(u32))
208 #define BEGIN_DMA( n ) \
210 if ( MGA_VERBOSE ) { \
211 DRM_INFO( "BEGIN_DMA( %d ) in %s\n", \
213 DRM_INFO( " space=0x%x req=0x%x\n", \
214 dev_priv->prim.space, (n) * DMA_BLOCK_SIZE ); \
216 prim = dev_priv->prim.start; \
217 write = dev_priv->prim.tail; \
220 #define BEGIN_DMA_WRAP() \
222 if ( MGA_VERBOSE ) { \
223 DRM_INFO( "BEGIN_DMA() in %s\n", __func__ ); \
224 DRM_INFO( " space=0x%x\n", dev_priv->prim.space ); \
226 prim = dev_priv->prim.start; \
227 write = dev_priv->prim.tail; \
230 #define ADVANCE_DMA() \
232 dev_priv->prim.tail = write; \
233 if ( MGA_VERBOSE ) { \
234 DRM_INFO( "ADVANCE_DMA() tail=0x%05x sp=0x%x\n", \
235 write, dev_priv->prim.space ); \
239 #define FLUSH_DMA() \
242 DRM_INFO( "%s:\n", __func__ ); \
243 DRM_INFO( " tail=0x%06x head=0x%06lx\n", \
244 dev_priv->prim.tail, \
245 MGA_READ( MGA_PRIMADDRESS ) - \
246 dev_priv->primary->offset ); \
248 if ( !test_bit( 0, &dev_priv->prim.wrapped ) ) { \
249 if ( dev_priv->prim.space < \
250 dev_priv->prim.high_mark ) { \
251 mga_do_dma_wrap_start( dev_priv ); \
253 mga_do_dma_flush( dev_priv ); \
258 /* Never use this, always use DMA_BLOCK(...) for primary DMA output.
260 #define DMA_WRITE( offset, val ) \
262 if ( MGA_VERBOSE ) { \
263 DRM_INFO( " DMA_WRITE( 0x%08x ) at 0x%04x\n", \
264 (u32)(val), write + (offset) * sizeof(u32) ); \
266 *(volatile u32 *)(prim + write + (offset) * sizeof(u32)) = val; \
269 #define DMA_BLOCK( reg0, val0, reg1, val1, reg2, val2, reg3, val3 ) \
271 DMA_WRITE( 0, ((DMAREG( reg0 ) << 0) | \
272 (DMAREG( reg1 ) << 8) | \
273 (DMAREG( reg2 ) << 16) | \
274 (DMAREG( reg3 ) << 24)) ); \
275 DMA_WRITE( 1, val0 ); \
276 DMA_WRITE( 2, val1 ); \
277 DMA_WRITE( 3, val2 ); \
278 DMA_WRITE( 4, val3 ); \
279 write += DMA_BLOCK_SIZE; \
283 /* Buffer aging via primary DMA stream head pointer.
286 #define SET_AGE( age, h, w ) \
292 #define TEST_AGE( age, h, w ) ( (age)->wrap < w || \
293 ( (age)->wrap == w && \
296 #define AGE_BUFFER( buf_priv ) \
298 drm_mga_freelist_t *entry = (buf_priv)->list_entry; \
299 if ( (buf_priv)->dispatched ) { \
300 entry->age.head = (dev_priv->prim.tail + \
301 dev_priv->primary->offset); \
302 entry->age.wrap = dev_priv->sarea_priv->last_wrap; \
304 entry->age.head = 0; \
305 entry->age.wrap = 0; \
310 #define MGA_ENGINE_IDLE_MASK (MGA_SOFTRAPEN | \
313 #define MGA_DMA_IDLE_MASK (MGA_SOFTRAPEN | \
316 #define MGA_DMA_DEBUG 0
320 /* A reduced set of the mga registers.
322 #define MGA_CRTC_INDEX 0x1fd4
323 #define MGA_CRTC_DATA 0x1fd5
326 #define MGA_VINTCLR (1 << 4)
327 #define MGA_VINTEN (1 << 5)
329 #define MGA_ALPHACTRL 0x2c7c
330 #define MGA_AR0 0x1c60
331 #define MGA_AR1 0x1c64
332 #define MGA_AR2 0x1c68
333 #define MGA_AR3 0x1c6c
334 #define MGA_AR4 0x1c70
335 #define MGA_AR5 0x1c74
336 #define MGA_AR6 0x1c78
338 #define MGA_CXBNDRY 0x1c80
339 #define MGA_CXLEFT 0x1ca0
340 #define MGA_CXRIGHT 0x1ca4
342 #define MGA_DMAPAD 0x1c54
343 #define MGA_DSTORG 0x2cb8
344 #define MGA_DWGCTL 0x1c00
345 # define MGA_OPCOD_MASK (15 << 0)
346 # define MGA_OPCOD_TRAP (4 << 0)
347 # define MGA_OPCOD_TEXTURE_TRAP (6 << 0)
348 # define MGA_OPCOD_BITBLT (8 << 0)
349 # define MGA_OPCOD_ILOAD (9 << 0)
350 # define MGA_ATYPE_MASK (7 << 4)
351 # define MGA_ATYPE_RPL (0 << 4)
352 # define MGA_ATYPE_RSTR (1 << 4)
353 # define MGA_ATYPE_ZI (3 << 4)
354 # define MGA_ATYPE_BLK (4 << 4)
355 # define MGA_ATYPE_I (7 << 4)
356 # define MGA_LINEAR (1 << 7)
357 # define MGA_ZMODE_MASK (7 << 8)
358 # define MGA_ZMODE_NOZCMP (0 << 8)
359 # define MGA_ZMODE_ZE (2 << 8)
360 # define MGA_ZMODE_ZNE (3 << 8)
361 # define MGA_ZMODE_ZLT (4 << 8)
362 # define MGA_ZMODE_ZLTE (5 << 8)
363 # define MGA_ZMODE_ZGT (6 << 8)
364 # define MGA_ZMODE_ZGTE (7 << 8)
365 # define MGA_SOLID (1 << 11)
366 # define MGA_ARZERO (1 << 12)
367 # define MGA_SGNZERO (1 << 13)
368 # define MGA_SHIFTZERO (1 << 14)
369 # define MGA_BOP_MASK (15 << 16)
370 # define MGA_BOP_ZERO (0 << 16)
371 # define MGA_BOP_DST (10 << 16)
372 # define MGA_BOP_SRC (12 << 16)
373 # define MGA_BOP_ONE (15 << 16)
374 # define MGA_TRANS_SHIFT 20
375 # define MGA_TRANS_MASK (15 << 20)
376 # define MGA_BLTMOD_MASK (15 << 25)
377 # define MGA_BLTMOD_BMONOLEF (0 << 25)
378 # define MGA_BLTMOD_BMONOWF (4 << 25)
379 # define MGA_BLTMOD_PLAN (1 << 25)
380 # define MGA_BLTMOD_BFCOL (2 << 25)
381 # define MGA_BLTMOD_BU32BGR (3 << 25)
382 # define MGA_BLTMOD_BU32RGB (7 << 25)
383 # define MGA_BLTMOD_BU24BGR (11 << 25)
384 # define MGA_BLTMOD_BU24RGB (15 << 25)
385 # define MGA_PATTERN (1 << 29)
386 # define MGA_TRANSC (1 << 30)
387 # define MGA_CLIPDIS (1 << 31)
388 #define MGA_DWGSYNC 0x2c4c
390 #define MGA_FCOL 0x1c24
391 #define MGA_FIFOSTATUS 0x1e10
392 #define MGA_FOGCOL 0x1cf4
393 #define MGA_FXBNDRY 0x1c84
394 #define MGA_FXLEFT 0x1ca8
395 #define MGA_FXRIGHT 0x1cac
397 #define MGA_ICLEAR 0x1e18
398 # define MGA_SOFTRAPICLR (1 << 0)
399 # define MGA_VLINEICLR (1 << 5)
400 #define MGA_IEN 0x1e1c
401 # define MGA_SOFTRAPIEN (1 << 0)
402 # define MGA_VLINEIEN (1 << 5)
404 #define MGA_LEN 0x1c5c
406 #define MGA_MACCESS 0x1c04
408 #define MGA_PITCH 0x1c8c
409 #define MGA_PLNWT 0x1c1c
410 #define MGA_PRIMADDRESS 0x1e58
411 # define MGA_DMA_GENERAL (0 << 0)
412 # define MGA_DMA_BLIT (1 << 0)
413 # define MGA_DMA_VECTOR (2 << 0)
414 # define MGA_DMA_VERTEX (3 << 0)
415 #define MGA_PRIMEND 0x1e5c
416 # define MGA_PRIMNOSTART (1 << 0)
417 # define MGA_PAGPXFER (1 << 1)
418 #define MGA_PRIMPTR 0x1e50
419 # define MGA_PRIMPTREN0 (1 << 0)
420 # define MGA_PRIMPTREN1 (1 << 1)
422 #define MGA_RST 0x1e40
423 # define MGA_SOFTRESET (1 << 0)
424 # define MGA_SOFTEXTRST (1 << 1)
426 #define MGA_SECADDRESS 0x2c40
427 #define MGA_SECEND 0x2c44
428 #define MGA_SETUPADDRESS 0x2cd0
429 #define MGA_SETUPEND 0x2cd4
430 #define MGA_SGN 0x1c58
431 #define MGA_SOFTRAP 0x2c48
432 #define MGA_SRCORG 0x2cb4
433 # define MGA_SRMMAP_MASK (1 << 0)
434 # define MGA_SRCMAP_FB (0 << 0)
435 # define MGA_SRCMAP_SYSMEM (1 << 0)
436 # define MGA_SRCACC_MASK (1 << 1)
437 # define MGA_SRCACC_PCI (0 << 1)
438 # define MGA_SRCACC_AGP (1 << 1)
439 #define MGA_STATUS 0x1e14
440 # define MGA_SOFTRAPEN (1 << 0)
441 # define MGA_VSYNCPEN (1 << 4)
442 # define MGA_VLINEPEN (1 << 5)
443 # define MGA_DWGENGSTS (1 << 16)
444 # define MGA_ENDPRDMASTS (1 << 17)
445 #define MGA_STENCIL 0x2cc8
446 #define MGA_STENCILCTL 0x2ccc
448 #define MGA_TDUALSTAGE0 0x2cf8
449 #define MGA_TDUALSTAGE1 0x2cfc
450 #define MGA_TEXBORDERCOL 0x2c5c
451 #define MGA_TEXCTL 0x2c30
452 #define MGA_TEXCTL2 0x2c3c
453 # define MGA_DUALTEX (1 << 7)
454 # define MGA_G400_TC2_MAGIC (1 << 15)
455 # define MGA_MAP1_ENABLE (1 << 31)
456 #define MGA_TEXFILTER 0x2c58
457 #define MGA_TEXHEIGHT 0x2c2c
458 #define MGA_TEXORG 0x2c24
459 # define MGA_TEXORGMAP_MASK (1 << 0)
460 # define MGA_TEXORGMAP_FB (0 << 0)
461 # define MGA_TEXORGMAP_SYSMEM (1 << 0)
462 # define MGA_TEXORGACC_MASK (1 << 1)
463 # define MGA_TEXORGACC_PCI (0 << 1)
464 # define MGA_TEXORGACC_AGP (1 << 1)
465 #define MGA_TEXORG1 0x2ca4
466 #define MGA_TEXORG2 0x2ca8
467 #define MGA_TEXORG3 0x2cac
468 #define MGA_TEXORG4 0x2cb0
469 #define MGA_TEXTRANS 0x2c34
470 #define MGA_TEXTRANSHIGH 0x2c38
471 #define MGA_TEXWIDTH 0x2c28
473 #define MGA_WACCEPTSEQ 0x1dd4
474 #define MGA_WCODEADDR 0x1e6c
475 #define MGA_WFLAG 0x1dc4
476 #define MGA_WFLAG1 0x1de0
477 #define MGA_WFLAGNB 0x1e64
478 #define MGA_WFLAGNB1 0x1e08
479 #define MGA_WGETMSB 0x1dc8
480 #define MGA_WIADDR 0x1dc0
481 #define MGA_WIADDR2 0x1dd8
482 # define MGA_WMODE_SUSPEND (0 << 0)
483 # define MGA_WMODE_RESUME (1 << 0)
484 # define MGA_WMODE_JUMP (2 << 0)
485 # define MGA_WMODE_START (3 << 0)
486 # define MGA_WAGP_ENABLE (1 << 2)
487 #define MGA_WMISC 0x1e70
488 # define MGA_WUCODECACHE_ENABLE (1 << 0)
489 # define MGA_WMASTER_ENABLE (1 << 1)
490 # define MGA_WCACHEFLUSH_ENABLE (1 << 3)
491 #define MGA_WVRTXSZ 0x1dcc
493 #define MGA_YBOT 0x1c9c
494 #define MGA_YDST 0x1c90
495 #define MGA_YDSTLEN 0x1c88
496 #define MGA_YDSTORG 0x1c94
497 #define MGA_YTOP 0x1c98
499 #define MGA_ZORG 0x1c0c
501 /* This finishes the current batch of commands
503 #define MGA_EXEC 0x0100
507 #define MGA_WR0 0x2d00
508 #define MGA_WR1 0x2d04
509 #define MGA_WR2 0x2d08
510 #define MGA_WR3 0x2d0c
511 #define MGA_WR4 0x2d10
512 #define MGA_WR5 0x2d14
513 #define MGA_WR6 0x2d18
514 #define MGA_WR7 0x2d1c
515 #define MGA_WR8 0x2d20
516 #define MGA_WR9 0x2d24
517 #define MGA_WR10 0x2d28
518 #define MGA_WR11 0x2d2c
519 #define MGA_WR12 0x2d30
520 #define MGA_WR13 0x2d34
521 #define MGA_WR14 0x2d38
522 #define MGA_WR15 0x2d3c
523 #define MGA_WR16 0x2d40
524 #define MGA_WR17 0x2d44
525 #define MGA_WR18 0x2d48
526 #define MGA_WR19 0x2d4c
527 #define MGA_WR20 0x2d50
528 #define MGA_WR21 0x2d54
529 #define MGA_WR22 0x2d58
530 #define MGA_WR23 0x2d5c
531 #define MGA_WR24 0x2d60
532 #define MGA_WR25 0x2d64
533 #define MGA_WR26 0x2d68
534 #define MGA_WR27 0x2d6c
535 #define MGA_WR28 0x2d70
536 #define MGA_WR29 0x2d74
537 #define MGA_WR30 0x2d78
538 #define MGA_WR31 0x2d7c
539 #define MGA_WR32 0x2d80
540 #define MGA_WR33 0x2d84
541 #define MGA_WR34 0x2d88
542 #define MGA_WR35 0x2d8c
543 #define MGA_WR36 0x2d90
544 #define MGA_WR37 0x2d94
545 #define MGA_WR38 0x2d98
546 #define MGA_WR39 0x2d9c
547 #define MGA_WR40 0x2da0
548 #define MGA_WR41 0x2da4
549 #define MGA_WR42 0x2da8
550 #define MGA_WR43 0x2dac
551 #define MGA_WR44 0x2db0
552 #define MGA_WR45 0x2db4
553 #define MGA_WR46 0x2db8
554 #define MGA_WR47 0x2dbc
555 #define MGA_WR48 0x2dc0
556 #define MGA_WR49 0x2dc4
557 #define MGA_WR50 0x2dc8
558 #define MGA_WR51 0x2dcc
559 #define MGA_WR52 0x2dd0
560 #define MGA_WR53 0x2dd4
561 #define MGA_WR54 0x2dd8
562 #define MGA_WR55 0x2ddc
563 #define MGA_WR56 0x2de0
564 #define MGA_WR57 0x2de4
565 #define MGA_WR58 0x2de8
566 #define MGA_WR59 0x2dec
567 #define MGA_WR60 0x2df0
568 #define MGA_WR61 0x2df4
569 #define MGA_WR62 0x2df8
570 #define MGA_WR63 0x2dfc
571 # define MGA_G400_WR_MAGIC (1 << 6)
572 # define MGA_G400_WR56_MAGIC 0x46480000 /* 12800.0f */
575 #define MGA_ILOAD_ALIGN 64
576 #define MGA_ILOAD_MASK (MGA_ILOAD_ALIGN - 1)
578 #define MGA_DWGCTL_FLUSH (MGA_OPCOD_TEXTURE_TRAP | \
584 (15 << MGA_TRANS_SHIFT))
586 #define MGA_DWGCTL_CLEAR (MGA_OPCOD_TRAP | \
593 (0 << MGA_TRANS_SHIFT) | \
594 MGA_BLTMOD_BMONOLEF | \
598 #define MGA_DWGCTL_COPY (MGA_OPCOD_BITBLT | \
603 (0 << MGA_TRANS_SHIFT) | \
609 static __inline__ int mga_is_idle( drm_mga_private_t *dev_priv )
611 u32 status = MGA_READ( MGA_STATUS ) & MGA_ENGINE_IDLE_MASK;
612 return ( status == MGA_ENDPRDMASTS );