Subversion Repositories Kolibri OS

Rev

Blame | Last modification | View Log | RSS feed

  1. /*
  2.  * Copyright © 2010 Intel Corporation
  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 (including the next
  12.  * paragraph) shall be included in all copies or substantial portions of the
  13.  * Software.
  14.  *
  15.  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16.  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17.  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  18.  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19.  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  20.  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  21.  * IN THE SOFTWARE.
  22.  *
  23.  * Authors:
  24.  *    Eric Anholt <eric@anholt.net>
  25.  *
  26.  */
  27.  
  28. /** @file intel_aub.h
  29.  *
  30.  * The AUB file is a file format used by Intel's internal simulation
  31.  * and other validation tools.  It can be used at various levels by a
  32.  * driver to input state to the simulated hardware or a replaying
  33.  * debugger.
  34.  *
  35.  * We choose to dump AUB files using the trace block format for ease
  36.  * of implementation -- dump out the blocks of memory as plain blobs
  37.  * and insert ring commands to execute the batchbuffer blob.
  38.  */
  39.  
  40. #ifndef _INTEL_AUB_H
  41. #define _INTEL_AUB_H
  42.  
  43. #define AUB_MI_NOOP                     (0)
  44. #define AUB_MI_BATCH_BUFFER_START       (0x31 << 23)
  45. #define AUB_PIPE_CONTROL                (0x7a000002)
  46.  
  47. /* DW0: instruction type. */
  48.  
  49. #define CMD_AUB                 (7 << 29)
  50.  
  51. #define CMD_AUB_HEADER          (CMD_AUB | (1 << 23) | (0x05 << 16))
  52. /* DW1 */
  53. # define AUB_HEADER_MAJOR_SHIFT         24
  54. # define AUB_HEADER_MINOR_SHIFT         16
  55.  
  56. #define CMD_AUB_TRACE_HEADER_BLOCK (CMD_AUB | (1 << 23) | (0x41 << 16))
  57. #define CMD_AUB_DUMP_BMP           (CMD_AUB | (1 << 23) | (0x9e << 16))
  58.  
  59. /* DW1 */
  60. #define AUB_TRACE_OPERATION_MASK        0x000000ff
  61. #define AUB_TRACE_OP_COMMENT            0x00000000
  62. #define AUB_TRACE_OP_DATA_WRITE         0x00000001
  63. #define AUB_TRACE_OP_COMMAND_WRITE      0x00000002
  64. #define AUB_TRACE_OP_MMIO_WRITE         0x00000003
  65. // operation = TRACE_DATA_WRITE, Type
  66. #define AUB_TRACE_TYPE_MASK             0x0000ff00
  67. #define AUB_TRACE_TYPE_NOTYPE           (0 << 8)
  68. #define AUB_TRACE_TYPE_BATCH            (1 << 8)
  69. #define AUB_TRACE_TYPE_VERTEX_BUFFER    (5 << 8)
  70. #define AUB_TRACE_TYPE_2D_MAP           (6 << 8)
  71. #define AUB_TRACE_TYPE_CUBE_MAP         (7 << 8)
  72. #define AUB_TRACE_TYPE_VOLUME_MAP       (9 << 8)
  73. #define AUB_TRACE_TYPE_1D_MAP           (10 << 8)
  74. #define AUB_TRACE_TYPE_CONSTANT_BUFFER  (11 << 8)
  75. #define AUB_TRACE_TYPE_CONSTANT_URB     (12 << 8)
  76. #define AUB_TRACE_TYPE_INDEX_BUFFER     (13 << 8)
  77. #define AUB_TRACE_TYPE_GENERAL          (14 << 8)
  78. #define AUB_TRACE_TYPE_SURFACE          (15 << 8)
  79.  
  80.  
  81. // operation = TRACE_COMMAND_WRITE, Type =
  82. #define AUB_TRACE_TYPE_RING_HWB         (1 << 8)
  83. #define AUB_TRACE_TYPE_RING_PRB0        (2 << 8)
  84. #define AUB_TRACE_TYPE_RING_PRB1        (3 << 8)
  85. #define AUB_TRACE_TYPE_RING_PRB2        (4 << 8)
  86.  
  87. // Address space
  88. #define AUB_TRACE_ADDRESS_SPACE_MASK    0x00ff0000
  89. #define AUB_TRACE_MEMTYPE_GTT           (0 << 16)
  90. #define AUB_TRACE_MEMTYPE_LOCAL         (1 << 16)
  91. #define AUB_TRACE_MEMTYPE_NONLOCAL      (2 << 16)
  92. #define AUB_TRACE_MEMTYPE_PCI           (3 << 16)
  93. #define AUB_TRACE_MEMTYPE_GTT_ENTRY     (4 << 16)
  94.  
  95. /* DW2 */
  96.  
  97. /**
  98.  * aub_state_struct_type enum values are encoded with the top 16 bits
  99.  * representing the type to be delivered to the .aub file, and the bottom 16
  100.  * bits representing the subtype.  This macro performs the encoding.
  101.  */
  102. #define ENCODE_SS_TYPE(type, subtype) (((type) << 16) | (subtype))
  103.  
  104. enum aub_state_struct_type {
  105.    AUB_TRACE_VS_STATE =                 ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 1),
  106.    AUB_TRACE_GS_STATE =                 ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 2),
  107.    AUB_TRACE_CLIP_STATE =               ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 3),
  108.    AUB_TRACE_SF_STATE =                 ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 4),
  109.    AUB_TRACE_WM_STATE =                 ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 5),
  110.    AUB_TRACE_CC_STATE =                 ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 6),
  111.    AUB_TRACE_CLIP_VP_STATE =            ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 7),
  112.    AUB_TRACE_SF_VP_STATE =              ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 8),
  113.    AUB_TRACE_CC_VP_STATE =              ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 0x9),
  114.    AUB_TRACE_SAMPLER_STATE =            ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 0xa),
  115.    AUB_TRACE_KERNEL_INSTRUCTIONS =      ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 0xb),
  116.    AUB_TRACE_SCRATCH_SPACE =            ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 0xc),
  117.    AUB_TRACE_SAMPLER_DEFAULT_COLOR =    ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 0xd),
  118.  
  119.    AUB_TRACE_SCISSOR_STATE =            ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 0x15),
  120.    AUB_TRACE_BLEND_STATE =              ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 0x16),
  121.    AUB_TRACE_DEPTH_STENCIL_STATE =      ENCODE_SS_TYPE(AUB_TRACE_TYPE_GENERAL, 0x17),
  122.  
  123.    AUB_TRACE_VERTEX_BUFFER =            ENCODE_SS_TYPE(AUB_TRACE_TYPE_VERTEX_BUFFER, 0),
  124.    AUB_TRACE_BINDING_TABLE =            ENCODE_SS_TYPE(AUB_TRACE_TYPE_SURFACE, 0x100),
  125.    AUB_TRACE_SURFACE_STATE =            ENCODE_SS_TYPE(AUB_TRACE_TYPE_SURFACE, 0x200),
  126.    AUB_TRACE_VS_CONSTANTS =             ENCODE_SS_TYPE(AUB_TRACE_TYPE_CONSTANT_BUFFER, 0),
  127.    AUB_TRACE_WM_CONSTANTS =             ENCODE_SS_TYPE(AUB_TRACE_TYPE_CONSTANT_BUFFER, 1),
  128. };
  129.  
  130. #undef ENCODE_SS_TYPE
  131.  
  132. /**
  133.  * Decode a aub_state_struct_type value to determine the type that should be
  134.  * stored in the .aub file.
  135.  */
  136. static inline uint32_t AUB_TRACE_TYPE(enum aub_state_struct_type ss_type)
  137. {
  138.    return (ss_type & 0xFFFF0000) >> 16;
  139. }
  140.  
  141. /**
  142.  * Decode a state_struct_type value to determine the subtype that should be
  143.  * stored in the .aub file.
  144.  */
  145. static inline uint32_t AUB_TRACE_SUBTYPE(enum aub_state_struct_type ss_type)
  146. {
  147.    return ss_type & 0xFFFF;
  148. }
  149.  
  150. /* DW3: address */
  151. /* DW4: len */
  152.  
  153. #endif /* _INTEL_AUB_H */
  154.