1 /* mach64_drm.h -- Public header for the mach64 driver -*- linux-c -*-
2  * Created: Thu Nov 30 20:04:32 2000 by gareth@valinux.com
3  */
4 /*
5  * Copyright 2000 Gareth Hughes
6  * Copyright 2002 Frank C. Earl
7  * Copyright 2002-2003 Leif Delgass
8  * All Rights Reserved.
9  *
10  * Permission is hereby granted, free of charge, to any person obtaining a
11  * copy of this software and associated documentation files (the "Software"),
12  * to deal in the Software without restriction, including without limitation
13  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
14  * and/or sell copies of the Software, and to permit persons to whom the
15  * Software is furnished to do so, subject to the following conditions:
16  *
17  * The above copyright notice and this permission notice (including the next
18  * paragraph) shall be included in all copies or substantial portions of the
19  * Software.
20  *
21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
24  * THE COPYRIGHT OWNER(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
25  * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
26  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
27  *
28  * Authors:
29  *    Gareth Hughes <gareth@valinux.com>
30  *    Frank C. Earl <fearl@airmail.net>
31  *    Leif Delgass <ldelgass@retinalburn.net>
32  */
33 
34 #ifndef __MACH64_DRM_H__
35 #define __MACH64_DRM_H__
36 
37 /* WARNING: If you change any of these defines, make sure to change the
38  * defines in the Xserver file (mach64_sarea.h)
39  */
40 #ifndef __MACH64_SAREA_DEFINES__
41 #define __MACH64_SAREA_DEFINES__
42 
43 /* What needs to be changed for the current vertex buffer?
44  * GH: We're going to be pedantic about this.  We want the card to do as
45  * little as possible, so let's avoid having it fetch a whole bunch of
46  * register values that don't change all that often, if at all.
47  */
48 #define MACH64_UPLOAD_DST_OFF_PITCH     0x0001
49 #define MACH64_UPLOAD_Z_OFF_PITCH       0x0002
50 #define MACH64_UPLOAD_Z_ALPHA_CNTL      0x0004
51 #define MACH64_UPLOAD_SCALE_3D_CNTL     0x0008
52 #define MACH64_UPLOAD_DP_FOG_CLR        0x0010
53 #define MACH64_UPLOAD_DP_WRITE_MASK     0x0020
54 #define MACH64_UPLOAD_DP_PIX_WIDTH      0x0040
55 #define MACH64_UPLOAD_SETUP_CNTL        0x0080
56 #define MACH64_UPLOAD_MISC              0x0100
57 #define MACH64_UPLOAD_TEXTURE           0x0200
58 #define MACH64_UPLOAD_TEX0IMAGE                   0x0400
59 #define MACH64_UPLOAD_TEX1IMAGE                   0x0800
60 #define MACH64_UPLOAD_CLIPRECTS                   0x1000    /* handled client-side */
61 #define MACH64_UPLOAD_CONTEXT           0x00ff
62 #define MACH64_UPLOAD_ALL               0x1fff
63 
64 /* DMA buffer size
65  */
66 #define MACH64_BUFFER_SIZE              16384
67 
68 /* Max number of swaps allowed on the ring
69  * before the client must wait
70  */
71 #define MACH64_MAX_QUEUED_FRAMES        3U
72 
73 /* Byte offsets for host blit buffer data
74  */
75 #define MACH64_HOSTDATA_BLIT_OFFSET     104
76 
77 /* Keep these small for testing.
78  */
79 #define MACH64_NR_SAREA_CLIPRECTS       8
80 
81 #define MACH64_CARD_HEAP                0
82 #define MACH64_AGP_HEAP                           1
83 #define MACH64_NR_TEX_HEAPS             2
84 #define MACH64_NR_TEX_REGIONS           64
85 #define MACH64_LOG_TEX_GRANULARITY      16
86 
87 #define MACH64_TEX_MAXLEVELS            1
88 
89 #define MACH64_NR_CONTEXT_REGS                    15
90 #define MACH64_NR_TEXTURE_REGS                    4
91 
92 #endif                                  /* __MACH64_SAREA_DEFINES__ */
93 
94 typedef struct {
95           unsigned int dst_off_pitch;
96 
97           unsigned int z_off_pitch;
98           unsigned int z_cntl;
99           unsigned int alpha_tst_cntl;
100 
101           unsigned int scale_3d_cntl;
102 
103           unsigned int sc_left_right;
104           unsigned int sc_top_bottom;
105 
106           unsigned int dp_fog_clr;
107           unsigned int dp_write_mask;
108           unsigned int dp_pix_width;
109           unsigned int dp_mix;
110           unsigned int dp_src;
111 
112           unsigned int clr_cmp_cntl;
113           unsigned int gui_traj_cntl;
114 
115           unsigned int setup_cntl;
116 
117           unsigned int tex_size_pitch;
118           unsigned int tex_cntl;
119           unsigned int secondary_tex_off;
120           unsigned int tex_offset;
121 } drm_mach64_context_regs_t;
122 
123 typedef struct drm_mach64_sarea {
124           /* The channel for communication of state information to the kernel
125            * on firing a vertex dma buffer.
126            */
127           drm_mach64_context_regs_t context_state;
128           unsigned int dirty;
129           unsigned int vertsize;
130 
131           /* The current cliprects, or a subset thereof.
132            */
133           struct drm_clip_rect boxes[MACH64_NR_SAREA_CLIPRECTS];
134           unsigned int nbox;
135 
136           /* Counters for client-side throttling of rendering clients.
137            */
138           unsigned int frames_queued;
139 
140           /* Texture memory LRU.
141            */
142           struct drm_tex_region tex_list[MACH64_NR_TEX_HEAPS][MACH64_NR_TEX_REGIONS +
143                                                                    1];
144           unsigned int tex_age[MACH64_NR_TEX_HEAPS];
145           int ctx_owner;
146 } drm_mach64_sarea_t;
147 
148 /* WARNING: If you change any of these defines, make sure to change the
149  * defines in the Xserver file (mach64_common.h)
150  */
151 
152 /* Mach64 specific ioctls
153  * The device specific ioctl range is 0x40 to 0x79.
154  */
155 
156 #define DRM_MACH64_INIT           0x00
157 #define DRM_MACH64_IDLE           0x01
158 #define DRM_MACH64_RESET          0x02
159 #define DRM_MACH64_SWAP           0x03
160 #define DRM_MACH64_CLEAR          0x04
161 #define DRM_MACH64_VERTEX         0x05
162 #define DRM_MACH64_BLIT           0x06
163 #define DRM_MACH64_FLUSH          0x07
164 #define DRM_MACH64_GETPARAM       0x08
165 
166 #define DRM_IOCTL_MACH64_INIT           DRM_IOW( DRM_COMMAND_BASE + DRM_MACH64_INIT, drm_mach64_init_t)
167 #define DRM_IOCTL_MACH64_IDLE           DRM_IO(  DRM_COMMAND_BASE + DRM_MACH64_IDLE )
168 #define DRM_IOCTL_MACH64_RESET          DRM_IO(  DRM_COMMAND_BASE + DRM_MACH64_RESET )
169 #define DRM_IOCTL_MACH64_SWAP           DRM_IO(  DRM_COMMAND_BASE + DRM_MACH64_SWAP )
170 #define DRM_IOCTL_MACH64_CLEAR          DRM_IOW( DRM_COMMAND_BASE + DRM_MACH64_CLEAR, drm_mach64_clear_t)
171 #define DRM_IOCTL_MACH64_VERTEX         DRM_IOW( DRM_COMMAND_BASE + DRM_MACH64_VERTEX, drm_mach64_vertex_t)
172 #define DRM_IOCTL_MACH64_BLIT           DRM_IOW( DRM_COMMAND_BASE + DRM_MACH64_BLIT, drm_mach64_blit_t)
173 #define DRM_IOCTL_MACH64_FLUSH          DRM_IO(  DRM_COMMAND_BASE + DRM_MACH64_FLUSH )
174 #define DRM_IOCTL_MACH64_GETPARAM       DRM_IOWR( DRM_COMMAND_BASE + DRM_MACH64_GETPARAM, drm_mach64_getparam_t)
175 
176 /* Buffer flags for clears
177  */
178 #define MACH64_FRONT                              0x1
179 #define MACH64_BACK                     0x2
180 #define MACH64_DEPTH                              0x4
181 
182 /* Primitive types for vertex buffers
183  */
184 #define MACH64_PRIM_POINTS              0x00000000
185 #define MACH64_PRIM_LINES               0x00000001
186 #define MACH64_PRIM_LINE_LOOP           0x00000002
187 #define MACH64_PRIM_LINE_STRIP                    0x00000003
188 #define MACH64_PRIM_TRIANGLES           0x00000004
189 #define MACH64_PRIM_TRIANGLE_STRIP      0x00000005
190 #define MACH64_PRIM_TRIANGLE_FAN        0x00000006
191 #define MACH64_PRIM_QUADS               0x00000007
192 #define MACH64_PRIM_QUAD_STRIP                    0x00000008
193 #define MACH64_PRIM_POLYGON             0x00000009
194 
195 typedef enum _drm_mach64_dma_mode_t {
196           MACH64_MODE_DMA_ASYNC,
197           MACH64_MODE_DMA_SYNC,
198           MACH64_MODE_MMIO
199 } drm_mach64_dma_mode_t;
200 
201 typedef struct drm_mach64_init {
202           enum {
203                     DRM_MACH64_INIT_DMA = 0x01,
204                     DRM_MACH64_CLEANUP_DMA = 0x02
205           } func;
206 
207           unsigned long sarea_priv_offset;
208           int is_pci;
209           drm_mach64_dma_mode_t dma_mode;
210 
211           unsigned int fb_bpp;
212           unsigned int front_offset, front_pitch;
213           unsigned int back_offset, back_pitch;
214 
215           unsigned int depth_bpp;
216           unsigned int depth_offset, depth_pitch;
217 
218           unsigned long fb_offset;
219           unsigned long mmio_offset;
220           unsigned long ring_offset;
221           unsigned long buffers_offset;
222           unsigned long agp_textures_offset;
223 } drm_mach64_init_t;
224 
225 typedef struct drm_mach64_clear {
226           unsigned int flags;
227           int x, y, w, h;
228           unsigned int clear_color;
229           unsigned int clear_depth;
230 } drm_mach64_clear_t;
231 
232 typedef struct drm_mach64_vertex {
233           int prim;
234           void *buf;                    /* Address of vertex buffer */
235           unsigned long used; /* Number of bytes in buffer */
236           int discard;                  /* Client finished with buffer? */
237 } drm_mach64_vertex_t;
238 
239 typedef struct drm_mach64_blit {
240           void *buf;
241           int pitch;
242           int offset;
243           int format;
244           unsigned short x, y;
245           unsigned short width, height;
246 } drm_mach64_blit_t;
247 
248 typedef struct drm_mach64_getparam {
249           enum {
250                     MACH64_PARAM_FRAMES_QUEUED = 0x01,
251                     MACH64_PARAM_IRQ_NR = 0x02
252           } param;
253           void *value;
254 } drm_mach64_getparam_t;
255 
256 #endif
257