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,
276 ADDR_FMT_ASTC_4x4
= 0x00000040,
277 ADDR_FMT_ASTC_5x4
= 0x00000041,
278 ADDR_FMT_ASTC_5x5
= 0x00000042,
279 ADDR_FMT_ASTC_6x5
= 0x00000043,
280 ADDR_FMT_ASTC_6x6
= 0x00000044,
281 ADDR_FMT_ASTC_8x5
= 0x00000045,
282 ADDR_FMT_ASTC_8x6
= 0x00000046,
283 ADDR_FMT_ASTC_8x8
= 0x00000047,
284 ADDR_FMT_ASTC_10x5
= 0x00000048,
285 ADDR_FMT_ASTC_10x6
= 0x00000049,
286 ADDR_FMT_ASTC_10x8
= 0x0000004a,
287 ADDR_FMT_ASTC_10x10
= 0x0000004b,
288 ADDR_FMT_ASTC_12x10
= 0x0000004c,
289 ADDR_FMT_ASTC_12x12
= 0x0000004d,
293 ****************************************************************************************************
297 * Neutral enum for addrFlt32ToDepthPixel
299 ****************************************************************************************************
301 typedef enum _AddrDepthFormat
303 ADDR_DEPTH_INVALID
= 0x00000000,
304 ADDR_DEPTH_16
= 0x00000001,
305 ADDR_DEPTH_X8_24
= 0x00000002,
306 ADDR_DEPTH_8_24
= 0x00000003,
307 ADDR_DEPTH_X8_24_FLOAT
= 0x00000004,
308 ADDR_DEPTH_8_24_FLOAT
= 0x00000005,
309 ADDR_DEPTH_32_FLOAT
= 0x00000006,
310 ADDR_DEPTH_X24_8_32_FLOAT
= 0x00000007,
315 ****************************************************************************************************
319 * Neutral enum for ColorFormat
321 ****************************************************************************************************
323 typedef enum _AddrColorFormat
325 ADDR_COLOR_INVALID
= 0x00000000,
326 ADDR_COLOR_8
= 0x00000001,
327 ADDR_COLOR_4_4
= 0x00000002,
328 ADDR_COLOR_3_3_2
= 0x00000003,
329 ADDR_COLOR_RESERVED_4
= 0x00000004,
330 ADDR_COLOR_16
= 0x00000005,
331 ADDR_COLOR_16_FLOAT
= 0x00000006,
332 ADDR_COLOR_8_8
= 0x00000007,
333 ADDR_COLOR_5_6_5
= 0x00000008,
334 ADDR_COLOR_6_5_5
= 0x00000009,
335 ADDR_COLOR_1_5_5_5
= 0x0000000a,
336 ADDR_COLOR_4_4_4_4
= 0x0000000b,
337 ADDR_COLOR_5_5_5_1
= 0x0000000c,
338 ADDR_COLOR_32
= 0x0000000d,
339 ADDR_COLOR_32_FLOAT
= 0x0000000e,
340 ADDR_COLOR_16_16
= 0x0000000f,
341 ADDR_COLOR_16_16_FLOAT
= 0x00000010,
342 ADDR_COLOR_8_24
= 0x00000011,
343 ADDR_COLOR_8_24_FLOAT
= 0x00000012,
344 ADDR_COLOR_24_8
= 0x00000013,
345 ADDR_COLOR_24_8_FLOAT
= 0x00000014,
346 ADDR_COLOR_10_11_11
= 0x00000015,
347 ADDR_COLOR_10_11_11_FLOAT
= 0x00000016,
348 ADDR_COLOR_11_11_10
= 0x00000017,
349 ADDR_COLOR_11_11_10_FLOAT
= 0x00000018,
350 ADDR_COLOR_2_10_10_10
= 0x00000019,
351 ADDR_COLOR_8_8_8_8
= 0x0000001a,
352 ADDR_COLOR_10_10_10_2
= 0x0000001b,
353 ADDR_COLOR_X24_8_32_FLOAT
= 0x0000001c,
354 ADDR_COLOR_32_32
= 0x0000001d,
355 ADDR_COLOR_32_32_FLOAT
= 0x0000001e,
356 ADDR_COLOR_16_16_16_16
= 0x0000001f,
357 ADDR_COLOR_16_16_16_16_FLOAT
= 0x00000020,
358 ADDR_COLOR_RESERVED_33
= 0x00000021,
359 ADDR_COLOR_32_32_32_32
= 0x00000022,
360 ADDR_COLOR_32_32_32_32_FLOAT
= 0x00000023,
364 ****************************************************************************************************
368 * Neutral enum for SurfaceNumber
370 ****************************************************************************************************
372 typedef enum _AddrSurfaceNumber
{
373 ADDR_NUMBER_UNORM
= 0x00000000,
374 ADDR_NUMBER_SNORM
= 0x00000001,
375 ADDR_NUMBER_USCALED
= 0x00000002,
376 ADDR_NUMBER_SSCALED
= 0x00000003,
377 ADDR_NUMBER_UINT
= 0x00000004,
378 ADDR_NUMBER_SINT
= 0x00000005,
379 ADDR_NUMBER_SRGB
= 0x00000006,
380 ADDR_NUMBER_FLOAT
= 0x00000007,
384 ****************************************************************************************************
388 * Neutral enum for SurfaceSwap
390 ****************************************************************************************************
392 typedef enum _AddrSurfaceSwap
{
393 ADDR_SWAP_STD
= 0x00000000,
394 ADDR_SWAP_ALT
= 0x00000001,
395 ADDR_SWAP_STD_REV
= 0x00000002,
396 ADDR_SWAP_ALT_REV
= 0x00000003,
400 ****************************************************************************************************
404 * Size of HTILE blocks, valid values are 4 or 8 for now
405 ****************************************************************************************************
407 typedef enum _AddrHtileBlockSize
409 ADDR_HTILE_BLOCKSIZE_4
= 4,
410 ADDR_HTILE_BLOCKSIZE_8
= 8,
411 } AddrHtileBlockSize
;
415 ****************************************************************************************************
419 * The pipe configuration field specifies both the number of pipes and
420 * how pipes are interleaved on the surface.
421 * The expression of number of pipes, the shader engine tile size, and packer tile size
422 * is encoded in a PIPE_CONFIG register field.
423 * In general the number of pipes usually matches the number of memory channels of the
424 * hardware configuration.
425 * For hw configurations w/ non-pow2 memory number of memory channels, it usually matches
426 * the number of ROP units(? TODO: which registers??)
427 * The enum value = hw enum + 1 which is to reserve 0 for requesting default.
428 ****************************************************************************************************
430 typedef enum _AddrPipeCfg
432 ADDR_PIPECFG_INVALID
= 0,
433 ADDR_PIPECFG_P2
= 1, /// 2 pipes,
434 ADDR_PIPECFG_P4_8x16
= 5, /// 4 pipes,
435 ADDR_PIPECFG_P4_16x16
= 6,
436 ADDR_PIPECFG_P4_16x32
= 7,
437 ADDR_PIPECFG_P4_32x32
= 8,
438 ADDR_PIPECFG_P8_16x16_8x16
= 9, /// 8 pipes
439 ADDR_PIPECFG_P8_16x32_8x16
= 10,
440 ADDR_PIPECFG_P8_32x32_8x16
= 11,
441 ADDR_PIPECFG_P8_16x32_16x16
= 12,
442 ADDR_PIPECFG_P8_32x32_16x16
= 13,
443 ADDR_PIPECFG_P8_32x32_16x32
= 14,
444 ADDR_PIPECFG_P8_32x64_32x32
= 15,
445 ADDR_PIPECFG_P16_32x32_8x16
= 17, /// 16 pipes
446 ADDR_PIPECFG_P16_32x32_16x16
= 18,
447 ADDR_PIPECFG_MAX
= 19,
451 ****************************************************************************************************
455 * Neutral enums that specifies micro tile type (MICRO_TILE_MODE)
456 ****************************************************************************************************
458 typedef enum _AddrTileType
460 ADDR_DISPLAYABLE
= 0, ///< Displayable tiling
461 ADDR_NON_DISPLAYABLE
= 1, ///< Non-displayable tiling, a.k.a thin micro tiling
462 ADDR_DEPTH_SAMPLE_ORDER
= 2, ///< Same as non-displayable plus depth-sample-order
463 ADDR_ROTATED
= 3, ///< Rotated displayable tiling
464 ADDR_THICK
= 4, ///< Thick micro-tiling, only valid for THICK and XTHICK
467 ////////////////////////////////////////////////////////////////////////////////////////////////////
469 // Type definitions: short system-independent names for address library types
471 ////////////////////////////////////////////////////////////////////////////////////////////////////
473 #if !defined(__APPLE__) || defined(HAVE_TSERVER)
475 #ifndef BOOL_32 // no bool type in C
476 /// @brief Boolean type, since none is defined in C
486 #define UINT_32 unsigned int
494 #define UINT_16 unsigned short
502 #define UINT_8 unsigned char
518 // 64-bit integer types depend on the compiler
520 #if defined( __GNUC__ ) || defined( __WATCOMC__ )
521 #define INT_64 long long
522 #define UINT_64 unsigned long long
524 #elif defined( _WIN32 )
525 #define INT_64 __int64
526 #define UINT_64 unsigned __int64
529 #error Unsupported compiler and/or operating system for 64-bit integers
531 /// @brief 64-bit signed integer type (compiler dependent)
534 /// The addrlib defines a 64-bit signed integer type for either
535 /// Gnu/Watcom compilers (which use the first syntax) or for
536 /// the Windows VCC compiler (which uses the second syntax).
537 #define INT_64 long long OR __int64
539 /// @brief 64-bit unsigned integer type (compiler dependent)
542 /// The addrlib defines a 64-bit unsigned integer type for either
543 /// Gnu/Watcom compilers (which use the first syntax) or for
544 /// the Windows VCC compiler (which uses the second syntax).
546 #define UINT_64 unsigned long long OR unsigned __int64
549 #endif // #if !defined(__APPLE__) || defined(HAVE_TSERVER)
551 // ADDR64X is used to print addresses in hex form on both Windows and Linux
553 #if defined( __GNUC__ ) || defined( __WATCOMC__ )
554 #define ADDR64X "llx"
555 #define ADDR64D "lld"
557 #elif defined( _WIN32 )
558 #define ADDR64X "I64x"
559 #define ADDR64D "I64d"
562 #error Unsupported compiler and/or operating system for 64-bit integers
564 /// @brief Addrlib device address 64-bit printf tag (compiler dependent)
567 /// This allows printf to display an ADDR_64 for either the Windows VCC compiler
568 /// (which used this value) or the Gnu/Watcom compilers (which use "llx".
569 /// An example of use is printf("addr 0x%"ADDR64X"\n", address);
571 #define ADDR64X "llx" OR "I64x"
572 #define ADDR64D "lld" OR "I64d"
576 /// @brief Union for storing a 32-bit float or 32-bit integer
579 /// This union provides a simple way to convert between a 32-bit float
580 /// and a 32-bit integer. It also prevents the compiler from producing
581 /// code that alters NaN values when assiging or coying floats.
582 /// Therefore, all address library routines that pass or return 32-bit
583 /// floating point data do so by passing or returning a FLT_32.
592 ////////////////////////////////////////////////////////////////////////////////////////////////////
594 // Macros for controlling linking and building on multiple systems
596 ////////////////////////////////////////////////////////////////////////////////////////////////////
597 #if defined(_MSC_VER)
599 #undef va_copy //redefine va_copy to support VC2013
603 #if !defined(va_copy)
604 #define va_copy(dst, src) \
605 ((void) memcpy(&(dst), &(src), sizeof(va_list)))
608 #endif // __ADDR_TYPES_H__