• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /****************************************************************************
2 * Copyright (C) 2014-2015 Intel Corporation.   All Rights Reserved.
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
13 * Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
21 * IN THE SOFTWARE.
22 *
23 * @file knobs.h
24 *
25 * @brief Static (Compile-Time) Knobs for Core.
26 *
27 ******************************************************************************/
28 #pragma once
29 
30 #include <stdint.h>
31 #include <gen_knobs.h>
32 
33 #define KNOB_ARCH_AVX    0
34 #define KNOB_ARCH_AVX2   1
35 #define KNOB_ARCH_AVX512 2
36 
37 ///////////////////////////////////////////////////////////////////////////////
38 // AVX512 Support
39 ///////////////////////////////////////////////////////////////////////////////
40 
41 #define ENABLE_AVX512_SIMD16    0
42 #define USE_8x2_TILE_BACKEND    0
43 
44 ///////////////////////////////////////////////////////////////////////////////
45 // Architecture validation
46 ///////////////////////////////////////////////////////////////////////////////
47 #if !defined(KNOB_ARCH)
48 #define KNOB_ARCH KNOB_ARCH_AVX
49 #endif
50 
51 #if (KNOB_ARCH == KNOB_ARCH_AVX)
52 #define KNOB_ARCH_ISA AVX
53 #define KNOB_ARCH_STR "AVX"
54 #define KNOB_SIMD_WIDTH 8
55 #define KNOB_SIMD_BYTES 32
56 #elif (KNOB_ARCH == KNOB_ARCH_AVX2)
57 #define KNOB_ARCH_ISA AVX2
58 #define KNOB_ARCH_STR "AVX2"
59 #define KNOB_SIMD_WIDTH 8
60 #define KNOB_SIMD_BYTES 32
61 #elif (KNOB_ARCH == KNOB_ARCH_AVX512)
62 #if 0
63 // not ready to enable this globally, enabled on the side (below)
64 #define KNOB_ARCH_ISA AVX512F
65 #define KNOB_ARCH_STR "AVX512"
66 #define KNOB_SIMD_WIDTH 16
67 #define KNOB_SIMD_BYTES 64
68 #else
69 #define KNOB_ARCH_ISA AVX2
70 #define KNOB_ARCH_STR "AVX2"
71 #define KNOB_SIMD_WIDTH 8
72 #define KNOB_SIMD_BYTES 32
73 #endif
74 #else
75 #error "Unknown architecture"
76 #endif
77 
78 #if ENABLE_AVX512_SIMD16
79 
80 #define KNOB_SIMD16_WIDTH 16
81 #define KNOB_SIMD16_BYTES 64
82 
83 #if (KNOB_ARCH == KNOB_ARCH_AVX512)
84 #define ENABLE_AVX512_EMULATION 0
85 #else
86 #define ENABLE_AVX512_EMULATION 1
87 #endif
88 
89 #endif
90 
91 #define MAX_KNOB_ARCH_STR_LEN sizeof("AVX512_PLUS_PADDING")
92 
93 ///////////////////////////////////////////////////////////////////////////////
94 // Configuration knobs
95 ///////////////////////////////////////////////////////////////////////////////
96 // Maximum supported number of active vertex buffer streams
97 #define KNOB_NUM_STREAMS                    32
98 
99 // Maximum supported number of attributes per vertex
100 #define KNOB_NUM_ATTRIBUTES                 39
101 
102 // Maximum supported active viewports and scissors
103 #define KNOB_NUM_VIEWPORTS_SCISSORS         16
104 
105 // Guardband range used by the clipper
106 #define KNOB_GUARDBAND_WIDTH                32768.0f
107 #define KNOB_GUARDBAND_HEIGHT               32768.0f
108 
109 ///////////////////////////////
110 // Macro tile configuration
111 ///////////////////////////////
112 
113 // raster tile dimensions
114 #define KNOB_TILE_X_DIM                      8
115 #define KNOB_TILE_X_DIM_SHIFT                3
116 #define KNOB_TILE_Y_DIM                      8
117 #define KNOB_TILE_Y_DIM_SHIFT                3
118 
119 // fixed macrotile pixel dimension for now, eventually will be
120 // dynamically set based on tile format and pixel size
121 #define KNOB_MACROTILE_X_DIM                32
122 #define KNOB_MACROTILE_Y_DIM                32
123 #define KNOB_MACROTILE_X_DIM_FIXED_SHIFT    13
124 #define KNOB_MACROTILE_Y_DIM_FIXED_SHIFT    13
125 #define KNOB_MACROTILE_X_DIM_FIXED          (KNOB_MACROTILE_X_DIM << 8)
126 #define KNOB_MACROTILE_Y_DIM_FIXED          (KNOB_MACROTILE_Y_DIM << 8)
127 #define KNOB_MACROTILE_X_DIM_IN_TILES       (KNOB_MACROTILE_X_DIM >> KNOB_TILE_X_DIM_SHIFT)
128 #define KNOB_MACROTILE_Y_DIM_IN_TILES       (KNOB_MACROTILE_Y_DIM >> KNOB_TILE_Y_DIM_SHIFT)
129 
130 // total # of hot tiles available. This should be enough to
131 // fully render a 16kx16k 128bpp render target
132 #define KNOB_NUM_HOT_TILES_X                 256
133 #define KNOB_NUM_HOT_TILES_Y                 256
134 #define KNOB_COLOR_HOT_TILE_FORMAT           R32G32B32A32_FLOAT
135 #define KNOB_DEPTH_HOT_TILE_FORMAT           R32_FLOAT
136 #define KNOB_STENCIL_HOT_TILE_FORMAT         R8_UINT
137 
138 // Max scissor rectangle
139 #define KNOB_MAX_SCISSOR_X                  KNOB_NUM_HOT_TILES_X * KNOB_MACROTILE_X_DIM
140 #define KNOB_MAX_SCISSOR_Y                  KNOB_NUM_HOT_TILES_Y * KNOB_MACROTILE_Y_DIM
141 
142 #if KNOB_SIMD_WIDTH==8 && KNOB_TILE_X_DIM < 4
143 #error "incompatible width/tile dimensions"
144 #endif
145 
146 #if ENABLE_AVX512_SIMD16
147 #if KNOB_SIMD16_WIDTH == 16 && KNOB_TILE_X_DIM < 8
148 #error "incompatible width/tile dimensions"
149 #endif
150 #endif
151 
152 #if KNOB_SIMD_WIDTH == 8
153 #define SIMD_TILE_X_DIM 4
154 #define SIMD_TILE_Y_DIM 2
155 #else
156 #error "Invalid simd width"
157 #endif
158 
159 #if ENABLE_AVX512_SIMD16
160 #if KNOB_SIMD16_WIDTH == 16
161 #define SIMD16_TILE_X_DIM 8
162 #define SIMD16_TILE_Y_DIM 2
163 #else
164 #error "Invalid simd width"
165 #endif
166 #endif
167 
168 ///////////////////////////////////////////////////////////////////////////////
169 // Optimization knobs
170 ///////////////////////////////////////////////////////////////////////////////
171 #define KNOB_USE_FAST_SRGB                     TRUE
172 
173 // enables cut-aware primitive assembler
174 #define KNOB_ENABLE_CUT_AWARE_PA               TRUE
175 
176 ///////////////////////////////////////////////////////////////////////////////
177 // Debug knobs
178 ///////////////////////////////////////////////////////////////////////////////
179 //#define KNOB_ENABLE_RDTSC
180 
181 // Set to 1 to use the dynamic KNOB_TOSS_XXXX knobs.
182 #if !defined(KNOB_ENABLE_TOSS_POINTS)
183 #define KNOB_ENABLE_TOSS_POINTS                 0
184 #endif
185 
186