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                                       uint facing);
  90
  91 /** Function for running fragment program */
  92 typedef vector unsigned int (*spu_fragment_program_func)(vector float *inputs,
  93                                                          vector float *outputs,
  94                                                          vector float *constants);
  95
  96
  97 struct spu_framebuffer
  98 {
  99    void *color_start;              /**< addr of color surface in main memory */
 100    void *depth_start;              /**< addr of depth surface in main memory */
 101    enum pipe_format color_format;
 102    enum pipe_format depth_format;
 103    uint width, height;             /**< size in pixels */
 104    uint width_tiles, height_tiles; /**< width and height in tiles */
 105
 106    uint color_clear_value;
 107    uint depth_clear_value;
 108
 109    uint zsize;                     /**< 0, 2 or 4 bytes per Z */
 110    float zscale;                   /**< 65535.0, 2^24-1 or 2^32-1 */
 111 } ALIGN16_ATTRIB;
 112
 113
 114 /** per-texture level info */
 115 struct spu_texture_level
 116 {
 117    void *start;
 118    ushort width, height, depth;
 119    ushort tiles_per_row;
 120    uint bytes_per_image;
 121    /** texcoord scale factors */
 122    vector float scale_s, scale_t, scale_r;
 123    /** texcoord masks (if REPEAT then size-1, else ~0) */
 124    vector signed int mask_s, mask_t, mask_r;
 125    /** texcoord clamp limits */
 126    vector signed int max_s, max_t, max_r;
 127 } ALIGN16_ATTRIB;
 128
 129
 130 struct spu_texture
 131 {
 132    struct spu_texture_level level[CELL_MAX_TEXTURE_LEVELS];
 133    uint max_level;
 134    uint target;  /**< PIPE_TEXTURE_x */
 135 } ALIGN16_ATTRIB;
 136
 137
 138 /**
 139  * All SPU global/context state will be in a singleton object of this type:
 140  */
 141 struct spu_global
 142 {
 143    /** One-time init/constant info */
 144    struct cell_init_info init;
 145
 146    /*
 147     * Current state
 148     */
 149    struct spu_framebuffer fb;
 150    struct pipe_depth_stencil_alpha_state depth_stencil_alpha;
 151    struct pipe_blend_state blend;
 152    struct pipe_blend_color blend_color;
 153    struct pipe_sampler_state sampler[PIPE_MAX_SAMPLERS];
 154    struct pipe_rasterizer_state rasterizer;
 155    struct spu_texture texture[PIPE_MAX_SAMPLERS];
 156    struct vertex_info vertex_info;
 157
 158    /** Current color and Z tiles */
 159    tile_t ctile ALIGN16_ATTRIB;
 160    tile_t ztile ALIGN16_ATTRIB;
 161
 162    /** Read depth/stencil tiles? */
 163    boolean read_depth;
 164    boolean read_stencil;
 165
 166    /** Current tiles' status */
 167    ubyte cur_ctile_status, cur_ztile_status;
 168
 169    /** Status of all tiles in framebuffer */
 170    ubyte ctile_status[CELL_MAX_HEIGHT/TILE_SIZE][CELL_MAX_WIDTH/TILE_SIZE] ALIGN16_ATTRIB;
 171    ubyte ztile_status[CELL_MAX_HEIGHT/TILE_SIZE][CELL_MAX_WIDTH/TILE_SIZE] ALIGN16_ATTRIB;
 172
 173    /** Current fragment ops machine code, at 8-byte boundary */
 174    uint fragment_ops_code[SPU_MAX_FRAGMENT_OPS_INSTS] ALIGN8_ATTRIB;
 175    /** Current fragment ops function */
 176    spu_fragment_ops_func fragment_ops;
 177
 178    /** Current fragment program machine code, at 8-byte boundary */
 179    uint fragment_program_code[SPU_MAX_FRAGMENT_PROGRAM_INSTS] ALIGN8_ATTRIB;
 180    /** Current fragment ops function */
 181    spu_fragment_program_func fragment_program;
 182
 183    /** Current texture sampler function */
 184    spu_sample_texture_2d_func sample_texture_2d[CELL_MAX_SAMPLERS];
 185    spu_sample_texture_2d_func min_sample_texture_2d[CELL_MAX_SAMPLERS];
 186    spu_sample_texture_2d_func mag_sample_texture_2d[CELL_MAX_SAMPLERS];
 187
 188    /** Fragment program constants */
 189    vector float constants[4 * CELL_MAX_CONSTANTS];
 190
 191 } ALIGN16_ATTRIB;
 192
 193
 194 extern struct spu_global spu;
 195
 196
 197
 198 /* DMA TAGS */
 199
 200 #define TAG_SURFACE_CLEAR     10
 201 #define TAG_VERTEX_BUFFER     11
 202 #define TAG_READ_TILE_COLOR   12
 203 #define TAG_READ_TILE_Z       13
 204 #define TAG_WRITE_TILE_COLOR  14
 205 #define TAG_WRITE_TILE_Z      15
 206 #define TAG_INDEX_BUFFER      16
 207 #define TAG_BATCH_BUFFER      17
 208 #define TAG_MISC              18
 209 #define TAG_DCACHE0           20
 210 #define TAG_DCACHE1           21
 211 #define TAG_DCACHE2           22
 212 #define TAG_DCACHE3           23
 213 #define TAG_FENCE             24
 214
 215
 216 static INLINE void
 217 wait_on_mask(unsigned tagMask)
 218 {
 219    mfc_write_tag_mask( tagMask );
 220    /* wait for completion of _any_ DMAs specified by tagMask */
 221    mfc_read_tag_status_any();
 222 }
 223
 224
 225 static INLINE void
 226 wait_on_mask_all(unsigned tagMask)
 227 {
 228    mfc_write_tag_mask( tagMask );
 229    /* wait for completion of _any_ DMAs specified by tagMask */
 230    mfc_read_tag_status_all();
 231 }
 232
 233
 234
 235
 236
 237 static INLINE void
 238 memset16(ushort *d, ushort value, uint count)
 239 {
 240    uint i;
 241    for (i = 0; i < count; i++)
 242       d[i] = value;
 243 }
 244
 245
 246 static INLINE void
 247 memset32(uint *d, uint value, uint count)
 248 {
 249    uint i;
 250    for (i = 0; i < count; i++)
 251       d[i] = value;
 252 }
 253
 254
 255 #endif /* SPU_MAIN_H */