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 100 #define DEBUG_ANY (~0ull) 101 102 /* These flags are not compatible with the disk shader cache */ 103 #define DEBUG_DISK_CACHE_DISABLE_MASK 0 104 105 /* These flags may affect program generation */ 106 #define DEBUG_DISK_CACHE_MASK \ 107 (DEBUG_NO_DUAL_OBJECT_GS | DEBUG_SPILL_FS | \ 108 DEBUG_SPILL_VEC4 | DEBUG_NO_COMPACTION | DEBUG_DO32 | DEBUG_SOFT64) 109 110 extern uint64_t intel_simd; 111 extern uint32_t intel_debug_bkp_before_draw_count; 112 extern uint32_t intel_debug_bkp_after_draw_count; 113 114 #define INTEL_SIMD(type, size) (!!(intel_simd & (DEBUG_ ## type ## _SIMD ## size))) 115 116 /* VS, TCS, TES and GS stages are dispatched in one size */ 117 #define DEBUG_FS_SIMD8 (1ull << 0) 118 #define DEBUG_FS_SIMD16 (1ull << 1) 119 #define DEBUG_FS_SIMD32 (1ull << 2) 120 #define DEBUG_FS_SIMD2X8 (1ull << 3) 121 #define DEBUG_FS_SIMD4X8 (1ull << 4) 122 #define DEBUG_FS_SIMD2X16 (1ull << 5) 123 124 #define DEBUG_CS_SIMD8 (1ull << 6) 125 #define DEBUG_CS_SIMD16 (1ull << 7) 126 #define DEBUG_CS_SIMD32 (1ull << 8) 127 128 #define DEBUG_TS_SIMD8 (1ull << 9) 129 #define DEBUG_TS_SIMD16 (1ull << 10) 130 #define DEBUG_TS_SIMD32 (1ull << 11) 131 132 #define DEBUG_MS_SIMD8 (1ull << 12) 133 #define DEBUG_MS_SIMD16 (1ull << 13) 134 #define DEBUG_MS_SIMD32 (1ull << 14) 135 136 #define DEBUG_RT_SIMD8 (1ull << 15) 137 #define DEBUG_RT_SIMD16 (1ull << 16) 138 #define DEBUG_RT_SIMD32 (1ull << 17) 139 140 #define SIMD_DISK_CACHE_MASK ((1ull << 18) - 1) 141 142 #ifdef HAVE_ANDROID_PLATFORM 143 #define LOG_TAG "INTEL-MESA" 144 #if ANDROID_API_LEVEL >= 26 145 #include <log/log.h> 146 #else 147 #include <cutils/log.h> 148 #endif /* use log/log.h start from android 8 major version */ 149 #ifndef ALOGW 150 #define ALOGW LOGW 151 #endif 152 #define dbg_printf(...) ALOGW(__VA_ARGS__) 153 #else 154 #define dbg_printf(...) fprintf(stderr, __VA_ARGS__) 155 #endif /* HAVE_ANDROID_PLATFORM */ 156 157 #define DBG(...) do { \ 158 if (INTEL_DEBUG(FILE_DEBUG_FLAG)) \ 159 dbg_printf(__VA_ARGS__); \ 160 } while(0) 161 162 extern uint64_t intel_debug_flag_for_shader_stage(gl_shader_stage stage); 163 164 extern void process_intel_debug_variable(void); 165 166 /* Below is a list of structure located in the identifier buffer. The driver 167 * can fill those in for debug purposes. 168 */ 169 170 enum intel_debug_block_type { 171 /* End of the debug blocks */ 172 INTEL_DEBUG_BLOCK_TYPE_END = 1, 173 174 /* Driver identifier (struct intel_debug_block_driver) */ 175 INTEL_DEBUG_BLOCK_TYPE_DRIVER, 176 177 /* Frame identifier (struct intel_debug_block_frame) */ 178 INTEL_DEBUG_BLOCK_TYPE_FRAME, 179 180 /* Internal, never to be written out */ 181 INTEL_DEBUG_BLOCK_TYPE_MAX, 182 }; 183 184 struct intel_debug_block_base { 185 uint32_t type; /* enum intel_debug_block_type */ 186 uint32_t length; /* inclusive of this structure size */ 187 }; 188 189 struct intel_debug_block_driver { 190 struct intel_debug_block_base base; 191 uint8_t description[]; 192 }; 193 194 struct intel_debug_block_frame { 195 struct intel_debug_block_base base; 196 uint64_t frame_id; 197 }; 198 199 extern void *intel_debug_identifier(void); 200 extern uint32_t intel_debug_identifier_size(void); 201 202 extern uint32_t intel_debug_write_identifiers(void *output, 203 uint32_t output_size, 204 const char *driver_name); 205 206 extern void *intel_debug_get_identifier_block(void *buffer, 207 uint32_t buffer_size, 208 enum intel_debug_block_type type); 209 210 bool intel_debug_batch_in_range(uint64_t frame_id); 211 212 #ifdef __cplusplus 213 } 214 #endif 215 216 #endif /* INTEL_DEBUG_H */ 217