blob: d6b5a21f3d3c9f9c228ae0291b3ae9b19f486bcc [file] [log] [blame]
Alex Deucher81629cb2015-04-20 16:42:01 -04001/* amdgpu_drm.h -- Public header for the amdgpu driver -*- linux-c -*-
2 *
3 * Copyright 2000 Precision Insight, Inc., Cedar Park, Texas.
4 * Copyright 2000 VA Linux Systems, Inc., Fremont, California.
5 * Copyright 2002 Tungsten Graphics, Inc., Cedar Park, Texas.
6 * Copyright 2014 Advanced Micro Devices, Inc.
7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
14 *
15 * The above copyright notice and this permission notice shall be included in
16 * all copies or substantial portions of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
22 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
23 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
24 * OTHER DEALINGS IN THE SOFTWARE.
25 *
26 * Authors:
27 * Kevin E. Martin <martin@valinux.com>
28 * Gareth Hughes <gareth@valinux.com>
29 * Keith Whitwell <keith@tungstengraphics.com>
30 */
31
32#ifndef __AMDGPU_DRM_H__
33#define __AMDGPU_DRM_H__
34
Michel Dänzerb3fcf36a2015-07-22 17:29:01 +090035#include "drm.h"
Alex Deucher81629cb2015-04-20 16:42:01 -040036
Emil Velikovcfa71522016-04-07 18:45:18 +010037#if defined(__cplusplus)
38extern "C" {
39#endif
40
Alex Deucher81629cb2015-04-20 16:42:01 -040041#define DRM_AMDGPU_GEM_CREATE 0x00
42#define DRM_AMDGPU_GEM_MMAP 0x01
43#define DRM_AMDGPU_CTX 0x02
44#define DRM_AMDGPU_BO_LIST 0x03
45#define DRM_AMDGPU_CS 0x04
46#define DRM_AMDGPU_INFO 0x05
47#define DRM_AMDGPU_GEM_METADATA 0x06
48#define DRM_AMDGPU_GEM_WAIT_IDLE 0x07
49#define DRM_AMDGPU_GEM_VA 0x08
50#define DRM_AMDGPU_WAIT_CS 0x09
51#define DRM_AMDGPU_GEM_OP 0x10
52#define DRM_AMDGPU_GEM_USERPTR 0x11
53
54#define DRM_IOCTL_AMDGPU_GEM_CREATE DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_CREATE, union drm_amdgpu_gem_create)
55#define DRM_IOCTL_AMDGPU_GEM_MMAP DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_MMAP, union drm_amdgpu_gem_mmap)
56#define DRM_IOCTL_AMDGPU_CTX DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_CTX, union drm_amdgpu_ctx)
57#define DRM_IOCTL_AMDGPU_BO_LIST DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_BO_LIST, union drm_amdgpu_bo_list)
58#define DRM_IOCTL_AMDGPU_CS DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_CS, union drm_amdgpu_cs)
59#define DRM_IOCTL_AMDGPU_INFO DRM_IOW(DRM_COMMAND_BASE + DRM_AMDGPU_INFO, struct drm_amdgpu_info)
60#define DRM_IOCTL_AMDGPU_GEM_METADATA DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_METADATA, struct drm_amdgpu_gem_metadata)
61#define DRM_IOCTL_AMDGPU_GEM_WAIT_IDLE DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_WAIT_IDLE, union drm_amdgpu_gem_wait_idle)
Christian König34b5f6a2015-06-08 15:03:00 +020062#define DRM_IOCTL_AMDGPU_GEM_VA DRM_IOW(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_VA, struct drm_amdgpu_gem_va)
Alex Deucher81629cb2015-04-20 16:42:01 -040063#define DRM_IOCTL_AMDGPU_WAIT_CS DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_WAIT_CS, union drm_amdgpu_wait_cs)
64#define DRM_IOCTL_AMDGPU_GEM_OP DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_OP, struct drm_amdgpu_gem_op)
65#define DRM_IOCTL_AMDGPU_GEM_USERPTR DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_USERPTR, struct drm_amdgpu_gem_userptr)
66
67#define AMDGPU_GEM_DOMAIN_CPU 0x1
68#define AMDGPU_GEM_DOMAIN_GTT 0x2
69#define AMDGPU_GEM_DOMAIN_VRAM 0x4
70#define AMDGPU_GEM_DOMAIN_GDS 0x8
71#define AMDGPU_GEM_DOMAIN_GWS 0x10
72#define AMDGPU_GEM_DOMAIN_OA 0x20
73
Alex Deucher81629cb2015-04-20 16:42:01 -040074/* Flag that CPU access will be required for the case of VRAM domain */
75#define AMDGPU_GEM_CREATE_CPU_ACCESS_REQUIRED (1 << 0)
76/* Flag that CPU access will not work, this VRAM domain is invisible */
77#define AMDGPU_GEM_CREATE_NO_CPU_ACCESS (1 << 1)
Alex Deucher81629cb2015-04-20 16:42:01 -040078/* Flag that USWC attributes should be used for GTT */
Jammy Zhou88671282015-05-06 18:44:29 +080079#define AMDGPU_GEM_CREATE_CPU_GTT_USWC (1 << 2)
Flora Cui4fea83f2016-07-20 14:44:38 +080080/* Flag that the memory should be in VRAM and cleared */
81#define AMDGPU_GEM_CREATE_VRAM_CLEARED (1 << 3)
Chunming Zhoue7893c42016-07-26 14:13:21 +080082/* Flag that create shadow bo(GTT) while allocating vram bo */
83#define AMDGPU_GEM_CREATE_SHADOW (1 << 4)
Alex Deucher81629cb2015-04-20 16:42:01 -040084
Alex Deucher81629cb2015-04-20 16:42:01 -040085struct drm_amdgpu_gem_create_in {
86 /** the requested memory size */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +010087 __u64 bo_size;
Alex Deucher81629cb2015-04-20 16:42:01 -040088 /** physical start_addr alignment in bytes for some HW requirements */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +010089 __u64 alignment;
Alex Deucher81629cb2015-04-20 16:42:01 -040090 /** the requested memory domains */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +010091 __u64 domains;
Alex Deucher81629cb2015-04-20 16:42:01 -040092 /** allocation flags */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +010093 __u64 domain_flags;
Alex Deucher81629cb2015-04-20 16:42:01 -040094};
95
96struct drm_amdgpu_gem_create_out {
97 /** returned GEM object handle */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +010098 __u32 handle;
99 __u32 _pad;
Alex Deucher81629cb2015-04-20 16:42:01 -0400100};
101
102union drm_amdgpu_gem_create {
103 struct drm_amdgpu_gem_create_in in;
104 struct drm_amdgpu_gem_create_out out;
105};
106
107/** Opcode to create new residency list. */
108#define AMDGPU_BO_LIST_OP_CREATE 0
109/** Opcode to destroy previously created residency list */
110#define AMDGPU_BO_LIST_OP_DESTROY 1
111/** Opcode to update resource information in the list */
112#define AMDGPU_BO_LIST_OP_UPDATE 2
113
114struct drm_amdgpu_bo_list_in {
115 /** Type of operation */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100116 __u32 operation;
Alex Deucher81629cb2015-04-20 16:42:01 -0400117 /** Handle of list or 0 if we want to create one */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100118 __u32 list_handle;
Alex Deucher81629cb2015-04-20 16:42:01 -0400119 /** Number of BOs in list */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100120 __u32 bo_number;
Alex Deucher81629cb2015-04-20 16:42:01 -0400121 /** Size of each element describing BO */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100122 __u32 bo_info_size;
Alex Deucher81629cb2015-04-20 16:42:01 -0400123 /** Pointer to array describing BOs */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100124 __u64 bo_info_ptr;
Alex Deucher81629cb2015-04-20 16:42:01 -0400125};
126
127struct drm_amdgpu_bo_list_entry {
128 /** Handle of BO */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100129 __u32 bo_handle;
Alex Deucher81629cb2015-04-20 16:42:01 -0400130 /** New (if specified) BO priority to be used during migration */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100131 __u32 bo_priority;
Alex Deucher81629cb2015-04-20 16:42:01 -0400132};
133
134struct drm_amdgpu_bo_list_out {
135 /** Handle of resource list */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100136 __u32 list_handle;
137 __u32 _pad;
Alex Deucher81629cb2015-04-20 16:42:01 -0400138};
139
140union drm_amdgpu_bo_list {
141 struct drm_amdgpu_bo_list_in in;
142 struct drm_amdgpu_bo_list_out out;
143};
144
145/* context related */
146#define AMDGPU_CTX_OP_ALLOC_CTX 1
147#define AMDGPU_CTX_OP_FREE_CTX 2
148#define AMDGPU_CTX_OP_QUERY_STATE 3
149
Marek Olšákd94aed52015-05-05 21:13:49 +0200150/* GPU reset status */
151#define AMDGPU_CTX_NO_RESET 0
Christian König675da0d2015-06-09 15:54:37 +0200152/* this the context caused it */
153#define AMDGPU_CTX_GUILTY_RESET 1
154/* some other context caused it */
155#define AMDGPU_CTX_INNOCENT_RESET 2
156/* unknown cause */
157#define AMDGPU_CTX_UNKNOWN_RESET 3
Marek Olšákd94aed52015-05-05 21:13:49 +0200158
Alex Deucher81629cb2015-04-20 16:42:01 -0400159struct drm_amdgpu_ctx_in {
Christian König675da0d2015-06-09 15:54:37 +0200160 /** AMDGPU_CTX_OP_* */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100161 __u32 op;
Christian König675da0d2015-06-09 15:54:37 +0200162 /** For future use, no flags defined so far */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100163 __u32 flags;
164 __u32 ctx_id;
165 __u32 _pad;
Alex Deucher81629cb2015-04-20 16:42:01 -0400166};
167
168union drm_amdgpu_ctx_out {
169 struct {
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100170 __u32 ctx_id;
171 __u32 _pad;
Alex Deucher81629cb2015-04-20 16:42:01 -0400172 } alloc;
173
174 struct {
Christian König675da0d2015-06-09 15:54:37 +0200175 /** For future use, no flags defined so far */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100176 __u64 flags;
Marek Olšákd94aed52015-05-05 21:13:49 +0200177 /** Number of resets caused by this context so far. */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100178 __u32 hangs;
Marek Olšákd94aed52015-05-05 21:13:49 +0200179 /** Reset status since the last call of the ioctl. */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100180 __u32 reset_status;
Alex Deucher81629cb2015-04-20 16:42:01 -0400181 } state;
182};
183
184union drm_amdgpu_ctx {
185 struct drm_amdgpu_ctx_in in;
186 union drm_amdgpu_ctx_out out;
187};
188
189/*
190 * This is not a reliable API and you should expect it to fail for any
191 * number of reasons and have fallback path that do not use userptr to
192 * perform any operation.
193 */
194#define AMDGPU_GEM_USERPTR_READONLY (1 << 0)
195#define AMDGPU_GEM_USERPTR_ANONONLY (1 << 1)
196#define AMDGPU_GEM_USERPTR_VALIDATE (1 << 2)
197#define AMDGPU_GEM_USERPTR_REGISTER (1 << 3)
198
199struct drm_amdgpu_gem_userptr {
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100200 __u64 addr;
201 __u64 size;
Christian König675da0d2015-06-09 15:54:37 +0200202 /* AMDGPU_GEM_USERPTR_* */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100203 __u32 flags;
Christian König675da0d2015-06-09 15:54:37 +0200204 /* Resulting GEM handle */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100205 __u32 handle;
Alex Deucher81629cb2015-04-20 16:42:01 -0400206};
207
Marek Olšákfbd76d52015-05-14 23:48:26 +0200208/* same meaning as the GB_TILE_MODE and GL_MACRO_TILE_MODE fields */
209#define AMDGPU_TILING_ARRAY_MODE_SHIFT 0
210#define AMDGPU_TILING_ARRAY_MODE_MASK 0xf
211#define AMDGPU_TILING_PIPE_CONFIG_SHIFT 4
212#define AMDGPU_TILING_PIPE_CONFIG_MASK 0x1f
213#define AMDGPU_TILING_TILE_SPLIT_SHIFT 9
214#define AMDGPU_TILING_TILE_SPLIT_MASK 0x7
215#define AMDGPU_TILING_MICRO_TILE_MODE_SHIFT 12
216#define AMDGPU_TILING_MICRO_TILE_MODE_MASK 0x7
217#define AMDGPU_TILING_BANK_WIDTH_SHIFT 15
218#define AMDGPU_TILING_BANK_WIDTH_MASK 0x3
219#define AMDGPU_TILING_BANK_HEIGHT_SHIFT 17
220#define AMDGPU_TILING_BANK_HEIGHT_MASK 0x3
221#define AMDGPU_TILING_MACRO_TILE_ASPECT_SHIFT 19
222#define AMDGPU_TILING_MACRO_TILE_ASPECT_MASK 0x3
223#define AMDGPU_TILING_NUM_BANKS_SHIFT 21
224#define AMDGPU_TILING_NUM_BANKS_MASK 0x3
225
226#define AMDGPU_TILING_SET(field, value) \
227 (((value) & AMDGPU_TILING_##field##_MASK) << AMDGPU_TILING_##field##_SHIFT)
228#define AMDGPU_TILING_GET(value, field) \
229 (((value) >> AMDGPU_TILING_##field##_SHIFT) & AMDGPU_TILING_##field##_MASK)
Alex Deucher81629cb2015-04-20 16:42:01 -0400230
231#define AMDGPU_GEM_METADATA_OP_SET_METADATA 1
232#define AMDGPU_GEM_METADATA_OP_GET_METADATA 2
233
234/** The same structure is shared for input/output */
235struct drm_amdgpu_gem_metadata {
Christian König675da0d2015-06-09 15:54:37 +0200236 /** GEM Object handle */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100237 __u32 handle;
Christian König675da0d2015-06-09 15:54:37 +0200238 /** Do we want get or set metadata */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100239 __u32 op;
Alex Deucher81629cb2015-04-20 16:42:01 -0400240 struct {
Christian König675da0d2015-06-09 15:54:37 +0200241 /** For future use, no flags defined so far */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100242 __u64 flags;
Christian König675da0d2015-06-09 15:54:37 +0200243 /** family specific tiling info */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100244 __u64 tiling_info;
245 __u32 data_size_bytes;
246 __u32 data[64];
Alex Deucher81629cb2015-04-20 16:42:01 -0400247 } data;
248};
249
250struct drm_amdgpu_gem_mmap_in {
Christian König675da0d2015-06-09 15:54:37 +0200251 /** the GEM object handle */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100252 __u32 handle;
253 __u32 _pad;
Alex Deucher81629cb2015-04-20 16:42:01 -0400254};
255
256struct drm_amdgpu_gem_mmap_out {
Christian König675da0d2015-06-09 15:54:37 +0200257 /** mmap offset from the vma offset manager */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100258 __u64 addr_ptr;
Alex Deucher81629cb2015-04-20 16:42:01 -0400259};
260
261union drm_amdgpu_gem_mmap {
262 struct drm_amdgpu_gem_mmap_in in;
263 struct drm_amdgpu_gem_mmap_out out;
264};
265
266struct drm_amdgpu_gem_wait_idle_in {
Christian König675da0d2015-06-09 15:54:37 +0200267 /** GEM object handle */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100268 __u32 handle;
Christian König675da0d2015-06-09 15:54:37 +0200269 /** For future use, no flags defined so far */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100270 __u32 flags;
Christian König675da0d2015-06-09 15:54:37 +0200271 /** Absolute timeout to wait */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100272 __u64 timeout;
Alex Deucher81629cb2015-04-20 16:42:01 -0400273};
274
275struct drm_amdgpu_gem_wait_idle_out {
Christian König675da0d2015-06-09 15:54:37 +0200276 /** BO status: 0 - BO is idle, 1 - BO is busy */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100277 __u32 status;
Christian König675da0d2015-06-09 15:54:37 +0200278 /** Returned current memory domain */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100279 __u32 domain;
Alex Deucher81629cb2015-04-20 16:42:01 -0400280};
281
282union drm_amdgpu_gem_wait_idle {
283 struct drm_amdgpu_gem_wait_idle_in in;
284 struct drm_amdgpu_gem_wait_idle_out out;
285};
286
287struct drm_amdgpu_wait_cs_in {
Christian König675da0d2015-06-09 15:54:37 +0200288 /** Command submission handle */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100289 __u64 handle;
Christian König675da0d2015-06-09 15:54:37 +0200290 /** Absolute timeout to wait */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100291 __u64 timeout;
292 __u32 ip_type;
293 __u32 ip_instance;
294 __u32 ring;
295 __u32 ctx_id;
Alex Deucher81629cb2015-04-20 16:42:01 -0400296};
297
298struct drm_amdgpu_wait_cs_out {
Christian König675da0d2015-06-09 15:54:37 +0200299 /** CS status: 0 - CS completed, 1 - CS still busy */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100300 __u64 status;
Alex Deucher81629cb2015-04-20 16:42:01 -0400301};
302
303union drm_amdgpu_wait_cs {
304 struct drm_amdgpu_wait_cs_in in;
305 struct drm_amdgpu_wait_cs_out out;
306};
307
Marek Olšákd8f65a22015-05-27 14:30:38 +0200308#define AMDGPU_GEM_OP_GET_GEM_CREATE_INFO 0
309#define AMDGPU_GEM_OP_SET_PLACEMENT 1
Alex Deucher81629cb2015-04-20 16:42:01 -0400310
Christian König675da0d2015-06-09 15:54:37 +0200311/* Sets or returns a value associated with a buffer. */
312struct drm_amdgpu_gem_op {
313 /** GEM object handle */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100314 __u32 handle;
Christian König675da0d2015-06-09 15:54:37 +0200315 /** AMDGPU_GEM_OP_* */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100316 __u32 op;
Christian König675da0d2015-06-09 15:54:37 +0200317 /** Input or return value */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100318 __u64 value;
Christian König675da0d2015-06-09 15:54:37 +0200319};
320
Alex Deucher81629cb2015-04-20 16:42:01 -0400321#define AMDGPU_VA_OP_MAP 1
322#define AMDGPU_VA_OP_UNMAP 2
323
Christian Königfc220f62015-06-29 17:12:20 +0200324/* Delay the page table update till the next CS */
325#define AMDGPU_VM_DELAY_UPDATE (1 << 0)
326
Alex Deucher81629cb2015-04-20 16:42:01 -0400327/* Mapping flags */
328/* readable mapping */
329#define AMDGPU_VM_PAGE_READABLE (1 << 1)
330/* writable mapping */
331#define AMDGPU_VM_PAGE_WRITEABLE (1 << 2)
332/* executable mapping, new for VI */
333#define AMDGPU_VM_PAGE_EXECUTABLE (1 << 3)
334
Christian König34b5f6a2015-06-08 15:03:00 +0200335struct drm_amdgpu_gem_va {
Christian König675da0d2015-06-09 15:54:37 +0200336 /** GEM object handle */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100337 __u32 handle;
338 __u32 _pad;
Christian König675da0d2015-06-09 15:54:37 +0200339 /** AMDGPU_VA_OP_* */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100340 __u32 operation;
Christian König675da0d2015-06-09 15:54:37 +0200341 /** AMDGPU_VM_PAGE_* */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100342 __u32 flags;
Christian König675da0d2015-06-09 15:54:37 +0200343 /** va address to assign . Must be correctly aligned.*/
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100344 __u64 va_address;
Christian König675da0d2015-06-09 15:54:37 +0200345 /** Specify offset inside of BO to assign. Must be correctly aligned.*/
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100346 __u64 offset_in_bo;
Christian König675da0d2015-06-09 15:54:37 +0200347 /** Specify mapping size. Must be correctly aligned. */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100348 __u64 map_size;
Alex Deucher81629cb2015-04-20 16:42:01 -0400349};
350
Alex Deucher81629cb2015-04-20 16:42:01 -0400351#define AMDGPU_HW_IP_GFX 0
352#define AMDGPU_HW_IP_COMPUTE 1
353#define AMDGPU_HW_IP_DMA 2
354#define AMDGPU_HW_IP_UVD 3
355#define AMDGPU_HW_IP_VCE 4
356#define AMDGPU_HW_IP_NUM 5
357
358#define AMDGPU_HW_IP_INSTANCE_MAX_COUNT 1
359
360#define AMDGPU_CHUNK_ID_IB 0x01
361#define AMDGPU_CHUNK_ID_FENCE 0x02
Christian König2b48d322015-06-19 17:31:29 +0200362#define AMDGPU_CHUNK_ID_DEPENDENCIES 0x03
Christian König675da0d2015-06-09 15:54:37 +0200363
Alex Deucher81629cb2015-04-20 16:42:01 -0400364struct drm_amdgpu_cs_chunk {
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100365 __u32 chunk_id;
366 __u32 length_dw;
367 __u64 chunk_data;
Alex Deucher81629cb2015-04-20 16:42:01 -0400368};
369
370struct drm_amdgpu_cs_in {
371 /** Rendering context id */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100372 __u32 ctx_id;
Alex Deucher81629cb2015-04-20 16:42:01 -0400373 /** Handle of resource list associated with CS */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100374 __u32 bo_list_handle;
375 __u32 num_chunks;
376 __u32 _pad;
377 /** this points to __u64 * which point to cs chunks */
378 __u64 chunks;
Alex Deucher81629cb2015-04-20 16:42:01 -0400379};
380
381struct drm_amdgpu_cs_out {
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100382 __u64 handle;
Alex Deucher81629cb2015-04-20 16:42:01 -0400383};
384
385union drm_amdgpu_cs {
Christian König675da0d2015-06-09 15:54:37 +0200386 struct drm_amdgpu_cs_in in;
387 struct drm_amdgpu_cs_out out;
Alex Deucher81629cb2015-04-20 16:42:01 -0400388};
389
390/* Specify flags to be used for IB */
391
392/* This IB should be submitted to CE */
393#define AMDGPU_IB_FLAG_CE (1<<0)
394
Jammy Zhouaa2bdb242015-05-11 23:49:34 +0800395/* CE Preamble */
Jammy Zhoucab6d572015-06-06 04:49:22 +0800396#define AMDGPU_IB_FLAG_PREAMBLE (1<<1)
Jammy Zhouaa2bdb242015-05-11 23:49:34 +0800397
Alex Deucher81629cb2015-04-20 16:42:01 -0400398struct drm_amdgpu_cs_chunk_ib {
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100399 __u32 _pad;
Christian König675da0d2015-06-09 15:54:37 +0200400 /** AMDGPU_IB_FLAG_* */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100401 __u32 flags;
Christian König675da0d2015-06-09 15:54:37 +0200402 /** Virtual address to begin IB execution */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100403 __u64 va_start;
Christian König675da0d2015-06-09 15:54:37 +0200404 /** Size of submission */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100405 __u32 ib_bytes;
Christian König675da0d2015-06-09 15:54:37 +0200406 /** HW IP to submit to */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100407 __u32 ip_type;
Christian König675da0d2015-06-09 15:54:37 +0200408 /** HW IP index of the same type to submit to */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100409 __u32 ip_instance;
Christian König675da0d2015-06-09 15:54:37 +0200410 /** Ring index to submit to */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100411 __u32 ring;
Alex Deucher81629cb2015-04-20 16:42:01 -0400412};
413
Christian König2b48d322015-06-19 17:31:29 +0200414struct drm_amdgpu_cs_chunk_dep {
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100415 __u32 ip_type;
416 __u32 ip_instance;
417 __u32 ring;
418 __u32 ctx_id;
419 __u64 handle;
Christian König2b48d322015-06-19 17:31:29 +0200420};
421
Alex Deucher81629cb2015-04-20 16:42:01 -0400422struct drm_amdgpu_cs_chunk_fence {
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100423 __u32 handle;
424 __u32 offset;
Alex Deucher81629cb2015-04-20 16:42:01 -0400425};
426
427struct drm_amdgpu_cs_chunk_data {
428 union {
429 struct drm_amdgpu_cs_chunk_ib ib_data;
430 struct drm_amdgpu_cs_chunk_fence fence_data;
431 };
432};
433
434/**
435 * Query h/w info: Flag that this is integrated (a.h.a. fusion) GPU
436 *
437 */
438#define AMDGPU_IDS_FLAGS_FUSION 0x1
439
440/* indicate if acceleration can be working */
441#define AMDGPU_INFO_ACCEL_WORKING 0x00
442/* get the crtc_id from the mode object id? */
443#define AMDGPU_INFO_CRTC_FROM_ID 0x01
444/* query hw IP info */
445#define AMDGPU_INFO_HW_IP_INFO 0x02
446/* query hw IP instance count for the specified type */
447#define AMDGPU_INFO_HW_IP_COUNT 0x03
448/* timestamp for GL_ARB_timer_query */
449#define AMDGPU_INFO_TIMESTAMP 0x05
450/* Query the firmware version */
451#define AMDGPU_INFO_FW_VERSION 0x0e
452 /* Subquery id: Query VCE firmware version */
453 #define AMDGPU_INFO_FW_VCE 0x1
454 /* Subquery id: Query UVD firmware version */
455 #define AMDGPU_INFO_FW_UVD 0x2
456 /* Subquery id: Query GMC firmware version */
457 #define AMDGPU_INFO_FW_GMC 0x03
458 /* Subquery id: Query GFX ME firmware version */
459 #define AMDGPU_INFO_FW_GFX_ME 0x04
460 /* Subquery id: Query GFX PFP firmware version */
461 #define AMDGPU_INFO_FW_GFX_PFP 0x05
462 /* Subquery id: Query GFX CE firmware version */
463 #define AMDGPU_INFO_FW_GFX_CE 0x06
464 /* Subquery id: Query GFX RLC firmware version */
465 #define AMDGPU_INFO_FW_GFX_RLC 0x07
466 /* Subquery id: Query GFX MEC firmware version */
467 #define AMDGPU_INFO_FW_GFX_MEC 0x08
468 /* Subquery id: Query SMC firmware version */
469 #define AMDGPU_INFO_FW_SMC 0x0a
470 /* Subquery id: Query SDMA firmware version */
471 #define AMDGPU_INFO_FW_SDMA 0x0b
472/* number of bytes moved for TTM migration */
473#define AMDGPU_INFO_NUM_BYTES_MOVED 0x0f
474/* the used VRAM size */
475#define AMDGPU_INFO_VRAM_USAGE 0x10
476/* the used GTT size */
477#define AMDGPU_INFO_GTT_USAGE 0x11
478/* Information about GDS, etc. resource configuration */
479#define AMDGPU_INFO_GDS_CONFIG 0x13
480/* Query information about VRAM and GTT domains */
481#define AMDGPU_INFO_VRAM_GTT 0x14
482/* Query information about register in MMR address space*/
483#define AMDGPU_INFO_READ_MMR_REG 0x15
484/* Query information about device: rev id, family, etc. */
485#define AMDGPU_INFO_DEV_INFO 0x16
486/* visible vram usage */
487#define AMDGPU_INFO_VIS_VRAM_USAGE 0x17
Marek Olšák83a59b62016-08-17 23:58:58 +0200488/* number of TTM buffer evictions */
489#define AMDGPU_INFO_NUM_EVICTIONS 0x18
Alex Deucher81629cb2015-04-20 16:42:01 -0400490
491#define AMDGPU_INFO_MMR_SE_INDEX_SHIFT 0
492#define AMDGPU_INFO_MMR_SE_INDEX_MASK 0xff
493#define AMDGPU_INFO_MMR_SH_INDEX_SHIFT 8
494#define AMDGPU_INFO_MMR_SH_INDEX_MASK 0xff
495
Huang Rui000cab92016-06-12 15:44:44 +0800496struct drm_amdgpu_query_fw {
497 /** AMDGPU_INFO_FW_* */
498 __u32 fw_type;
499 /**
500 * Index of the IP if there are more IPs of
501 * the same type.
502 */
503 __u32 ip_instance;
504 /**
505 * Index of the engine. Whether this is used depends
506 * on the firmware type. (e.g. MEC, SDMA)
507 */
508 __u32 index;
509 __u32 _pad;
510};
511
Alex Deucher81629cb2015-04-20 16:42:01 -0400512/* Input structure for the INFO ioctl */
513struct drm_amdgpu_info {
514 /* Where the return value will be stored */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100515 __u64 return_pointer;
Alex Deucher81629cb2015-04-20 16:42:01 -0400516 /* The size of the return value. Just like "size" in "snprintf",
517 * it limits how many bytes the kernel can write. */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100518 __u32 return_size;
Alex Deucher81629cb2015-04-20 16:42:01 -0400519 /* The query request id. */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100520 __u32 query;
Alex Deucher81629cb2015-04-20 16:42:01 -0400521
522 union {
523 struct {
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100524 __u32 id;
525 __u32 _pad;
Alex Deucher81629cb2015-04-20 16:42:01 -0400526 } mode_crtc;
527
528 struct {
529 /** AMDGPU_HW_IP_* */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100530 __u32 type;
Alex Deucher81629cb2015-04-20 16:42:01 -0400531 /**
Christian König675da0d2015-06-09 15:54:37 +0200532 * Index of the IP if there are more IPs of the same
533 * type. Ignored by AMDGPU_INFO_HW_IP_COUNT.
Alex Deucher81629cb2015-04-20 16:42:01 -0400534 */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100535 __u32 ip_instance;
Alex Deucher81629cb2015-04-20 16:42:01 -0400536 } query_hw_ip;
537
538 struct {
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100539 __u32 dword_offset;
Christian König675da0d2015-06-09 15:54:37 +0200540 /** number of registers to read */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100541 __u32 count;
542 __u32 instance;
Christian König675da0d2015-06-09 15:54:37 +0200543 /** For future use, no flags defined so far */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100544 __u32 flags;
Alex Deucher81629cb2015-04-20 16:42:01 -0400545 } read_mmr_reg;
546
Huang Rui000cab92016-06-12 15:44:44 +0800547 struct drm_amdgpu_query_fw query_fw;
Alex Deucher81629cb2015-04-20 16:42:01 -0400548 };
549};
550
551struct drm_amdgpu_info_gds {
552 /** GDS GFX partition size */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100553 __u32 gds_gfx_partition_size;
Alex Deucher81629cb2015-04-20 16:42:01 -0400554 /** GDS compute partition size */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100555 __u32 compute_partition_size;
Alex Deucher81629cb2015-04-20 16:42:01 -0400556 /** total GDS memory size */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100557 __u32 gds_total_size;
Alex Deucher81629cb2015-04-20 16:42:01 -0400558 /** GWS size per GFX partition */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100559 __u32 gws_per_gfx_partition;
Alex Deucher81629cb2015-04-20 16:42:01 -0400560 /** GSW size per compute partition */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100561 __u32 gws_per_compute_partition;
Alex Deucher81629cb2015-04-20 16:42:01 -0400562 /** OA size per GFX partition */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100563 __u32 oa_per_gfx_partition;
Alex Deucher81629cb2015-04-20 16:42:01 -0400564 /** OA size per compute partition */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100565 __u32 oa_per_compute_partition;
566 __u32 _pad;
Alex Deucher81629cb2015-04-20 16:42:01 -0400567};
568
569struct drm_amdgpu_info_vram_gtt {
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100570 __u64 vram_size;
571 __u64 vram_cpu_accessible_size;
572 __u64 gtt_size;
Alex Deucher81629cb2015-04-20 16:42:01 -0400573};
574
575struct drm_amdgpu_info_firmware {
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100576 __u32 ver;
577 __u32 feature;
Alex Deucher81629cb2015-04-20 16:42:01 -0400578};
579
Ken Wang81c59f52015-06-03 21:02:01 +0800580#define AMDGPU_VRAM_TYPE_UNKNOWN 0
581#define AMDGPU_VRAM_TYPE_GDDR1 1
582#define AMDGPU_VRAM_TYPE_DDR2 2
583#define AMDGPU_VRAM_TYPE_GDDR3 3
584#define AMDGPU_VRAM_TYPE_GDDR4 4
585#define AMDGPU_VRAM_TYPE_GDDR5 5
586#define AMDGPU_VRAM_TYPE_HBM 6
587#define AMDGPU_VRAM_TYPE_DDR3 7
588
Alex Deucher81629cb2015-04-20 16:42:01 -0400589struct drm_amdgpu_info_device {
590 /** PCI Device ID */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100591 __u32 device_id;
Alex Deucher81629cb2015-04-20 16:42:01 -0400592 /** Internal chip revision: A0, A1, etc.) */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100593 __u32 chip_rev;
594 __u32 external_rev;
Alex Deucher81629cb2015-04-20 16:42:01 -0400595 /** Revision id in PCI Config space */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100596 __u32 pci_rev;
597 __u32 family;
598 __u32 num_shader_engines;
599 __u32 num_shader_arrays_per_engine;
Christian König675da0d2015-06-09 15:54:37 +0200600 /* in KHz */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100601 __u32 gpu_counter_freq;
602 __u64 max_engine_clock;
603 __u64 max_memory_clock;
Alex Deucher81629cb2015-04-20 16:42:01 -0400604 /* cu information */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100605 __u32 cu_active_number;
606 __u32 cu_ao_mask;
607 __u32 cu_bitmap[4][4];
Alex Deucher81629cb2015-04-20 16:42:01 -0400608 /** Render backend pipe mask. One render backend is CB+DB. */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100609 __u32 enabled_rb_pipes_mask;
610 __u32 num_rb_pipes;
611 __u32 num_hw_gfx_contexts;
612 __u32 _pad;
613 __u64 ids_flags;
Alex Deucher81629cb2015-04-20 16:42:01 -0400614 /** Starting virtual address for UMDs. */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100615 __u64 virtual_address_offset;
Jammy Zhou02b70c82015-05-12 22:46:45 +0800616 /** The maximum virtual address */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100617 __u64 virtual_address_max;
Alex Deucher81629cb2015-04-20 16:42:01 -0400618 /** Required alignment of virtual addresses. */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100619 __u32 virtual_address_alignment;
Alex Deucher81629cb2015-04-20 16:42:01 -0400620 /** Page table entry - fragment size */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100621 __u32 pte_fragment_size;
622 __u32 gart_page_size;
Ken Wanga101a892015-06-03 17:47:54 +0800623 /** constant engine ram size*/
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100624 __u32 ce_ram_size;
Jammy Zhoucab6d572015-06-06 04:49:22 +0800625 /** video memory type info*/
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100626 __u32 vram_type;
Ken Wang81c59f52015-06-03 21:02:01 +0800627 /** video memory bit width*/
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100628 __u32 vram_bit_width;
Leo Liufa927542015-07-13 12:46:23 -0400629 /* vce harvesting instance */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100630 __u32 vce_harvest_config;
Alex Deucher81629cb2015-04-20 16:42:01 -0400631};
632
633struct drm_amdgpu_info_hw_ip {
634 /** Version of h/w IP */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100635 __u32 hw_ip_version_major;
636 __u32 hw_ip_version_minor;
Alex Deucher81629cb2015-04-20 16:42:01 -0400637 /** Capabilities */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100638 __u64 capabilities_flags;
Ken Wang71062f42015-06-04 21:26:57 +0800639 /** command buffer address start alignment*/
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100640 __u32 ib_start_alignment;
Ken Wang71062f42015-06-04 21:26:57 +0800641 /** command buffer size alignment*/
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100642 __u32 ib_size_alignment;
Alex Deucher81629cb2015-04-20 16:42:01 -0400643 /** Bitmask of available rings. Bit 0 means ring 0, etc. */
Mikko Rapeli2ce9dde2015-12-02 23:44:33 +0100644 __u32 available_rings;
645 __u32 _pad;
Alex Deucher81629cb2015-04-20 16:42:01 -0400646};
647
648/*
649 * Supported GPU families
650 */
651#define AMDGPU_FAMILY_UNKNOWN 0
Ken Wang295d0da2016-05-24 21:02:53 +0800652#define AMDGPU_FAMILY_SI 110 /* Hainan, Oland, Verde, Pitcairn, Tahiti */
Alex Deucher81629cb2015-04-20 16:42:01 -0400653#define AMDGPU_FAMILY_CI 120 /* Bonaire, Hawaii */
654#define AMDGPU_FAMILY_KV 125 /* Kaveri, Kabini, Mullins */
655#define AMDGPU_FAMILY_VI 130 /* Iceland, Tonga */
Samuel Li39bb0c92015-10-08 16:31:43 -0400656#define AMDGPU_FAMILY_CZ 135 /* Carrizo, Stoney */
Alex Deucher81629cb2015-04-20 16:42:01 -0400657
Emil Velikovcfa71522016-04-07 18:45:18 +0100658#if defined(__cplusplus)
659}
660#endif
661
Alex Deucher81629cb2015-04-20 16:42:01 -0400662#endif