drivers/gpu/drm/xe/xe_guc_log.h

Source file repositories/reference/linux-study-clean/drivers/gpu/drm/xe/xe_guc_log.h

File Facts

System
Linux kernel
Corpus path
drivers/gpu/drm/xe/xe_guc_log.h
Extension
.h
Size
2640 bytes
Lines
76
Domain
Driver Families
Bucket
drivers/gpu
Inferred role
Driver Families: implementation source
Status
source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

#ifndef _XE_GUC_LOG_H_
#define _XE_GUC_LOG_H_

#include "xe_guc_log_types.h"
#include "abi/guc_log_abi.h"

struct drm_printer;
struct xe_device;

#if IS_ENABLED(CONFIG_DRM_XE_DEBUG_GUC)
#define XE_GUC_LOG_EVENT_DATA_BUFFER_SIZE	SZ_16M
#define XE_GUC_LOG_CRASH_DUMP_BUFFER_SIZE	SZ_1M
#define XE_GUC_LOG_STATE_CAPTURE_BUFFER_SIZE	SZ_2M
#elif IS_ENABLED(CONFIG_DRM_XE_DEBUG)
#define XE_GUC_LOG_EVENT_DATA_BUFFER_SIZE	SZ_8M
#define XE_GUC_LOG_CRASH_DUMP_BUFFER_SIZE	SZ_1M
#define XE_GUC_LOG_STATE_CAPTURE_BUFFER_SIZE	SZ_1M
#else
#define XE_GUC_LOG_EVENT_DATA_BUFFER_SIZE	SZ_64K
#define XE_GUC_LOG_CRASH_DUMP_BUFFER_SIZE	SZ_16K
#define XE_GUC_LOG_STATE_CAPTURE_BUFFER_SIZE	SZ_1M
#endif

#define GUC_LOG_SIZE (SZ_4K + \
		      XE_GUC_LOG_EVENT_DATA_BUFFER_SIZE + \
		      XE_GUC_LOG_CRASH_DUMP_BUFFER_SIZE + \
		      XE_GUC_LOG_STATE_CAPTURE_BUFFER_SIZE)

#define XE_GUC_LOG_EVENT_DATA_OFFSET	SZ_4K
#define XE_GUC_LOG_CRASH_DUMP_OFFSET	(XE_GUC_LOG_EVENT_DATA_OFFSET + \
					 XE_GUC_LOG_EVENT_DATA_BUFFER_SIZE)
#define XE_GUC_LOG_STATE_CAPTURE_OFFSET	(XE_GUC_LOG_CRASH_DUMP_OFFSET + \
					 XE_GUC_LOG_CRASH_DUMP_BUFFER_SIZE)

/*
 * While we're using plain log level in i915, GuC controls are much more...
 * "elaborate"? We have a couple of bits for verbosity, separate bit for actual
 * log enabling, and separate bit for default logging - which "conveniently"
 * ignores the enable bit.
 */
#define GUC_LOG_LEVEL_DISABLED		0
#define GUC_LOG_LEVEL_NON_VERBOSE	1
#define GUC_LOG_LEVEL_IS_ENABLED(x)	((x) > GUC_LOG_LEVEL_DISABLED)
#define GUC_LOG_LEVEL_IS_VERBOSE(x)	((x) > GUC_LOG_LEVEL_NON_VERBOSE)
#define GUC_LOG_LEVEL_TO_VERBOSITY(x) ({		\
	typeof(x) _x = (x);				\
	GUC_LOG_LEVEL_IS_VERBOSE(_x) ? _x - 2 : 0;	\
})
#define GUC_VERBOSITY_TO_LOG_LEVEL(x)	((x) + 2)
#define GUC_LOG_LEVEL_MAX GUC_VERBOSITY_TO_LOG_LEVEL(GUC_LOG_VERBOSITY_MAX)

int xe_guc_log_init(struct xe_guc_log *log);
void xe_guc_log_print(struct xe_guc_log *log, struct drm_printer *p);
void xe_guc_log_print_lfd(struct xe_guc_log *log, struct drm_printer *p);
void xe_guc_log_print_dmesg(struct xe_guc_log *log);
struct xe_guc_log_snapshot *xe_guc_log_snapshot_capture(struct xe_guc_log *log, bool atomic);
void xe_guc_log_snapshot_print(struct xe_guc_log_snapshot *snapshot, struct drm_printer *p);
void xe_guc_log_snapshot_free(struct xe_guc_log_snapshot *snapshot);

static inline u32
xe_guc_log_get_level(struct xe_guc_log *log)
{
	return log->level;
}

bool xe_guc_check_log_buf_overflow(struct xe_guc_log *log,
				   enum guc_log_type type,
				   unsigned int full_cnt);

#endif

Annotation

Implementation Notes