1 /* 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 35 #include "drm.h" 36 37 #if defined(__cplusplus) 38 extern "C" { 39 #endif 40 41 #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 #define DRM_AMDGPU_WAIT_FENCES 0x12 54 #define DRM_AMDGPU_VM 0x13 55 #define DRM_AMDGPU_FENCE_TO_HANDLE 0x14 56 #define DRM_AMDGPU_SCHED 0x15 57 58 #define DRM_IOCTL_AMDGPU_GEM_CREATE DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_CREATE, union drm_amdgpu_gem_create) 59 #define DRM_IOCTL_AMDGPU_GEM_MMAP DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_MMAP, union drm_amdgpu_gem_mmap) 60 #define DRM_IOCTL_AMDGPU_CTX DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_CTX, union drm_amdgpu_ctx) 61 #define DRM_IOCTL_AMDGPU_BO_LIST DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_BO_LIST, union drm_amdgpu_bo_list) 62 #define DRM_IOCTL_AMDGPU_CS DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_CS, union drm_amdgpu_cs) 63 #define DRM_IOCTL_AMDGPU_INFO DRM_IOW(DRM_COMMAND_BASE + DRM_AMDGPU_INFO, struct drm_amdgpu_info) 64 #define DRM_IOCTL_AMDGPU_GEM_METADATA DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_METADATA, struct drm_amdgpu_gem_metadata) 65 #define DRM_IOCTL_AMDGPU_GEM_WAIT_IDLE DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_WAIT_IDLE, union drm_amdgpu_gem_wait_idle) 66 #define DRM_IOCTL_AMDGPU_GEM_VA DRM_IOW(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_VA, struct drm_amdgpu_gem_va) 67 #define DRM_IOCTL_AMDGPU_WAIT_CS DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_WAIT_CS, union drm_amdgpu_wait_cs) 68 #define DRM_IOCTL_AMDGPU_GEM_OP DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_OP, struct drm_amdgpu_gem_op) 69 #define DRM_IOCTL_AMDGPU_GEM_USERPTR DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_USERPTR, struct drm_amdgpu_gem_userptr) 70 #define DRM_IOCTL_AMDGPU_WAIT_FENCES DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_WAIT_FENCES, union drm_amdgpu_wait_fences) 71 #define DRM_IOCTL_AMDGPU_VM DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_VM, union drm_amdgpu_vm) 72 #define DRM_IOCTL_AMDGPU_FENCE_TO_HANDLE DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_FENCE_TO_HANDLE, union drm_amdgpu_fence_to_handle) 73 #define DRM_IOCTL_AMDGPU_SCHED DRM_IOW(DRM_COMMAND_BASE + DRM_AMDGPU_SCHED, union drm_amdgpu_sched) 74 75 /** 76 * DOC: memory domains 77 * 78 * %AMDGPU_GEM_DOMAIN_CPU System memory that is not GPU accessible. 79 * Memory in this pool could be swapped out to disk if there is pressure. 80 * 81 * %AMDGPU_GEM_DOMAIN_GTT GPU accessible system memory, mapped into the 82 * GPU's virtual address space via gart. Gart memory linearizes non-contiguous 83 * pages of system memory, allows GPU access system memory in a linezrized 84 * fashion. 85 * 86 * %AMDGPU_GEM_DOMAIN_VRAM Local video memory. For APUs, it is memory 87 * carved out by the BIOS. 88 * 89 * %AMDGPU_GEM_DOMAIN_GDS Global on-chip data storage used to share data 90 * across shader threads. 91 * 92 * %AMDGPU_GEM_DOMAIN_GWS Global wave sync, used to synchronize the 93 * execution of all the waves on a device. 94 * 95 * %AMDGPU_GEM_DOMAIN_OA Ordered append, used by 3D or Compute engines 96 * for appending data. 97 */ 98 #define AMDGPU_GEM_DOMAIN_CPU 0x1 99 #define AMDGPU_GEM_DOMAIN_GTT 0x2 100 #define AMDGPU_GEM_DOMAIN_VRAM 0x4 101 #define AMDGPU_GEM_DOMAIN_GDS 0x8 102 #define AMDGPU_GEM_DOMAIN_GWS 0x10 103 #define AMDGPU_GEM_DOMAIN_OA 0x20 104 #define AMDGPU_GEM_DOMAIN_MASK (AMDGPU_GEM_DOMAIN_CPU | \ 105 AMDGPU_GEM_DOMAIN_GTT | \ 106 AMDGPU_GEM_DOMAIN_VRAM | \ 107 AMDGPU_GEM_DOMAIN_GDS | \ 108 AMDGPU_GEM_DOMAIN_GWS | \ 109 AMDGPU_GEM_DOMAIN_OA) 110 111 /* Flag that CPU access will be required for the case of VRAM domain */ 112 #define AMDGPU_GEM_CREATE_CPU_ACCESS_REQUIRED (1 << 0) 113 /* Flag that CPU access will not work, this VRAM domain is invisible */ 114 #define AMDGPU_GEM_CREATE_NO_CPU_ACCESS (1 << 1) 115 /* Flag that USWC attributes should be used for GTT */ 116 #define AMDGPU_GEM_CREATE_CPU_GTT_USWC (1 << 2) 117 /* Flag that the memory should be in VRAM and cleared */ 118 #define AMDGPU_GEM_CREATE_VRAM_CLEARED (1 << 3) 119 /* Flag that create shadow bo(GTT) while allocating vram bo */ 120 #define AMDGPU_GEM_CREATE_SHADOW (1 << 4) 121 /* Flag that allocating the BO should use linear VRAM */ 122 #define AMDGPU_GEM_CREATE_VRAM_CONTIGUOUS (1 << 5) 123 /* Flag that BO is always valid in this VM */ 124 #define AMDGPU_GEM_CREATE_VM_ALWAYS_VALID (1 << 6) 125 /* Flag that BO sharing will be explicitly synchronized */ 126 #define AMDGPU_GEM_CREATE_EXPLICIT_SYNC (1 << 7) 127 /* Flag that indicates allocating MQD gart on GFX9, where the mtype 128 * for the second page onward should be set to NC. 129 */ 130 #define AMDGPU_GEM_CREATE_MQD_GFX9 (1 << 8) 131 132 struct drm_amdgpu_gem_create_in { 133 /** the requested memory size */ 134 __u64 bo_size; 135 /** physical start_addr alignment in bytes for some HW requirements */ 136 __u64 alignment; 137 /** the requested memory domains */ 138 __u64 domains; 139 /** allocation flags */ 140 __u64 domain_flags; 141 }; 142 143 struct drm_amdgpu_gem_create_out { 144 /** returned GEM object handle */ 145 __u32 handle; 146 __u32 _pad; 147 }; 148 149 union drm_amdgpu_gem_create { 150 struct drm_amdgpu_gem_create_in in; 151 struct drm_amdgpu_gem_create_out out; 152 }; 153 154 /** Opcode to create new residency list. */ 155 #define AMDGPU_BO_LIST_OP_CREATE 0 156 /** Opcode to destroy previously created residency list */ 157 #define AMDGPU_BO_LIST_OP_DESTROY 1 158 /** Opcode to update resource information in the list */ 159 #define AMDGPU_BO_LIST_OP_UPDATE 2 160 161 struct drm_amdgpu_bo_list_in { 162 /** Type of operation */ 163 __u32 operation; 164 /** Handle of list or 0 if we want to create one */ 165 __u32 list_handle; 166 /** Number of BOs in list */ 167 __u32 bo_number; 168 /** Size of each element describing BO */ 169 __u32 bo_info_size; 170 /** Pointer to array describing BOs */ 171 __u64 bo_info_ptr; 172 }; 173 174 struct drm_amdgpu_bo_list_entry { 175 /** Handle of BO */ 176 __u32 bo_handle; 177 /** New (if specified) BO priority to be used during migration */ 178 __u32 bo_priority; 179 }; 180 181 struct drm_amdgpu_bo_list_out { 182 /** Handle of resource list */ 183 __u32 list_handle; 184 __u32 _pad; 185 }; 186 187 union drm_amdgpu_bo_list { 188 struct drm_amdgpu_bo_list_in in; 189 struct drm_amdgpu_bo_list_out out; 190 }; 191 192 /* context related */ 193 #define AMDGPU_CTX_OP_ALLOC_CTX 1 194 #define AMDGPU_CTX_OP_FREE_CTX 2 195 #define AMDGPU_CTX_OP_QUERY_STATE 3 196 #define AMDGPU_CTX_OP_QUERY_STATE2 4 197 198 /* GPU reset status */ 199 #define AMDGPU_CTX_NO_RESET 0 200 /* this the context caused it */ 201 #define AMDGPU_CTX_GUILTY_RESET 1 202 /* some other context caused it */ 203 #define AMDGPU_CTX_INNOCENT_RESET 2 204 /* unknown cause */ 205 #define AMDGPU_CTX_UNKNOWN_RESET 3 206 207 /* indicate gpu reset occurred after ctx created */ 208 #define AMDGPU_CTX_QUERY2_FLAGS_RESET (1<<0) 209 /* indicate vram lost occurred after ctx created */ 210 #define AMDGPU_CTX_QUERY2_FLAGS_VRAMLOST (1<<1) 211 /* indicate some job from this context once cause gpu hang */ 212 #define AMDGPU_CTX_QUERY2_FLAGS_GUILTY (1<<2) 213 /* indicate some errors are detected by RAS */ 214 #define AMDGPU_CTX_QUERY2_FLAGS_RAS_CE (1<<3) 215 #define AMDGPU_CTX_QUERY2_FLAGS_RAS_UE (1<<4) 216 217 /* Context priority level */ 218 #define AMDGPU_CTX_PRIORITY_UNSET -2048 219 #define AMDGPU_CTX_PRIORITY_VERY_LOW -1023 220 #define AMDGPU_CTX_PRIORITY_LOW -512 221 #define AMDGPU_CTX_PRIORITY_NORMAL 0 222 /* Selecting a priority above NORMAL requires CAP_SYS_NICE or DRM_MASTER */ 223 #define AMDGPU_CTX_PRIORITY_HIGH 512 224 #define AMDGPU_CTX_PRIORITY_VERY_HIGH 1023 225 226 struct drm_amdgpu_ctx_in { 227 /** AMDGPU_CTX_OP_* */ 228 __u32 op; 229 /** For future use, no flags defined so far */ 230 __u32 flags; 231 __u32 ctx_id; 232 __s32 priority; 233 }; 234 235 union drm_amdgpu_ctx_out { 236 struct { 237 __u32 ctx_id; 238 __u32 _pad; 239 } alloc; 240 241 struct { 242 /** For future use, no flags defined so far */ 243 __u64 flags; 244 /** Number of resets caused by this context so far. */ 245 __u32 hangs; 246 /** Reset status since the last call of the ioctl. */ 247 __u32 reset_status; 248 } state; 249 }; 250 251 union drm_amdgpu_ctx { 252 struct drm_amdgpu_ctx_in in; 253 union drm_amdgpu_ctx_out out; 254 }; 255 256 /* vm ioctl */ 257 #define AMDGPU_VM_OP_RESERVE_VMID 1 258 #define AMDGPU_VM_OP_UNRESERVE_VMID 2 259 260 struct drm_amdgpu_vm_in { 261 /** AMDGPU_VM_OP_* */ 262 __u32 op; 263 __u32 flags; 264 }; 265 266 struct drm_amdgpu_vm_out { 267 /** For future use, no flags defined so far */ 268 __u64 flags; 269 }; 270 271 union drm_amdgpu_vm { 272 struct drm_amdgpu_vm_in in; 273 struct drm_amdgpu_vm_out out; 274 }; 275 276 /* sched ioctl */ 277 #define AMDGPU_SCHED_OP_PROCESS_PRIORITY_OVERRIDE 1 278 #define AMDGPU_SCHED_OP_CONTEXT_PRIORITY_OVERRIDE 2 279 280 struct drm_amdgpu_sched_in { 281 /* AMDGPU_SCHED_OP_* */ 282 __u32 op; 283 __u32 fd; 284 __s32 priority; 285 __u32 ctx_id; 286 }; 287 288 union drm_amdgpu_sched { 289 struct drm_amdgpu_sched_in in; 290 }; 291 292 /* 293 * This is not a reliable API and you should expect it to fail for any 294 * number of reasons and have fallback path that do not use userptr to 295 * perform any operation. 296 */ 297 #define AMDGPU_GEM_USERPTR_READONLY (1 << 0) 298 #define AMDGPU_GEM_USERPTR_ANONONLY (1 << 1) 299 #define AMDGPU_GEM_USERPTR_VALIDATE (1 << 2) 300 #define AMDGPU_GEM_USERPTR_REGISTER (1 << 3) 301 302 struct drm_amdgpu_gem_userptr { 303 __u64 addr; 304 __u64 size; 305 /* AMDGPU_GEM_USERPTR_* */ 306 __u32 flags; 307 /* Resulting GEM handle */ 308 __u32 handle; 309 }; 310 311 /* SI-CI-VI: */ 312 /* same meaning as the GB_TILE_MODE and GL_MACRO_TILE_MODE fields */ 313 #define AMDGPU_TILING_ARRAY_MODE_SHIFT 0 314 #define AMDGPU_TILING_ARRAY_MODE_MASK 0xf 315 #define AMDGPU_TILING_PIPE_CONFIG_SHIFT 4 316 #define AMDGPU_TILING_PIPE_CONFIG_MASK 0x1f 317 #define AMDGPU_TILING_TILE_SPLIT_SHIFT 9 318 #define AMDGPU_TILING_TILE_SPLIT_MASK 0x7 319 #define AMDGPU_TILING_MICRO_TILE_MODE_SHIFT 12 320 #define AMDGPU_TILING_MICRO_TILE_MODE_MASK 0x7 321 #define AMDGPU_TILING_BANK_WIDTH_SHIFT 15 322 #define AMDGPU_TILING_BANK_WIDTH_MASK 0x3 323 #define AMDGPU_TILING_BANK_HEIGHT_SHIFT 17 324 #define AMDGPU_TILING_BANK_HEIGHT_MASK 0x3 325 #define AMDGPU_TILING_MACRO_TILE_ASPECT_SHIFT 19 326 #define AMDGPU_TILING_MACRO_TILE_ASPECT_MASK 0x3 327 #define AMDGPU_TILING_NUM_BANKS_SHIFT 21 328 #define AMDGPU_TILING_NUM_BANKS_MASK 0x3 329 330 /* GFX9 and later: */ 331 #define AMDGPU_TILING_SWIZZLE_MODE_SHIFT 0 332 #define AMDGPU_TILING_SWIZZLE_MODE_MASK 0x1f 333 #define AMDGPU_TILING_DCC_OFFSET_256B_SHIFT 5 334 #define AMDGPU_TILING_DCC_OFFSET_256B_MASK 0xFFFFFF 335 #define AMDGPU_TILING_DCC_PITCH_MAX_SHIFT 29 336 #define AMDGPU_TILING_DCC_PITCH_MAX_MASK 0x3FFF 337 #define AMDGPU_TILING_DCC_INDEPENDENT_64B_SHIFT 43 338 #define AMDGPU_TILING_DCC_INDEPENDENT_64B_MASK 0x1 339 340 /* Set/Get helpers for tiling flags. */ 341 #define AMDGPU_TILING_SET(field, value) \ 342 (((__u64)(value) & AMDGPU_TILING_##field##_MASK) << AMDGPU_TILING_##field##_SHIFT) 343 #define AMDGPU_TILING_GET(value, field) \ 344 (((__u64)(value) >> AMDGPU_TILING_##field##_SHIFT) & AMDGPU_TILING_##field##_MASK) 345 346 #define AMDGPU_GEM_METADATA_OP_SET_METADATA 1 347 #define AMDGPU_GEM_METADATA_OP_GET_METADATA 2 348 349 /** The same structure is shared for input/output */ 350 struct drm_amdgpu_gem_metadata { 351 /** GEM Object handle */ 352 __u32 handle; 353 /** Do we want get or set metadata */ 354 __u32 op; 355 struct { 356 /** For future use, no flags defined so far */ 357 __u64 flags; 358 /** family specific tiling info */ 359 __u64 tiling_info; 360 __u32 data_size_bytes; 361 __u32 data[64]; 362 } data; 363 }; 364 365 struct drm_amdgpu_gem_mmap_in { 366 /** the GEM object handle */ 367 __u32 handle; 368 __u32 _pad; 369 }; 370 371 struct drm_amdgpu_gem_mmap_out { 372 /** mmap offset from the vma offset manager */ 373 __u64 addr_ptr; 374 }; 375 376 union drm_amdgpu_gem_mmap { 377 struct drm_amdgpu_gem_mmap_in in; 378 struct drm_amdgpu_gem_mmap_out out; 379 }; 380 381 struct drm_amdgpu_gem_wait_idle_in { 382 /** GEM object handle */ 383 __u32 handle; 384 /** For future use, no flags defined so far */ 385 __u32 flags; 386 /** Absolute timeout to wait */ 387 __u64 timeout; 388 }; 389 390 struct drm_amdgpu_gem_wait_idle_out { 391 /** BO status: 0 - BO is idle, 1 - BO is busy */ 392 __u32 status; 393 /** Returned current memory domain */ 394 __u32 domain; 395 }; 396 397 union drm_amdgpu_gem_wait_idle { 398 struct drm_amdgpu_gem_wait_idle_in in; 399 struct drm_amdgpu_gem_wait_idle_out out; 400 }; 401 402 struct drm_amdgpu_wait_cs_in { 403 /* Command submission handle 404 * handle equals 0 means none to wait for 405 * handle equals ~0ull means wait for the latest sequence number 406 */ 407 __u64 handle; 408 /** Absolute timeout to wait */ 409 __u64 timeout; 410 __u32 ip_type; 411 __u32 ip_instance; 412 __u32 ring; 413 __u32 ctx_id; 414 }; 415 416 struct drm_amdgpu_wait_cs_out { 417 /** CS status: 0 - CS completed, 1 - CS still busy */ 418 __u64 status; 419 }; 420 421 union drm_amdgpu_wait_cs { 422 struct drm_amdgpu_wait_cs_in in; 423 struct drm_amdgpu_wait_cs_out out; 424 }; 425 426 struct drm_amdgpu_fence { 427 __u32 ctx_id; 428 __u32 ip_type; 429 __u32 ip_instance; 430 __u32 ring; 431 __u64 seq_no; 432 }; 433 434 struct drm_amdgpu_wait_fences_in { 435 /** This points to uint64_t * which points to fences */ 436 __u64 fences; 437 __u32 fence_count; 438 __u32 wait_all; 439 __u64 timeout_ns; 440 }; 441 442 struct drm_amdgpu_wait_fences_out { 443 __u32 status; 444 __u32 first_signaled; 445 }; 446 447 union drm_amdgpu_wait_fences { 448 struct drm_amdgpu_wait_fences_in in; 449 struct drm_amdgpu_wait_fences_out out; 450 }; 451 452 #define AMDGPU_GEM_OP_GET_GEM_CREATE_INFO 0 453 #define AMDGPU_GEM_OP_SET_PLACEMENT 1 454 455 /* Sets or returns a value associated with a buffer. */ 456 struct drm_amdgpu_gem_op { 457 /** GEM object handle */ 458 __u32 handle; 459 /** AMDGPU_GEM_OP_* */ 460 __u32 op; 461 /** Input or return value */ 462 __u64 value; 463 }; 464 465 #define AMDGPU_VA_OP_MAP 1 466 #define AMDGPU_VA_OP_UNMAP 2 467 #define AMDGPU_VA_OP_CLEAR 3 468 #define AMDGPU_VA_OP_REPLACE 4 469 470 /* Delay the page table update till the next CS */ 471 #define AMDGPU_VM_DELAY_UPDATE (1 << 0) 472 473 /* Mapping flags */ 474 /* readable mapping */ 475 #define AMDGPU_VM_PAGE_READABLE (1 << 1) 476 /* writable mapping */ 477 #define AMDGPU_VM_PAGE_WRITEABLE (1 << 2) 478 /* executable mapping, new for VI */ 479 #define AMDGPU_VM_PAGE_EXECUTABLE (1 << 3) 480 /* partially resident texture */ 481 #define AMDGPU_VM_PAGE_PRT (1 << 4) 482 /* MTYPE flags use bit 5 to 8 */ 483 #define AMDGPU_VM_MTYPE_MASK (0xf << 5) 484 /* Default MTYPE. Pre-AI must use this. Recommended for newer ASICs. */ 485 #define AMDGPU_VM_MTYPE_DEFAULT (0 << 5) 486 /* Use NC MTYPE instead of default MTYPE */ 487 #define AMDGPU_VM_MTYPE_NC (1 << 5) 488 /* Use WC MTYPE instead of default MTYPE */ 489 #define AMDGPU_VM_MTYPE_WC (2 << 5) 490 /* Use CC MTYPE instead of default MTYPE */ 491 #define AMDGPU_VM_MTYPE_CC (3 << 5) 492 /* Use UC MTYPE instead of default MTYPE */ 493 #define AMDGPU_VM_MTYPE_UC (4 << 5) 494 495 struct drm_amdgpu_gem_va { 496 /** GEM object handle */ 497 __u32 handle; 498 __u32 _pad; 499 /** AMDGPU_VA_OP_* */ 500 __u32 operation; 501 /** AMDGPU_VM_PAGE_* */ 502 __u32 flags; 503 /** va address to assign . Must be correctly aligned.*/ 504 __u64 va_address; 505 /** Specify offset inside of BO to assign. Must be correctly aligned.*/ 506 __u64 offset_in_bo; 507 /** Specify mapping size. Must be correctly aligned. */ 508 __u64 map_size; 509 }; 510 511 #define AMDGPU_HW_IP_GFX 0 512 #define AMDGPU_HW_IP_COMPUTE 1 513 #define AMDGPU_HW_IP_DMA 2 514 #define AMDGPU_HW_IP_UVD 3 515 #define AMDGPU_HW_IP_VCE 4 516 #define AMDGPU_HW_IP_UVD_ENC 5 517 #define AMDGPU_HW_IP_VCN_DEC 6 518 #define AMDGPU_HW_IP_VCN_ENC 7 519 #define AMDGPU_HW_IP_VCN_JPEG 8 520 #define AMDGPU_HW_IP_NUM 9 521 522 #define AMDGPU_HW_IP_INSTANCE_MAX_COUNT 1 523 524 #define AMDGPU_CHUNK_ID_IB 0x01 525 #define AMDGPU_CHUNK_ID_FENCE 0x02 526 #define AMDGPU_CHUNK_ID_DEPENDENCIES 0x03 527 #define AMDGPU_CHUNK_ID_SYNCOBJ_IN 0x04 528 #define AMDGPU_CHUNK_ID_SYNCOBJ_OUT 0x05 529 #define AMDGPU_CHUNK_ID_BO_HANDLES 0x06 530 #define AMDGPU_CHUNK_ID_SCHEDULED_DEPENDENCIES 0x07 531 #define AMDGPU_CHUNK_ID_SYNCOBJ_TIMELINE_WAIT 0x08 532 #define AMDGPU_CHUNK_ID_SYNCOBJ_TIMELINE_SIGNAL 0x09 533 534 struct drm_amdgpu_cs_chunk { 535 __u32 chunk_id; 536 __u32 length_dw; 537 __u64 chunk_data; 538 }; 539 540 struct drm_amdgpu_cs_in { 541 /** Rendering context id */ 542 __u32 ctx_id; 543 /** Handle of resource list associated with CS */ 544 __u32 bo_list_handle; 545 __u32 num_chunks; 546 __u32 _pad; 547 /** this points to __u64 * which point to cs chunks */ 548 __u64 chunks; 549 }; 550 551 struct drm_amdgpu_cs_out { 552 __u64 handle; 553 }; 554 555 union drm_amdgpu_cs { 556 struct drm_amdgpu_cs_in in; 557 struct drm_amdgpu_cs_out out; 558 }; 559 560 /* Specify flags to be used for IB */ 561 562 /* This IB should be submitted to CE */ 563 #define AMDGPU_IB_FLAG_CE (1<<0) 564 565 /* Preamble flag, which means the IB could be dropped if no context switch */ 566 #define AMDGPU_IB_FLAG_PREAMBLE (1<<1) 567 568 /* Preempt flag, IB should set Pre_enb bit if PREEMPT flag detected */ 569 #define AMDGPU_IB_FLAG_PREEMPT (1<<2) 570 571 /* The IB fence should do the L2 writeback but not invalidate any shader 572 * caches (L2/vL1/sL1/I$). */ 573 #define AMDGPU_IB_FLAG_TC_WB_NOT_INVALIDATE (1 << 3) 574 575 /* Set GDS_COMPUTE_MAX_WAVE_ID = DEFAULT before PACKET3_INDIRECT_BUFFER. 576 * This will reset wave ID counters for the IB. 577 */ 578 #define AMDGPU_IB_FLAG_RESET_GDS_MAX_WAVE_ID (1 << 4) 579 580 struct drm_amdgpu_cs_chunk_ib { 581 __u32 _pad; 582 /** AMDGPU_IB_FLAG_* */ 583 __u32 flags; 584 /** Virtual address to begin IB execution */ 585 __u64 va_start; 586 /** Size of submission */ 587 __u32 ib_bytes; 588 /** HW IP to submit to */ 589 __u32 ip_type; 590 /** HW IP index of the same type to submit to */ 591 __u32 ip_instance; 592 /** Ring index to submit to */ 593 __u32 ring; 594 }; 595 596 struct drm_amdgpu_cs_chunk_dep { 597 __u32 ip_type; 598 __u32 ip_instance; 599 __u32 ring; 600 __u32 ctx_id; 601 __u64 handle; 602 }; 603 604 struct drm_amdgpu_cs_chunk_fence { 605 __u32 handle; 606 __u32 offset; 607 }; 608 609 struct drm_amdgpu_cs_chunk_sem { 610 __u32 handle; 611 }; 612 613 struct drm_amdgpu_cs_chunk_syncobj { 614 __u32 handle; 615 __u32 flags; 616 __u64 point; 617 }; 618 619 620 #define AMDGPU_FENCE_TO_HANDLE_GET_SYNCOBJ 0 621 #define AMDGPU_FENCE_TO_HANDLE_GET_SYNCOBJ_FD 1 622 #define AMDGPU_FENCE_TO_HANDLE_GET_SYNC_FILE_FD 2 623 624 union drm_amdgpu_fence_to_handle { 625 struct { 626 struct drm_amdgpu_fence fence; 627 __u32 what; 628 __u32 pad; 629 } in; 630 struct { 631 __u32 handle; 632 } out; 633 }; 634 635 struct drm_amdgpu_cs_chunk_data { 636 union { 637 struct drm_amdgpu_cs_chunk_ib ib_data; 638 struct drm_amdgpu_cs_chunk_fence fence_data; 639 }; 640 }; 641 642 /** 643 * Query h/w info: Flag that this is integrated (a.h.a. fusion) GPU 644 * 645 */ 646 #define AMDGPU_IDS_FLAGS_FUSION 0x1 647 #define AMDGPU_IDS_FLAGS_PREEMPTION 0x2 648 649 /* indicate if acceleration can be working */ 650 #define AMDGPU_INFO_ACCEL_WORKING 0x00 651 /* get the crtc_id from the mode object id? */ 652 #define AMDGPU_INFO_CRTC_FROM_ID 0x01 653 /* query hw IP info */ 654 #define AMDGPU_INFO_HW_IP_INFO 0x02 655 /* query hw IP instance count for the specified type */ 656 #define AMDGPU_INFO_HW_IP_COUNT 0x03 657 /* timestamp for GL_ARB_timer_query */ 658 #define AMDGPU_INFO_TIMESTAMP 0x05 659 /* Query the firmware version */ 660 #define AMDGPU_INFO_FW_VERSION 0x0e 661 /* Subquery id: Query VCE firmware version */ 662 #define AMDGPU_INFO_FW_VCE 0x1 663 /* Subquery id: Query UVD firmware version */ 664 #define AMDGPU_INFO_FW_UVD 0x2 665 /* Subquery id: Query GMC firmware version */ 666 #define AMDGPU_INFO_FW_GMC 0x03 667 /* Subquery id: Query GFX ME firmware version */ 668 #define AMDGPU_INFO_FW_GFX_ME 0x04 669 /* Subquery id: Query GFX PFP firmware version */ 670 #define AMDGPU_INFO_FW_GFX_PFP 0x05 671 /* Subquery id: Query GFX CE firmware version */ 672 #define AMDGPU_INFO_FW_GFX_CE 0x06 673 /* Subquery id: Query GFX RLC firmware version */ 674 #define AMDGPU_INFO_FW_GFX_RLC 0x07 675 /* Subquery id: Query GFX MEC firmware version */ 676 #define AMDGPU_INFO_FW_GFX_MEC 0x08 677 /* Subquery id: Query SMC firmware version */ 678 #define AMDGPU_INFO_FW_SMC 0x0a 679 /* Subquery id: Query SDMA firmware version */ 680 #define AMDGPU_INFO_FW_SDMA 0x0b 681 /* Subquery id: Query PSP SOS firmware version */ 682 #define AMDGPU_INFO_FW_SOS 0x0c 683 /* Subquery id: Query PSP ASD firmware version */ 684 #define AMDGPU_INFO_FW_ASD 0x0d 685 /* Subquery id: Query VCN firmware version */ 686 #define AMDGPU_INFO_FW_VCN 0x0e 687 /* Subquery id: Query GFX RLC SRLC firmware version */ 688 #define AMDGPU_INFO_FW_GFX_RLC_RESTORE_LIST_CNTL 0x0f 689 /* Subquery id: Query GFX RLC SRLG firmware version */ 690 #define AMDGPU_INFO_FW_GFX_RLC_RESTORE_LIST_GPM_MEM 0x10 691 /* Subquery id: Query GFX RLC SRLS firmware version */ 692 #define AMDGPU_INFO_FW_GFX_RLC_RESTORE_LIST_SRM_MEM 0x11 693 /* Subquery id: Query DMCU firmware version */ 694 #define AMDGPU_INFO_FW_DMCU 0x12 695 #define AMDGPU_INFO_FW_TA 0x13 696 /* number of bytes moved for TTM migration */ 697 #define AMDGPU_INFO_NUM_BYTES_MOVED 0x0f 698 /* the used VRAM size */ 699 #define AMDGPU_INFO_VRAM_USAGE 0x10 700 /* the used GTT size */ 701 #define AMDGPU_INFO_GTT_USAGE 0x11 702 /* Information about GDS, etc. resource configuration */ 703 #define AMDGPU_INFO_GDS_CONFIG 0x13 704 /* Query information about VRAM and GTT domains */ 705 #define AMDGPU_INFO_VRAM_GTT 0x14 706 /* Query information about register in MMR address space*/ 707 #define AMDGPU_INFO_READ_MMR_REG 0x15 708 /* Query information about device: rev id, family, etc. */ 709 #define AMDGPU_INFO_DEV_INFO 0x16 710 /* visible vram usage */ 711 #define AMDGPU_INFO_VIS_VRAM_USAGE 0x17 712 /* number of TTM buffer evictions */ 713 #define AMDGPU_INFO_NUM_EVICTIONS 0x18 714 /* Query memory about VRAM and GTT domains */ 715 #define AMDGPU_INFO_MEMORY 0x19 716 /* Query vce clock table */ 717 #define AMDGPU_INFO_VCE_CLOCK_TABLE 0x1A 718 /* Query vbios related information */ 719 #define AMDGPU_INFO_VBIOS 0x1B 720 /* Subquery id: Query vbios size */ 721 #define AMDGPU_INFO_VBIOS_SIZE 0x1 722 /* Subquery id: Query vbios image */ 723 #define AMDGPU_INFO_VBIOS_IMAGE 0x2 724 /* Query UVD handles */ 725 #define AMDGPU_INFO_NUM_HANDLES 0x1C 726 /* Query sensor related information */ 727 #define AMDGPU_INFO_SENSOR 0x1D 728 /* Subquery id: Query GPU shader clock */ 729 #define AMDGPU_INFO_SENSOR_GFX_SCLK 0x1 730 /* Subquery id: Query GPU memory clock */ 731 #define AMDGPU_INFO_SENSOR_GFX_MCLK 0x2 732 /* Subquery id: Query GPU temperature */ 733 #define AMDGPU_INFO_SENSOR_GPU_TEMP 0x3 734 /* Subquery id: Query GPU load */ 735 #define AMDGPU_INFO_SENSOR_GPU_LOAD 0x4 736 /* Subquery id: Query average GPU power */ 737 #define AMDGPU_INFO_SENSOR_GPU_AVG_POWER 0x5 738 /* Subquery id: Query northbridge voltage */ 739 #define AMDGPU_INFO_SENSOR_VDDNB 0x6 740 /* Subquery id: Query graphics voltage */ 741 #define AMDGPU_INFO_SENSOR_VDDGFX 0x7 742 /* Subquery id: Query GPU stable pstate shader clock */ 743 #define AMDGPU_INFO_SENSOR_STABLE_PSTATE_GFX_SCLK 0x8 744 /* Subquery id: Query GPU stable pstate memory clock */ 745 #define AMDGPU_INFO_SENSOR_STABLE_PSTATE_GFX_MCLK 0x9 746 /* Number of VRAM page faults on CPU access. */ 747 #define AMDGPU_INFO_NUM_VRAM_CPU_PAGE_FAULTS 0x1E 748 #define AMDGPU_INFO_VRAM_LOST_COUNTER 0x1F 749 /* query ras mask of enabled features*/ 750 #define AMDGPU_INFO_RAS_ENABLED_FEATURES 0x20 751 752 /* RAS MASK: UMC (VRAM) */ 753 #define AMDGPU_INFO_RAS_ENABLED_UMC (1 << 0) 754 /* RAS MASK: SDMA */ 755 #define AMDGPU_INFO_RAS_ENABLED_SDMA (1 << 1) 756 /* RAS MASK: GFX */ 757 #define AMDGPU_INFO_RAS_ENABLED_GFX (1 << 2) 758 /* RAS MASK: MMHUB */ 759 #define AMDGPU_INFO_RAS_ENABLED_MMHUB (1 << 3) 760 /* RAS MASK: ATHUB */ 761 #define AMDGPU_INFO_RAS_ENABLED_ATHUB (1 << 4) 762 /* RAS MASK: PCIE */ 763 #define AMDGPU_INFO_RAS_ENABLED_PCIE (1 << 5) 764 /* RAS MASK: HDP */ 765 #define AMDGPU_INFO_RAS_ENABLED_HDP (1 << 6) 766 /* RAS MASK: XGMI */ 767 #define AMDGPU_INFO_RAS_ENABLED_XGMI (1 << 7) 768 /* RAS MASK: DF */ 769 #define AMDGPU_INFO_RAS_ENABLED_DF (1 << 8) 770 /* RAS MASK: SMN */ 771 #define AMDGPU_INFO_RAS_ENABLED_SMN (1 << 9) 772 /* RAS MASK: SEM */ 773 #define AMDGPU_INFO_RAS_ENABLED_SEM (1 << 10) 774 /* RAS MASK: MP0 */ 775 #define AMDGPU_INFO_RAS_ENABLED_MP0 (1 << 11) 776 /* RAS MASK: MP1 */ 777 #define AMDGPU_INFO_RAS_ENABLED_MP1 (1 << 12) 778 /* RAS MASK: FUSE */ 779 #define AMDGPU_INFO_RAS_ENABLED_FUSE (1 << 13) 780 781 #define AMDGPU_INFO_MMR_SE_INDEX_SHIFT 0 782 #define AMDGPU_INFO_MMR_SE_INDEX_MASK 0xff 783 #define AMDGPU_INFO_MMR_SH_INDEX_SHIFT 8 784 #define AMDGPU_INFO_MMR_SH_INDEX_MASK 0xff 785 786 struct drm_amdgpu_query_fw { 787 /** AMDGPU_INFO_FW_* */ 788 __u32 fw_type; 789 /** 790 * Index of the IP if there are more IPs of 791 * the same type. 792 */ 793 __u32 ip_instance; 794 /** 795 * Index of the engine. Whether this is used depends 796 * on the firmware type. (e.g. MEC, SDMA) 797 */ 798 __u32 index; 799 __u32 _pad; 800 }; 801 802 /* Input structure for the INFO ioctl */ 803 struct drm_amdgpu_info { 804 /* Where the return value will be stored */ 805 __u64 return_pointer; 806 /* The size of the return value. Just like "size" in "snprintf", 807 * it limits how many bytes the kernel can write. */ 808 __u32 return_size; 809 /* The query request id. */ 810 __u32 query; 811 812 union { 813 struct { 814 __u32 id; 815 __u32 _pad; 816 } mode_crtc; 817 818 struct { 819 /** AMDGPU_HW_IP_* */ 820 __u32 type; 821 /** 822 * Index of the IP if there are more IPs of the same 823 * type. Ignored by AMDGPU_INFO_HW_IP_COUNT. 824 */ 825 __u32 ip_instance; 826 } query_hw_ip; 827 828 struct { 829 __u32 dword_offset; 830 /** number of registers to read */ 831 __u32 count; 832 __u32 instance; 833 /** For future use, no flags defined so far */ 834 __u32 flags; 835 } read_mmr_reg; 836 837 struct drm_amdgpu_query_fw query_fw; 838 839 struct { 840 __u32 type; 841 __u32 offset; 842 } vbios_info; 843 844 struct { 845 __u32 type; 846 } sensor_info; 847 }; 848 }; 849 850 struct drm_amdgpu_info_gds { 851 /** GDS GFX partition size */ 852 __u32 gds_gfx_partition_size; 853 /** GDS compute partition size */ 854 __u32 compute_partition_size; 855 /** total GDS memory size */ 856 __u32 gds_total_size; 857 /** GWS size per GFX partition */ 858 __u32 gws_per_gfx_partition; 859 /** GSW size per compute partition */ 860 __u32 gws_per_compute_partition; 861 /** OA size per GFX partition */ 862 __u32 oa_per_gfx_partition; 863 /** OA size per compute partition */ 864 __u32 oa_per_compute_partition; 865 __u32 _pad; 866 }; 867 868 struct drm_amdgpu_info_vram_gtt { 869 __u64 vram_size; 870 __u64 vram_cpu_accessible_size; 871 __u64 gtt_size; 872 }; 873 874 struct drm_amdgpu_heap_info { 875 /** max. physical memory */ 876 __u64 total_heap_size; 877 878 /** Theoretical max. available memory in the given heap */ 879 __u64 usable_heap_size; 880 881 /** 882 * Number of bytes allocated in the heap. This includes all processes 883 * and private allocations in the kernel. It changes when new buffers 884 * are allocated, freed, and moved. It cannot be larger than 885 * heap_size. 886 */ 887 __u64 heap_usage; 888 889 /** 890 * Theoretical possible max. size of buffer which 891 * could be allocated in the given heap 892 */ 893 __u64 max_allocation; 894 }; 895 896 struct drm_amdgpu_memory_info { 897 struct drm_amdgpu_heap_info vram; 898 struct drm_amdgpu_heap_info cpu_accessible_vram; 899 struct drm_amdgpu_heap_info gtt; 900 }; 901 902 struct drm_amdgpu_info_firmware { 903 __u32 ver; 904 __u32 feature; 905 }; 906 907 #define AMDGPU_VRAM_TYPE_UNKNOWN 0 908 #define AMDGPU_VRAM_TYPE_GDDR1 1 909 #define AMDGPU_VRAM_TYPE_DDR2 2 910 #define AMDGPU_VRAM_TYPE_GDDR3 3 911 #define AMDGPU_VRAM_TYPE_GDDR4 4 912 #define AMDGPU_VRAM_TYPE_GDDR5 5 913 #define AMDGPU_VRAM_TYPE_HBM 6 914 #define AMDGPU_VRAM_TYPE_DDR3 7 915 #define AMDGPU_VRAM_TYPE_DDR4 8 916 #define AMDGPU_VRAM_TYPE_GDDR6 9 917 918 struct drm_amdgpu_info_device { 919 /** PCI Device ID */ 920 __u32 device_id; 921 /** Internal chip revision: A0, A1, etc.) */ 922 __u32 chip_rev; 923 __u32 external_rev; 924 /** Revision id in PCI Config space */ 925 __u32 pci_rev; 926 __u32 family; 927 __u32 num_shader_engines; 928 __u32 num_shader_arrays_per_engine; 929 /* in KHz */ 930 __u32 gpu_counter_freq; 931 __u64 max_engine_clock; 932 __u64 max_memory_clock; 933 /* cu information */ 934 __u32 cu_active_number; 935 /* NOTE: cu_ao_mask is INVALID, DON'T use it */ 936 __u32 cu_ao_mask; 937 __u32 cu_bitmap[4][4]; 938 /** Render backend pipe mask. One render backend is CB+DB. */ 939 __u32 enabled_rb_pipes_mask; 940 __u32 num_rb_pipes; 941 __u32 num_hw_gfx_contexts; 942 __u32 _pad; 943 __u64 ids_flags; 944 /** Starting virtual address for UMDs. */ 945 __u64 virtual_address_offset; 946 /** The maximum virtual address */ 947 __u64 virtual_address_max; 948 /** Required alignment of virtual addresses. */ 949 __u32 virtual_address_alignment; 950 /** Page table entry - fragment size */ 951 __u32 pte_fragment_size; 952 __u32 gart_page_size; 953 /** constant engine ram size*/ 954 __u32 ce_ram_size; 955 /** video memory type info*/ 956 __u32 vram_type; 957 /** video memory bit width*/ 958 __u32 vram_bit_width; 959 /* vce harvesting instance */ 960 __u32 vce_harvest_config; 961 /* gfx double offchip LDS buffers */ 962 __u32 gc_double_offchip_lds_buf; 963 /* NGG Primitive Buffer */ 964 __u64 prim_buf_gpu_addr; 965 /* NGG Position Buffer */ 966 __u64 pos_buf_gpu_addr; 967 /* NGG Control Sideband */ 968 __u64 cntl_sb_buf_gpu_addr; 969 /* NGG Parameter Cache */ 970 __u64 param_buf_gpu_addr; 971 __u32 prim_buf_size; 972 __u32 pos_buf_size; 973 __u32 cntl_sb_buf_size; 974 __u32 param_buf_size; 975 /* wavefront size*/ 976 __u32 wave_front_size; 977 /* shader visible vgprs*/ 978 __u32 num_shader_visible_vgprs; 979 /* CU per shader array*/ 980 __u32 num_cu_per_sh; 981 /* number of tcc blocks*/ 982 __u32 num_tcc_blocks; 983 /* gs vgt table depth*/ 984 __u32 gs_vgt_table_depth; 985 /* gs primitive buffer depth*/ 986 __u32 gs_prim_buffer_depth; 987 /* max gs wavefront per vgt*/ 988 __u32 max_gs_waves_per_vgt; 989 __u32 _pad1; 990 /* always on cu bitmap */ 991 __u32 cu_ao_bitmap[4][4]; 992 /** Starting high virtual address for UMDs. */ 993 __u64 high_va_offset; 994 /** The maximum high virtual address */ 995 __u64 high_va_max; 996 /* gfx10 pa_sc_tile_steering_override */ 997 __u32 pa_sc_tile_steering_override; 998 }; 999 1000 struct drm_amdgpu_info_hw_ip { 1001 /** Version of h/w IP */ 1002 __u32 hw_ip_version_major; 1003 __u32 hw_ip_version_minor; 1004 /** Capabilities */ 1005 __u64 capabilities_flags; 1006 /** command buffer address start alignment*/ 1007 __u32 ib_start_alignment; 1008 /** command buffer size alignment*/ 1009 __u32 ib_size_alignment; 1010 /** Bitmask of available rings. Bit 0 means ring 0, etc. */ 1011 __u32 available_rings; 1012 __u32 _pad; 1013 }; 1014 1015 struct drm_amdgpu_info_num_handles { 1016 /** Max handles as supported by firmware for UVD */ 1017 __u32 uvd_max_handles; 1018 /** Handles currently in use for UVD */ 1019 __u32 uvd_used_handles; 1020 }; 1021 1022 #define AMDGPU_VCE_CLOCK_TABLE_ENTRIES 6 1023 1024 struct drm_amdgpu_info_vce_clock_table_entry { 1025 /** System clock */ 1026 __u32 sclk; 1027 /** Memory clock */ 1028 __u32 mclk; 1029 /** VCE clock */ 1030 __u32 eclk; 1031 __u32 pad; 1032 }; 1033 1034 struct drm_amdgpu_info_vce_clock_table { 1035 struct drm_amdgpu_info_vce_clock_table_entry entries[AMDGPU_VCE_CLOCK_TABLE_ENTRIES]; 1036 __u32 num_valid_entries; 1037 __u32 pad; 1038 }; 1039 1040 /* 1041 * Supported GPU families 1042 */ 1043 #define AMDGPU_FAMILY_UNKNOWN 0 1044 #define AMDGPU_FAMILY_SI 110 /* Hainan, Oland, Verde, Pitcairn, Tahiti */ 1045 #define AMDGPU_FAMILY_CI 120 /* Bonaire, Hawaii */ 1046 #define AMDGPU_FAMILY_KV 125 /* Kaveri, Kabini, Mullins */ 1047 #define AMDGPU_FAMILY_VI 130 /* Iceland, Tonga */ 1048 #define AMDGPU_FAMILY_CZ 135 /* Carrizo, Stoney */ 1049 #define AMDGPU_FAMILY_AI 141 /* Vega10 */ 1050 #define AMDGPU_FAMILY_RV 142 /* Raven */ 1051 #define AMDGPU_FAMILY_NV 143 /* Navi10 */ 1052 1053 #if defined(__cplusplus) 1054 } 1055 #endif 1056 1057 #endif 1058