16#include "xrt/xrt_config_have.h"
17#include "xrt/xrt_config_build.h"
21#if defined(XRT_FEATURE_TRACING) && defined(XRT_HAVE_PERCETTO)
22#define U_TRACE_PERCETTO
26#if !defined(XRT_FEATURE_TRACING) || !defined(XRT_HAVE_TRACY)
27#define U_TRACE_FUNC_COLOR(CATEGORY, COLOR) \
29 U_TRACE_FUNC(CATEGORY)
31#define U_TRACE_IDENT_COLOR(CATEGORY, IDENT, COLOR) \
33 U_TRACE_IDENT(CATEGORY, IDENT)
35#define U_TRACE_BEGIN_COLOR(CATEGORY, IDENT, COLOR) \
37 U_TRACE_BEGIN(CATEGORY, IDENT)
40#if defined(XRT_FEATURE_TRACING) && defined(XRT_HAVE_TRACY)
45#include "tracy/TracyC.h"
47#include "tracy/Tracy.hpp"
63 U_TRACE_WHICH_SERVICE,
84#define COLOR_TRACE_MARKER(COLOR) U_TRACE_FUNC_COLOR(color, COLOR)
85#define COLOR_TRACE_IDENT(IDENT, COLOR) U_TRACE_IDENT_COLOR(color, IDENT, COLOR)
86#define COLOR_TRACE_BEGIN(IDENT, COLOR) U_TRACE_BEGIN_COLOR(color, IDENT, COLOR)
87#define COLOR_TRACE_END(IDENT) U_TRACE_END(color, IDENT)
89#define VK_TRACE_MARKER() U_TRACE_FUNC_COLOR(vk, 0xffffff)
90#define VK_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(vk, IDENT, 0xffffff)
91#define VK_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(vk, IDENT, 0xffffff)
92#define VK_TRACE_END(IDENT) U_TRACE_END(vk, IDENT)
94#define VK_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x491556)
95#define VK_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x324ff2)
96#define VK_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xabc9c8)
97#define VK_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xc12a8a)
99#define XRT_TRACE_MARKER() U_TRACE_FUNC_COLOR(xrt, 0x708090)
100#define XRT_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(xrt, IDENT, 0x708090)
101#define XRT_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(xrt, IDENT, 0x708090)
102#define XRT_TRACE_END(IDENT) U_TRACE_END(xrt, IDENT)
104#define XRT_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x1e1447)
105#define XRT_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x404444)
106#define XRT_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x0c080b)
107#define XRT_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xeff9d6)
109#define DRV_TRACE_MARKER() U_TRACE_FUNC_COLOR(drv, 0x000080)
110#define DRV_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(drv, IDENT, 0x000080)
111#define DRV_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(drv, IDENT, 0x000080)
112#define DRV_TRACE_END(IDENT) U_TRACE_END(drv, IDENT)
114#define DRV_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x000107)
115#define DRV_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xc9bad3)
116#define DRV_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x1bb4ba)
117#define DRV_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x05080a)
119#define IPC_TRACE_MARKER() U_TRACE_FUNC_COLOR(ipc, 0x87cefa)
120#define IPC_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(ipc, IDENT, 0x87cefa)
121#define IPC_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(ipc, IDENT, 0x87cefa)
122#define IPC_TRACE_END(IDENT) U_TRACE_END(ipc, IDENT)
124#define IPC_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xc934d3)
125#define IPC_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x010f05)
126#define IPC_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x050707)
127#define IPC_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x0c0108)
129#define OXR_TRACE_MARKER() U_TRACE_FUNC_COLOR(oxr, 0x7fffd4)
130#define OXR_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(oxr, IDENT, 0x7fffd4)
131#define OXR_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(oxr, IDENT, 0x7fffd4)
132#define OXR_TRACE_END(IDENT) U_TRACE_END(oxr, IDENT, 0x7fffd4)
134#define OXR_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xb06044)
135#define OXR_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xe8e7e5)
136#define OXR_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x135584)
137#define OXR_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x20eac5)
139#define COMP_TRACE_MARKER() U_TRACE_FUNC_COLOR(comp, 0x00ff00)
140#define COMP_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x00ff00)
141#define COMP_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(comp, IDENT, 0x00ff00)
142#define COMP_TRACE_END(IDENT) U_TRACE_END(comp, IDENT)
144#define COMP_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xff2312)
145#define COMP_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x2312ff)
146#define COMP_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x33a012)
147#define COMP_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x88a0d2)
149#define SINK_TRACE_MARKER() U_TRACE_FUNC_COLOR(sink, 0xffa500)
150#define SINK_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(sink, IDENT, 0xffa500)
151#define SINK_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(sink, IDENT, 0xffa500)
152#define SINK_TRACE_END(IDENT) U_TRACE_END(sink, IDENT)
154#define SINK_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x898368)
155#define SINK_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x026d09)
156#define SINK_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xa6eda1)
157#define SINK_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x233f93)
159#define SWAPCHAIN_TRACE_MARKER() U_TRACE_FUNC_COLOR(sc, 0x007700)
160#define SWAPCHAIN_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(sc, IDENT, 0x007700)
161#define SWAPCHAIN_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(sc, IDENT, 0x007700)
162#define SWAPCHAIN_TRACE_END(IDENT) U_TRACE_END(sc, IDENT)
164#define SWAPCHAIN_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xa4a4f2)
165#define SWAPCHAIN_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x376349)
166#define SWAPCHAIN_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xa0766a)
167#define SWAPCHAIN_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0xacdce0)
169#define TRACK_TRACE_MARKER() U_TRACE_FUNC_COLOR(track, 0xff0000)
170#define TRACK_TRACE_IDENT(IDENT) U_TRACE_IDENT_COLOR(track, IDENT, 0xff0000)
171#define TRACK_TRACE_BEGIN(IDENT) U_TRACE_BEGIN_COLOR(track, IDENT, 0xff0000)
172#define TRACK_TRACE_END(IDENT) U_TRACE_END(track, IDENT, 0xff0000)
174#define TRACK_TRACE_IDENT_SUBZONE1(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x384949)
175#define TRACK_TRACE_IDENT_SUBZONE2(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x373d1e)
176#define TRACK_TRACE_IDENT_SUBZONE3(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x053d37)
177#define TRACK_TRACE_IDENT_SUBZONE4(IDENT) U_TRACE_IDENT_COLOR(comp, IDENT, 0x0b223f)
186#ifndef XRT_FEATURE_TRACING
189#define U_TRACE_FUNC(CATEGORY) \
193#define U_TRACE_IDENT(CATEGORY, IDENT) \
197#define U_TRACE_BEGIN(CATEGORY, IDENT) \
198 int __trace_##IDENT = 0; \
202#define U_TRACE_END(CATEGORY, IDENT) \
204 (void)__trace_##IDENT; \
207#define U_TRACE_EVENT_BEGIN_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
211#define U_TRACE_EVENT_BEGIN_ON_TRACK_DATA(CATEGORY, TRACK, TIME, NAME, ...) \
215#define U_TRACE_EVENT_END_ON_TRACK(CATEGORY, TRACK, TIME) \
219#define U_TRACE_INSTANT_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
223#define U_TRACE_CATEGORY_IS_ENABLED(_) (false)
225#define U_TRACE_SET_THREAD_NAME(STRING) \
235#define U_TRACE_TARGET_SETUP(WHICH)
244#elif defined(XRT_HAVE_TRACY)
249#define U_TRACE_FUNC_COLOR(CATEGORY, COLOR) ZoneScopedC(COLOR)
251#define U_TRACE_FUNC(CATEGORY) ZoneScoped
253#define U_TRACE_IDENT_COLOR(CATEGORY, IDENT, COLOR) ZoneScopedNC(#IDENT, COLOR)
255#define U_TRACE_IDENT(CATEGORY, IDENT) ZoneScopedN(#IDENT)
257#elif !defined(XRT_OS_WINDOWS) || defined(__clang__)
260u_trace_scope_cleanup(TracyCZoneCtx *ctx_ptr)
262 TracyCZoneEnd(*ctx_ptr);
265#define U_TRACE_FUNC_COLOR(CATEGORY, COLOR) \
266 static const struct ___tracy_source_location_data __func_loc = { \
267 NULL, __func__, __FILE__, (uint32_t)__LINE__, COLOR, \
269 TracyCZoneCtx __attribute__((cleanup(u_trace_scope_cleanup))) ctx = \
270 ___tracy_emit_zone_begin(&__func_loc, true); \
274#define U_TRACE_FUNC(CATEGORY) \
275 static const struct ___tracy_source_location_data __func_loc = { \
276 NULL, __func__, __FILE__, (uint32_t)__LINE__, 0, \
278 TracyCZoneCtx __attribute__((cleanup(u_trace_scope_cleanup))) ctx = \
279 ___tracy_emit_zone_begin(&__func_loc, true); \
282#define U_TRACE_IDENT_COLOR(CATEGORY, IDENT, COLOR) \
283 static const struct ___tracy_source_location_data __##IDENT##_loc = { \
284 #IDENT, __func__, __FILE__, (uint32_t)__LINE__, COLOR, \
286 TracyCZoneCtx __attribute__((cleanup(u_trace_scope_cleanup))) ctx##IDENT = \
287 ___tracy_emit_zone_begin(&__##IDENT##_loc, true); \
290#define U_TRACE_IDENT(CATEGORY, IDENT) \
291 static const struct ___tracy_source_location_data __##IDENT##_loc = { \
292 #IDENT, __func__, __FILE__, (uint32_t)__LINE__, 0, \
294 TracyCZoneCtx __attribute__((cleanup(u_trace_scope_cleanup))) ctx##IDENT = \
295 ___tracy_emit_zone_begin(&__##IDENT##_loc, true); \
299#define U_TRACE_FUNC_COLOR(CATEGORY, COLOR) \
303#define U_TRACE_FUNC(CATEGORY) \
307#define U_TRACE_IDENT_COLOR(CATEGORY, IDENT, COLOR) \
311#define U_TRACE_IDENT(CATEGORY, IDENT) \
317#define U_TRACE_BEGIN(CATEGORY, IDENT) TracyCZoneN(__trace_##IDENT, #IDENT, true)
318#define U_TRACE_BEGIN_COLOR(CATEGORY, IDENT, COLOR) TracyCZoneNC(__trace_##IDENT, #IDENT, COLOR, true)
319#define U_TRACE_END(CATEGORY, IDENT) TracyCZoneEnd(__trace_##IDENT)
321#define U_TRACE_EVENT_BEGIN_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
325#define U_TRACE_EVENT_BEGIN_ON_TRACK_DATA(CATEGORY, TRACK, TIME, NAME, ...) \
329#define U_TRACE_EVENT_END_ON_TRACK(CATEGORY, TRACK, TIME) \
333#define U_TRACE_INSTANT_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
337#define U_TRACE_CATEGORY_IS_ENABLED(_) (true)
339#define U_TRACE_SET_THREAD_NAME(STRING) \
342 TracyCZoneN(created, "created", true); \
343 TracyCSetThreadName(STRING); \
344 TracyCZoneEnd(created); \
347#define U_TRACE_TARGET_SETUP(WHICH)
356#elif defined(XRT_HAVE_PERCETTO)
359#error "Tracing only supported on Linux"
363#define U_TRACE_CATEGORIES(C, G) \
375PERCETTO_CATEGORY_DECLARE(U_TRACE_CATEGORIES)
377PERCETTO_TRACK_DECLARE(pc_cpu);
378PERCETTO_TRACK_DECLARE(pc_allotted);
379PERCETTO_TRACK_DECLARE(pc_gpu);
380PERCETTO_TRACK_DECLARE(pc_margin);
381PERCETTO_TRACK_DECLARE(pc_error);
382PERCETTO_TRACK_DECLARE(pc_info);
383PERCETTO_TRACK_DECLARE(pc_present);
384PERCETTO_TRACK_DECLARE(pa_cpu);
385PERCETTO_TRACK_DECLARE(pa_draw);
386PERCETTO_TRACK_DECLARE(pa_wait);
388#define U_TRACE_FUNC(CATEGORY) TRACE_EVENT(CATEGORY, __func__)
389#define U_TRACE_IDENT(CATEGORY, IDENT) TRACE_EVENT(CATEGORY, #IDENT)
390#define U_TRACE_BEGIN(CATEGORY, IDENT) TRACE_EVENT_BEGIN(CATEGORY, #IDENT)
391#define U_TRACE_END(CATEGORY, IDENT) TRACE_EVENT_END(CATEGORY)
392#define U_TRACE_EVENT_BEGIN_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
393 TRACE_EVENT_BEGIN_ON_TRACK(CATEGORY, TRACK, TIME, NAME)
394#define U_TRACE_EVENT_BEGIN_ON_TRACK_DATA(CATEGORY, TRACK, TIME, NAME, ...) \
395 TRACE_EVENT_BEGIN_ON_TRACK_DATA(CATEGORY, TRACK, TIME, NAME, __VA_ARGS__)
396#define U_TRACE_EVENT_END_ON_TRACK(CATEGORY, TRACK, TIME) TRACE_EVENT_END_ON_TRACK(CATEGORY, TRACK, TIME)
397#define U_TRACE_CATEGORY_IS_ENABLED(CATEGORY) PERCETTO_CATEGORY_IS_ENABLED(CATEGORY)
398#define U_TRACE_INSTANT_ON_TRACK(CATEGORY, TRACK, TIME, NAME) \
399 TRACE_ANY_WITH_ARGS(PERCETTO_EVENT_INSTANT, CATEGORY, &g_percetto_track_##TRACK, TIME, NAME, 0)
400#define U_TRACE_DATA(fd, type, data) u_trace_data(fd, type, (void *)&(data), sizeof(data))
402#define U_TRACE_SET_THREAD_NAME(STRING) \
407#define U_TRACE_TARGET_SETUP(WHICH) \
408 void __attribute__((constructor(101))) u_trace_marker_constructor(void); \
410 void u_trace_marker_constructor(void) \
412 u_trace_marker_setup(WHICH); \
417#error "Need to have Percetto/Perfetto"
u_trace_which
Should the extra tracks be enabled, see Tracing support.
Definition u_trace_marker.h:62
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.