1 | /* mga_drm.h -- Public header for the Matrox g200/g400 driver -*- linux-c -*-
|
---|
2 | * Created: Tue Jan 25 01:50:01 1999 by [email protected]
|
---|
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 | * 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.
|
---|
26 | *
|
---|
27 | * Authors:
|
---|
28 | * Jeff Hartmann <[email protected]>
|
---|
29 | * Keith Whitwell <[email protected]>
|
---|
30 | *
|
---|
31 | * Rewritten by:
|
---|
32 | * Gareth Hughes <[email protected]>
|
---|
33 | */
|
---|
34 |
|
---|
35 | #ifndef __MGA_DRM_H__
|
---|
36 | #define __MGA_DRM_H__
|
---|
37 |
|
---|
38 | /* WARNING: If you change any of these defines, make sure to change the
|
---|
39 | * defines in the Xserver file (mga_sarea.h)
|
---|
40 | */
|
---|
41 |
|
---|
42 | #ifndef __MGA_SAREA_DEFINES__
|
---|
43 | #define __MGA_SAREA_DEFINES__
|
---|
44 |
|
---|
45 | /* WARP pipe flags
|
---|
46 | */
|
---|
47 | #define MGA_F 0x1 /* fog */
|
---|
48 | #define MGA_A 0x2 /* alpha */
|
---|
49 | #define MGA_S 0x4 /* specular */
|
---|
50 | #define MGA_T2 0x8 /* multitexture */
|
---|
51 |
|
---|
52 | #define MGA_WARP_TGZ 0
|
---|
53 | #define MGA_WARP_TGZF (MGA_F)
|
---|
54 | #define MGA_WARP_TGZA (MGA_A)
|
---|
55 | #define MGA_WARP_TGZAF (MGA_F|MGA_A)
|
---|
56 | #define MGA_WARP_TGZS (MGA_S)
|
---|
57 | #define MGA_WARP_TGZSF (MGA_S|MGA_F)
|
---|
58 | #define MGA_WARP_TGZSA (MGA_S|MGA_A)
|
---|
59 | #define MGA_WARP_TGZSAF (MGA_S|MGA_F|MGA_A)
|
---|
60 | #define MGA_WARP_T2GZ (MGA_T2)
|
---|
61 | #define MGA_WARP_T2GZF (MGA_T2|MGA_F)
|
---|
62 | #define MGA_WARP_T2GZA (MGA_T2|MGA_A)
|
---|
63 | #define MGA_WARP_T2GZAF (MGA_T2|MGA_A|MGA_F)
|
---|
64 | #define MGA_WARP_T2GZS (MGA_T2|MGA_S)
|
---|
65 | #define MGA_WARP_T2GZSF (MGA_T2|MGA_S|MGA_F)
|
---|
66 | #define MGA_WARP_T2GZSA (MGA_T2|MGA_S|MGA_A)
|
---|
67 | #define MGA_WARP_T2GZSAF (MGA_T2|MGA_S|MGA_F|MGA_A)
|
---|
68 |
|
---|
69 | #define MGA_MAX_G200_PIPES 8 /* no multitex */
|
---|
70 | #define MGA_MAX_G400_PIPES 16
|
---|
71 | #define MGA_MAX_WARP_PIPES MGA_MAX_G400_PIPES
|
---|
72 | #define MGA_WARP_UCODE_SIZE 32768 /* in bytes */
|
---|
73 |
|
---|
74 | #define MGA_CARD_TYPE_G200 1
|
---|
75 | #define MGA_CARD_TYPE_G400 2
|
---|
76 | #define MGA_CARD_TYPE_G450 3 /* not currently used */
|
---|
77 | #define MGA_CARD_TYPE_G550 4
|
---|
78 |
|
---|
79 | #define MGA_FRONT 0x1
|
---|
80 | #define MGA_BACK 0x2
|
---|
81 | #define MGA_DEPTH 0x4
|
---|
82 |
|
---|
83 | /* What needs to be changed for the current vertex dma buffer?
|
---|
84 | */
|
---|
85 | #define MGA_UPLOAD_CONTEXT 0x1
|
---|
86 | #define MGA_UPLOAD_TEX0 0x2
|
---|
87 | #define MGA_UPLOAD_TEX1 0x4
|
---|
88 | #define MGA_UPLOAD_PIPE 0x8
|
---|
89 | #define MGA_UPLOAD_TEX0IMAGE 0x10 /* handled client-side */
|
---|
90 | #define MGA_UPLOAD_TEX1IMAGE 0x20 /* handled client-side */
|
---|
91 | #define MGA_UPLOAD_2D 0x40
|
---|
92 | #define MGA_WAIT_AGE 0x80 /* handled client-side */
|
---|
93 | #define MGA_UPLOAD_CLIPRECTS 0x100 /* handled client-side */
|
---|
94 | #if 0
|
---|
95 | #define MGA_DMA_FLUSH 0x200 /* set when someone gets the lock
|
---|
96 | quiescent */
|
---|
97 | #endif
|
---|
98 |
|
---|
99 | /* 32 buffers of 64k each, total 2 meg.
|
---|
100 | */
|
---|
101 | #define MGA_BUFFER_SIZE (1 << 16)
|
---|
102 | #define MGA_NUM_BUFFERS 128
|
---|
103 |
|
---|
104 | /* Keep these small for testing.
|
---|
105 | */
|
---|
106 | #define MGA_NR_SAREA_CLIPRECTS 8
|
---|
107 |
|
---|
108 | /* 2 heaps (1 for card, 1 for agp), each divided into upto 128
|
---|
109 | * regions, subject to a minimum region size of (1<<16) == 64k.
|
---|
110 | *
|
---|
111 | * Clients may subdivide regions internally, but when sharing between
|
---|
112 | * clients, the region size is the minimum granularity.
|
---|
113 | */
|
---|
114 |
|
---|
115 | #define MGA_CARD_HEAP 0
|
---|
116 | #define MGA_AGP_HEAP 1
|
---|
117 | #define MGA_NR_TEX_HEAPS 2
|
---|
118 | #define MGA_NR_TEX_REGIONS 16
|
---|
119 | #define MGA_LOG_MIN_TEX_REGION_SIZE 16
|
---|
120 |
|
---|
121 | #define DRM_MGA_IDLE_RETRY 2048
|
---|
122 |
|
---|
123 | #endif /* __MGA_SAREA_DEFINES__ */
|
---|
124 |
|
---|
125 | /* Setup registers for 3D context
|
---|
126 | */
|
---|
127 | typedef struct {
|
---|
128 | unsigned int dstorg;
|
---|
129 | unsigned int maccess;
|
---|
130 | unsigned int plnwt;
|
---|
131 | unsigned int dwgctl;
|
---|
132 | unsigned int alphactrl;
|
---|
133 | unsigned int fogcolor;
|
---|
134 | unsigned int wflag;
|
---|
135 | unsigned int tdualstage0;
|
---|
136 | unsigned int tdualstage1;
|
---|
137 | unsigned int fcol;
|
---|
138 | unsigned int stencil;
|
---|
139 | unsigned int stencilctl;
|
---|
140 | } drm_mga_context_regs_t;
|
---|
141 |
|
---|
142 | /* Setup registers for 2D, X server
|
---|
143 | */
|
---|
144 | typedef struct {
|
---|
145 | unsigned int pitch;
|
---|
146 | } drm_mga_server_regs_t;
|
---|
147 |
|
---|
148 | /* Setup registers for each texture unit
|
---|
149 | */
|
---|
150 | typedef struct {
|
---|
151 | unsigned int texctl;
|
---|
152 | unsigned int texctl2;
|
---|
153 | unsigned int texfilter;
|
---|
154 | unsigned int texbordercol;
|
---|
155 | unsigned int texorg;
|
---|
156 | unsigned int texwidth;
|
---|
157 | unsigned int texheight;
|
---|
158 | unsigned int texorg1;
|
---|
159 | unsigned int texorg2;
|
---|
160 | unsigned int texorg3;
|
---|
161 | unsigned int texorg4;
|
---|
162 | } drm_mga_texture_regs_t;
|
---|
163 |
|
---|
164 | /* General aging mechanism
|
---|
165 | */
|
---|
166 | typedef struct {
|
---|
167 | unsigned int head; /* Position of head pointer */
|
---|
168 | unsigned int wrap; /* Primary DMA wrap count */
|
---|
169 | } drm_mga_age_t;
|
---|
170 |
|
---|
171 | typedef struct _drm_mga_sarea {
|
---|
172 | /* The channel for communication of state information to the kernel
|
---|
173 | * on firing a vertex dma buffer.
|
---|
174 | */
|
---|
175 | drm_mga_context_regs_t context_state;
|
---|
176 | drm_mga_server_regs_t server_state;
|
---|
177 | drm_mga_texture_regs_t tex_state[2];
|
---|
178 | unsigned int warp_pipe;
|
---|
179 | unsigned int dirty;
|
---|
180 | unsigned int vertsize;
|
---|
181 |
|
---|
182 | /* The current cliprects, or a subset thereof.
|
---|
183 | */
|
---|
184 | drm_clip_rect_t boxes[MGA_NR_SAREA_CLIPRECTS];
|
---|
185 | unsigned int nbox;
|
---|
186 |
|
---|
187 | /* Information about the most recently used 3d drawable. The
|
---|
188 | * client fills in the req_* fields, the server fills in the
|
---|
189 | * exported_ fields and puts the cliprects into boxes, above.
|
---|
190 | *
|
---|
191 | * The client clears the exported_drawable field before
|
---|
192 | * clobbering the boxes data.
|
---|
193 | */
|
---|
194 | unsigned int req_drawable; /* the X drawable id */
|
---|
195 | unsigned int req_draw_buffer; /* MGA_FRONT or MGA_BACK */
|
---|
196 |
|
---|
197 | unsigned int exported_drawable;
|
---|
198 | unsigned int exported_index;
|
---|
199 | unsigned int exported_stamp;
|
---|
200 | unsigned int exported_buffers;
|
---|
201 | unsigned int exported_nfront;
|
---|
202 | unsigned int exported_nback;
|
---|
203 | int exported_back_x, exported_front_x, exported_w;
|
---|
204 | int exported_back_y, exported_front_y, exported_h;
|
---|
205 | drm_clip_rect_t exported_boxes[MGA_NR_SAREA_CLIPRECTS];
|
---|
206 |
|
---|
207 | /* Counters for aging textures and for client-side throttling.
|
---|
208 | */
|
---|
209 | unsigned int status[4];
|
---|
210 | unsigned int last_wrap;
|
---|
211 |
|
---|
212 | drm_mga_age_t last_frame;
|
---|
213 | unsigned int last_enqueue; /* last time a buffer was enqueued */
|
---|
214 | unsigned int last_dispatch; /* age of the most recently dispatched buffer */
|
---|
215 | unsigned int last_quiescent; /* */
|
---|
216 |
|
---|
217 | /* LRU lists for texture memory in agp space and on the card.
|
---|
218 | */
|
---|
219 | drm_tex_region_t texList[MGA_NR_TEX_HEAPS][MGA_NR_TEX_REGIONS + 1];
|
---|
220 | unsigned int texAge[MGA_NR_TEX_HEAPS];
|
---|
221 |
|
---|
222 | /* Mechanism to validate card state.
|
---|
223 | */
|
---|
224 | int ctxOwner;
|
---|
225 | } drm_mga_sarea_t;
|
---|
226 |
|
---|
227 |
|
---|
228 | /* MGA specific ioctls
|
---|
229 | * The device specific ioctl range is 0x40 to 0x79.
|
---|
230 | */
|
---|
231 | #define DRM_MGA_INIT 0x00
|
---|
232 | #define DRM_MGA_FLUSH 0x01
|
---|
233 | #define DRM_MGA_RESET 0x02
|
---|
234 | #define DRM_MGA_SWAP 0x03
|
---|
235 | #define DRM_MGA_CLEAR 0x04
|
---|
236 | #define DRM_MGA_VERTEX 0x05
|
---|
237 | #define DRM_MGA_INDICES 0x06
|
---|
238 | #define DRM_MGA_ILOAD 0x07
|
---|
239 | #define DRM_MGA_BLIT 0x08
|
---|
240 | #define DRM_MGA_GETPARAM 0x09
|
---|
241 |
|
---|
242 | /* 3.2:
|
---|
243 | * ioctls for operating on fences.
|
---|
244 | */
|
---|
245 | #define DRM_MGA_SET_FENCE 0x0a
|
---|
246 | #define DRM_MGA_WAIT_FENCE 0x0b
|
---|
247 | #define DRM_MGA_DMA_BOOTSTRAP 0x0c
|
---|
248 |
|
---|
249 |
|
---|
250 | #define DRM_IOCTL_MGA_INIT DRM_IOW( DRM_COMMAND_BASE + DRM_MGA_INIT, drm_mga_init_t)
|
---|
251 | #define DRM_IOCTL_MGA_FLUSH DRM_IOW( DRM_COMMAND_BASE + DRM_MGA_FLUSH, drm_lock_t)
|
---|
252 | #define DRM_IOCTL_MGA_RESET DRM_IO( DRM_COMMAND_BASE + DRM_MGA_RESET)
|
---|
253 | #define DRM_IOCTL_MGA_SWAP DRM_IO( DRM_COMMAND_BASE + DRM_MGA_SWAP)
|
---|
254 | #define DRM_IOCTL_MGA_CLEAR DRM_IOW( DRM_COMMAND_BASE + DRM_MGA_CLEAR, drm_mga_clear_t)
|
---|
255 | #define DRM_IOCTL_MGA_VERTEX DRM_IOW( DRM_COMMAND_BASE + DRM_MGA_VERTEX, drm_mga_vertex_t)
|
---|
256 | #define DRM_IOCTL_MGA_INDICES DRM_IOW( DRM_COMMAND_BASE + DRM_MGA_INDICES, drm_mga_indices_t)
|
---|
257 | #define DRM_IOCTL_MGA_ILOAD DRM_IOW( DRM_COMMAND_BASE + DRM_MGA_ILOAD, drm_mga_iload_t)
|
---|
258 | #define DRM_IOCTL_MGA_BLIT DRM_IOW( DRM_COMMAND_BASE + DRM_MGA_BLIT, drm_mga_blit_t)
|
---|
259 | #define DRM_IOCTL_MGA_GETPARAM DRM_IOWR(DRM_COMMAND_BASE + DRM_MGA_GETPARAM, drm_mga_getparam_t)
|
---|
260 | #define DRM_IOCTL_MGA_SET_FENCE DRM_IOW( DRM_COMMAND_BASE + DRM_MGA_SET_FENCE, uint32_t)
|
---|
261 | #define DRM_IOCTL_MGA_WAIT_FENCE DRM_IOWR(DRM_COMMAND_BASE + DRM_MGA_WAIT_FENCE, uint32_t)
|
---|
262 | #define DRM_IOCTL_MGA_DMA_BOOTSTRAP DRM_IOWR(DRM_COMMAND_BASE + DRM_MGA_DMA_BOOTSTRAP, drm_mga_dma_bootstrap_t)
|
---|
263 |
|
---|
264 | typedef struct _drm_mga_warp_index {
|
---|
265 | int installed;
|
---|
266 | unsigned long phys_addr;
|
---|
267 | int size;
|
---|
268 | } drm_mga_warp_index_t;
|
---|
269 |
|
---|
270 | typedef struct drm_mga_init {
|
---|
271 | enum {
|
---|
272 | MGA_INIT_DMA = 0x01,
|
---|
273 | MGA_CLEANUP_DMA = 0x02
|
---|
274 | } func;
|
---|
275 |
|
---|
276 | unsigned long sarea_priv_offset;
|
---|
277 |
|
---|
278 | int chipset;
|
---|
279 | int sgram;
|
---|
280 |
|
---|
281 | unsigned int maccess;
|
---|
282 |
|
---|
283 | unsigned int fb_cpp;
|
---|
284 | unsigned int front_offset, front_pitch;
|
---|
285 | unsigned int back_offset, back_pitch;
|
---|
286 |
|
---|
287 | unsigned int depth_cpp;
|
---|
288 | unsigned int depth_offset, depth_pitch;
|
---|
289 |
|
---|
290 | unsigned int texture_offset[MGA_NR_TEX_HEAPS];
|
---|
291 | unsigned int texture_size[MGA_NR_TEX_HEAPS];
|
---|
292 |
|
---|
293 | unsigned long fb_offset;
|
---|
294 | unsigned long mmio_offset;
|
---|
295 | unsigned long status_offset;
|
---|
296 | unsigned long warp_offset;
|
---|
297 | unsigned long primary_offset;
|
---|
298 | unsigned long buffers_offset;
|
---|
299 | } drm_mga_init_t;
|
---|
300 |
|
---|
301 |
|
---|
302 | typedef struct drm_mga_dma_bootstrap {
|
---|
303 | /**
|
---|
304 | * \name AGP texture region
|
---|
305 | *
|
---|
306 | * On return from the DRM_MGA_DMA_BOOTSTRAP ioctl, these fields will
|
---|
307 | * be filled in with the actual AGP texture settings.
|
---|
308 | *
|
---|
309 | * \warning
|
---|
310 | * If these fields are non-zero, but dma_mga_dma_bootstrap::agp_mode
|
---|
311 | * is zero, it means that PCI memory (most likely through the use of
|
---|
312 | * an IOMMU) is being used for "AGP" textures.
|
---|
313 | */
|
---|
314 | /*@{*/
|
---|
315 | unsigned long texture_handle; /**< Handle used to map AGP textures. */
|
---|
316 | uint32_t texture_size; /**< Size of the AGP texture region. */
|
---|
317 | /*@}*/
|
---|
318 |
|
---|
319 |
|
---|
320 | /**
|
---|
321 | * Requested size of the primary DMA region.
|
---|
322 | *
|
---|
323 | * On return from the DRM_MGA_DMA_BOOTSTRAP ioctl, this field will be
|
---|
324 | * filled in with the actual AGP mode. If AGP was not available
|
---|
325 | */
|
---|
326 | uint32_t primary_size;
|
---|
327 |
|
---|
328 |
|
---|
329 | /**
|
---|
330 | * Requested number of secondary DMA buffers.
|
---|
331 | *
|
---|
332 | * On return from the DRM_MGA_DMA_BOOTSTRAP ioctl, this field will be
|
---|
333 | * filled in with the actual number of secondary DMA buffers
|
---|
334 | * allocated. Particularly when PCI DMA is used, this may be
|
---|
335 | * (subtantially) less than the number requested.
|
---|
336 | */
|
---|
337 | uint32_t secondary_bin_count;
|
---|
338 |
|
---|
339 |
|
---|
340 | /**
|
---|
341 | * Requested size of each secondary DMA buffer.
|
---|
342 | *
|
---|
343 | * While the kernel \b is free to reduce
|
---|
344 | * dma_mga_dma_bootstrap::secondary_bin_count, it is \b not allowed
|
---|
345 | * to reduce dma_mga_dma_bootstrap::secondary_bin_size.
|
---|
346 | */
|
---|
347 | uint32_t secondary_bin_size;
|
---|
348 |
|
---|
349 |
|
---|
350 | /**
|
---|
351 | * Bit-wise mask of AGPSTAT2_* values. Currently only \c AGPSTAT2_1X,
|
---|
352 | * \c AGPSTAT2_2X, and \c AGPSTAT2_4X are supported. If this value is
|
---|
353 | * zero, it means that PCI DMA should be used, even if AGP is
|
---|
354 | * possible.
|
---|
355 | *
|
---|
356 | * On return from the DRM_MGA_DMA_BOOTSTRAP ioctl, this field will be
|
---|
357 | * filled in with the actual AGP mode. If AGP was not available
|
---|
358 | * (i.e., PCI DMA was used), this value will be zero.
|
---|
359 | */
|
---|
360 | uint32_t agp_mode;
|
---|
361 |
|
---|
362 |
|
---|
363 | /**
|
---|
364 | * Desired AGP GART size, measured in megabytes.
|
---|
365 | */
|
---|
366 | uint8_t agp_size;
|
---|
367 | } drm_mga_dma_bootstrap_t;
|
---|
368 |
|
---|
369 | typedef struct drm_mga_clear {
|
---|
370 | unsigned int flags;
|
---|
371 | unsigned int clear_color;
|
---|
372 | unsigned int clear_depth;
|
---|
373 | unsigned int color_mask;
|
---|
374 | unsigned int depth_mask;
|
---|
375 | } drm_mga_clear_t;
|
---|
376 |
|
---|
377 | typedef struct drm_mga_vertex {
|
---|
378 | int idx; /* buffer to queue */
|
---|
379 | int used; /* bytes in use */
|
---|
380 | int discard; /* client finished with buffer? */
|
---|
381 | } drm_mga_vertex_t;
|
---|
382 |
|
---|
383 | typedef struct drm_mga_indices {
|
---|
384 | int idx; /* buffer to queue */
|
---|
385 | unsigned int start;
|
---|
386 | unsigned int end;
|
---|
387 | int discard; /* client finished with buffer? */
|
---|
388 | } drm_mga_indices_t;
|
---|
389 |
|
---|
390 | typedef struct drm_mga_iload {
|
---|
391 | int idx;
|
---|
392 | unsigned int dstorg;
|
---|
393 | unsigned int length;
|
---|
394 | } drm_mga_iload_t;
|
---|
395 |
|
---|
396 | typedef struct _drm_mga_blit {
|
---|
397 | unsigned int planemask;
|
---|
398 | unsigned int srcorg;
|
---|
399 | unsigned int dstorg;
|
---|
400 | int src_pitch, dst_pitch;
|
---|
401 | int delta_sx, delta_sy;
|
---|
402 | int delta_dx, delta_dy;
|
---|
403 | int height, ydir; /* flip image vertically */
|
---|
404 | int source_pitch, dest_pitch;
|
---|
405 | } drm_mga_blit_t;
|
---|
406 |
|
---|
407 | /* 3.1: An ioctl to get parameters that aren't available to the 3d
|
---|
408 | * client any other way.
|
---|
409 | */
|
---|
410 | #define MGA_PARAM_IRQ_NR 1
|
---|
411 |
|
---|
412 | /* 3.2: Query the actual card type. The DDX only distinguishes between
|
---|
413 | * G200 chips and non-G200 chips, which it calls G400. It turns out that
|
---|
414 | * there are some very sublte differences between the G4x0 chips and the G550
|
---|
415 | * chips. Using this parameter query, a client-side driver can detect the
|
---|
416 | * difference between a G4x0 and a G550.
|
---|
417 | */
|
---|
418 | #define MGA_PARAM_CARD_TYPE 2
|
---|
419 |
|
---|
420 | typedef struct drm_mga_getparam {
|
---|
421 | int param;
|
---|
422 | void __user *value;
|
---|
423 | } drm_mga_getparam_t;
|
---|
424 |
|
---|
425 | #endif
|
---|