1 /* 2 * Copyright 2022 Advanced Micro Devices, Inc. 3 * 4 * Permission is hereby granted, free of charge, to any person obtaining a 5 * copy of this software and associated documentation files (the "Software"), 6 * to deal in the Software without restriction, including without limitation 7 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 8 * and/or sell copies of the Software, and to permit persons to whom the 9 * Software is furnished to do so, subject to the following conditions: 10 * 11 * The above copyright notice and this permission notice shall be included in 12 * all copies or substantial portions of the Software. 13 * 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 17 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR 18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 20 * OTHER DEALINGS IN THE SOFTWARE. 21 * 22 */ 23 24 #ifndef __MES_API_DEF_H__ 25 #define __MES_API_DEF_H__ 26 27 #pragma pack(push, 4) 28 29 #define MES_API_VERSION 1 30 31 /* Driver submits one API(cmd) as a single Frame and this command size is same 32 * for all API to ease the debugging and parsing of ring buffer. 33 */ 34 enum { API_FRAME_SIZE_IN_DWORDS = 64 }; 35 36 /* To avoid command in scheduler context to be overwritten whenenver mutilple 37 * interrupts come in, this creates another queue. 38 */ 39 enum { API_NUMBER_OF_COMMAND_MAX = 32 }; 40 41 enum MES_API_TYPE { 42 MES_API_TYPE_SCHEDULER = 1, 43 MES_API_TYPE_MAX 44 }; 45 46 enum MES_SCH_API_OPCODE { 47 MES_SCH_API_SET_HW_RSRC = 0, 48 MES_SCH_API_SET_SCHEDULING_CONFIG = 1, /* agreegated db, quantums, etc */ 49 MES_SCH_API_ADD_QUEUE = 2, 50 MES_SCH_API_REMOVE_QUEUE = 3, 51 MES_SCH_API_PERFORM_YIELD = 4, 52 MES_SCH_API_SET_GANG_PRIORITY_LEVEL = 5, 53 MES_SCH_API_SUSPEND = 6, 54 MES_SCH_API_RESUME = 7, 55 MES_SCH_API_RESET = 8, 56 MES_SCH_API_SET_LOG_BUFFER = 9, 57 MES_SCH_API_CHANGE_GANG_PRORITY = 10, 58 MES_SCH_API_QUERY_SCHEDULER_STATUS = 11, 59 MES_SCH_API_PROGRAM_GDS = 12, 60 MES_SCH_API_SET_DEBUG_VMID = 13, 61 MES_SCH_API_MISC = 14, 62 MES_SCH_API_UPDATE_ROOT_PAGE_TABLE = 15, 63 MES_SCH_API_AMD_LOG = 16, 64 MES_SCH_API_MAX = 0xFF 65 }; 66 67 union MES_API_HEADER { 68 struct { 69 uint32_t type : 4; /* 0 - Invalid; 1 - Scheduling; 2 - TBD */ 70 uint32_t opcode : 8; 71 uint32_t dwsize : 8; /* including header */ 72 uint32_t reserved : 12; 73 }; 74 75 uint32_t u32All; 76 }; 77 78 enum MES_AMD_PRIORITY_LEVEL { 79 AMD_PRIORITY_LEVEL_LOW = 0, 80 AMD_PRIORITY_LEVEL_NORMAL = 1, 81 AMD_PRIORITY_LEVEL_MEDIUM = 2, 82 AMD_PRIORITY_LEVEL_HIGH = 3, 83 AMD_PRIORITY_LEVEL_REALTIME = 4, 84 AMD_PRIORITY_NUM_LEVELS 85 }; 86 87 enum MES_QUEUE_TYPE { 88 MES_QUEUE_TYPE_GFX, 89 MES_QUEUE_TYPE_COMPUTE, 90 MES_QUEUE_TYPE_SDMA, 91 MES_QUEUE_TYPE_MAX, 92 }; 93 94 struct MES_API_STATUS { 95 uint64_t api_completion_fence_addr; 96 uint64_t api_completion_fence_value; 97 }; 98 99 enum { MAX_COMPUTE_PIPES = 8 }; 100 enum { MAX_GFX_PIPES = 2 }; 101 enum { MAX_SDMA_PIPES = 2 }; 102 103 enum { MAX_COMPUTE_HQD_PER_PIPE = 8 }; 104 enum { MAX_GFX_HQD_PER_PIPE = 8 }; 105 enum { MAX_SDMA_HQD_PER_PIPE = 10 }; 106 enum { MAX_SDMA_HQD_PER_PIPE_11_0 = 8 }; 107 108 enum { MAX_QUEUES_IN_A_GANG = 8 }; 109 110 enum VM_HUB_TYPE { 111 VM_HUB_TYPE_GC = 0, 112 VM_HUB_TYPE_MM = 1, 113 VM_HUB_TYPE_MAX, 114 }; 115 116 enum { VMID_INVALID = 0xffff }; 117 118 enum { MAX_VMID_GCHUB = 16 }; 119 enum { MAX_VMID_MMHUB = 16 }; 120 121 enum SET_DEBUG_VMID_OPERATIONS { 122 DEBUG_VMID_OP_PROGRAM = 0, 123 DEBUG_VMID_OP_ALLOCATE = 1, 124 DEBUG_VMID_OP_RELEASE = 2 125 }; 126 127 enum MES_LOG_OPERATION { 128 MES_LOG_OPERATION_CONTEXT_STATE_CHANGE = 0, 129 MES_LOG_OPERATION_QUEUE_NEW_WORK = 1, 130 MES_LOG_OPERATION_QUEUE_UNWAIT_SYNC_OBJECT = 2, 131 MES_LOG_OPERATION_QUEUE_NO_MORE_WORK = 3, 132 MES_LOG_OPERATION_QUEUE_WAIT_SYNC_OBJECT = 4, 133 MES_LOG_OPERATION_QUEUE_INVALID = 0xF, 134 }; 135 136 enum MES_LOG_CONTEXT_STATE { 137 MES_LOG_CONTEXT_STATE_IDLE = 0, 138 MES_LOG_CONTEXT_STATE_RUNNING = 1, 139 MES_LOG_CONTEXT_STATE_READY = 2, 140 MES_LOG_CONTEXT_STATE_READY_STANDBY = 3, 141 MES_LOG_CONTEXT_STATE_INVALID = 0xF, 142 }; 143 144 struct MES_LOG_CONTEXT_STATE_CHANGE { 145 void *h_context; 146 enum MES_LOG_CONTEXT_STATE new_context_state; 147 }; 148 149 struct MES_LOG_QUEUE_NEW_WORK { 150 uint64_t h_queue; 151 uint64_t reserved; 152 }; 153 154 struct MES_LOG_QUEUE_UNWAIT_SYNC_OBJECT { 155 uint64_t h_queue; 156 uint64_t h_sync_object; 157 }; 158 159 struct MES_LOG_QUEUE_NO_MORE_WORK { 160 uint64_t h_queue; 161 uint64_t reserved; 162 }; 163 164 struct MES_LOG_QUEUE_WAIT_SYNC_OBJECT { 165 uint64_t h_queue; 166 uint64_t h_sync_object; 167 }; 168 169 struct MES_LOG_ENTRY_HEADER { 170 uint32_t first_free_entry_index; 171 uint32_t wraparound_count; 172 uint64_t number_of_entries; 173 uint64_t reserved[2]; 174 }; 175 176 struct MES_LOG_ENTRY_DATA { 177 uint64_t gpu_time_stamp; 178 uint32_t operation_type; /* operation_type is of MES_LOG_OPERATION type */ 179 uint32_t reserved_operation_type_bits; 180 union { 181 struct MES_LOG_CONTEXT_STATE_CHANGE context_state_change; 182 struct MES_LOG_QUEUE_NEW_WORK queue_new_work; 183 struct MES_LOG_QUEUE_UNWAIT_SYNC_OBJECT queue_unwait_sync_object; 184 struct MES_LOG_QUEUE_NO_MORE_WORK queue_no_more_work; 185 struct MES_LOG_QUEUE_WAIT_SYNC_OBJECT queue_wait_sync_object; 186 uint64_t all[2]; 187 }; 188 }; 189 190 struct MES_LOG_BUFFER { 191 struct MES_LOG_ENTRY_HEADER header; 192 struct MES_LOG_ENTRY_DATA entries[1]; 193 }; 194 195 enum MES_SWIP_TO_HWIP_DEF { 196 MES_MAX_HWIP_SEGMENT = 8, 197 }; 198 199 union MESAPI_SET_HW_RESOURCES { 200 struct { 201 union MES_API_HEADER header; 202 uint32_t vmid_mask_mmhub; 203 uint32_t vmid_mask_gfxhub; 204 uint32_t gds_size; 205 uint32_t paging_vmid; 206 uint32_t compute_hqd_mask[MAX_COMPUTE_PIPES]; 207 uint32_t gfx_hqd_mask[MAX_GFX_PIPES]; 208 uint32_t sdma_hqd_mask[MAX_SDMA_PIPES]; 209 uint32_t aggregated_doorbells[AMD_PRIORITY_NUM_LEVELS]; 210 uint64_t g_sch_ctx_gpu_mc_ptr; 211 uint64_t query_status_fence_gpu_mc_ptr; 212 uint32_t gc_base[MES_MAX_HWIP_SEGMENT]; 213 uint32_t mmhub_base[MES_MAX_HWIP_SEGMENT]; 214 uint32_t osssys_base[MES_MAX_HWIP_SEGMENT]; 215 struct MES_API_STATUS api_status; 216 union { 217 struct { 218 uint32_t disable_reset : 1; 219 uint32_t use_different_vmid_compute : 1; 220 uint32_t disable_mes_log : 1; 221 uint32_t apply_mmhub_pgvm_invalidate_ack_loss_wa : 1; 222 uint32_t apply_grbm_remote_register_dummy_read_wa : 1; 223 uint32_t second_gfx_pipe_enabled : 1; 224 uint32_t enable_level_process_quantum_check : 1; 225 uint32_t legacy_sch_mode : 1; 226 uint32_t disable_add_queue_wptr_mc_addr : 1; 227 uint32_t enable_mes_event_int_logging : 1; 228 uint32_t enable_reg_active_poll : 1; 229 uint32_t reserved : 21; 230 }; 231 uint32_t uint32_t_all; 232 }; 233 uint32_t oversubscription_timer; 234 uint64_t doorbell_info; 235 }; 236 237 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 238 }; 239 240 union MESAPI__ADD_QUEUE { 241 struct { 242 union MES_API_HEADER header; 243 uint32_t process_id; 244 uint64_t page_table_base_addr; 245 uint64_t process_va_start; 246 uint64_t process_va_end; 247 uint64_t process_quantum; 248 uint64_t process_context_addr; 249 uint64_t gang_quantum; 250 uint64_t gang_context_addr; 251 uint32_t inprocess_gang_priority; 252 enum MES_AMD_PRIORITY_LEVEL gang_global_priority_level; 253 uint32_t doorbell_offset; 254 uint64_t mqd_addr; 255 uint64_t wptr_addr; 256 uint64_t h_context; 257 uint64_t h_queue; 258 enum MES_QUEUE_TYPE queue_type; 259 uint32_t gds_base; 260 uint32_t gds_size; 261 uint32_t gws_base; 262 uint32_t gws_size; 263 uint32_t oa_mask; 264 uint64_t trap_handler_addr; 265 uint32_t vm_context_cntl; 266 267 struct { 268 uint32_t paging : 1; 269 uint32_t debug_vmid : 4; 270 uint32_t program_gds : 1; 271 uint32_t is_gang_suspended : 1; 272 uint32_t is_tmz_queue : 1; 273 uint32_t map_kiq_utility_queue : 1; 274 uint32_t is_kfd_process : 1; 275 uint32_t trap_en : 1; 276 uint32_t is_aql_queue : 1; 277 uint32_t skip_process_ctx_clear : 1; 278 uint32_t map_legacy_kq : 1; 279 uint32_t exclusively_scheduled : 1; 280 uint32_t reserved : 17; 281 }; 282 struct MES_API_STATUS api_status; 283 uint64_t tma_addr; 284 }; 285 286 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 287 }; 288 289 union MESAPI__REMOVE_QUEUE { 290 struct { 291 union MES_API_HEADER header; 292 uint32_t doorbell_offset; 293 uint64_t gang_context_addr; 294 295 struct { 296 uint32_t unmap_legacy_gfx_queue : 1; 297 uint32_t unmap_kiq_utility_queue : 1; 298 uint32_t preempt_legacy_gfx_queue : 1; 299 uint32_t unmap_legacy_queue : 1; 300 uint32_t reserved : 28; 301 }; 302 struct MES_API_STATUS api_status; 303 304 uint32_t pipe_id; 305 uint32_t queue_id; 306 307 uint64_t tf_addr; 308 uint32_t tf_data; 309 310 enum MES_QUEUE_TYPE queue_type; 311 }; 312 313 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 314 }; 315 316 union MESAPI__SET_SCHEDULING_CONFIG { 317 struct { 318 union MES_API_HEADER header; 319 /* Grace period when preempting another priority band for this 320 * priority band. The value for idle priority band is ignored, 321 * as it never preempts other bands. 322 */ 323 uint64_t grace_period_other_levels[AMD_PRIORITY_NUM_LEVELS]; 324 /* Default quantum for scheduling across processes within 325 * a priority band. 326 */ 327 uint64_t process_quantum_for_level[AMD_PRIORITY_NUM_LEVELS]; 328 /* Default grace period for processes that preempt each other 329 * within a priority band. 330 */ 331 uint64_t process_grace_period_same_level[AMD_PRIORITY_NUM_LEVELS]; 332 /* For normal level this field specifies the target GPU 333 * percentage in situations when it's starved by the high level. 334 * Valid values are between 0 and 50, with the default being 10. 335 */ 336 uint32_t normal_yield_percent; 337 struct MES_API_STATUS api_status; 338 }; 339 340 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 341 }; 342 343 union MESAPI__PERFORM_YIELD { 344 struct { 345 union MES_API_HEADER header; 346 uint32_t dummy; 347 struct MES_API_STATUS api_status; 348 }; 349 350 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 351 }; 352 353 union MESAPI__CHANGE_GANG_PRIORITY_LEVEL { 354 struct { 355 union MES_API_HEADER header; 356 uint32_t inprocess_gang_priority; 357 enum MES_AMD_PRIORITY_LEVEL gang_global_priority_level; 358 uint64_t gang_quantum; 359 uint64_t gang_context_addr; 360 struct MES_API_STATUS api_status; 361 }; 362 363 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 364 }; 365 366 union MESAPI__SUSPEND { 367 struct { 368 union MES_API_HEADER header; 369 /* false - suspend all gangs; true - specific gang */ 370 struct { 371 uint32_t suspend_all_gangs : 1; 372 uint32_t reserved : 31; 373 }; 374 /* gang_context_addr is valid only if suspend_all = false */ 375 uint64_t gang_context_addr; 376 377 uint64_t suspend_fence_addr; 378 uint32_t suspend_fence_value; 379 380 struct MES_API_STATUS api_status; 381 }; 382 383 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 384 }; 385 386 union MESAPI__RESUME { 387 struct { 388 union MES_API_HEADER header; 389 /* false - resume all gangs; true - specified gang */ 390 struct { 391 uint32_t resume_all_gangs : 1; 392 uint32_t reserved : 31; 393 }; 394 /* valid only if resume_all_gangs = false */ 395 uint64_t gang_context_addr; 396 397 struct MES_API_STATUS api_status; 398 }; 399 400 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 401 }; 402 403 union MESAPI__RESET { 404 struct { 405 union MES_API_HEADER header; 406 407 struct { 408 /* Only reset the queue given by doorbell_offset (not entire gang) */ 409 uint32_t reset_queue_only : 1; 410 /* Hang detection first then reset any queues that are hung */ 411 uint32_t hang_detect_then_reset : 1; 412 /* Only do hang detection (no reset) */ 413 uint32_t hang_detect_only : 1; 414 /* Rest HP and LP kernel queues not managed by MES */ 415 uint32_t reset_legacy_gfx : 1; 416 uint32_t reserved : 28; 417 }; 418 419 uint64_t gang_context_addr; 420 421 /* valid only if reset_queue_only = true */ 422 uint32_t doorbell_offset; 423 424 /* valid only if hang_detect_then_reset = true */ 425 uint64_t doorbell_offset_addr; 426 enum MES_QUEUE_TYPE queue_type; 427 428 /* valid only if reset_legacy_gfx = true */ 429 uint32_t pipe_id_lp; 430 uint32_t queue_id_lp; 431 uint32_t vmid_id_lp; 432 uint64_t mqd_mc_addr_lp; 433 uint32_t doorbell_offset_lp; 434 uint64_t wptr_addr_lp; 435 436 uint32_t pipe_id_hp; 437 uint32_t queue_id_hp; 438 uint32_t vmid_id_hp; 439 uint64_t mqd_mc_addr_hp; 440 uint32_t doorbell_offset_hp; 441 uint64_t wptr_addr_hp; 442 443 struct MES_API_STATUS api_status; 444 }; 445 446 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 447 }; 448 449 union MESAPI__SET_LOGGING_BUFFER { 450 struct { 451 union MES_API_HEADER header; 452 /* There are separate log buffers for each queue type */ 453 enum MES_QUEUE_TYPE log_type; 454 /* Log buffer GPU Address */ 455 uint64_t logging_buffer_addr; 456 /* number of entries in the log buffer */ 457 uint32_t number_of_entries; 458 /* Entry index at which CPU interrupt needs to be signalled */ 459 uint32_t interrupt_entry; 460 461 struct MES_API_STATUS api_status; 462 }; 463 464 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 465 }; 466 467 union MESAPI__QUERY_MES_STATUS { 468 struct { 469 union MES_API_HEADER header; 470 bool mes_healthy; /* 0 - not healthy, 1 - healthy */ 471 struct MES_API_STATUS api_status; 472 }; 473 474 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 475 }; 476 477 union MESAPI__PROGRAM_GDS { 478 struct { 479 union MES_API_HEADER header; 480 uint64_t process_context_addr; 481 uint32_t gds_base; 482 uint32_t gds_size; 483 uint32_t gws_base; 484 uint32_t gws_size; 485 uint32_t oa_mask; 486 struct MES_API_STATUS api_status; 487 }; 488 489 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 490 }; 491 492 union MESAPI__SET_DEBUG_VMID { 493 struct { 494 union MES_API_HEADER header; 495 struct MES_API_STATUS api_status; 496 union { 497 struct { 498 uint32_t use_gds : 1; 499 uint32_t operation : 2; 500 uint32_t reserved : 29; 501 } flags; 502 uint32_t u32All; 503 }; 504 uint32_t reserved; 505 uint32_t debug_vmid; 506 uint64_t process_context_addr; 507 uint64_t page_table_base_addr; 508 uint64_t process_va_start; 509 uint64_t process_va_end; 510 uint32_t gds_base; 511 uint32_t gds_size; 512 uint32_t gws_base; 513 uint32_t gws_size; 514 uint32_t oa_mask; 515 516 /* output addr of the acquired vmid value */ 517 uint64_t output_addr; 518 }; 519 520 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 521 }; 522 523 enum MESAPI_MISC_OPCODE { 524 MESAPI_MISC__WRITE_REG, 525 MESAPI_MISC__INV_GART, 526 MESAPI_MISC__QUERY_STATUS, 527 MESAPI_MISC__READ_REG, 528 MESAPI_MISC__WAIT_REG_MEM, 529 MESAPI_MISC__SET_SHADER_DEBUGGER, 530 MESAPI_MISC__MAX, 531 }; 532 533 enum { MISC_DATA_MAX_SIZE_IN_DWORDS = 20 }; 534 535 struct WRITE_REG { 536 uint32_t reg_offset; 537 uint32_t reg_value; 538 }; 539 540 struct READ_REG { 541 uint32_t reg_offset; 542 uint64_t buffer_addr; 543 }; 544 545 enum WRM_OPERATION { 546 WRM_OPERATION__WAIT_REG_MEM, 547 WRM_OPERATION__WR_WAIT_WR_REG, 548 WRM_OPERATION__MAX, 549 }; 550 551 struct WAIT_REG_MEM { 552 enum WRM_OPERATION op; 553 uint32_t reference; 554 uint32_t mask; 555 uint32_t reg_offset1; 556 uint32_t reg_offset2; 557 }; 558 559 struct INV_GART { 560 uint64_t inv_range_va_start; 561 uint64_t inv_range_size; 562 }; 563 564 struct QUERY_STATUS { 565 uint32_t context_id; 566 }; 567 568 struct SET_SHADER_DEBUGGER { 569 uint64_t process_context_addr; 570 union { 571 struct { 572 uint32_t single_memop : 1; /* SQ_DEBUG.single_memop */ 573 uint32_t single_alu_op : 1; /* SQ_DEBUG.single_alu_op */ 574 uint32_t reserved : 30; 575 }; 576 uint32_t u32all; 577 } flags; 578 uint32_t spi_gdbg_per_vmid_cntl; 579 uint32_t tcp_watch_cntl[4]; /* TCP_WATCHx_CNTL */ 580 uint32_t trap_en; 581 }; 582 583 union MESAPI__MISC { 584 struct { 585 union MES_API_HEADER header; 586 enum MESAPI_MISC_OPCODE opcode; 587 struct MES_API_STATUS api_status; 588 589 union { 590 struct WRITE_REG write_reg; 591 struct INV_GART inv_gart; 592 struct QUERY_STATUS query_status; 593 struct READ_REG read_reg; 594 struct WAIT_REG_MEM wait_reg_mem; 595 struct SET_SHADER_DEBUGGER set_shader_debugger; 596 enum MES_AMD_PRIORITY_LEVEL queue_sch_level; 597 598 uint32_t data[MISC_DATA_MAX_SIZE_IN_DWORDS]; 599 }; 600 }; 601 602 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 603 }; 604 605 union MESAPI__UPDATE_ROOT_PAGE_TABLE { 606 struct { 607 union MES_API_HEADER header; 608 uint64_t page_table_base_addr; 609 uint64_t process_context_addr; 610 struct MES_API_STATUS api_status; 611 }; 612 613 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 614 }; 615 616 union MESAPI_AMD_LOG { 617 struct { 618 union MES_API_HEADER header; 619 uint64_t p_buffer_memory; 620 uint64_t p_buffer_size_used; 621 struct MES_API_STATUS api_status; 622 }; 623 624 uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS]; 625 }; 626 627 #pragma pack(pop) 628 #endif 629