xref: /aosp_15_r20/external/mesa3d/src/intel/dev/intel_debug.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1 /*
2  * Copyright 2003 VMware, Inc.
3  * Copyright © 2007 Intel Corporation
4  *
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, sublicense, 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:
12  *
13  * The above copyright notice and this permission notice (including the
14  * next paragraph) shall be included in all copies or substantial
15  * portions of the Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
18  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
20  * IN NO EVENT SHALL THE COPYRIGHT OWNER(S) AND/OR ITS SUPPLIERS BE
21  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
22  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
23  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24  */
25 
26 #ifndef INTEL_DEBUG_H
27 #define INTEL_DEBUG_H
28 
29 #include <stdint.h>
30 #include "compiler/shader_enums.h"
31 #include "util/macros.h"
32 
33 #ifdef __cplusplus
34 extern "C" {
35 #endif
36 /**
37  * \file intel_debug.h
38  *
39  * Basic INTEL_DEBUG environment variable handling.  This file defines the
40  * list of debugging flags, as well as some macros for handling them.
41  */
42 
43 extern uint64_t intel_debug;
44 
45 /* Returns 0/1, not the matching bit mask. */
46 #define INTEL_DEBUG(flags)        unlikely(intel_debug & (flags))
47 
48 #define DEBUG_TEXTURE             (1ull <<  0)
49 #define DEBUG_BLIT                (1ull <<  1)
50 #define DEBUG_PERF                (1ull <<  2)
51 #define DEBUG_PERFMON             (1ull <<  3)
52 #define DEBUG_BATCH               (1ull <<  4)
53 #define DEBUG_BUFMGR              (1ull <<  5)
54 #define DEBUG_GS                  (1ull <<  6)
55 #define DEBUG_SYNC                (1ull <<  7)
56 #define DEBUG_SF                  (1ull <<  8)
57 #define DEBUG_SUBMIT              (1ull <<  9)
58 #define DEBUG_WM                  (1ull << 10)
59 #define DEBUG_URB                 (1ull << 11)
60 #define DEBUG_VS                  (1ull << 12)
61 #define DEBUG_CLIP                (1ull << 13)
62 #define DEBUG_STALL               (1ull << 14)
63 #define DEBUG_BLORP               (1ull << 15)
64 /* reserved                       (1ull << 16) */
65 #define DEBUG_NO_DUAL_OBJECT_GS   (1ull << 17)
66 #define DEBUG_OPTIMIZER           (1ull << 18)
67 #define DEBUG_ANNOTATION          (1ull << 19)
68 /* reserved                       (1ull << 20) */
69 #define DEBUG_NO_OACONFIG         (1ull << 21)
70 #define DEBUG_SPILL_FS            (1ull << 22)
71 #define DEBUG_SPILL_VEC4          (1ull << 23)
72 #define DEBUG_CS                  (1ull << 24)
73 #define DEBUG_HEX                 (1ull << 25)
74 #define DEBUG_NO_COMPACTION       (1ull << 26)
75 #define DEBUG_TCS                 (1ull << 27)
76 #define DEBUG_TES                 (1ull << 28)
77 #define DEBUG_L3                  (1ull << 29)
78 #define DEBUG_DO32                (1ull << 30)
79 #define DEBUG_NO_CCS              (1ull << 31)
80 #define DEBUG_NO_HIZ              (1ull << 32)
81 #define DEBUG_COLOR               (1ull << 33)
82 #define DEBUG_REEMIT              (1ull << 34)
83 #define DEBUG_SOFT64              (1ull << 35)
84 #define DEBUG_BT                  (1ull << 36)
85 #define DEBUG_PIPE_CONTROL        (1ull << 37)
86 #define DEBUG_NO_FAST_CLEAR       (1ull << 38)
87 /* reserved                       (1ull << 39) */
88 #define DEBUG_RT                  (1ull << 40)
89 #define DEBUG_TASK                (1ull << 41)
90 #define DEBUG_MESH                (1ull << 42)
91 #define DEBUG_CAPTURE_ALL         (1ull << 43)
92 #define DEBUG_PERF_SYMBOL_NAMES   (1ull << 44)
93 #define DEBUG_SWSB_STALL          (1ull << 45)
94 #define DEBUG_HEAPS               (1ull << 46)
95 #define DEBUG_ISL                 (1ull << 47)
96 #define DEBUG_SPARSE              (1ull << 48)
97 #define DEBUG_DRAW_BKP            (1ull << 49)
98 #define DEBUG_BATCH_STATS         (1ull << 50)
99 #define DEBUG_REG_PRESSURE        (1ull << 51)
100 #define DEBUG_SHADER_PRINT        (1ull << 52)
101 #define DEBUG_CL_QUIET            (1ull << 53)
102 
103 #define DEBUG_ANY                 (~0ull)
104 
105 /* These flags are not compatible with the disk shader cache */
106 #define DEBUG_DISK_CACHE_DISABLE_MASK 0
107 
108 /* These flags may affect program generation */
109 #define DEBUG_DISK_CACHE_MASK \
110    (DEBUG_NO_DUAL_OBJECT_GS | DEBUG_SPILL_FS | \
111    DEBUG_SPILL_VEC4 | DEBUG_NO_COMPACTION | DEBUG_DO32 | DEBUG_SOFT64)
112 
113 extern uint64_t intel_simd;
114 extern uint32_t intel_debug_bkp_before_draw_count;
115 extern uint32_t intel_debug_bkp_after_draw_count;
116 extern uint64_t intel_debug_batch_frame_start;
117 extern uint64_t intel_debug_batch_frame_stop;
118 
119 #define INTEL_SIMD(type, size)        (!!(intel_simd & (DEBUG_ ## type ## _SIMD ## size)))
120 
121 /* VS, TCS, TES and GS stages are dispatched in one size */
122 #define DEBUG_FS_SIMD8    (1ull << 0)
123 #define DEBUG_FS_SIMD16   (1ull << 1)
124 #define DEBUG_FS_SIMD32   (1ull << 2)
125 #define DEBUG_FS_SIMD2X8  (1ull << 3)
126 #define DEBUG_FS_SIMD4X8  (1ull << 4)
127 #define DEBUG_FS_SIMD2X16 (1ull << 5)
128 
129 #define DEBUG_CS_SIMD8    (1ull << 6)
130 #define DEBUG_CS_SIMD16   (1ull << 7)
131 #define DEBUG_CS_SIMD32   (1ull << 8)
132 
133 #define DEBUG_TS_SIMD8    (1ull << 9)
134 #define DEBUG_TS_SIMD16   (1ull << 10)
135 #define DEBUG_TS_SIMD32   (1ull << 11)
136 
137 #define DEBUG_MS_SIMD8    (1ull << 12)
138 #define DEBUG_MS_SIMD16   (1ull << 13)
139 #define DEBUG_MS_SIMD32   (1ull << 14)
140 
141 #define DEBUG_RT_SIMD8    (1ull << 15)
142 #define DEBUG_RT_SIMD16   (1ull << 16)
143 #define DEBUG_RT_SIMD32   (1ull << 17)
144 
145 #define SIMD_DISK_CACHE_MASK ((1ull << 18) - 1)
146 
147 #ifdef HAVE_ANDROID_PLATFORM
148 #define LOG_TAG "INTEL-MESA"
149 #if ANDROID_API_LEVEL >= 26
150 #include <log/log.h>
151 #else
152 #include <cutils/log.h>
153 #endif /* use log/log.h start from android 8 major version */
154 #ifndef ALOGW
155 #define ALOGW LOGW
156 #endif
157 #define dbg_printf(...)	ALOGW(__VA_ARGS__)
158 #else
159 #define dbg_printf(...)	fprintf(stderr, __VA_ARGS__)
160 #endif /* HAVE_ANDROID_PLATFORM */
161 
162 #define DBG(...) do {                  \
163    if (INTEL_DEBUG(FILE_DEBUG_FLAG))   \
164       dbg_printf(__VA_ARGS__);         \
165 } while(0)
166 
167 extern uint64_t intel_debug_flag_for_shader_stage(gl_shader_stage stage);
168 
169 extern void process_intel_debug_variable(void);
170 
171 #ifdef __cplusplus
172 }
173 #endif
174 
175 #endif /* INTEL_DEBUG_H */
176