mga_sarea.h revision fe5e51b7 
1/* $XFree86$ */
2
3/*
4 * Copyright 2000 Gareth Hughes
5 * All Rights Reserved.
6 *
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the "Software"),
9 * to deal in the Software without restriction, including without limitation
10 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11 * and/or sell copies of the Software, and to permit persons to whom the
12 * Software is furnished to do so, subject to the following conditions:
13 *
14 * The above copyright notice and this permission notice (including the next
15 * paragraph) shall be included in all copies or substantial portions of the
16 * Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
21 * GARETH HUGHES BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
22 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24 *
25 * Authors:
26 *   Gareth Hughes <gareth@valinux.com>
27 */
28
29#ifndef __MGA_SAREA_H__
30#define __MGA_SAREA_H__
31
32/* WARNING: If you change any of these defines, make sure to change
33 * the kernel include file as well (mga_drm.h)
34 */
35#ifndef __MGA_SAREA_DEFINES__
36#define __MGA_SAREA_DEFINES__
37
38/* WARP pipe flags
39 */
40#define MGA_F			0x1		/* fog */
41#define MGA_A			0x2		/* alpha */
42#define MGA_S			0x4		/* specular */
43#define MGA_T2			0x8		/* multitexture */
44
45#define MGA_WARP_TGZ		0
46#define MGA_WARP_TGZF		(MGA_F)
47#define MGA_WARP_TGZA		(MGA_A)
48#define MGA_WARP_TGZAF		(MGA_F|MGA_A)
49#define MGA_WARP_TGZS		(MGA_S)
50#define MGA_WARP_TGZSF		(MGA_S|MGA_F)
51#define MGA_WARP_TGZSA		(MGA_S|MGA_A)
52#define MGA_WARP_TGZSAF		(MGA_S|MGA_F|MGA_A)
53#define MGA_WARP_T2GZ		(MGA_T2)
54#define MGA_WARP_T2GZF		(MGA_T2|MGA_F)
55#define MGA_WARP_T2GZA		(MGA_T2|MGA_A)
56#define MGA_WARP_T2GZAF		(MGA_T2|MGA_A|MGA_F)
57#define MGA_WARP_T2GZS		(MGA_T2|MGA_S)
58#define MGA_WARP_T2GZSF		(MGA_T2|MGA_S|MGA_F)
59#define MGA_WARP_T2GZSA		(MGA_T2|MGA_S|MGA_A)
60#define MGA_WARP_T2GZSAF	(MGA_T2|MGA_S|MGA_F|MGA_A)
61
62#define MGA_MAX_G200_PIPES	8		/* no multitex */
63#define MGA_MAX_G400_PIPES	16
64#define MGA_MAX_WARP_PIPES	MGA_MAX_G400_PIPES
65#define MGA_WARP_UCODE_SIZE	32768		/* in bytes */
66
67#define MGA_CARD_TYPE_G200	1
68#define MGA_CARD_TYPE_G400	2
69
70
71#define MGA_FRONT		0x1
72#define MGA_BACK		0x2
73#define MGA_DEPTH		0x4
74
75/* What needs to be changed for the current vertex dma buffer?
76 */
77#define MGA_UPLOAD_CONTEXT	0x1
78#define MGA_UPLOAD_TEX0		0x2
79#define MGA_UPLOAD_TEX1		0x4
80#define MGA_UPLOAD_PIPE		0x8
81#define MGA_UPLOAD_TEX0IMAGE	0x10
82#define MGA_UPLOAD_TEX1IMAGE	0x20
83#define MGA_UPLOAD_2D		0x40
84#define MGA_WAIT_AGE		0x80 /* handled client-side */
85#define MGA_UPLOAD_CLIPRECTS	0x100 /* handled client-side */
86#if 0
87#define MGA_DMA_FLUSH		0x200 /* set when someone gets the lock
88					 quiescent */
89#endif
90
91/* 32 buffers of 64k each, total 1 meg.
92 */
93#define MGA_BUFFER_SIZE		(1 << 16)
94#define MGA_NUM_BUFFERS		128
95
96/* Keep these small for testing.
97 */
98#define MGA_NR_SAREA_CLIPRECTS	8
99
100/* 2 heaps (1 for card, 1 for agp), each divided into upto 128
101 * regions, subject to a minimum region size of (1<<16) == 64k.
102 *
103 * Clients may subdivide regions internally, but when sharing between
104 * clients, the region size is the minimum granularity.
105 */
106
107#define MGA_CARD_HEAP			0
108#define MGA_AGP_HEAP			1
109#define MGA_NR_TEX_HEAPS		2
110#define MGA_NR_TEX_REGIONS		16
111#define MGA_LOG_MIN_TEX_REGION_SIZE	16
112
113#endif /* __MGA_SAREA_DEFINES__ */
114
115
116/* Setup registers for 3D context
117 */
118typedef struct {
119   unsigned int dstorg;
120   unsigned int maccess;
121   unsigned int plnwt;
122   unsigned int dwgctl;
123   unsigned int alphactrl;
124   unsigned int fogcolor;
125   unsigned int wflag;
126   unsigned int tdualstage0;
127   unsigned int tdualstage1;
128   unsigned int fcol;
129   unsigned int stencil;
130   unsigned int stencilctl;
131} mga_context_regs_t;
132
133/* Setup registers for 2D, X server
134 */
135typedef struct {
136   unsigned int pitch;
137} mga_server_regs_t;
138
139/* Setup registers for each texture unit
140 */
141typedef struct {
142   unsigned int texctl;
143   unsigned int texctl2;
144   unsigned int texfilter;
145   unsigned int texbordercol;
146   unsigned int texorg;
147   unsigned int texwidth;
148   unsigned int texheight;
149   unsigned int texorg1;
150   unsigned int texorg2;
151   unsigned int texorg3;
152   unsigned int texorg4;
153} mga_texture_regs_t;
154
155/* General ageing mechanism
156 */
157typedef struct {
158	unsigned int head;		/* Position of head pointer          */
159	unsigned int wrap;		/* Primary DMA wrap count            */
160} mga_age_t;
161
162
163/* WARNING: Do not change the SAREA structure without changing the kernel
164 * as well.
165 */
166typedef struct {
167   /* The channel for communication of state information to the kernel
168    * on firing a vertex dma buffer.
169    */
170   mga_context_regs_t ContextState;
171   mga_server_regs_t ServerState;
172   mga_texture_regs_t TexState[2];
173   unsigned int WarpPipe;
174   unsigned int dirty;
175   unsigned int vertsize;
176
177   /* The current cliprects, or a subset thereof.
178    */
179   drm_clip_rect_t boxes[MGA_NR_SAREA_CLIPRECTS];
180   unsigned int nbox;
181
182   /* Information about the most recently used 3d drawable.  The
183    * client fills in the req_* fields, the server fills in the
184    * exported_ fields and puts the cliprects into boxes, above.
185    *
186    * The client clears the exported_drawable field before
187    * clobbering the boxes data.
188    */
189   unsigned int req_drawable;       /* the X drawable id */
190   unsigned int req_draw_buffer;    /* MGA_FRONT or MGA_BACK */
191
192   unsigned int exported_drawable;
193   unsigned int exported_index;
194   unsigned int exported_stamp;
195   unsigned int exported_buffers;
196   unsigned int exported_nfront;	/* FIXME: verify signedness... */
197   unsigned int exported_nback;
198   int exported_back_x, exported_front_x, exported_w;
199   int exported_back_y, exported_front_y, exported_h;
200   drm_clip_rect_t exported_boxes[MGA_NR_SAREA_CLIPRECTS];
201
202   /* Counters for aging textures and for client-side throttling.
203    */
204   unsigned int status[4];
205   unsigned int last_wrap;
206
207   mga_age_t last_frame;
208   unsigned int last_enqueue;       /* last time a buffer was enqueued */
209   unsigned int last_dispatch;      /* age of the most recently dispatched buffer */
210   unsigned int last_quiescent;     /*  */
211
212   /* LRU lists for texture memory in agp space and on the card.
213    */
214   drmTextureRegion texList[MGA_NR_TEX_HEAPS][MGA_NR_TEX_REGIONS+1];
215   unsigned int texAge[MGA_NR_TEX_HEAPS];
216
217   /* Last context that uploaded statel
218    */
219   int ctxOwner;
220} MGASAREAPrivRec, *MGASAREAPrivPtr;
221
222#endif
223