846 lines · 23.8 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_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 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 /* 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) 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 /* 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 struct drm_amdgpu_ctx_in {	/** AMDGPU_CTX_OP_* */	__u32	op;	/** For future use, no flags defined so far */	__u32	flags;	__u32	ctx_id;	__u32	_pad;}; 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;}; /* * 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 /* 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)/* Use UC MTYPE instead of default MTYPE */#define AMDGPU_VM_MTYPE_UC		(4 << 5) struct drm_amdgpu_gem_va {	/** GEM object handle */	__u32 handle;	__u32 _pad;	/** AMDGPU_VA_OP_* */	__u32 operation;	/** AMDGPU_VM_PAGE_* */	__u32 flags;	/** va address to assign . Must be correctly aligned.*/	__u64 va_address;	/** Specify offset inside of BO to assign. Must be correctly aligned.*/	__u64 offset_in_bo;	/** Specify mapping size. Must be correctly aligned. */	__u64 map_size;}; #define AMDGPU_HW_IP_GFX          0#define AMDGPU_HW_IP_COMPUTE      1#define AMDGPU_HW_IP_DMA          2#define AMDGPU_HW_IP_UVD          3#define AMDGPU_HW_IP_VCE          4#define AMDGPU_HW_IP_UVD_ENC      5#define AMDGPU_HW_IP_NUM          6 #define AMDGPU_HW_IP_INSTANCE_MAX_COUNT 1 #define AMDGPU_CHUNK_ID_IB		0x01#define AMDGPU_CHUNK_ID_FENCE		0x02#define AMDGPU_CHUNK_ID_DEPENDENCIES	0x03 struct drm_amdgpu_cs_chunk {	__u32		chunk_id;	__u32		length_dw;	__u64		chunk_data;}; struct drm_amdgpu_cs_in {	/** Rendering context id */	__u32		ctx_id;	/**  Handle of resource list associated with CS */	__u32		bo_list_handle;	__u32		num_chunks;	__u32		_pad;	/** this points to __u64 * which point to cs chunks */	__u64		chunks;}; struct drm_amdgpu_cs_out {	__u64 handle;}; union drm_amdgpu_cs {	struct drm_amdgpu_cs_in in;	struct drm_amdgpu_cs_out out;}; /* Specify flags to be used for IB */ /* This IB should be submitted to CE */#define AMDGPU_IB_FLAG_CE	(1<<0) /* Preamble flag, which means the IB could be dropped if no context switch */#define AMDGPU_IB_FLAG_PREAMBLE (1<<1) /* Preempt flag, IB should set Pre_enb bit if PREEMPT flag detected */#define AMDGPU_IB_FLAG_PREEMPT (1<<2) struct drm_amdgpu_cs_chunk_ib {	__u32 _pad;	/** AMDGPU_IB_FLAG_* */	__u32 flags;	/** Virtual address to begin IB execution */	__u64 va_start;	/** Size of submission */	__u32 ib_bytes;	/** HW IP to submit to */	__u32 ip_type;	/** HW IP index of the same type to submit to  */	__u32 ip_instance;	/** Ring index to submit to */	__u32 ring;}; struct drm_amdgpu_cs_chunk_dep {	__u32 ip_type;	__u32 ip_instance;	__u32 ring;	__u32 ctx_id;	__u64 handle;}; struct drm_amdgpu_cs_chunk_fence {	__u32 handle;	__u32 offset;}; struct drm_amdgpu_cs_chunk_data {	union {		struct drm_amdgpu_cs_chunk_ib		ib_data;		struct drm_amdgpu_cs_chunk_fence	fence_data;	};}; /** *  Query h/w info: Flag that this is integrated (a.h.a. fusion) GPU * */#define AMDGPU_IDS_FLAGS_FUSION         0x1#define AMDGPU_IDS_FLAGS_PREEMPTION     0x2 /* indicate if acceleration can be working */

Lines 1–500 of 846.