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) 39extern "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 105typedef 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 */ 142typedef 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 150typedef 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 226typedef 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 253typedef struct drm_r128_cce_stop { 254 int flush; 255 int idle; 256} drm_r128_cce_stop_t; 257 258typedef 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 266typedef 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 273typedef 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 281typedef 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 290typedef 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 __user *x; 299 int __user *y; 300 unsigned int __user *buffer; 301 unsigned char __user *mask; 302} drm_r128_depth_t; 303 304typedef struct drm_r128_stipple { 305 unsigned int __user *mask; 306} drm_r128_stipple_t; 307 308typedef struct drm_r128_indirect { 309 int idx; 310 int start; 311 int end; 312 int discard; 313} drm_r128_indirect_t; 314 315typedef 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 327typedef struct drm_r128_getparam { 328 int param; 329 void __user *value; 330} drm_r128_getparam_t; 331 332#if defined(__cplusplus) 333} 334#endif 335 336#endif 337