src/gallium/drivers/cell/spu/spu_main.h

   1 /**************************************************************************
   2  *
   3  * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas.
   4  * All Rights Reserved.
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a
   7  * copy of this software and associated documentation files (the
   8  * "Software"), to deal in the Software without restriction, including
   9  * without limitation the rights to use, copy, modify, merge, publish,
  10  * distribute, sub license, and/or sell copies of the Software, and to
  11  * permit persons to whom the Software is furnished to do so, subject to
  12  * the following conditions:
  13  *
  14  * The above copyright notice and this permission notice (including the
  15  * next paragraph) shall be included in all copies or substantial portions
  16  * of the Software.
  17  *
  18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  19  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  20  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
  21  * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
  22  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
  23  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  24  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  25  *
  26  **************************************************************************/
  27
  28 #ifndef SPU_MAIN_H
  29 #define SPU_MAIN_H
  30
  31
  32 #include <spu_mfcio.h>
  33
  34 #include "cell/common.h"
  35 #include "draw/draw_vertex.h"
  36 #include "pipe/p_state.h"
  37
  38
  39 #if DEBUG
  40 /* These debug macros use the unusual construction ", ##__VA_ARGS__"
  41  * which expands to the expected comma + args if variadic arguments
  42  * are supplied, but swallows the comma if there are no variadic
  43  * arguments (which avoids syntax errors that would otherwise occur).
  44  */
  45 #define D_PRINTF(flag, format,...) \
  46    if (spu.init.debug_flags & (flag)) \
  47       printf("SPU %u: " format, spu.init.id, ##__VA_ARGS__)
  48 #else
  49 #define D_PRINTF(...)
  50 #endif
  51
  52
  53 /**
  54  * A tile is basically a TILE_SIZE x TILE_SIZE block of 4-byte pixels.
  55  * The data may be addressed through several different types.
  56  */
  57 typedef union {
  58    ushort us[TILE_SIZE][TILE_SIZE];
  59    uint   ui[TILE_SIZE][TILE_SIZE];
  60    vector unsigned short us8[TILE_SIZE/2][TILE_SIZE/4];
  61    vector unsigned int ui4[TILE_SIZE/2][TILE_SIZE/2];
  62 } tile_t;
  63
  64
  65 #define TILE_STATUS_CLEAR   1
  66 #define TILE_STATUS_DEFINED 2  /**< defined in FB, but not in local store */
  67 #define TILE_STATUS_CLEAN   3  /**< in local store, but not changed */
  68 #define TILE_STATUS_DIRTY   4  /**< modified locally, but not put back yet */
  69 #define TILE_STATUS_GETTING 5  /**< mfc_get() called but not yet arrived */
  70
  71
  72 /** Function for sampling textures */
  73 typedef void (*spu_sample_texture_2d_func)(vector float s,
  74                                            vector float t,
  75                                            uint unit, uint level, uint face,
  76                                            vector float colors[4]);
  77
  78
  79 /** Function for performing per-fragment ops */
  80 typedef void (*spu_fragment_ops_func)(uint x, uint y,
  81                                       tile_t *colorTile,
  82                                       tile_t *depthStencilTile,
  83                                       vector float fragZ,
  84                                       vector float fragRed,
  85                                       vector float fragGreen,
  86                                       vector float fragBlue,
  87                                       vector float fragAlpha,
  88                                       vector unsigned int mask);
  89
  90 /** Function for running fragment program */
  91 typedef vector unsigned int (*spu_fragment_program_func)(vector float *inputs,
  92                                                          vector float *outputs,
  93                                                          vector float *constants);
  94
  95
  96 struct spu_framebuffer
  97 {
  98    void *color_start;              /**< addr of color surface in main memory */
  99    void *depth_start;              /**< addr of depth surface in main memory */
 100    enum pipe_format color_format;
 101    enum pipe_format depth_format;
 102    uint width, height;             /**< size in pixels */
 103    uint width_tiles, height_tiles; /**< width and height in tiles */
 104
 105    uint color_clear_value;
 106    uint depth_clear_value;
 107
 108    uint zsize;                     /**< 0, 2 or 4 bytes per Z */
 109    float zscale;                   /**< 65535.0, 2^24-1 or 2^32-1 */
 110 } ALIGN16_ATTRIB;
 111
 112
 113 /** per-texture level info */
 114 struct spu_texture_level
 115 {
 116    void *start;
 117    ushort width, height, depth;
 118    ushort tiles_per_row;
 119    uint bytes_per_image;
 120    /** texcoord scale factors */
 121    vector float scale_s, scale_t, scale_r;
 122    /** texcoord masks (if REPEAT then size-1, else ~0) */
 123    vector signed int mask_s, mask_t, mask_r;
 124    /** texcoord clamp limits */
 125    vector signed int max_s, max_t, max_r;
 126 } ALIGN16_ATTRIB;
 127
 128
 129 struct spu_texture
 130 {
 131    struct spu_texture_level level[CELL_MAX_TEXTURE_LEVELS];
 132    uint max_level;
 133    uint target;  /**< PIPE_TEXTURE_x */
 134 } ALIGN16_ATTRIB;
 135
 136
 137 /**
 138  * All SPU global/context state will be in a singleton object of this type:
 139  */
 140 struct spu_global
 141 {
 142    /** One-time init/constant info */
 143    struct cell_init_info init;
 144
 145    /*
 146     * Current state
 147     */
 148    struct spu_framebuffer fb;
 149    struct pipe_depth_stencil_alpha_state depth_stencil_alpha;
 150    struct pipe_blend_state blend;
 151    struct pipe_blend_color blend_color;
 152    struct pipe_sampler_state sampler[PIPE_MAX_SAMPLERS];
 153    struct pipe_rasterizer_state rasterizer;
 154    struct spu_texture texture[PIPE_MAX_SAMPLERS];
 155    struct vertex_info vertex_info;
 156
 157    /** Current color and Z tiles */
 158    tile_t ctile ALIGN16_ATTRIB;
 159    tile_t ztile ALIGN16_ATTRIB;
 160
 161    /** Read depth/stencil tiles? */
 162    boolean read_depth_stencil;
 163
 164    /** Current tiles' status */
 165    ubyte cur_ctile_status, cur_ztile_status;
 166
 167    /** Status of all tiles in framebuffer */
 168    ubyte ctile_status[CELL_MAX_HEIGHT/TILE_SIZE][CELL_MAX_WIDTH/TILE_SIZE] ALIGN16_ATTRIB;
 169    ubyte ztile_status[CELL_MAX_HEIGHT/TILE_SIZE][CELL_MAX_WIDTH/TILE_SIZE] ALIGN16_ATTRIB;
 170
 171    /** Current fragment ops machine code, at 8-byte boundary */
 172    uint *fragment_ops_code;
 173    uint fragment_ops_code_size;
 174    /** Current fragment ops functions, 0 = frontfacing, 1 = backfacing */
 175    spu_fragment_ops_func fragment_ops[2];
 176
 177    /** Current fragment program machine code, at 8-byte boundary */
 178    uint fragment_program_code[SPU_MAX_FRAGMENT_PROGRAM_INSTS] ALIGN8_ATTRIB;
 179    /** Current fragment ops function */
 180    spu_fragment_program_func fragment_program;
 181
 182    /** Current texture sampler function */
 183    spu_sample_texture_2d_func sample_texture_2d[CELL_MAX_SAMPLERS];
 184    spu_sample_texture_2d_func min_sample_texture_2d[CELL_MAX_SAMPLERS];
 185    spu_sample_texture_2d_func mag_sample_texture_2d[CELL_MAX_SAMPLERS];
 186
 187    /** Fragment program constants */
 188    vector float constants[4 * CELL_MAX_CONSTANTS];
 189
 190 } ALIGN16_ATTRIB;
 191
 192
 193 extern struct spu_global spu;
 194
 195
 196
 197 /* DMA TAGS */
 198
 199 #define TAG_SURFACE_CLEAR     10
 200 #define TAG_VERTEX_BUFFER     11
 201 #define TAG_READ_TILE_COLOR   12
 202 #define TAG_READ_TILE_Z       13
 203 #define TAG_WRITE_TILE_COLOR  14
 204 #define TAG_WRITE_TILE_Z      15
 205 #define TAG_INDEX_BUFFER      16
 206 #define TAG_BATCH_BUFFER      17
 207 #define TAG_MISC              18
 208 #define TAG_DCACHE0           20
 209 #define TAG_DCACHE1           21
 210 #define TAG_DCACHE2           22
 211 #define TAG_DCACHE3           23
 212 #define TAG_FENCE             24
 213
 214
 215 static INLINE void
 216 wait_on_mask(unsigned tagMask)
 217 {
 218    mfc_write_tag_mask( tagMask );
 219    /* wait for completion of _any_ DMAs specified by tagMask */
 220    mfc_read_tag_status_any();
 221 }
 222
 223
 224 static INLINE void
 225 wait_on_mask_all(unsigned tagMask)
 226 {
 227    mfc_write_tag_mask( tagMask );
 228    /* wait for completion of _any_ DMAs specified by tagMask */
 229    mfc_read_tag_status_all();
 230 }
 231
 232
 233
 234
 235
 236 static INLINE void
 237 memset16(ushort *d, ushort value, uint count)
 238 {
 239    uint i;
 240    for (i = 0; i < count; i++)
 241       d[i] = value;
 242 }
 243
 244
 245 static INLINE void
 246 memset32(uint *d, uint value, uint count)
 247 {
 248    uint i;
 249    for (i = 0; i < count; i++)
 250       d[i] = value;
 251 }
 252
 253
 254 #endif /* SPU_MAIN_H */