15#include "xrt/xrt_config_have.h"
16#include "xrt/xrt_config_build.h"
20#if defined(XRT_FEATURE_TRACING) && defined(XRT_HAVE_PERCETTO)
21#define U_TRACE_PERCETTO
25#if !defined(XRT_FEATURE_TRACING) || !defined(XRT_HAVE_TRACY)
26#define U_TRACE_FUNC_COLOR(CATEGORY, COLOR) \
28 U_TRACE_FUNC(CATEGORY)
30#define U_TRACE_IDENT_COLOR(CATEGORY, IDENT, COLOR) \
32 U_TRACE_IDENT(CATEGORY, IDENT)
34#define U_TRACE_BEGIN_COLOR(CATEGORY, IDENT, COLOR) \
36 U_TRACE_BEGIN(CATEGORY, IDENT)
39#if defined(XRT_FEATURE_TRACING) && defined(XRT_HAVE_TRACY)
44#include "tracy/TracyC.h"
46#include "tracy/Tracy.hpp"
62 U_TRACE_WHICH_SERVICE,
82#define COLOR_TRACE_MARKER(COLOR) U_TRACE_FUNC_COLOR(color, COLOR)
83#define COLOR_TRACE_IDENT(IDENT, COLOR) U_TRACE_IDENT_COLOR(color, IDENT, COLOR)
84#define COLOR_TRACE_BEGIN(IDENT, COLOR) U_TRACE_BEGIN_COLOR(color, IDENT, COLOR)
85#define COLOR_TRACE_END(IDENT) U_TRACE_END(color, IDENT)
87#define VK_TRACE_MARKER() U_TRACE_FUNC_COLOR(vk, 0xffffff)
88#define VK_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(vk, IDENT, 0xffffff)
89#define VK_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(vk, IDENT, 0xffffff)
90#define VK_TRACE_END(IDENT) U_TRACE_END(vk, IDENT)
92#define VK_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x491556)
93#define VK_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x324ff2)
94#define VK_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xabc9c8)
95#define VK_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xc12a8a)
97#define XRT_TRACE_MARKER() U_TRACE_FUNC_COLOR(xrt, 0x708090)
98#define XRT_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(xrt, IDENT, 0x708090)
99#define XRT_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(xrt, IDENT, 0x708090)
100#define XRT_TRACE_END(IDENT) U_TRACE_END(xrt, IDENT)
102#define XRT_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x1e1447)
103#define XRT_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x404444)
104#define XRT_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x0c080b)
105#define XRT_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xeff9d6)
107#define DRV_TRACE_MARKER() U_TRACE_FUNC_COLOR(drv, 0x000080)
108#define DRV_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(drv, IDENT, 0x000080)
109#define DRV_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(drv, IDENT, 0x000080)
110#define DRV_TRACE_END(IDENT) U_TRACE_END(drv, IDENT)
112#define DRV_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x000107)
113#define DRV_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xc9bad3)
114#define DRV_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x1bb4ba)
115#define DRV_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x05080a)
117#define IPC_TRACE_MARKER() U_TRACE_FUNC_COLOR(ipc, 0x87cefa)
118#define IPC_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(ipc, IDENT, 0x87cefa)
119#define IPC_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(ipc, IDENT, 0x87cefa)
120#define IPC_TRACE_END(IDENT) U_TRACE_END(ipc, IDENT)
122#define IPC_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xc934d3)
123#define IPC_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x010f05)
124#define IPC_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x050707)
125#define IPC_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x0c0108)
127#define OXR_TRACE_MARKER() U_TRACE_FUNC_COLOR(oxr, 0x7fffd4)
128#define OXR_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(oxr, IDENT, 0x7fffd4)
129#define OXR_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(oxr, IDENT, 0x7fffd4)
130#define OXR_TRACE_END(IDENT) U_TRACE_END(oxr, IDENT, 0x7fffd4)
132#define OXR_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xb06044)
133#define OXR_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xe8e7e5)
134#define OXR_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x135584)
135#define OXR_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x20eac5)
137#define COMP_TRACE_MARKER() U_TRACE_FUNC_COLOR(comp, 0x00ff00)
138#define COMP_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x00ff00)
139#define COMP_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(comp, IDENT, 0x00ff00)
140#define COMP_TRACE_END(IDENT) U_TRACE_END(comp, IDENT)
142#define COMP_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xff2312)
143#define COMP_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x2312ff)
144#define COMP_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x33a012)
145#define COMP_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x88a0d2)
147#define SINK_TRACE_MARKER() U_TRACE_FUNC_COLOR(sink, 0xffa500)
148#define SINK_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(sink, IDENT, 0xffa500)
149#define SINK_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(sink, IDENT, 0xffa500)
150#define SINK_TRACE_END(IDENT) U_TRACE_END(sink, IDENT)
152#define SINK_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x898368)
153#define SINK_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x026d09)
154#define SINK_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xa6eda1)
155#define SINK_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x233f93)
157#define SWAPCHAIN_TRACE_MARKER() U_TRACE_FUNC_COLOR(sc, 0x007700)
158#define SWAPCHAIN_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(sc, IDENT, 0x007700)
159#define SWAPCHAIN_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(sc, IDENT, 0x007700)
160#define SWAPCHAIN_TRACE_END(IDENT) U_TRACE_END(sc, IDENT)
162#define SWAPCHAIN_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xa4a4f2)
163#define SWAPCHAIN_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x376349)
164#define SWAPCHAIN_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xa0766a)
165#define SWAPCHAIN_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xacdce0)
167#define TRACK_TRACE_MARKER() U_TRACE_FUNC_COLOR(track, 0xff0000)
168#define TRACK_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(track, IDENT, 0xff0000)
169#define TRACK_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(track, IDENT, 0xff0000)
170#define TRACK_TRACE_END(IDENT) U_TRACE_END(track, IDENT, 0xff0000)
172#define TRACK_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x384949)
173#define TRACK_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x373d1e)
174#define TRACK_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x053d37)
175#define TRACK_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x0b223f)
184#ifndef XRT_FEATURE_TRACING
187#define U_TRACE_FUNC(CATEGORY) \
191#define U_TRACE_IDENT(CATEGORY, IDENT) \
195#define U_TRACE_BEGIN(CATEGORY, IDENT) \
196 int __trace_##IDENT = 0; \
200#define U_TRACE_END(CATEGORY, IDENT) \
202 (void)__trace_##IDENT; \
205#define U_TRACE_EVENT_BEGIN_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
209#define U_TRACE_EVENT_BEGIN_ON_TRACK_DATA(CATEGORY, TRACK, TIME, NAME, ...) \
213#define U_TRACE_EVENT_END_ON_TRACK(CATEGORY, TRACK, TIME) \
217#define U_TRACE_INSTANT_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
221#define U_TRACE_CATEGORY_IS_ENABLED(_) (false)
223#define U_TRACE_SET_THREAD_NAME(STRING) \
233#define U_TRACE_TARGET_SETUP(WHICH)
242#elif defined(XRT_HAVE_TRACY)
247#define U_TRACE_FUNC_COLOR(CATEGORY, COLOR) ZoneScopedC(COLOR)
249#define U_TRACE_FUNC(CATEGORY) ZoneScoped
251#define U_TRACE_IDENT_COLOR(CATEGORY, IDENT, COLOR) ZoneScopedNC(#IDENT, COLOR)
253#define U_TRACE_IDENT(CATEGORY, IDENT) ZoneScopedN(#IDENT)
255#elif !defined(XRT_OS_WINDOWS) || defined(__clang__)
258u_trace_scope_cleanup(TracyCZoneCtx *ctx_ptr)
260 TracyCZoneEnd(*ctx_ptr);
263#define U_TRACE_FUNC_COLOR(CATEGORY, COLOR) \
264 static const struct ___tracy_source_location_data __func_loc = { \
265 NULL, __func__, __FILE__, (uint32_t)__LINE__, COLOR, \
267 TracyCZoneCtx __attribute__((cleanup(u_trace_scope_cleanup))) ctx = \
268 ___tracy_emit_zone_begin(&__func_loc, true); \
272#define U_TRACE_FUNC(CATEGORY) \
273 static const struct ___tracy_source_location_data __func_loc = { \
274 NULL, __func__, __FILE__, (uint32_t)__LINE__, 0, \
276 TracyCZoneCtx __attribute__((cleanup(u_trace_scope_cleanup))) ctx = \
277 ___tracy_emit_zone_begin(&__func_loc, true); \
280#define U_TRACE_IDENT_COLOR(CATEGORY, IDENT, COLOR) \
281 static const struct ___tracy_source_location_data __##IDENT##_loc = { \
282 #IDENT, __func__, __FILE__, (uint32_t)__LINE__, COLOR, \
284 TracyCZoneCtx __attribute__((cleanup(u_trace_scope_cleanup))) ctx##IDENT = \
285 ___tracy_emit_zone_begin(&__##IDENT##_loc, true); \
288#define U_TRACE_IDENT(CATEGORY, IDENT) \
289 static const struct ___tracy_source_location_data __##IDENT##_loc = { \
290 #IDENT, __func__, __FILE__, (uint32_t)__LINE__, 0, \
292 TracyCZoneCtx __attribute__((cleanup(u_trace_scope_cleanup))) ctx##IDENT = \
293 ___tracy_emit_zone_begin(&__##IDENT##_loc, true); \
297#define U_TRACE_FUNC_COLOR(CATEGORY, COLOR) \
301#define U_TRACE_FUNC(CATEGORY) \
305#define U_TRACE_IDENT_COLOR(CATEGORY, IDENT, COLOR) \
309#define U_TRACE_IDENT(CATEGORY, IDENT) \
315#define U_TRACE_BEGIN(CATEGORY, IDENT) TracyCZoneN(__trace_##IDENT, #IDENT, true)
316#define U_TRACE_BEGIN_COLOR(CATEGORY, IDENT, COLOR) TracyCZoneNC(__trace_##IDENT, #IDENT, COLOR, true)
317#define U_TRACE_END(CATEGORY, IDENT) TracyCZoneEnd(__trace_##IDENT)
319#define U_TRACE_EVENT_BEGIN_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
323#define U_TRACE_EVENT_BEGIN_ON_TRACK_DATA(CATEGORY, TRACK, TIME, NAME, ...) \
327#define U_TRACE_EVENT_END_ON_TRACK(CATEGORY, TRACK, TIME) \
331#define U_TRACE_INSTANT_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
335#define U_TRACE_CATEGORY_IS_ENABLED(_) (true)
337#define U_TRACE_SET_THREAD_NAME(STRING) \
340 TracyCZoneN(created, "created", true); \
341 TracyCSetThreadName(STRING); \
342 TracyCZoneEnd(created); \
345#define U_TRACE_TARGET_SETUP(WHICH)
354#elif defined(XRT_HAVE_PERCETTO)
357#error "Tracing only supported on Linux"
361#define U_TRACE_CATEGORIES(C, G) \
373PERCETTO_CATEGORY_DECLARE(U_TRACE_CATEGORIES)
375PERCETTO_TRACK_DECLARE(pc_cpu);
376PERCETTO_TRACK_DECLARE(pc_allotted);
377PERCETTO_TRACK_DECLARE(pc_gpu);
378PERCETTO_TRACK_DECLARE(pc_margin);
379PERCETTO_TRACK_DECLARE(pc_error);
380PERCETTO_TRACK_DECLARE(pc_info);
381PERCETTO_TRACK_DECLARE(pc_present);
382PERCETTO_TRACK_DECLARE(pa_cpu);
383PERCETTO_TRACK_DECLARE(pa_draw);
384PERCETTO_TRACK_DECLARE(pa_wait);
386#define U_TRACE_FUNC(CATEGORY) TRACE_EVENT(CATEGORY, __func__)
387#define U_TRACE_IDENT(CATEGORY, IDENT) TRACE_EVENT(CATEGORY, #IDENT)
388#define U_TRACE_BEGIN(CATEGORY, IDENT) TRACE_EVENT_BEGIN(CATEGORY, #IDENT)
389#define U_TRACE_END(CATEGORY, IDENT) TRACE_EVENT_END(CATEGORY)
390#define U_TRACE_EVENT_BEGIN_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
391 TRACE_EVENT_BEGIN_ON_TRACK(CATEGORY, TRACK, TIME, NAME)
392#define U_TRACE_EVENT_BEGIN_ON_TRACK_DATA(CATEGORY, TRACK, TIME, NAME, ...) \
393 TRACE_EVENT_BEGIN_ON_TRACK_DATA(CATEGORY, TRACK, TIME, NAME, __VA_ARGS__)
394#define U_TRACE_EVENT_END_ON_TRACK(CATEGORY, TRACK, TIME) TRACE_EVENT_END_ON_TRACK(CATEGORY, TRACK, TIME)
395#define U_TRACE_CATEGORY_IS_ENABLED(CATEGORY) PERCETTO_CATEGORY_IS_ENABLED(CATEGORY)
396#define U_TRACE_INSTANT_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
397 TRACE_ANY_WITH_ARGS(PERCETTO_EVENT_INSTANT, CATEGORY, &g_percetto_track_##TRACK, TIME, NAME, 0)
398#define U_TRACE_DATA(fd, type, data) u_trace_data(fd, type, (void *)&(data), sizeof(data))
400#define U_TRACE_SET_THREAD_NAME(STRING) \
405#define U_TRACE_TARGET_SETUP(WHICH) \
406 void __attribute__((constructor(101))) u_trace_marker_constructor(void); \
408 void u_trace_marker_constructor(void) \
410 u_trace_marker_setup(WHICH); \
415#error "Need to have Percetto/Perfetto"
u_trace_which
Should the extra tracks be enabled, see Tracing support.
Definition: u_trace_marker.h:61
void u_trace_marker_setup(enum u_trace_which which)
Internal setup function, use U_TRACE_TARGET_SETUP, see Tracing support.
Definition: u_trace_marker.c:95
void u_trace_marker_init(void)
Must be called from a non-static/global constructor context.
Definition: u_trace_marker.c:103
Header holding common defines.
Auto detect OS and certain features.