• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1  /* r128_drm.h -- Public header for the r128 driver -*- linux-c -*-
2   * Created: Wed Apr  5 19:24:19 2000 by kevin@precisioninsight.com
3   */
4  /*
5   * Copyright 2000 Precision Insight, Inc., Cedar Park, Texas.
6   * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
7   * All rights reserved.
8   *
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:
15   *
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.
19   *
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.
27   *
28   * Authors:
29   *    Gareth Hughes <gareth@valinux.com>
30   *    Kevin E. Martin <martin@valinux.com>
31   */
32  
33  #ifndef __R128_DRM_H__
34  #define __R128_DRM_H__
35  
36  #include "drm.h"
37  
38  #if defined(__cplusplus)
39  extern "C" {
40  #endif
41  
42  /* WARNING: If you change any of these defines, make sure to change the
43   * defines in the X server file (r128_sarea.h)
44   */
45  #ifndef __R128_SAREA_DEFINES__
46  #define __R128_SAREA_DEFINES__
47  
48  /* What needs to be changed for the current vertex buffer?
49   */
50  #define R128_UPLOAD_CONTEXT		0x001
51  #define R128_UPLOAD_SETUP		0x002
52  #define R128_UPLOAD_TEX0		0x004
53  #define R128_UPLOAD_TEX1		0x008
54  #define R128_UPLOAD_TEX0IMAGES		0x010
55  #define R128_UPLOAD_TEX1IMAGES		0x020
56  #define R128_UPLOAD_CORE		0x040
57  #define R128_UPLOAD_MASKS		0x080
58  #define R128_UPLOAD_WINDOW		0x100
59  #define R128_UPLOAD_CLIPRECTS		0x200	/* handled client-side */
60  #define R128_REQUIRE_QUIESCENCE		0x400
61  #define R128_UPLOAD_ALL			0x7ff
62  
63  #define R128_FRONT			0x1
64  #define R128_BACK			0x2
65  #define R128_DEPTH			0x4
66  
67  /* Primitive types
68   */
69  #define R128_POINTS			0x1
70  #define R128_LINES			0x2
71  #define R128_LINE_STRIP			0x3
72  #define R128_TRIANGLES			0x4
73  #define R128_TRIANGLE_FAN		0x5
74  #define R128_TRIANGLE_STRIP		0x6
75  
76  /* Vertex/indirect buffer size
77   */
78  #define R128_BUFFER_SIZE		16384
79  
80  /* Byte offsets for indirect buffer data
81   */
82  #define R128_INDEX_PRIM_OFFSET		20
83  #define R128_HOSTDATA_BLIT_OFFSET	32
84  
85  /* Keep these small for testing.
86   */
87  #define R128_NR_SAREA_CLIPRECTS		12
88  
89  /* There are 2 heaps (local/AGP).  Each region within a heap is a
90   *  minimum of 64k, and there are at most 64 of them per heap.
91   */
92  #define R128_LOCAL_TEX_HEAP		0
93  #define R128_AGP_TEX_HEAP		1
94  #define R128_NR_TEX_HEAPS		2
95  #define R128_NR_TEX_REGIONS		64
96  #define R128_LOG_TEX_GRANULARITY	16
97  
98  #define R128_NR_CONTEXT_REGS		12
99  
100  #define R128_MAX_TEXTURE_LEVELS		11
101  #define R128_MAX_TEXTURE_UNITS		2
102  
103  #endif				/* __R128_SAREA_DEFINES__ */
104  
105  typedef struct {
106  	/* Context state - can be written in one large chunk */
107  	unsigned int dst_pitch_offset_c;
108  	unsigned int dp_gui_master_cntl_c;
109  	unsigned int sc_top_left_c;
110  	unsigned int sc_bottom_right_c;
111  	unsigned int z_offset_c;
112  	unsigned int z_pitch_c;
113  	unsigned int z_sten_cntl_c;
114  	unsigned int tex_cntl_c;
115  	unsigned int misc_3d_state_cntl_reg;
116  	unsigned int texture_clr_cmp_clr_c;
117  	unsigned int texture_clr_cmp_msk_c;
118  	unsigned int fog_color_c;
119  
120  	/* Texture state */
121  	unsigned int tex_size_pitch_c;
122  	unsigned int constant_color_c;
123  
124  	/* Setup state */
125  	unsigned int pm4_vc_fpu_setup;
126  	unsigned int setup_cntl;
127  
128  	/* Mask state */
129  	unsigned int dp_write_mask;
130  	unsigned int sten_ref_mask_c;
131  	unsigned int plane_3d_mask_c;
132  
133  	/* Window state */
134  	unsigned int window_xy_offset;
135  
136  	/* Core state */
137  	unsigned int scale_3d_cntl;
138  } drm_r128_context_regs_t;
139  
140  /* Setup registers for each texture unit
141   */
142  typedef struct {
143  	unsigned int tex_cntl;
144  	unsigned int tex_combine_cntl;
145  	unsigned int tex_size_pitch;
146  	unsigned int tex_offset[R128_MAX_TEXTURE_LEVELS];
147  	unsigned int tex_border_color;
148  } drm_r128_texture_regs_t;
149  
150  typedef struct drm_r128_sarea {
151  	/* The channel for communication of state information to the kernel
152  	 * on firing a vertex buffer.
153  	 */
154  	drm_r128_context_regs_t context_state;
155  	drm_r128_texture_regs_t tex_state[R128_MAX_TEXTURE_UNITS];
156  	unsigned int dirty;
157  	unsigned int vertsize;
158  	unsigned int vc_format;
159  
160  	/* The current cliprects, or a subset thereof.
161  	 */
162  	struct drm_clip_rect boxes[R128_NR_SAREA_CLIPRECTS];
163  	unsigned int nbox;
164  
165  	/* Counters for client-side throttling of rendering clients.
166  	 */
167  	unsigned int last_frame;
168  	unsigned int last_dispatch;
169  
170  	struct drm_tex_region tex_list[R128_NR_TEX_HEAPS][R128_NR_TEX_REGIONS + 1];
171  	unsigned int tex_age[R128_NR_TEX_HEAPS];
172  	int ctx_owner;
173  	int pfAllowPageFlip;	/* number of 3d windows (0,1,2 or more) */
174  	int pfCurrentPage;	/* which buffer is being displayed? */
175  } drm_r128_sarea_t;
176  
177  /* WARNING: If you change any of these defines, make sure to change the
178   * defines in the Xserver file (xf86drmR128.h)
179   */
180  
181  /* Rage 128 specific ioctls
182   * The device specific ioctl range is 0x40 to 0x79.
183   */
184  #define DRM_R128_INIT       0x00
185  #define DRM_R128_CCE_START  0x01
186  #define DRM_R128_CCE_STOP   0x02
187  #define DRM_R128_CCE_RESET  0x03
188  #define DRM_R128_CCE_IDLE   0x04
189  /* 0x05 not used */
190  #define DRM_R128_RESET      0x06
191  #define DRM_R128_SWAP       0x07
192  #define DRM_R128_CLEAR      0x08
193  #define DRM_R128_VERTEX     0x09
194  #define DRM_R128_INDICES    0x0a
195  #define DRM_R128_BLIT       0x0b
196  #define DRM_R128_DEPTH      0x0c
197  #define DRM_R128_STIPPLE    0x0d
198  /* 0x0e not used */
199  #define DRM_R128_INDIRECT   0x0f
200  #define DRM_R128_FULLSCREEN 0x10
201  #define DRM_R128_CLEAR2     0x11
202  #define DRM_R128_GETPARAM   0x12
203  #define DRM_R128_FLIP       0x13
204  
205  #define DRM_IOCTL_R128_INIT       DRM_IOW( DRM_COMMAND_BASE + DRM_R128_INIT, drm_r128_init_t)
206  #define DRM_IOCTL_R128_CCE_START  DRM_IO(  DRM_COMMAND_BASE + DRM_R128_CCE_START)
207  #define DRM_IOCTL_R128_CCE_STOP   DRM_IOW( DRM_COMMAND_BASE + DRM_R128_CCE_STOP, drm_r128_cce_stop_t)
208  #define DRM_IOCTL_R128_CCE_RESET  DRM_IO(  DRM_COMMAND_BASE + DRM_R128_CCE_RESET)
209  #define DRM_IOCTL_R128_CCE_IDLE   DRM_IO(  DRM_COMMAND_BASE + DRM_R128_CCE_IDLE)
210  /* 0x05 not used */
211  #define DRM_IOCTL_R128_RESET      DRM_IO(  DRM_COMMAND_BASE + DRM_R128_RESET)
212  #define DRM_IOCTL_R128_SWAP       DRM_IO(  DRM_COMMAND_BASE + DRM_R128_SWAP)
213  #define DRM_IOCTL_R128_CLEAR      DRM_IOW( DRM_COMMAND_BASE + DRM_R128_CLEAR, drm_r128_clear_t)
214  #define DRM_IOCTL_R128_VERTEX     DRM_IOW( DRM_COMMAND_BASE + DRM_R128_VERTEX, drm_r128_vertex_t)
215  #define DRM_IOCTL_R128_INDICES    DRM_IOW( DRM_COMMAND_BASE + DRM_R128_INDICES, drm_r128_indices_t)
216  #define DRM_IOCTL_R128_BLIT       DRM_IOW( DRM_COMMAND_BASE + DRM_R128_BLIT, drm_r128_blit_t)
217  #define DRM_IOCTL_R128_DEPTH      DRM_IOW( DRM_COMMAND_BASE + DRM_R128_DEPTH, drm_r128_depth_t)
218  #define DRM_IOCTL_R128_STIPPLE    DRM_IOW( DRM_COMMAND_BASE + DRM_R128_STIPPLE, drm_r128_stipple_t)
219  /* 0x0e not used */
220  #define DRM_IOCTL_R128_INDIRECT   DRM_IOWR(DRM_COMMAND_BASE + DRM_R128_INDIRECT, drm_r128_indirect_t)
221  #define DRM_IOCTL_R128_FULLSCREEN DRM_IOW( DRM_COMMAND_BASE + DRM_R128_FULLSCREEN, drm_r128_fullscreen_t)
222  #define DRM_IOCTL_R128_CLEAR2     DRM_IOW( DRM_COMMAND_BASE + DRM_R128_CLEAR2, drm_r128_clear2_t)
223  #define DRM_IOCTL_R128_GETPARAM   DRM_IOWR( DRM_COMMAND_BASE + DRM_R128_GETPARAM, drm_r128_getparam_t)
224  #define DRM_IOCTL_R128_FLIP       DRM_IO(  DRM_COMMAND_BASE + DRM_R128_FLIP)
225  
226  typedef struct drm_r128_init {
227  	enum {
228  		R128_INIT_CCE = 0x01,
229  		R128_CLEANUP_CCE = 0x02
230  	} func;
231  	unsigned long sarea_priv_offset;
232  	int is_pci;
233  	int cce_mode;
234  	int cce_secure;
235  	int ring_size;
236  	int usec_timeout;
237  
238  	unsigned int fb_bpp;
239  	unsigned int front_offset, front_pitch;
240  	unsigned int back_offset, back_pitch;
241  	unsigned int depth_bpp;
242  	unsigned int depth_offset, depth_pitch;
243  	unsigned int span_offset;
244  
245  	unsigned long fb_offset;
246  	unsigned long mmio_offset;
247  	unsigned long ring_offset;
248  	unsigned long ring_rptr_offset;
249  	unsigned long buffers_offset;
250  	unsigned long agp_textures_offset;
251  } drm_r128_init_t;
252  
253  typedef struct drm_r128_cce_stop {
254  	int flush;
255  	int idle;
256  } drm_r128_cce_stop_t;
257  
258  typedef struct drm_r128_clear {
259  	unsigned int flags;
260  	unsigned int clear_color;
261  	unsigned int clear_depth;
262  	unsigned int color_mask;
263  	unsigned int depth_mask;
264  } drm_r128_clear_t;
265  
266  typedef struct drm_r128_vertex {
267  	int prim;
268  	int idx;		/* Index of vertex buffer */
269  	int count;		/* Number of vertices in buffer */
270  	int discard;		/* Client finished with buffer? */
271  } drm_r128_vertex_t;
272  
273  typedef struct drm_r128_indices {
274  	int prim;
275  	int idx;
276  	int start;
277  	int end;
278  	int discard;		/* Client finished with buffer? */
279  } drm_r128_indices_t;
280  
281  typedef struct drm_r128_blit {
282  	int idx;
283  	int pitch;
284  	int offset;
285  	int format;
286  	unsigned short x, y;
287  	unsigned short width, height;
288  } drm_r128_blit_t;
289  
290  typedef struct drm_r128_depth {
291  	enum {
292  		R128_WRITE_SPAN = 0x01,
293  		R128_WRITE_PIXELS = 0x02,
294  		R128_READ_SPAN = 0x03,
295  		R128_READ_PIXELS = 0x04
296  	} func;
297  	int n;
298  	int *x;
299  	int *y;
300  	unsigned int *buffer;
301  	unsigned char *mask;
302  } drm_r128_depth_t;
303  
304  typedef struct drm_r128_stipple {
305  	unsigned int *mask;
306  } drm_r128_stipple_t;
307  
308  typedef struct drm_r128_indirect {
309  	int idx;
310  	int start;
311  	int end;
312  	int discard;
313  } drm_r128_indirect_t;
314  
315  typedef struct drm_r128_fullscreen {
316  	enum {
317  		R128_INIT_FULLSCREEN = 0x01,
318  		R128_CLEANUP_FULLSCREEN = 0x02
319  	} func;
320  } drm_r128_fullscreen_t;
321  
322  /* 2.3: An ioctl to get parameters that aren't available to the 3d
323   * client any other way.
324   */
325  #define R128_PARAM_IRQ_NR            1
326  
327  typedef struct drm_r128_getparam {
328  	int param;
329  	void *value;
330  } drm_r128_getparam_t;
331  
332  #if defined(__cplusplus)
333  }
334  #endif
335  
336  #endif
337