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 /* 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;
109           unsigned int misc_3d_state_cntl_reg;
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;
132 } drm_r128_context_regs_t;
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;
142 } drm_r128_texture_regs_t;
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            */
148           drm_r128_context_regs_t context_state;
149           drm_r128_texture_regs_t tex_state[R128_MAX_TEXTURE_UNITS];
150           unsigned int dirty;
151           unsigned int vertsize;
152           unsigned int vc_format;
153 
154           /* The current cliprects, or a subset thereof.
155            */
156           struct drm_clip_rect boxes[R128_NR_SAREA_CLIPRECTS];
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 
164           struct drm_tex_region tex_list[R128_NR_TEX_HEAPS][R128_NR_TEX_REGIONS + 1];
165           unsigned int tex_age[R128_NR_TEX_HEAPS];
166           int ctx_owner;
167           int pfAllowPageFlip;          /* number of 3d windows (0,1,2 or more) */
168           int pfCurrentPage;  /* which buffer is being displayed? */
169 } drm_r128_sarea_t;
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 {
222                     R128_INIT_CCE = 0x01,
223                     R128_CLEANUP_CCE = 0x02
224           } func;
225           unsigned long sarea_priv_offset;
226           int is_pci;
227           int cce_mode;
228           int cce_secure;
229           int ring_size;
230           int usec_timeout;
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;
245 } drm_r128_init_t;
246 
247 typedef struct drm_r128_cce_stop {
248           int flush;
249           int idle;
250 } drm_r128_cce_stop_t;
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;
258 } drm_r128_clear_t;
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? */
265 } drm_r128_vertex_t;
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? */
273 } drm_r128_indices_t;
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;
282 } drm_r128_blit_t;
283 
284 typedef struct drm_r128_depth {
285           enum {
286                     R128_WRITE_SPAN = 0x01,
287                     R128_WRITE_PIXELS = 0x02,
288                     R128_READ_SPAN = 0x03,
289                     R128_READ_PIXELS = 0x04
290           } func;
291           int n;
292           int __user *x;
293           int __user *y;
294           unsigned int __user *buffer;
295           unsigned char __user *mask;
296 } drm_r128_depth_t;
297 
298 typedef struct drm_r128_stipple {
299           unsigned int __user *mask;
300 } drm_r128_stipple_t;
301 
302 typedef struct drm_r128_indirect {
303           int idx;
304           int start;
305           int end;
306           int discard;
307 } drm_r128_indirect_t;
308 
309 typedef struct drm_r128_fullscreen {
310           enum {
311                     R128_INIT_FULLSCREEN = 0x01,
312                     R128_CLEANUP_FULLSCREEN = 0x02
313           } func;
314 } drm_r128_fullscreen_t;
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;
324 } drm_r128_getparam_t;
325 
326 #endif
327