1069 lines · 31.2 KB · C
RawDownload
/* amdgpu_drm.h -- Public header for the amdgpu driver -*- linux-c -*- * * Copyright 2000 Precision Insight, Inc., Cedar Park, Texas. * Copyright 2000 VA Linux Systems, Inc., Fremont, California. * Copyright 2002 Tungsten Graphics, Inc., Cedar Park, Texas. * Copyright 2014 Advanced Micro Devices, Inc. * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR * OTHER DEALINGS IN THE SOFTWARE. * * Authors: *    Kevin E. Martin <martin@valinux.com> *    Gareth Hughes <gareth@valinux.com> *    Keith Whitwell <keith@tungstengraphics.com> */ #ifndef __AMDGPU_DRM_H__#define __AMDGPU_DRM_H__ #include "drm.h" #if defined(__cplusplus)extern "C" {#endif #define DRM_AMDGPU_GEM_CREATE		0x00#define DRM_AMDGPU_GEM_MMAP		0x01#define DRM_AMDGPU_CTX			0x02#define DRM_AMDGPU_BO_LIST		0x03#define DRM_AMDGPU_CS			0x04#define DRM_AMDGPU_INFO			0x05#define DRM_AMDGPU_GEM_METADATA		0x06#define DRM_AMDGPU_GEM_WAIT_IDLE	0x07#define DRM_AMDGPU_GEM_VA		0x08#define DRM_AMDGPU_WAIT_CS		0x09#define DRM_AMDGPU_GEM_OP		0x10#define DRM_AMDGPU_GEM_USERPTR		0x11#define DRM_AMDGPU_WAIT_FENCES		0x12#define DRM_AMDGPU_VM			0x13#define DRM_AMDGPU_FENCE_TO_HANDLE	0x14#define DRM_AMDGPU_SCHED		0x15 #define DRM_IOCTL_AMDGPU_GEM_CREATE	DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_CREATE, union drm_amdgpu_gem_create)#define DRM_IOCTL_AMDGPU_GEM_MMAP	DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_MMAP, union drm_amdgpu_gem_mmap)#define DRM_IOCTL_AMDGPU_CTX		DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_CTX, union drm_amdgpu_ctx)#define DRM_IOCTL_AMDGPU_BO_LIST	DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_BO_LIST, union drm_amdgpu_bo_list)#define DRM_IOCTL_AMDGPU_CS		DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_CS, union drm_amdgpu_cs)#define DRM_IOCTL_AMDGPU_INFO		DRM_IOW(DRM_COMMAND_BASE + DRM_AMDGPU_INFO, struct drm_amdgpu_info)#define DRM_IOCTL_AMDGPU_GEM_METADATA	DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_METADATA, struct drm_amdgpu_gem_metadata)#define DRM_IOCTL_AMDGPU_GEM_WAIT_IDLE	DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_WAIT_IDLE, union drm_amdgpu_gem_wait_idle)#define DRM_IOCTL_AMDGPU_GEM_VA		DRM_IOW(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_VA, struct drm_amdgpu_gem_va)#define DRM_IOCTL_AMDGPU_WAIT_CS	DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_WAIT_CS, union drm_amdgpu_wait_cs)#define DRM_IOCTL_AMDGPU_GEM_OP		DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_OP, struct drm_amdgpu_gem_op)#define DRM_IOCTL_AMDGPU_GEM_USERPTR	DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_USERPTR, struct drm_amdgpu_gem_userptr)#define DRM_IOCTL_AMDGPU_WAIT_FENCES	DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_WAIT_FENCES, union drm_amdgpu_wait_fences)#define DRM_IOCTL_AMDGPU_VM		DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_VM, union drm_amdgpu_vm)#define DRM_IOCTL_AMDGPU_FENCE_TO_HANDLE DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_FENCE_TO_HANDLE, union drm_amdgpu_fence_to_handle)#define DRM_IOCTL_AMDGPU_SCHED		DRM_IOW(DRM_COMMAND_BASE + DRM_AMDGPU_SCHED, union drm_amdgpu_sched) /** * DOC: memory domains * * %AMDGPU_GEM_DOMAIN_CPU	System memory that is not GPU accessible. * Memory in this pool could be swapped out to disk if there is pressure. * * %AMDGPU_GEM_DOMAIN_GTT	GPU accessible system memory, mapped into the * GPU's virtual address space via gart. Gart memory linearizes non-contiguous * pages of system memory, allows GPU access system memory in a linezrized * fashion. * * %AMDGPU_GEM_DOMAIN_VRAM	Local video memory. For APUs, it is memory * carved out by the BIOS. * * %AMDGPU_GEM_DOMAIN_GDS	Global on-chip data storage used to share data * across shader threads. * * %AMDGPU_GEM_DOMAIN_GWS	Global wave sync, used to synchronize the * execution of all the waves on a device. * * %AMDGPU_GEM_DOMAIN_OA	Ordered append, used by 3D or Compute engines * for appending data. */#define AMDGPU_GEM_DOMAIN_CPU		0x1#define AMDGPU_GEM_DOMAIN_GTT		0x2#define AMDGPU_GEM_DOMAIN_VRAM		0x4#define AMDGPU_GEM_DOMAIN_GDS		0x8#define AMDGPU_GEM_DOMAIN_GWS		0x10#define AMDGPU_GEM_DOMAIN_OA		0x20#define AMDGPU_GEM_DOMAIN_MASK		(AMDGPU_GEM_DOMAIN_CPU | \					 AMDGPU_GEM_DOMAIN_GTT | \					 AMDGPU_GEM_DOMAIN_VRAM | \					 AMDGPU_GEM_DOMAIN_GDS | \					 AMDGPU_GEM_DOMAIN_GWS | \					 AMDGPU_GEM_DOMAIN_OA) /* Flag that CPU access will be required for the case of VRAM domain */#define AMDGPU_GEM_CREATE_CPU_ACCESS_REQUIRED	(1 << 0)/* Flag that CPU access will not work, this VRAM domain is invisible */#define AMDGPU_GEM_CREATE_NO_CPU_ACCESS		(1 << 1)/* Flag that USWC attributes should be used for GTT */#define AMDGPU_GEM_CREATE_CPU_GTT_USWC		(1 << 2)/* Flag that the memory should be in VRAM and cleared */#define AMDGPU_GEM_CREATE_VRAM_CLEARED		(1 << 3)/* Flag that create shadow bo(GTT) while allocating vram bo */#define AMDGPU_GEM_CREATE_SHADOW		(1 << 4)/* Flag that allocating the BO should use linear VRAM */#define AMDGPU_GEM_CREATE_VRAM_CONTIGUOUS	(1 << 5)/* Flag that BO is always valid in this VM */#define AMDGPU_GEM_CREATE_VM_ALWAYS_VALID	(1 << 6)/* Flag that BO sharing will be explicitly synchronized */#define AMDGPU_GEM_CREATE_EXPLICIT_SYNC		(1 << 7)/* Flag that indicates allocating MQD gart on GFX9, where the mtype * for the second page onward should be set to NC. */#define AMDGPU_GEM_CREATE_MQD_GFX9		(1 << 8)/* Flag that BO may contain sensitive data that must be wiped before * releasing the memory */#define AMDGPU_GEM_CREATE_VRAM_WIPE_ON_RELEASE	(1 << 9) struct drm_amdgpu_gem_create_in  {	/** the requested memory size */	__u64 bo_size;	/** physical start_addr alignment in bytes for some HW requirements */	__u64 alignment;	/** the requested memory domains */	__u64 domains;	/** allocation flags */	__u64 domain_flags;}; struct drm_amdgpu_gem_create_out  {	/** returned GEM object handle */	__u32 handle;	__u32 _pad;}; union drm_amdgpu_gem_create {	struct drm_amdgpu_gem_create_in		in;	struct drm_amdgpu_gem_create_out	out;}; /** Opcode to create new residency list.  */#define AMDGPU_BO_LIST_OP_CREATE	0/** Opcode to destroy previously created residency list */#define AMDGPU_BO_LIST_OP_DESTROY	1/** Opcode to update resource information in the list */#define AMDGPU_BO_LIST_OP_UPDATE	2 struct drm_amdgpu_bo_list_in {	/** Type of operation */	__u32 operation;	/** Handle of list or 0 if we want to create one */	__u32 list_handle;	/** Number of BOs in list  */	__u32 bo_number;	/** Size of each element describing BO */	__u32 bo_info_size;	/** Pointer to array describing BOs */	__u64 bo_info_ptr;}; struct drm_amdgpu_bo_list_entry {	/** Handle of BO */	__u32 bo_handle;	/** New (if specified) BO priority to be used during migration */	__u32 bo_priority;}; struct drm_amdgpu_bo_list_out {	/** Handle of resource list  */	__u32 list_handle;	__u32 _pad;}; union drm_amdgpu_bo_list {	struct drm_amdgpu_bo_list_in in;	struct drm_amdgpu_bo_list_out out;}; /* context related */#define AMDGPU_CTX_OP_ALLOC_CTX	1#define AMDGPU_CTX_OP_FREE_CTX	2#define AMDGPU_CTX_OP_QUERY_STATE	3#define AMDGPU_CTX_OP_QUERY_STATE2	4 /* GPU reset status */#define AMDGPU_CTX_NO_RESET		0/* this the context caused it */#define AMDGPU_CTX_GUILTY_RESET		1/* some other context caused it */#define AMDGPU_CTX_INNOCENT_RESET	2/* unknown cause */#define AMDGPU_CTX_UNKNOWN_RESET	3 /* indicate gpu reset occured after ctx created */#define AMDGPU_CTX_QUERY2_FLAGS_RESET    (1<<0)/* indicate vram lost occured after ctx created */#define AMDGPU_CTX_QUERY2_FLAGS_VRAMLOST (1<<1)/* indicate some job from this context once cause gpu hang */#define AMDGPU_CTX_QUERY2_FLAGS_GUILTY   (1<<2)/* indicate some errors are detected by RAS */#define AMDGPU_CTX_QUERY2_FLAGS_RAS_CE   (1<<3)#define AMDGPU_CTX_QUERY2_FLAGS_RAS_UE   (1<<4) /* Context priority level */#define AMDGPU_CTX_PRIORITY_UNSET       -2048#define AMDGPU_CTX_PRIORITY_VERY_LOW    -1023#define AMDGPU_CTX_PRIORITY_LOW         -512#define AMDGPU_CTX_PRIORITY_NORMAL      0/* * When used in struct drm_amdgpu_ctx_in, a priority above NORMAL requires * CAP_SYS_NICE or DRM_MASTER*/#define AMDGPU_CTX_PRIORITY_HIGH        512#define AMDGPU_CTX_PRIORITY_VERY_HIGH   1023 struct drm_amdgpu_ctx_in {	/** AMDGPU_CTX_OP_* */	__u32	op;	/** For future use, no flags defined so far */	__u32	flags;	__u32	ctx_id;	/** AMDGPU_CTX_PRIORITY_* */	__s32	priority;}; union drm_amdgpu_ctx_out {		struct {			__u32	ctx_id;			__u32	_pad;		} alloc; 		struct {			/** For future use, no flags defined so far */			__u64	flags;			/** Number of resets caused by this context so far. */			__u32	hangs;			/** Reset status since the last call of the ioctl. */			__u32	reset_status;		} state;}; union drm_amdgpu_ctx {	struct drm_amdgpu_ctx_in in;	union drm_amdgpu_ctx_out out;}; /* vm ioctl */#define AMDGPU_VM_OP_RESERVE_VMID	1#define AMDGPU_VM_OP_UNRESERVE_VMID	2 struct drm_amdgpu_vm_in {	/** AMDGPU_VM_OP_* */	__u32	op;	__u32	flags;}; struct drm_amdgpu_vm_out {	/** For future use, no flags defined so far */	__u64	flags;}; union drm_amdgpu_vm {	struct drm_amdgpu_vm_in in;	struct drm_amdgpu_vm_out out;}; /* sched ioctl */#define AMDGPU_SCHED_OP_PROCESS_PRIORITY_OVERRIDE	1#define AMDGPU_SCHED_OP_CONTEXT_PRIORITY_OVERRIDE	2 struct drm_amdgpu_sched_in {	/* AMDGPU_SCHED_OP_* */	__u32	op;	__u32	fd;	/** AMDGPU_CTX_PRIORITY_* */	__s32	priority;	__u32   ctx_id;}; union drm_amdgpu_sched {	struct drm_amdgpu_sched_in in;}; /* * This is not a reliable API and you should expect it to fail for any * number of reasons and have fallback path that do not use userptr to * perform any operation. */#define AMDGPU_GEM_USERPTR_READONLY	(1 << 0)#define AMDGPU_GEM_USERPTR_ANONONLY	(1 << 1)#define AMDGPU_GEM_USERPTR_VALIDATE	(1 << 2)#define AMDGPU_GEM_USERPTR_REGISTER	(1 << 3) struct drm_amdgpu_gem_userptr {	__u64		addr;	__u64		size;	/* AMDGPU_GEM_USERPTR_* */	__u32		flags;	/* Resulting GEM handle */	__u32		handle;}; /* SI-CI-VI: *//* same meaning as the GB_TILE_MODE and GL_MACRO_TILE_MODE fields */#define AMDGPU_TILING_ARRAY_MODE_SHIFT			0#define AMDGPU_TILING_ARRAY_MODE_MASK			0xf#define AMDGPU_TILING_PIPE_CONFIG_SHIFT			4#define AMDGPU_TILING_PIPE_CONFIG_MASK			0x1f#define AMDGPU_TILING_TILE_SPLIT_SHIFT			9#define AMDGPU_TILING_TILE_SPLIT_MASK			0x7#define AMDGPU_TILING_MICRO_TILE_MODE_SHIFT		12#define AMDGPU_TILING_MICRO_TILE_MODE_MASK		0x7#define AMDGPU_TILING_BANK_WIDTH_SHIFT			15#define AMDGPU_TILING_BANK_WIDTH_MASK			0x3#define AMDGPU_TILING_BANK_HEIGHT_SHIFT			17#define AMDGPU_TILING_BANK_HEIGHT_MASK			0x3#define AMDGPU_TILING_MACRO_TILE_ASPECT_SHIFT		19#define AMDGPU_TILING_MACRO_TILE_ASPECT_MASK		0x3#define AMDGPU_TILING_NUM_BANKS_SHIFT			21#define AMDGPU_TILING_NUM_BANKS_MASK			0x3 /* GFX9 and later: */#define AMDGPU_TILING_SWIZZLE_MODE_SHIFT		0#define AMDGPU_TILING_SWIZZLE_MODE_MASK			0x1f#define AMDGPU_TILING_DCC_OFFSET_256B_SHIFT		5#define AMDGPU_TILING_DCC_OFFSET_256B_MASK		0xFFFFFF#define AMDGPU_TILING_DCC_PITCH_MAX_SHIFT		29#define AMDGPU_TILING_DCC_PITCH_MAX_MASK		0x3FFF#define AMDGPU_TILING_DCC_INDEPENDENT_64B_SHIFT		43#define AMDGPU_TILING_DCC_INDEPENDENT_64B_MASK		0x1 /* Set/Get helpers for tiling flags. */#define AMDGPU_TILING_SET(field, value) \	(((__u64)(value) & AMDGPU_TILING_##field##_MASK) << AMDGPU_TILING_##field##_SHIFT)#define AMDGPU_TILING_GET(value, field) \	(((__u64)(value) >> AMDGPU_TILING_##field##_SHIFT) & AMDGPU_TILING_##field##_MASK) #define AMDGPU_GEM_METADATA_OP_SET_METADATA                  1#define AMDGPU_GEM_METADATA_OP_GET_METADATA                  2 /** The same structure is shared for input/output */struct drm_amdgpu_gem_metadata {	/** GEM Object handle */	__u32	handle;	/** Do we want get or set metadata */	__u32	op;	struct {		/** For future use, no flags defined so far */		__u64	flags;		/** family specific tiling info */		__u64	tiling_info;		__u32	data_size_bytes;		__u32	data[64];	} data;}; struct drm_amdgpu_gem_mmap_in {	/** the GEM object handle */	__u32 handle;	__u32 _pad;}; struct drm_amdgpu_gem_mmap_out {	/** mmap offset from the vma offset manager */	__u64 addr_ptr;}; union drm_amdgpu_gem_mmap {	struct drm_amdgpu_gem_mmap_in   in;	struct drm_amdgpu_gem_mmap_out out;}; struct drm_amdgpu_gem_wait_idle_in {	/** GEM object handle */	__u32 handle;	/** For future use, no flags defined so far */	__u32 flags;	/** Absolute timeout to wait */	__u64 timeout;}; struct drm_amdgpu_gem_wait_idle_out {	/** BO status:  0 - BO is idle, 1 - BO is busy */	__u32 status;	/** Returned current memory domain */	__u32 domain;}; union drm_amdgpu_gem_wait_idle {	struct drm_amdgpu_gem_wait_idle_in  in;	struct drm_amdgpu_gem_wait_idle_out out;}; struct drm_amdgpu_wait_cs_in {	/* Command submission handle         * handle equals 0 means none to wait for         * handle equals ~0ull means wait for the latest sequence number         */	__u64 handle;	/** Absolute timeout to wait */	__u64 timeout;	__u32 ip_type;	__u32 ip_instance;	__u32 ring;	__u32 ctx_id;}; struct drm_amdgpu_wait_cs_out {	/** CS status:  0 - CS completed, 1 - CS still busy */	__u64 status;}; union drm_amdgpu_wait_cs {	struct drm_amdgpu_wait_cs_in in;	struct drm_amdgpu_wait_cs_out out;}; struct drm_amdgpu_fence {	__u32 ctx_id;	__u32 ip_type;	__u32 ip_instance;	__u32 ring;	__u64 seq_no;}; struct drm_amdgpu_wait_fences_in {	/** This points to uint64_t * which points to fences */	__u64 fences;	__u32 fence_count;	__u32 wait_all;	__u64 timeout_ns;}; struct drm_amdgpu_wait_fences_out {	__u32 status;	__u32 first_signaled;}; union drm_amdgpu_wait_fences {	struct drm_amdgpu_wait_fences_in in;	struct drm_amdgpu_wait_fences_out out;}; #define AMDGPU_GEM_OP_GET_GEM_CREATE_INFO	0#define AMDGPU_GEM_OP_SET_PLACEMENT		1 /* Sets or returns a value associated with a buffer. */struct drm_amdgpu_gem_op {	/** GEM object handle */	__u32	handle;	/** AMDGPU_GEM_OP_* */	__u32	op;	/** Input or return value */	__u64	value;}; #define AMDGPU_VA_OP_MAP			1#define AMDGPU_VA_OP_UNMAP			2#define AMDGPU_VA_OP_CLEAR			3#define AMDGPU_VA_OP_REPLACE			4 /* Delay the page table update till the next CS */#define AMDGPU_VM_DELAY_UPDATE		(1 << 0) /* Mapping flags *//* readable mapping */#define AMDGPU_VM_PAGE_READABLE		(1 << 1)/* writable mapping */#define AMDGPU_VM_PAGE_WRITEABLE	(1 << 2)/* executable mapping, new for VI */#define AMDGPU_VM_PAGE_EXECUTABLE	(1 << 3)/* partially resident texture */#define AMDGPU_VM_PAGE_PRT		(1 << 4)/* MTYPE flags use bit 5 to 8 */#define AMDGPU_VM_MTYPE_MASK		(0xf << 5)/* Default MTYPE. Pre-AI must use this.  Recommended for newer ASICs. */#define AMDGPU_VM_MTYPE_DEFAULT		(0 << 5)/* Use NC MTYPE instead of default MTYPE */#define AMDGPU_VM_MTYPE_NC		(1 << 5)/* Use WC MTYPE instead of default MTYPE */#define AMDGPU_VM_MTYPE_WC		(2 << 5)/* Use CC MTYPE instead of default MTYPE */#define AMDGPU_VM_MTYPE_CC		(3 << 5)

Lines 1–500 of 1069.