880d405719
git-subtree-dir: qcom/opensource/graphics-kernel git-subtree-mainline:992813d9c1git-subtree-split:b4fdc4c042Change-Id: repo: https://git.codelinaro.org/clo/la/platform/vendor/qcom/opensource/graphics-kernel tag: GRAPHICS.LA.14.0.r1-07700-lanai.0
418 lines
14 KiB
C
418 lines
14 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* Copyright (c) 2012-2021, The Linux Foundation. All rights reserved.
|
|
* Copyright (c) 2022-2024, Qualcomm Innovation Center, Inc. All rights reserved.
|
|
*/
|
|
|
|
#ifndef _KGSL_SNAPSHOT_H_
|
|
#define _KGSL_SNAPSHOT_H_
|
|
|
|
#include <linux/types.h>
|
|
|
|
/* Snapshot header */
|
|
|
|
/* High word is static, low word is snapshot version ID */
|
|
#define SNAPSHOT_MAGIC 0x504D0002
|
|
|
|
/* GPU ID scheme:
|
|
* [16:31] - core identifer (0x0002 for 2D or 0x0003 for 3D)
|
|
* [00:16] - GPU specific identifier
|
|
*/
|
|
|
|
struct kgsl_snapshot_header {
|
|
__u32 magic; /* Magic identifier */
|
|
__u32 gpuid; /* GPU ID - see above */
|
|
/* Added in snapshot version 2 */
|
|
__u32 chipid; /* Chip ID from the GPU */
|
|
} __packed;
|
|
|
|
/* Section header */
|
|
#define SNAPSHOT_SECTION_MAGIC 0xABCD
|
|
|
|
struct kgsl_snapshot_section_header {
|
|
__u16 magic; /* Magic identifier */
|
|
__u16 id; /* Type of section */
|
|
__u32 size; /* Size of the section including this header */
|
|
} __packed;
|
|
|
|
/* Section identifiers */
|
|
#define KGSL_SNAPSHOT_SECTION_OS 0x0101
|
|
#define KGSL_SNAPSHOT_SECTION_REGS 0x0201
|
|
#define KGSL_SNAPSHOT_SECTION_REGS_V2 0x0202
|
|
#define KGSL_SNAPSHOT_SECTION_RB 0x0301
|
|
#define KGSL_SNAPSHOT_SECTION_RB_V2 0x0302
|
|
#define KGSL_SNAPSHOT_SECTION_IB 0x0401
|
|
#define KGSL_SNAPSHOT_SECTION_IB_V2 0x0402
|
|
#define KGSL_SNAPSHOT_SECTION_INDEXED_REGS 0x0501
|
|
#define KGSL_SNAPSHOT_SECTION_INDEXED_REGS_V2 0x0502
|
|
#define KGSL_SNAPSHOT_SECTION_ISTORE 0x0801
|
|
#define KGSL_SNAPSHOT_SECTION_DEBUG 0x0901
|
|
#define KGSL_SNAPSHOT_SECTION_DEBUGBUS 0x0A01
|
|
#define KGSL_SNAPSHOT_SECTION_GPU_OBJECT 0x0B01
|
|
#define KGSL_SNAPSHOT_SECTION_GPU_OBJECT_V2 0x0B02
|
|
#define KGSL_SNAPSHOT_SECTION_MEMLIST 0x0E01
|
|
#define KGSL_SNAPSHOT_SECTION_MEMLIST_V2 0x0E02
|
|
#define KGSL_SNAPSHOT_SECTION_SHADER 0x1201
|
|
#define KGSL_SNAPSHOT_SECTION_SHADER_V2 0x1202
|
|
#define KGSL_SNAPSHOT_SECTION_SHADER_V3 0x1203
|
|
#define KGSL_SNAPSHOT_SECTION_MVC 0x1501
|
|
#define KGSL_SNAPSHOT_SECTION_MVC_V2 0x1502
|
|
#define KGSL_SNAPSHOT_SECTION_MVC_V3 0x1503
|
|
#define KGSL_SNAPSHOT_SECTION_GMU 0x1601
|
|
#define KGSL_SNAPSHOT_SECTION_GMU_MEMORY 0x1701
|
|
#define KGSL_SNAPSHOT_SECTION_SIDE_DEBUGBUS 0x1801
|
|
#define KGSL_SNAPSHOT_SECTION_TRACE_BUFFER 0x1901
|
|
#define KGSL_SNAPSHOT_SECTION_EVENTLOG 0x1A01
|
|
|
|
#define KGSL_SNAPSHOT_SECTION_END 0xFFFF
|
|
|
|
/* OS sub-section header */
|
|
#define KGSL_SNAPSHOT_OS_LINUX 0x0001
|
|
#define KGSL_SNAPSHOT_OS_LINUX_V3 0x00000202
|
|
#define KGSL_SNAPSHOT_OS_LINUX_V4 0x00000203
|
|
|
|
/* Linux OS specific information */
|
|
struct kgsl_snapshot_linux {
|
|
int osid; /* subsection OS identifier */
|
|
int state; /* 1 if the thread is running, 0 for hung */
|
|
__u32 seconds; /* Unix timestamp for the snapshot */
|
|
__u32 power_flags; /* Current power flags */
|
|
__u32 power_level; /* Current power level */
|
|
__u32 power_interval_timeout; /* Power interval timeout */
|
|
__u32 grpclk; /* Current GP clock value */
|
|
__u32 busclk; /* Current busclk value */
|
|
__u32 ptbase; /* Current ptbase */
|
|
__u32 pid; /* PID of the process that owns the PT */
|
|
__u32 current_context; /* ID of the current context */
|
|
__u32 ctxtcount; /* Number of contexts appended to section */
|
|
unsigned char release[32]; /* kernel release */
|
|
unsigned char version[32]; /* kernel version */
|
|
unsigned char comm[16]; /* Name of the process that owns the PT */
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_linux_v2 {
|
|
int osid; /* subsection OS identifier */
|
|
__u32 seconds; /* Unix timestamp for the snapshot */
|
|
__u32 power_flags; /* Current power flags */
|
|
__u32 power_level; /* Current power level */
|
|
__u32 power_interval_timeout; /* Power interval timeout */
|
|
__u32 grpclk; /* Current GP clock value */
|
|
__u32 busclk; /* Current busclk value */
|
|
__u64 ptbase; /* Current ptbase */
|
|
__u32 pid; /* PID of the process that owns the PT */
|
|
__u32 current_context; /* ID of the current context */
|
|
__u32 ctxtcount; /* Number of contexts appended to section */
|
|
unsigned char release[32]; /* kernel release */
|
|
unsigned char version[32]; /* kernel version */
|
|
unsigned char comm[16]; /* Name of the process that owns the PT */
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_linux_v4 {
|
|
int osid; /* subsection OS identifier */
|
|
__u32 seconds; /* Unix timestamp for the snapshot */
|
|
__u32 power_flags; /* Current power flags */
|
|
__u32 power_level; /* Current power level */
|
|
__u32 power_interval_timeout; /* Power interval timeout */
|
|
__u32 grpclk; /* Current GP clock value */
|
|
__u32 busclk; /* Current busclk value */
|
|
__u64 ptbase; /* Current ptbase */
|
|
__u64 ptbase_lpac; /* Current LPAC ptbase */
|
|
__u32 pid; /* PID of the process that owns the PT */
|
|
__u32 pid_lpac; /* PID of the LPAC process that owns the PT */
|
|
__u32 current_context; /* ID of the current context */
|
|
__u32 current_context_lpac; /* ID of the current LPAC context */
|
|
__u32 ctxtcount; /* Number of contexts appended to section */
|
|
unsigned char release[32]; /* kernel release */
|
|
unsigned char version[32]; /* kernel version */
|
|
unsigned char comm[16]; /* Name of the process that owns the PT */
|
|
unsigned char comm_lpac[16]; /* Name of the LPAC process that owns the PT */
|
|
} __packed;
|
|
|
|
/*
|
|
* This structure contains a record of an active context.
|
|
* These are appended one after another in the OS section below
|
|
* the header above
|
|
*/
|
|
|
|
struct kgsl_snapshot_linux_context {
|
|
__u32 id; /* The context ID */
|
|
__u32 timestamp_queued; /* The last queued timestamp */
|
|
__u32 timestamp_retired; /* The last timestamp retired by HW */
|
|
};
|
|
|
|
struct kgsl_snapshot_linux_context_v2 {
|
|
__u32 id; /* The context ID */
|
|
__u32 timestamp_queued; /* The last queued timestamp */
|
|
__u32 timestamp_consumed; /* The last timestamp consumed by HW */
|
|
__u32 timestamp_retired; /* The last timestamp retired by HW */
|
|
};
|
|
/* Ringbuffer sub-section header */
|
|
struct kgsl_snapshot_rb {
|
|
int start; /* dword at the start of the dump */
|
|
int end; /* dword at the end of the dump */
|
|
int rbsize; /* Size (in dwords) of the ringbuffer */
|
|
int wptr; /* Current index of the CPU write pointer */
|
|
int rptr; /* Current index of the GPU read pointer */
|
|
int count; /* Number of dwords in the dump */
|
|
__u32 timestamp_queued; /* The last queued timestamp */
|
|
__u32 timestamp_retired; /* The last timestamp retired by HW */
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_rb_v2 {
|
|
int start; /* dword at the start of the dump */
|
|
int end; /* dword at the end of the dump */
|
|
int rbsize; /* Size (in dwords) of the ringbuffer */
|
|
int wptr; /* Current index of the CPU write pointer */
|
|
int rptr; /* Current index of the GPU read pointer */
|
|
int count; /* Number of dwords in the dump */
|
|
__u32 timestamp_queued; /* The last queued timestamp */
|
|
__u32 timestamp_retired; /* The last timestamp retired by HW */
|
|
__u64 gpuaddr; /* The GPU address of the ringbuffer */
|
|
__u32 id; /* Ringbuffer identifier */
|
|
} __packed;
|
|
|
|
|
|
/* Replay or Memory list section, both sections have same header */
|
|
struct kgsl_snapshot_replay_mem_list {
|
|
/*
|
|
* Number of IBs to replay for replay section or
|
|
* number of memory list entries for mem list section
|
|
*/
|
|
int num_entries;
|
|
/* Pagetable base to which the replay IBs or memory entries belong */
|
|
__u32 ptbase;
|
|
} __packed;
|
|
|
|
/* Replay or Memory list section, both sections have same header */
|
|
struct kgsl_snapshot_mem_list_v2 {
|
|
/*
|
|
* Number of IBs to replay for replay section or
|
|
* number of memory list entries for mem list section
|
|
*/
|
|
int num_entries;
|
|
/* Pagetable base to which the replay IBs or memory entries belong */
|
|
__u64 ptbase;
|
|
} __packed;
|
|
|
|
|
|
/* Indirect buffer sub-section header */
|
|
struct kgsl_snapshot_ib {
|
|
__u32 gpuaddr; /* GPU address of the IB */
|
|
__u32 ptbase; /* Base for the pagetable the GPU address is valid in */
|
|
int size; /* Size of the IB */
|
|
} __packed;
|
|
|
|
/* Indirect buffer sub-section header (v2) */
|
|
struct kgsl_snapshot_ib_v2 {
|
|
__u64 gpuaddr; /* GPU address of the IB */
|
|
__u64 ptbase; /* Base for the pagetable the GPU address is valid in */
|
|
__u64 size; /* Size of the IB */
|
|
} __packed;
|
|
|
|
/* GMU memory ID's */
|
|
#define SNAPSHOT_GMU_MEM_UNKNOWN 0x00
|
|
#define SNAPSHOT_GMU_MEM_HFI 0x01
|
|
#define SNAPSHOT_GMU_MEM_LOG 0x02
|
|
#define SNAPSHOT_GMU_MEM_BWTABLE 0x03
|
|
#define SNAPSHOT_GMU_MEM_DEBUG 0x04
|
|
#define SNAPSHOT_GMU_MEM_BIN_BLOCK 0x05
|
|
#define SNAPSHOT_GMU_MEM_CONTEXT_QUEUE 0x06
|
|
#define SNAPSHOT_GMU_MEM_HW_FENCE 0x07
|
|
#define SNAPSHOT_GMU_MEM_WARMBOOT 0x08
|
|
#define SNAPSHOT_GMU_MEM_VRB 0x09
|
|
#define SNAPSHOT_GMU_MEM_TRACE 0x0a
|
|
|
|
/* GMU memory section data */
|
|
struct kgsl_snapshot_gmu_mem {
|
|
int type;
|
|
uint64_t hostaddr;
|
|
uint64_t gmuaddr;
|
|
uint64_t gpuaddr;
|
|
} __packed;
|
|
|
|
/* Register sub-section header */
|
|
struct kgsl_snapshot_regs {
|
|
__u32 count; /* Number of register pairs in the section */
|
|
} __packed;
|
|
|
|
/* Indexed register sub-section header */
|
|
struct kgsl_snapshot_indexed_regs {
|
|
__u32 index_reg; /* Offset of the index register for this section */
|
|
__u32 data_reg; /* Offset of the data register for this section */
|
|
int start; /* Starting index */
|
|
int count; /* Number of dwords in the data */
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_indexed_regs_v2 {
|
|
u32 index_reg; /* Offset of the index register for this section */
|
|
u32 data_reg; /* Offset of the data register for this section */
|
|
u32 start; /* Starting index */
|
|
u32 count; /* Number of dwords in the data */
|
|
u32 pipe_id; /* Id of pipe, BV, Br etc */
|
|
u32 slice_id; /* Slice ID to be dumped */
|
|
} __packed;
|
|
|
|
/* MVC register sub-section header */
|
|
struct kgsl_snapshot_mvc_regs {
|
|
int ctxt_id;
|
|
int cluster_id;
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_mvc_regs_v2 {
|
|
int ctxt_id;
|
|
int cluster_id;
|
|
int pipe_id;
|
|
int location_id;
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_mvc_regs_v3 {
|
|
u32 ctxt_id;
|
|
u32 cluster_id;
|
|
u32 pipe_id;
|
|
u32 location_id;
|
|
u32 slice_id;
|
|
u32 sp_id;
|
|
u32 usptp_id;
|
|
} __packed;
|
|
|
|
/* Istore sub-section header */
|
|
struct kgsl_snapshot_istore {
|
|
int count; /* Number of instructions in the istore */
|
|
} __packed;
|
|
|
|
/* Debug data sub-section header */
|
|
|
|
/* A2XX debug sections */
|
|
#define SNAPSHOT_DEBUG_SX 1
|
|
#define SNAPSHOT_DEBUG_CP 2
|
|
#define SNAPSHOT_DEBUG_SQ 3
|
|
#define SNAPSHOT_DEBUG_SQTHREAD 4
|
|
#define SNAPSHOT_DEBUG_MIU 5
|
|
|
|
/* A3XX debug sections */
|
|
#define SNAPSHOT_DEBUG_VPC_MEMORY 6
|
|
#define SNAPSHOT_DEBUG_CP_MEQ 7
|
|
#define SNAPSHOT_DEBUG_CP_PM4_RAM 8
|
|
#define SNAPSHOT_DEBUG_CP_PFP_RAM 9
|
|
#define SNAPSHOT_DEBUG_CP_ROQ 10
|
|
#define SNAPSHOT_DEBUG_SHADER_MEMORY 11
|
|
#define SNAPSHOT_DEBUG_CP_MERCIU 12
|
|
#define SNAPSHOT_DEBUG_SQE_VERSION 14
|
|
|
|
/* GMU Version information */
|
|
#define SNAPSHOT_DEBUG_GMU_CORE_VERSION 15
|
|
#define SNAPSHOT_DEBUG_GMU_CORE_DEV_VERSION 16
|
|
#define SNAPSHOT_DEBUG_GMU_PWR_VERSION 17
|
|
#define SNAPSHOT_DEBUG_GMU_PWR_DEV_VERSION 18
|
|
#define SNAPSHOT_DEBUG_GMU_HFI_VERSION 19
|
|
#define SNAPSHOT_DEBUG_AQE_VERSION 20
|
|
|
|
struct kgsl_snapshot_debug {
|
|
int type; /* Type identifier for the attached tata */
|
|
int size; /* Size of the section in dwords */
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_debugbus {
|
|
int id; /* Debug bus ID */
|
|
int count; /* Number of dwords in the dump */
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_side_debugbus {
|
|
int id; /* Debug bus ID */
|
|
int size; /* Number of dwords in the dump */
|
|
int valid_data; /* Mask of valid bits of the side debugbus */
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_shader {
|
|
int type; /* SP/TP statetype */
|
|
int index; /* SP/TP index */
|
|
int size; /* Number of dwords in the dump */
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_shader_v2 {
|
|
int type; /* SP/TP statetype */
|
|
int index; /* SP/TP index */
|
|
int usptp; /* USPTP index */
|
|
int pipe_id; /* Pipe id */
|
|
int location; /* Location value */
|
|
u32 size; /* Number of dwords in the dump */
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_shader_v3 {
|
|
u32 type; /* SP/TP statetype */
|
|
u32 slice_id; /* Slice ID */
|
|
u32 sp_index; /* SP/TP index */
|
|
u32 usptp; /* USPTP index */
|
|
u32 pipe_id; /* Pipe id */
|
|
u32 location; /* Location value */
|
|
u32 ctxt_id; /* Context ID */
|
|
u32 size; /* Number of dwords in the dump */
|
|
} __packed;
|
|
|
|
#define TRACE_BUF_NUM_SIG 4
|
|
|
|
/**
|
|
* enum trace_buffer_source - Bits to identify the source block of trace buffer information
|
|
* GX_DBGC : Signals captured from GX block
|
|
* CX_DBGC : Signals captured from CX block
|
|
*/
|
|
enum trace_buffer_source {
|
|
GX_DBGC = 1,
|
|
CX_DBGC = 2,
|
|
};
|
|
|
|
/**
|
|
* kgsl_snapshot_trace_buffer: Header Information for the tracebuffer in snapshot.
|
|
*/
|
|
struct kgsl_snapshot_trace_buffer {
|
|
/** @dbgc_ctrl: Identify source for trace */
|
|
__u16 dbgc_ctrl;
|
|
/** @dbgc_ctrl: Identify source for trace */
|
|
__u16 segment;
|
|
/** @granularity: The total number of segments in each packet */
|
|
__u16 granularity;
|
|
/** @ping_blk: Signal block */
|
|
__u16 ping_blk[TRACE_BUF_NUM_SIG];
|
|
/** @ping_idx: Signal Index */
|
|
__u16 ping_idx[TRACE_BUF_NUM_SIG];
|
|
/** @size: Number of bytes in the dump */
|
|
__u32 size;
|
|
} __packed;
|
|
|
|
#define SNAPSHOT_GPU_OBJECT_SHADER 1
|
|
#define SNAPSHOT_GPU_OBJECT_IB 2
|
|
#define SNAPSHOT_GPU_OBJECT_GENERIC 3
|
|
#define SNAPSHOT_GPU_OBJECT_DRAW 4
|
|
#define SNAPSHOT_GPU_OBJECT_GLOBAL 5
|
|
|
|
struct kgsl_snapshot_gpu_object {
|
|
int type; /* Type of GPU object */
|
|
__u32 gpuaddr; /* GPU address of the object */
|
|
__u32 ptbase; /* Base for the pagetable the GPU address is valid in */
|
|
int size; /* Size of the object (in dwords) */
|
|
};
|
|
|
|
struct kgsl_snapshot_gpu_object_v2 {
|
|
int type; /* Type of GPU object */
|
|
__u64 gpuaddr; /* GPU address of the object */
|
|
__u64 ptbase; /* Base for the pagetable the GPU address is valid in */
|
|
__u64 size; /* Size of the object (in dwords) */
|
|
} __packed;
|
|
|
|
struct kgsl_snapshot_eventlog {
|
|
/** @type: Type of the event log buffer */
|
|
__u16 type;
|
|
/** @version: Version of the event log buffer */
|
|
__u16 version;
|
|
/** @size: Size of the eventlog buffer in bytes */
|
|
u32 size;
|
|
} __packed;
|
|
|
|
struct kgsl_device;
|
|
struct kgsl_process_private;
|
|
|
|
void kgsl_snapshot_push_object(struct kgsl_device *device,
|
|
struct kgsl_process_private *process,
|
|
uint64_t gpuaddr, uint64_t dwords);
|
|
#endif
|