2 * Copyright © 2014 Advanced Micro Devices, Inc.
5 * Permission is hereby granted, free of charge, to any person obtaining
6 * a copy of this software and associated documentation files (the
7 * "Software"), to deal in the Software without restriction, including
8 * without limitation the rights to use, copy, modify, merge, publish,
9 * distribute, sub license, and/or sell copies of the Software, and to
10 * permit persons to whom the Software is furnished to do so, subject to
11 * the following conditions:
13 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
14 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
15 * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
16 * NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS, AUTHORS
17 * AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
20 * USE OR OTHER DEALINGS IN THE SOFTWARE.
22 * The above copyright notice and this permission notice (including the
23 * next paragraph) shall be included in all copies or substantial portions
28 ****************************************************************************************************
30 * @brief Contains the helper function and constants
31 ****************************************************************************************************
33 #ifndef __ADDR_TYPES_H__
34 #define __ADDR_TYPES_H__
36 #if defined(__APPLE__) && !defined(HAVE_TSERVER)
37 // External definitions header maintained by Apple driver team, but not for diag team under Mac.
38 // Helps address compilation issues & reduces code covered by NDA
39 #include "addrExtDef.h"
43 // Windows and/or Linux
60 #include <stdarg.h> // va_list...etc need this header
62 #endif // defined (__APPLE__) && !defined(HAVE_TSERVER)
65 ****************************************************************************************************
67 ****************************************************************************************************
71 #define ADDR_CDECL __attribute__((cdecl))
73 #define ADDR_CDECL __cdecl
79 #if defined(__AMD64__)
82 #define ADDR_STDCALL __attribute__((stdcall))
85 #define ADDR_STDCALL __stdcall
92 #define ADDR_FASTCALL __attribute__((regparm(0)))
97 #define ADDR_FASTCALL __fastcall
102 #define GC_CDECL ADDR_CDECL
106 #define GC_STDCALL ADDR_STDCALL
110 #define GC_FASTCALL ADDR_FASTCALL
114 #if defined(__GNUC__)
115 #define ADDR_INLINE static inline // inline needs to be static to link
117 // win32, win64, other platforms
118 #define ADDR_INLINE __inline
119 #endif // #if defined(__GNUC__)
121 #define ADDR_API ADDR_FASTCALL //default call convention is fast call
124 ****************************************************************************************************
125 * Global defines used by other modules
126 ****************************************************************************************************
128 #if !defined(TILEINDEX_INVALID)
129 #define TILEINDEX_INVALID -1
132 #if !defined(TILEINDEX_LINEAR_GENERAL)
133 #define TILEINDEX_LINEAR_GENERAL -2
136 #if !defined(TILEINDEX_LINEAR_ALIGNED)
137 #define TILEINDEX_LINEAR_ALIGNED 8
141 ****************************************************************************************************
143 ****************************************************************************************************
145 typedef enum _ADDR_E_RETURNCODE
156 ADDR_PARAMSIZEMISMATCH
,
157 ADDR_INVALIDGBREGVALUES
,
162 ****************************************************************************************************
164 * Neutral enums that define tile modes for all H/W
166 * R600/R800 tiling mode can be cast to hw enums directly but never cast into HW enum from
167 * ADDR_TM_2D_TILED_XTHICK
169 ****************************************************************************************************
171 typedef enum _AddrTileMode
173 ADDR_TM_LINEAR_GENERAL
= 0, ///< Least restrictions, pitch: multiple of 8 if not buffer
174 ADDR_TM_LINEAR_ALIGNED
= 1, ///< Requests pitch or slice to be multiple of 64 pixels
175 ADDR_TM_1D_TILED_THIN1
= 2, ///< Linear array of 8x8 tiles
176 ADDR_TM_1D_TILED_THICK
= 3, ///< Linear array of 8x8x4 tiles
177 ADDR_TM_2D_TILED_THIN1
= 4, ///< A set of macro tiles consist of 8x8 tiles
178 ADDR_TM_2D_TILED_THIN2
= 5, ///< 600 HWL only, macro tile ratio is 1:4
179 ADDR_TM_2D_TILED_THIN4
= 6, ///< 600 HWL only, macro tile ratio is 1:16
180 ADDR_TM_2D_TILED_THICK
= 7, ///< A set of macro tiles consist of 8x8x4 tiles
181 ADDR_TM_2B_TILED_THIN1
= 8, ///< 600 HWL only, with bank swap
182 ADDR_TM_2B_TILED_THIN2
= 9, ///< 600 HWL only, with bank swap and ratio is 1:4
183 ADDR_TM_2B_TILED_THIN4
= 10, ///< 600 HWL only, with bank swap and ratio is 1:16
184 ADDR_TM_2B_TILED_THICK
= 11, ///< 600 HWL only, with bank swap, consists of 8x8x4 tiles
185 ADDR_TM_3D_TILED_THIN1
= 12, ///< Macro tiling w/ pipe rotation between slices
186 ADDR_TM_3D_TILED_THICK
= 13, ///< Macro tiling w/ pipe rotation bwtween slices, thick
187 ADDR_TM_3B_TILED_THIN1
= 14, ///< 600 HWL only, with bank swap
188 ADDR_TM_3B_TILED_THICK
= 15, ///< 600 HWL only, with bank swap, thick
189 ADDR_TM_2D_TILED_XTHICK
= 16, ///< Tile is 8x8x8, valid from NI
190 ADDR_TM_3D_TILED_XTHICK
= 17, ///< Tile is 8x8x8, valid from NI
191 ADDR_TM_POWER_SAVE
= 18, ///< Power save mode, only used by KMD on NI
192 ADDR_TM_PRT_TILED_THIN1
= 19, ///< No bank/pipe rotation or hashing beyond macrotile size
193 ADDR_TM_PRT_2D_TILED_THIN1
= 20, ///< Same as 2D_TILED_THIN1, PRT only
194 ADDR_TM_PRT_3D_TILED_THIN1
= 21, ///< Same as 3D_TILED_THIN1, PRT only
195 ADDR_TM_PRT_TILED_THICK
= 22, ///< No bank/pipe rotation or hashing beyond macrotile size
196 ADDR_TM_PRT_2D_TILED_THICK
= 23, ///< Same as 2D_TILED_THICK, PRT only
197 ADDR_TM_PRT_3D_TILED_THICK
= 24, ///< Same as 3D_TILED_THICK, PRT only
198 ADDR_TM_UNKNOWN
= 25, ///< Unkown tile mode, should be decided by address lib
199 ADDR_TM_COUNT
= 26, ///< Must be the value of the last tile mode
203 ****************************************************************************************************
207 * Neutral enum for SurfaceFormat
209 ****************************************************************************************************
211 typedef enum _AddrFormat
{
212 ADDR_FMT_INVALID
= 0x00000000,
213 ADDR_FMT_8
= 0x00000001,
214 ADDR_FMT_4_4
= 0x00000002,
215 ADDR_FMT_3_3_2
= 0x00000003,
216 ADDR_FMT_RESERVED_4
= 0x00000004,
217 ADDR_FMT_16
= 0x00000005,
218 ADDR_FMT_16_FLOAT
= 0x00000006,
219 ADDR_FMT_8_8
= 0x00000007,
220 ADDR_FMT_5_6_5
= 0x00000008,
221 ADDR_FMT_6_5_5
= 0x00000009,
222 ADDR_FMT_1_5_5_5
= 0x0000000a,
223 ADDR_FMT_4_4_4_4
= 0x0000000b,
224 ADDR_FMT_5_5_5_1
= 0x0000000c,
225 ADDR_FMT_32
= 0x0000000d,
226 ADDR_FMT_32_FLOAT
= 0x0000000e,
227 ADDR_FMT_16_16
= 0x0000000f,
228 ADDR_FMT_16_16_FLOAT
= 0x00000010,
229 ADDR_FMT_8_24
= 0x00000011,
230 ADDR_FMT_8_24_FLOAT
= 0x00000012,
231 ADDR_FMT_24_8
= 0x00000013,
232 ADDR_FMT_24_8_FLOAT
= 0x00000014,
233 ADDR_FMT_10_11_11
= 0x00000015,
234 ADDR_FMT_10_11_11_FLOAT
= 0x00000016,
235 ADDR_FMT_11_11_10
= 0x00000017,
236 ADDR_FMT_11_11_10_FLOAT
= 0x00000018,
237 ADDR_FMT_2_10_10_10
= 0x00000019,
238 ADDR_FMT_8_8_8_8
= 0x0000001a,
239 ADDR_FMT_10_10_10_2
= 0x0000001b,
240 ADDR_FMT_X24_8_32_FLOAT
= 0x0000001c,
241 ADDR_FMT_32_32
= 0x0000001d,
242 ADDR_FMT_32_32_FLOAT
= 0x0000001e,
243 ADDR_FMT_16_16_16_16
= 0x0000001f,
244 ADDR_FMT_16_16_16_16_FLOAT
= 0x00000020,
245 ADDR_FMT_RESERVED_33
= 0x00000021,
246 ADDR_FMT_32_32_32_32
= 0x00000022,
247 ADDR_FMT_32_32_32_32_FLOAT
= 0x00000023,
248 ADDR_FMT_RESERVED_36
= 0x00000024,
249 ADDR_FMT_1
= 0x00000025,
250 ADDR_FMT_1_REVERSED
= 0x00000026,
251 ADDR_FMT_GB_GR
= 0x00000027,
252 ADDR_FMT_BG_RG
= 0x00000028,
253 ADDR_FMT_32_AS_8
= 0x00000029,
254 ADDR_FMT_32_AS_8_8
= 0x0000002a,
255 ADDR_FMT_5_9_9_9_SHAREDEXP
= 0x0000002b,
256 ADDR_FMT_8_8_8
= 0x0000002c,
257 ADDR_FMT_16_16_16
= 0x0000002d,
258 ADDR_FMT_16_16_16_FLOAT
= 0x0000002e,
259 ADDR_FMT_32_32_32
= 0x0000002f,
260 ADDR_FMT_32_32_32_FLOAT
= 0x00000030,
261 ADDR_FMT_BC1
= 0x00000031,
262 ADDR_FMT_BC2
= 0x00000032,
263 ADDR_FMT_BC3
= 0x00000033,
264 ADDR_FMT_BC4
= 0x00000034,
265 ADDR_FMT_BC5
= 0x00000035,
266 ADDR_FMT_BC6
= 0x00000036,
267 ADDR_FMT_BC7
= 0x00000037,
268 ADDR_FMT_32_AS_32_32_32_32
= 0x00000038,
269 ADDR_FMT_APC3
= 0x00000039,
270 ADDR_FMT_APC4
= 0x0000003a,
271 ADDR_FMT_APC5
= 0x0000003b,
272 ADDR_FMT_APC6
= 0x0000003c,
273 ADDR_FMT_APC7
= 0x0000003d,
274 ADDR_FMT_CTX1
= 0x0000003e,
275 ADDR_FMT_RESERVED_63
= 0x0000003f,
279 ****************************************************************************************************
283 * Neutral enum for addrFlt32ToDepthPixel
285 ****************************************************************************************************
287 typedef enum _AddrDepthFormat
289 ADDR_DEPTH_INVALID
= 0x00000000,
290 ADDR_DEPTH_16
= 0x00000001,
291 ADDR_DEPTH_X8_24
= 0x00000002,
292 ADDR_DEPTH_8_24
= 0x00000003,
293 ADDR_DEPTH_X8_24_FLOAT
= 0x00000004,
294 ADDR_DEPTH_8_24_FLOAT
= 0x00000005,
295 ADDR_DEPTH_32_FLOAT
= 0x00000006,
296 ADDR_DEPTH_X24_8_32_FLOAT
= 0x00000007,
301 ****************************************************************************************************
305 * Neutral enum for ColorFormat
307 ****************************************************************************************************
309 typedef enum _AddrColorFormat
311 ADDR_COLOR_INVALID
= 0x00000000,
312 ADDR_COLOR_8
= 0x00000001,
313 ADDR_COLOR_4_4
= 0x00000002,
314 ADDR_COLOR_3_3_2
= 0x00000003,
315 ADDR_COLOR_RESERVED_4
= 0x00000004,
316 ADDR_COLOR_16
= 0x00000005,
317 ADDR_COLOR_16_FLOAT
= 0x00000006,
318 ADDR_COLOR_8_8
= 0x00000007,
319 ADDR_COLOR_5_6_5
= 0x00000008,
320 ADDR_COLOR_6_5_5
= 0x00000009,
321 ADDR_COLOR_1_5_5_5
= 0x0000000a,
322 ADDR_COLOR_4_4_4_4
= 0x0000000b,
323 ADDR_COLOR_5_5_5_1
= 0x0000000c,
324 ADDR_COLOR_32
= 0x0000000d,
325 ADDR_COLOR_32_FLOAT
= 0x0000000e,
326 ADDR_COLOR_16_16
= 0x0000000f,
327 ADDR_COLOR_16_16_FLOAT
= 0x00000010,
328 ADDR_COLOR_8_24
= 0x00000011,
329 ADDR_COLOR_8_24_FLOAT
= 0x00000012,
330 ADDR_COLOR_24_8
= 0x00000013,
331 ADDR_COLOR_24_8_FLOAT
= 0x00000014,
332 ADDR_COLOR_10_11_11
= 0x00000015,
333 ADDR_COLOR_10_11_11_FLOAT
= 0x00000016,
334 ADDR_COLOR_11_11_10
= 0x00000017,
335 ADDR_COLOR_11_11_10_FLOAT
= 0x00000018,
336 ADDR_COLOR_2_10_10_10
= 0x00000019,
337 ADDR_COLOR_8_8_8_8
= 0x0000001a,
338 ADDR_COLOR_10_10_10_2
= 0x0000001b,
339 ADDR_COLOR_X24_8_32_FLOAT
= 0x0000001c,
340 ADDR_COLOR_32_32
= 0x0000001d,
341 ADDR_COLOR_32_32_FLOAT
= 0x0000001e,
342 ADDR_COLOR_16_16_16_16
= 0x0000001f,
343 ADDR_COLOR_16_16_16_16_FLOAT
= 0x00000020,
344 ADDR_COLOR_RESERVED_33
= 0x00000021,
345 ADDR_COLOR_32_32_32_32
= 0x00000022,
346 ADDR_COLOR_32_32_32_32_FLOAT
= 0x00000023,
350 ****************************************************************************************************
354 * Neutral enum for SurfaceNumber
356 ****************************************************************************************************
358 typedef enum _AddrSurfaceNumber
{
359 ADDR_NUMBER_UNORM
= 0x00000000,
360 ADDR_NUMBER_SNORM
= 0x00000001,
361 ADDR_NUMBER_USCALED
= 0x00000002,
362 ADDR_NUMBER_SSCALED
= 0x00000003,
363 ADDR_NUMBER_UINT
= 0x00000004,
364 ADDR_NUMBER_SINT
= 0x00000005,
365 ADDR_NUMBER_SRGB
= 0x00000006,
366 ADDR_NUMBER_FLOAT
= 0x00000007,
370 ****************************************************************************************************
374 * Neutral enum for SurfaceSwap
376 ****************************************************************************************************
378 typedef enum _AddrSurfaceSwap
{
379 ADDR_SWAP_STD
= 0x00000000,
380 ADDR_SWAP_ALT
= 0x00000001,
381 ADDR_SWAP_STD_REV
= 0x00000002,
382 ADDR_SWAP_ALT_REV
= 0x00000003,
386 ****************************************************************************************************
390 * Size of HTILE blocks, valid values are 4 or 8 for now
391 ****************************************************************************************************
393 typedef enum _AddrHtileBlockSize
395 ADDR_HTILE_BLOCKSIZE_4
= 4,
396 ADDR_HTILE_BLOCKSIZE_8
= 8,
397 } AddrHtileBlockSize
;
401 ****************************************************************************************************
405 * The pipe configuration field specifies both the number of pipes and
406 * how pipes are interleaved on the surface.
407 * The expression of number of pipes, the shader engine tile size, and packer tile size
408 * is encoded in a PIPE_CONFIG register field.
409 * In general the number of pipes usually matches the number of memory channels of the
410 * hardware configuration.
411 * For hw configurations w/ non-pow2 memory number of memory channels, it usually matches
412 * the number of ROP units(? TODO: which registers??)
413 * The enum value = hw enum + 1 which is to reserve 0 for requesting default.
414 ****************************************************************************************************
416 typedef enum _AddrPipeCfg
418 ADDR_PIPECFG_INVALID
= 0,
419 ADDR_PIPECFG_P2
= 1, /// 2 pipes,
420 ADDR_PIPECFG_P4_8x16
= 5, /// 4 pipes,
421 ADDR_PIPECFG_P4_16x16
= 6,
422 ADDR_PIPECFG_P4_16x32
= 7,
423 ADDR_PIPECFG_P4_32x32
= 8,
424 ADDR_PIPECFG_P8_16x16_8x16
= 9, /// 8 pipes
425 ADDR_PIPECFG_P8_16x32_8x16
= 10,
426 ADDR_PIPECFG_P8_32x32_8x16
= 11,
427 ADDR_PIPECFG_P8_16x32_16x16
= 12,
428 ADDR_PIPECFG_P8_32x32_16x16
= 13,
429 ADDR_PIPECFG_P8_32x32_16x32
= 14,
430 ADDR_PIPECFG_P8_32x64_32x32
= 15,
431 ADDR_PIPECFG_P16_32x32_8x16
= 17, /// 16 pipes
432 ADDR_PIPECFG_P16_32x32_16x16
= 18,
433 ADDR_PIPECFG_MAX
= 19,
437 ****************************************************************************************************
441 * Neutral enums that specifies micro tile type (MICRO_TILE_MODE)
442 ****************************************************************************************************
444 typedef enum _AddrTileType
446 ADDR_DISPLAYABLE
= 0, ///< Displayable tiling
447 ADDR_NON_DISPLAYABLE
= 1, ///< Non-displayable tiling, a.k.a thin micro tiling
448 ADDR_DEPTH_SAMPLE_ORDER
= 2, ///< Same as non-displayable plus depth-sample-order
449 ADDR_ROTATED
= 3, ///< Rotated displayable tiling
450 ADDR_THICK
= 4, ///< Thick micro-tiling, only valid for THICK and XTHICK
453 ///////////////////////////////////////////////////////////////////////////////////////////////////
455 // Type definitions: short system-independent names for address library types
457 ///////////////////////////////////////////////////////////////////////////////////////////////////
459 #if !defined(__APPLE__) || defined(HAVE_TSERVER)
461 #ifndef BOOL_32 // no bool type in C
462 /// @brief Boolean type, since none is defined in C
472 #define UINT_32 unsigned int
480 #define UINT_16 unsigned short
488 #define UINT_8 unsigned char
504 // 64-bit integer types depend on the compiler
506 #if defined( __GNUC__ ) || defined( __WATCOMC__ )
507 #define INT_64 long long
508 #define UINT_64 unsigned long long
510 #elif defined( _WIN32 )
511 #define INT_64 __int64
512 #define UINT_64 unsigned __int64
515 #error Unsupported compiler and/or operating system for 64-bit integers
517 /// @brief 64-bit signed integer type (compiler dependent)
520 /// The addrlib defines a 64-bit signed integer type for either
521 /// Gnu/Watcom compilers (which use the first syntax) or for
522 /// the Windows VCC compiler (which uses the second syntax).
523 #define INT_64 long long OR __int64
525 /// @brief 64-bit unsigned integer type (compiler dependent)
528 /// The addrlib defines a 64-bit unsigned integer type for either
529 /// Gnu/Watcom compilers (which use the first syntax) or for
530 /// the Windows VCC compiler (which uses the second syntax).
532 #define UINT_64 unsigned long long OR unsigned __int64
535 #endif // #if !defined(__APPLE__) || defined(HAVE_TSERVER)
537 // ADDR64X is used to print addresses in hex form on both Windows and Linux
539 #if defined( __GNUC__ ) || defined( __WATCOMC__ )
540 #define ADDR64X "llx"
541 #define ADDR64D "lld"
543 #elif defined( _WIN32 )
544 #define ADDR64X "I64x"
545 #define ADDR64D "I64d"
548 #error Unsupported compiler and/or operating system for 64-bit integers
550 /// @brief Addrlib device address 64-bit printf tag (compiler dependent)
553 /// This allows printf to display an ADDR_64 for either the Windows VCC compiler
554 /// (which used this value) or the Gnu/Watcom compilers (which use "llx".
555 /// An example of use is printf("addr 0x%"ADDR64X"\n", address);
557 #define ADDR64X "llx" OR "I64x"
558 #define ADDR64D "lld" OR "I64d"
562 /// @brief Union for storing a 32-bit float or 32-bit integer
565 /// This union provides a simple way to convert between a 32-bit float
566 /// and a 32-bit integer. It also prevents the compiler from producing
567 /// code that alters NaN values when assiging or coying floats.
568 /// Therefore, all address library routines that pass or return 32-bit
569 /// floating point data do so by passing or returning a FLT_32.
578 ///////////////////////////////////////////////////////////////////////////////////////////////////
580 // Macros for controlling linking and building on multiple systems
582 ///////////////////////////////////////////////////////////////////////////////////////////////////
583 #if defined(_MSC_VER)
585 #undef va_copy //redefine va_copy to support VC2013
589 #if !defined(va_copy)
590 #define va_copy(dst, src) \
591 ((void) memcpy(&(dst), &(src), sizeof(va_list)))
594 #endif // __ADDR_TYPES_H__