drivers/gpu/drm/imagination/pvr_trace.h

/* SPDX-License-Identifier: GPL-2.0 OR MIT */
/* Copyright (c) 2026 Imagination Technologies Ltd. */

#undef TRACE_SYSTEM
#define TRACE_SYSTEM pvr

#if !defined(PVR_TRACE_H) || defined(TRACE_HEADER_MULTI_READ)
#define PVR_TRACE_H

#include "pvr_context.h"
#include "pvr_device.h"
#include "pvr_fw.h"
#include "pvr_hwrt.h"
#include "pvr_job.h"
#include "pvr_sync.h"

#include <linux/stringify.h>
#include <linux/types.h>
#include <linux/tracepoint.h>

/*
 * NOTE:
 * When adding trace points, or extra data to existing ones - you must capture
 * all the data in the TP_fast_assign section that you wish to use in the
 * TP_printk section. This is because the printk is performed on demand from the
 * captured data when you `cat /sys/kernel/tracing/trace` and by the time this
 * happens any pointers you captured will likely no longer point to valid data.
 */

/* Job submit */

TRACE_EVENT(pvr_job_submit_ioctl,
	    TP_PROTO(struct pvr_device *pvr_dev, u32 count),
	    TP_ARGS(pvr_dev, count),
	    TP_STRUCT__entry(__field(struct pvr_device *, pvr_dev)
			     __field(u32, count)),
	    TP_fast_assign(__entry->pvr_dev = pvr_dev;
			   __entry->count = count;),
	    TP_printk("pvr_dev=%p count=%u",
		      __entry->pvr_dev,
		      __entry->count)
);

#define PVR_JOB_GET_HWRT_FW_ADDR(job)                                                  \
	({                                                                             \
		struct pvr_job *_job = (job);                                          \
		u32 _hwrt_fw_addr = 0;                                                 \
										       \
		if (_job && _job->hwrt)                                                \
			pvr_fw_object_get_fw_addr(_job->hwrt->fw_obj, &_hwrt_fw_addr); \
										       \
		_hwrt_fw_addr;                                                         \
	})

#define PVR_JOB_TYPE_TO_STR(val)                                         \
	__print_symbolic(val,                                            \
			 { DRM_PVR_JOB_TYPE_GEOMETRY, "geometry" },      \
			 { DRM_PVR_JOB_TYPE_FRAGMENT, "fragment" },      \
			 { DRM_PVR_JOB_TYPE_COMPUTE, "compute" },        \
			 { DRM_PVR_JOB_TYPE_TRANSFER_FRAG, "transfer" })

TRACE_EVENT(pvr_job_create,
	    TP_PROTO(struct pvr_device *pvr_dev, struct pvr_job *job,
		     u32 sync_op_count),
	    TP_ARGS(pvr_dev, job, sync_op_count),
	    TP_STRUCT__entry(__field(struct pvr_device *, pvr_dev)
			     __field(struct pvr_context *, ctx)
			     __field(struct pvr_fw_object *, fw_obj)
			     __field(u32, fw_addr)
			     __field(u32, hwrt_addr)
			     __field(struct pvr_job *, job)
			     __field(enum drm_pvr_job_type, job_type)
			     __field(u32, sync_op_count)),
	    TP_fast_assign(__entry->pvr_dev = pvr_dev;
			   __entry->ctx = job->ctx;
			   __entry->fw_obj = job->ctx->fw_obj;
			   pvr_fw_object_get_fw_addr(job->ctx->fw_obj, &__entry->fw_addr);
			   __entry->hwrt_addr = PVR_JOB_GET_HWRT_FW_ADDR(job);
			   __entry->job = job;
			   __entry->job_type = job->type;
			   __entry->sync_op_count = sync_op_count;),
	    TP_printk("pvr_dev=%p ctx=%p fw_obj=%p fw_addr=0x%x hwrt_addr=0x%x job=%p job_type=%s sync_op_count=%u",
		      __entry->pvr_dev,
		      __entry->ctx,
		      __entry->fw_obj,
		      __entry->fw_addr,
		      __entry->hwrt_addr,
		      __entry->job,
		      PVR_JOB_TYPE_TO_STR(__entry->job_type),
		      __entry->sync_op_count)
);

#undef PVR_JOB_TYPE_TO_STR
#undef PVR_JOB_GET_HWRT_FW_ADDR

TRACE_EVENT(pvr_job_submit_fw,
	    TP_PROTO(struct pvr_job *job),
	    TP_ARGS(job),
	    TP_STRUCT__entry(__field(struct pvr_job *, job)
			     __field(u32, done_seqno)),
	    TP_fast_assign(__entry->job = job;
			   __entry->done_seqno = job->done_fence->seqno;),
	    TP_printk("job=%p done_seqno=%u",
		      __entry->job,
		      __entry->done_seqno)
);

TRACE_EVENT(pvr_job_done,
	    TP_PROTO(struct pvr_job *job),
	    TP_ARGS(job),
	    TP_STRUCT__entry(__field(struct pvr_job *, job)),
	    TP_fast_assign(__entry->job = job;),
	    TP_printk("job=%p", __entry->job)
);

#endif /* PVR_TRACE_H */

/* This part must be outside protection */
#undef TRACE_INCLUDE_PATH
#undef TRACE_INCLUDE_FILE
#define TRACE_INCLUDE_PATH ../../drivers/gpu/drm/imagination
#define TRACE_INCLUDE_FILE pvr_trace
#include <trace/define_trace.h>