drivers/gpu/drm/amd/include/mes_v11_api_def.h

   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 reserved               : 19;
 279                 };
 280                 struct MES_API_STATUS           api_status;
 281                 uint64_t                        tma_addr;
 282         };
 283
 284         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 285 };
 286
 287 union MESAPI__REMOVE_QUEUE {
 288         struct {
 289                 union MES_API_HEADER    header;
 290                 uint32_t                doorbell_offset;
 291                 uint64_t                gang_context_addr;
 292
 293                 struct {
 294                         uint32_t unmap_legacy_gfx_queue   : 1;
 295                         uint32_t unmap_kiq_utility_queue  : 1;
 296                         uint32_t preempt_legacy_gfx_queue : 1;
 297                         uint32_t unmap_legacy_queue       : 1;
 298                         uint32_t reserved                 : 28;
 299                 };
 300                 struct MES_API_STATUS       api_status;
 301
 302                 uint32_t                    pipe_id;
 303                 uint32_t                    queue_id;
 304
 305                 uint64_t                    tf_addr;
 306                 uint32_t                    tf_data;
 307
 308                 enum MES_QUEUE_TYPE         queue_type;
 309         };
 310
 311         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 312 };
 313
 314 union MESAPI__SET_SCHEDULING_CONFIG {
 315         struct {
 316                 union MES_API_HEADER    header;
 317                 /* Grace period when preempting another priority band for this
 318                  * priority band. The value for idle priority band is ignored,
 319                  * as it never preempts other bands.
 320                  */
 321                 uint64_t                grace_period_other_levels[AMD_PRIORITY_NUM_LEVELS];
 322                 /* Default quantum for scheduling across processes within
 323                  * a priority band.
 324                  */
 325                 uint64_t                process_quantum_for_level[AMD_PRIORITY_NUM_LEVELS];
 326                 /* Default grace period for processes that preempt each other
 327                  * within a priority band.
 328                  */
 329                 uint64_t                process_grace_period_same_level[AMD_PRIORITY_NUM_LEVELS];
 330                 /* For normal level this field specifies the target GPU
 331                  * percentage in situations when it's starved by the high level.
 332                  * Valid values are between 0 and 50, with the default being 10.
 333                  */
 334                 uint32_t                normal_yield_percent;
 335                 struct MES_API_STATUS   api_status;
 336         };
 337
 338         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 339 };
 340
 341 union MESAPI__PERFORM_YIELD {
 342         struct {
 343                 union MES_API_HEADER    header;
 344                 uint32_t                dummy;
 345                 struct MES_API_STATUS   api_status;
 346         };
 347
 348         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 349 };
 350
 351 union MESAPI__CHANGE_GANG_PRIORITY_LEVEL {
 352         struct {
 353                 union MES_API_HEADER            header;
 354                 uint32_t                        inprocess_gang_priority;
 355                 enum MES_AMD_PRIORITY_LEVEL     gang_global_priority_level;
 356                 uint64_t                        gang_quantum;
 357                 uint64_t                        gang_context_addr;
 358                 struct MES_API_STATUS           api_status;
 359         };
 360
 361         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 362 };
 363
 364 union MESAPI__SUSPEND {
 365         struct {
 366                 union MES_API_HEADER    header;
 367                 /* false - suspend all gangs; true - specific gang */
 368                 struct {
 369                         uint32_t suspend_all_gangs      : 1;
 370                         uint32_t reserved               : 31;
 371                 };
 372                 /* gang_context_addr is valid only if suspend_all = false */
 373                 uint64_t                gang_context_addr;
 374
 375                 uint64_t                suspend_fence_addr;
 376                 uint32_t                suspend_fence_value;
 377
 378                 struct MES_API_STATUS   api_status;
 379         };
 380
 381         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 382 };
 383
 384 union MESAPI__RESUME {
 385         struct {
 386                 union MES_API_HEADER    header;
 387                 /* false - resume all gangs; true - specified gang */
 388                 struct {
 389                         uint32_t resume_all_gangs       : 1;
 390                         uint32_t reserved               : 31;
 391                 };
 392                 /* valid only if resume_all_gangs = false */
 393                 uint64_t                gang_context_addr;
 394
 395                 struct MES_API_STATUS   api_status;
 396         };
 397
 398         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 399 };
 400
 401 union MESAPI__RESET {
 402         struct {
 403                 union MES_API_HEADER            header;
 404
 405                 struct {
 406                         /* Only reset the queue given by doorbell_offset (not entire gang) */
 407                         uint32_t                reset_queue_only : 1;
 408                         /* Hang detection first then reset any queues that are hung */
 409                         uint32_t                hang_detect_then_reset : 1;
 410                         /* Only do hang detection (no reset) */
 411                         uint32_t                hang_detect_only : 1;
 412                         /* Rest HP and LP kernel queues not managed by MES */
 413                         uint32_t                reset_legacy_gfx : 1;
 414                         uint32_t                reserved : 28;
 415                 };
 416
 417                 uint64_t                        gang_context_addr;
 418
 419                 /* valid only if reset_queue_only = true */
 420                 uint32_t                        doorbell_offset;
 421
 422                 /* valid only if hang_detect_then_reset = true */
 423                 uint64_t                        doorbell_offset_addr;
 424                 enum MES_QUEUE_TYPE             queue_type;
 425
 426                 /* valid only if reset_legacy_gfx = true */
 427                 uint32_t                        pipe_id_lp;
 428                 uint32_t                        queue_id_lp;
 429                 uint32_t                        vmid_id_lp;
 430                 uint64_t                        mqd_mc_addr_lp;
 431                 uint32_t                        doorbell_offset_lp;
 432                 uint64_t                        wptr_addr_lp;
 433
 434                 uint32_t                        pipe_id_hp;
 435                 uint32_t                        queue_id_hp;
 436                 uint32_t                        vmid_id_hp;
 437                 uint64_t                        mqd_mc_addr_hp;
 438                 uint32_t                        doorbell_offset_hp;
 439                 uint64_t                        wptr_addr_hp;
 440
 441                 struct MES_API_STATUS           api_status;
 442         };
 443
 444         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 445 };
 446
 447 union MESAPI__SET_LOGGING_BUFFER {
 448         struct {
 449                 union MES_API_HEADER    header;
 450                 /* There are separate log buffers for each queue type */
 451                 enum MES_QUEUE_TYPE     log_type;
 452                 /* Log buffer GPU Address */
 453                 uint64_t                logging_buffer_addr;
 454                 /* number of entries in the log buffer */
 455                 uint32_t                number_of_entries;
 456                 /* Entry index at which CPU interrupt needs to be signalled */
 457                 uint32_t                interrupt_entry;
 458
 459                 struct MES_API_STATUS   api_status;
 460         };
 461
 462         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 463 };
 464
 465 union MESAPI__QUERY_MES_STATUS {
 466         struct {
 467                 union MES_API_HEADER    header;
 468                 bool                    mes_healthy; /* 0 - not healthy, 1 - healthy */
 469                 struct MES_API_STATUS   api_status;
 470         };
 471
 472         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 473 };
 474
 475 union MESAPI__PROGRAM_GDS {
 476         struct {
 477                 union MES_API_HEADER    header;
 478                 uint64_t                process_context_addr;
 479                 uint32_t                gds_base;
 480                 uint32_t                gds_size;
 481                 uint32_t                gws_base;
 482                 uint32_t                gws_size;
 483                 uint32_t                oa_mask;
 484                 struct MES_API_STATUS   api_status;
 485         };
 486
 487         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 488 };
 489
 490 union MESAPI__SET_DEBUG_VMID {
 491         struct {
 492                 union MES_API_HEADER    header;
 493                 struct MES_API_STATUS   api_status;
 494                 union {
 495                         struct {
 496                                 uint32_t use_gds        : 1;
 497                                 uint32_t operation      : 2;
 498                                 uint32_t reserved       : 29;
 499                         } flags;
 500                         uint32_t        u32All;
 501                 };
 502                 uint32_t                reserved;
 503                 uint32_t                debug_vmid;
 504                 uint64_t                process_context_addr;
 505                 uint64_t                page_table_base_addr;
 506                 uint64_t                process_va_start;
 507                 uint64_t                process_va_end;
 508                 uint32_t                gds_base;
 509                 uint32_t                gds_size;
 510                 uint32_t                gws_base;
 511                 uint32_t                gws_size;
 512                 uint32_t                oa_mask;
 513
 514                 /* output addr of the acquired vmid value */
 515                 uint64_t                output_addr;
 516         };
 517
 518         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 519 };
 520
 521 enum MESAPI_MISC_OPCODE {
 522         MESAPI_MISC__WRITE_REG,
 523         MESAPI_MISC__INV_GART,
 524         MESAPI_MISC__QUERY_STATUS,
 525         MESAPI_MISC__READ_REG,
 526         MESAPI_MISC__WAIT_REG_MEM,
 527         MESAPI_MISC__SET_SHADER_DEBUGGER,
 528         MESAPI_MISC__MAX,
 529 };
 530
 531 enum { MISC_DATA_MAX_SIZE_IN_DWORDS = 20 };
 532
 533 struct WRITE_REG {
 534         uint32_t                  reg_offset;
 535         uint32_t                  reg_value;
 536 };
 537
 538 struct READ_REG {
 539         uint32_t                  reg_offset;
 540         uint64_t                  buffer_addr;
 541 };
 542
 543 enum WRM_OPERATION {
 544         WRM_OPERATION__WAIT_REG_MEM,
 545         WRM_OPERATION__WR_WAIT_WR_REG,
 546         WRM_OPERATION__MAX,
 547 };
 548
 549 struct WAIT_REG_MEM {
 550         enum WRM_OPERATION         op;
 551         uint32_t                   reference;
 552         uint32_t                   mask;
 553         uint32_t                   reg_offset1;
 554         uint32_t                   reg_offset2;
 555 };
 556
 557 struct INV_GART {
 558         uint64_t                  inv_range_va_start;
 559         uint64_t                  inv_range_size;
 560 };
 561
 562 struct QUERY_STATUS {
 563         uint32_t context_id;
 564 };
 565
 566 struct SET_SHADER_DEBUGGER {
 567         uint64_t process_context_addr;
 568         union {
 569                 struct {
 570                         uint32_t single_memop : 1;  /* SQ_DEBUG.single_memop */
 571                         uint32_t single_alu_op : 1; /* SQ_DEBUG.single_alu_op */
 572                         uint32_t reserved : 30;
 573                 };
 574                 uint32_t u32all;
 575         } flags;
 576         uint32_t spi_gdbg_per_vmid_cntl;
 577         uint32_t tcp_watch_cntl[4]; /* TCP_WATCHx_CNTL */
 578         uint32_t trap_en;
 579 };
 580
 581 union MESAPI__MISC {
 582         struct {
 583                 union MES_API_HEADER    header;
 584                 enum MESAPI_MISC_OPCODE opcode;
 585                 struct MES_API_STATUS   api_status;
 586
 587                 union {
 588                         struct          WRITE_REG write_reg;
 589                         struct          INV_GART inv_gart;
 590                         struct          QUERY_STATUS query_status;
 591                         struct          READ_REG read_reg;
 592                         struct          WAIT_REG_MEM wait_reg_mem;
 593                         struct          SET_SHADER_DEBUGGER set_shader_debugger;
 594                         enum MES_AMD_PRIORITY_LEVEL queue_sch_level;
 595
 596                         uint32_t        data[MISC_DATA_MAX_SIZE_IN_DWORDS];
 597                 };
 598         };
 599
 600         uint32_t        max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 601 };
 602
 603 union MESAPI__UPDATE_ROOT_PAGE_TABLE {
 604         struct {
 605                 union MES_API_HEADER        header;
 606                 uint64_t                    page_table_base_addr;
 607                 uint64_t                    process_context_addr;
 608                 struct MES_API_STATUS       api_status;
 609         };
 610
 611         uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 612 };
 613
 614 union MESAPI_AMD_LOG {
 615         struct {
 616                 union MES_API_HEADER        header;
 617                 uint64_t                    p_buffer_memory;
 618                 uint64_t                    p_buffer_size_used;
 619                 struct MES_API_STATUS       api_status;
 620         };
 621
 622         uint32_t max_dwords_in_api[API_FRAME_SIZE_IN_DWORDS];
 623 };
 624
 625 #pragma pack(pop)
 626 #endif