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