/* SPDX-License-Identifier: GPL-2.0-only */ /* * Copyright (c) 2012-2019, The Linux Foundation. All rights reserved. */ #ifndef _KGSL_SNAPSHOT_H_ #define _KGSL_SNAPSHOT_H_ #include /* 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_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_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_MVC 0x1501 #define KGSL_SNAPSHOT_SECTION_GMU 0x1601 #define KGSL_SNAPSHOT_SECTION_GMU_MEMORY 0x1701 #define KGSL_SNAPSHOT_SECTION_END 0xFFFF /* OS sub-section header */ #define KGSL_SNAPSHOT_OS_LINUX 0x0001 #define KGSL_SNAPSHOT_OS_LINUX_V3 0x00000202 /* 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; /* * 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 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 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 /* 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; /* MVC register sub-section header */ struct kgsl_snapshot_mvc_regs { int ctxt_id; int cluster_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 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_shader { int type; /* SP/TP statetype */ int index; /* SP/TP index */ int size; /* Number of dwords in the dump */ } __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 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 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_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