1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
/*
* Copyright 2003 VMware, Inc.
* Copyright © 2006 Intel Corporation
* Copyright © 2017 Broadcom
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice (including the next
* paragraph) shall be included in all copies or substantial portions of the
* Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
* IN THE SOFTWARE.
*/
/**
* \file v3d_debug.c
*
* Support for the V3D_DEBUG environment variable, along with other
* miscellaneous debugging code.
*/
#include <stdlib.h>
#include "common/v3d_debug.h"
#include "util/macros.h"
#include "util/u_debug.h"
#include "c11/threads.h"
uint32_t v3d_mesa_debug = 0;
static const struct debug_named_value debug_control[] = {
{ "cl", V3D_DEBUG_CL,
"Dump command list during creation" },
{ "cl_nobin", V3D_DEBUG_CL_NO_BIN,
"Dump command list during creation, excluding binary resources" },
{ "clif", V3D_DEBUG_CLIF,
"Dump command list (CLIF format) during creation", },
{ "qpu", V3D_DEBUG_QPU,
"Dump generated QPU instructions" },
{ "vir", V3D_DEBUG_VIR,
"Dump VIR during program compile" },
{ "nir", V3D_DEBUG_NIR,
"Dump NIR during program compile" },
{ "tgsi", V3D_DEBUG_TGSI,
"Dump TGSI during program compile (v3d only)" },
/* `shaderdb` is *not* used by shader-db, but is here so that any other
* game/app can dump its stats in the shader-db format, allowing them
* to be compared using shader-db's report.py tool.
*/
{ "shaderdb", V3D_DEBUG_SHADERDB,
"Dump program compile information for shader-db analysis" },
{ "surface", V3D_DEBUG_SURFACE,
/* FIXME: evaluate to implement it on v3dv */
"Print resource layout information (v3d only)" },
{ "perf", V3D_DEBUG_PERF,
"Print performance-related events during runtime" },
{ "norast", V3D_DEBUG_NORAST,
/* FIXME: evaluate to implement on v3dv*/
"Skip actual hardware execution of commands (v3d only)" },
{ "fs", V3D_DEBUG_FS,
"Dump fragment shaders" },
{ "gs", V3D_DEBUG_GS,
"Dump geometry shaders" },
{ "vs", V3D_DEBUG_VS,
"Dump vertex shaders" },
{ "cs", V3D_DEBUG_CS,
"Dump computer shaders" },
{ "always_flush", V3D_DEBUG_ALWAYS_FLUSH,
"Flush after each draw call" },
{ "precompile", V3D_DEBUG_PRECOMPILE,
"Precompiles shader variant at shader state creation time (v3d only)" },
{ "ra", V3D_DEBUG_RA,
"Dump register allocation failures" },
{ "dump_spirv", V3D_DEBUG_DUMP_SPIRV,
"Dump SPIR-V code (v3dv only)" },
{ "tmu32", V3D_DEBUG_TMU_32BIT,
"Force 32-bit precision on all TMU operations" },
/* This can lead to incorrect behavior for applications that do
* require full 32-bit precision, but can improve performance
* for those that don't.
*/
{ "tmu16", V3D_DEBUG_TMU_16BIT,
"Force 16-bit precision on all TMU operations" },
{ "noloopunroll", V3D_DEBUG_NO_LOOP_UNROLL,
"Disable loop unrolling" },
{ "db", V3D_DEBUG_DOUBLE_BUFFER,
"Enable double buffer for Tile Buffer when MSAA is disabled" },
#ifdef ENABLE_SHADER_CACHE
{ "cache", V3D_DEBUG_CACHE,
"Print on-disk cache events (only with cache enabled)" },
#endif
{ "no_merge_jobs", V3D_DEBUG_NO_MERGE_JOBS,
"Don't try to merge subpasses in the same job even if they share framebuffer configuration (v3dv only)" },
{ "opt_compile_time", V3D_DEBUG_OPT_COMPILE_TIME,
"Don't try to reduce shader spilling, might improve compile times with expensive shaders." },
/* disable_tfu is v3dv only because v3d has some uses of the TFU without alternative codepaths */
{ "disable_tfu", V3D_DEBUG_DISABLE_TFU,
"Disable TFU (v3dv only)" },
DEBUG_NAMED_VALUE_END
};
DEBUG_GET_ONCE_FLAGS_OPTION(v3d_debug, "V3D_DEBUG", debug_control, 0)
bool
v3d_debug_flag_for_shader_stage(gl_shader_stage stage)
{
uint32_t flags[] = {
[MESA_SHADER_VERTEX] = V3D_DEBUG_VS,
[MESA_SHADER_TESS_CTRL] = 0,
[MESA_SHADER_TESS_EVAL] = 0,
[MESA_SHADER_GEOMETRY] = V3D_DEBUG_GS,
[MESA_SHADER_FRAGMENT] = V3D_DEBUG_FS,
[MESA_SHADER_COMPUTE] = V3D_DEBUG_CS,
};
STATIC_ASSERT(MESA_SHADER_STAGES == 6);
return v3d_mesa_debug & flags[stage];
}
void
v3d_process_debug_variable(void)
{
v3d_mesa_debug = debug_get_option_v3d_debug();
}
|
