Home | History | Annotate | Download | only in drm
      1 /* mach64_drm.h -- Public header for the mach64 driver -*- linux-c -*-
      2  * Created: Thu Nov 30 20:04:32 2000 by gareth (at) 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 (at) valinux.com>
     30  *    Frank C. Earl <fearl (at) airmail.net>
     31  *    Leif Delgass <ldelgass (at) 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