| 1 | /* Copyright 2023 Advanced Micro Devices, Inc. |
| 2 | * |
| 3 | * Permission is hereby granted, free of charge, to any person obtaining a |
| 4 | * copy of this software and associated documentation files (the "Software"), |
| 5 | * to deal in the Software without restriction, including without limitation |
| 6 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, |
| 7 | * and/or sell copies of the Software, and to permit persons to whom the |
| 8 | * Software is furnished to do so, subject to the following conditions: |
| 9 | * |
| 10 | * The above copyright notice and this permission notice shall be included in |
| 11 | * all copies or substantial portions of the Software. |
| 12 | * |
| 13 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
| 14 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
| 15 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
| 16 | * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR |
| 17 | * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, |
| 18 | * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR |
| 19 | * OTHER DEALINGS IN THE SOFTWARE. |
| 20 | * |
| 21 | * Authors: AMD |
| 22 | * |
| 23 | */ |
| 24 | |
| 25 | #ifndef __VPE_6_1_FW_IF_H_ |
| 26 | #define __VPE_6_1_FW_IF_H_ |
| 27 | |
| 28 | /**************** |
| 29 | * VPE OP Codes |
| 30 | ****************/ |
| 31 | enum VPE_CMD_OPCODE { |
| 32 | VPE_CMD_OPCODE_NOP = 0x0, |
| 33 | VPE_CMD_OPCODE_VPE_DESC = 0x1, |
| 34 | VPE_CMD_OPCODE_PLANE_CFG = 0x2, |
| 35 | VPE_CMD_OPCODE_VPEP_CFG = 0x3, |
| 36 | VPE_CMD_OPCODE_INDIRECT = 0x4, |
| 37 | VPE_CMD_OPCODE_FENCE = 0x5, |
| 38 | VPE_CMD_OPCODE_TRAP = 0x6, |
| 39 | VPE_CMD_OPCODE_REG_WRITE = 0x7, |
| 40 | VPE_CMD_OPCODE_POLL_REGMEM = 0x8, |
| 41 | VPE_CMD_OPCODE_COND_EXE = 0x9, |
| 42 | VPE_CMD_OPCODE_ATOMIC = 0xA, |
| 43 | VPE_CMD_OPCODE_PRED_EXE = 0xB, |
| 44 | VPE_CMD_OPCODE_COLLAB_SYNC = 0xC, |
| 45 | VPE_CMD_OPCODE_TIMESTAMP = 0xD |
| 46 | }; |
| 47 | |
| 48 | /** Generic Command Header |
| 49 | * Generic Commands include: |
| 50 | * Noop, Fence, Trap, |
| 51 | * RegisterWrite, PollRegisterWriteMemory, |
| 52 | * SetLocalTimestamp, GetLocalTimestamp |
| 53 | * GetGlobalGPUTimestamp */ |
| 54 | #define 8 |
| 55 | #define 0x0000FF00 |
| 56 | #define 0 |
| 57 | #define 0x000000FF |
| 58 | |
| 59 | #define (op, subop) \ |
| 60 | (((subop << VPE_HEADER_SUB_OPCODE__SHIFT) & VPE_HEADER_SUB_OPCODE_MASK) | \ |
| 61 | ((op << VPE_HEADER_OPCODE__SHIFT) & VPE_HEADER_OPCODE_MASK)) |
| 62 | |
| 63 | |
| 64 | /*************************** |
| 65 | * VPE NOP |
| 66 | ***************************/ |
| 67 | #define 16 |
| 68 | #define 0x00003FFF |
| 69 | |
| 70 | #define (count) \ |
| 71 | (((count) & VPE_CMD_NOP_HEADER_COUNT_MASK) << VPE_CMD_NOP_HEADER_COUNT__SHIFT) |
| 72 | |
| 73 | /*************************** |
| 74 | * VPE Descriptor |
| 75 | ***************************/ |
| 76 | #define VPE_DESC_CD__SHIFT 16 |
| 77 | #define VPE_DESC_CD_MASK 0x000F0000 |
| 78 | |
| 79 | #define (cd) \ |
| 80 | (VPE_CMD_HEADER(VPE_CMD_OPCODE_VPE_DESC, 0) | \ |
| 81 | (((cd) << VPE_DESC_CD__SHIFT) & VPE_DESC_CD_MASK)) |
| 82 | |
| 83 | /*************************** |
| 84 | * VPE Plane Config |
| 85 | ***************************/ |
| 86 | enum VPE_PLANE_CFG_SUBOP { |
| 87 | VPE_PLANE_CFG_SUBOP_1_TO_1 = 0x0, |
| 88 | VPE_PLANE_CFG_SUBOP_2_TO_1 = 0x1, |
| 89 | VPE_PLANE_CFG_SUBOP_2_TO_2 = 0x2 |
| 90 | }; |
| 91 | |
| 92 | #define VPE_PLANE_CFG_ONE_PLANE 0 |
| 93 | #define VPE_PLANE_CFG_TWO_PLANES 1 |
| 94 | |
| 95 | #define VPE_PLANE_CFG_NPS0__SHIFT 16 |
| 96 | #define VPE_PLANE_CFG_NPS0_MASK 0x00030000 |
| 97 | |
| 98 | #define VPE_PLANE_CFG_NPD0__SHIFT 18 |
| 99 | #define VPE_PLANE_CFG_NPD0_MASK 0x000C0000 |
| 100 | |
| 101 | #define VPE_PLANE_CFG_NPS1__SHIFT 20 |
| 102 | #define VPE_PLANE_CFG_NPS1_MASK 0x00300000 |
| 103 | |
| 104 | #define VPE_PLANE_CFG_NPD1__SHIFT 22 |
| 105 | #define VPE_PLANE_CFG_NPD1_MASK 0x00C00000 |
| 106 | |
| 107 | #define VPE_PLANE_CFG_TMZ__SHIFT 16 |
| 108 | #define VPE_PLANE_CFG_TMZ_MASK 0x00010000 |
| 109 | |
| 110 | #define VPE_PLANE_CFG_SWIZZLE_MODE__SHIFT 3 |
| 111 | #define VPE_PLANE_CFG_SWIZZLE_MODE_MASK 0x000000F8 |
| 112 | |
| 113 | #define VPE_PLANE_CFG_ROTATION__SHIFT 0 |
| 114 | #define VPE_PLANE_CFG_ROTATION_MASK 0x00000003 |
| 115 | |
| 116 | #define VPE_PLANE_ADDR_LO__SHIFT 0 |
| 117 | #define VPE_PLANE_ADDR_LO_MASK 0xFFFFFF00 |
| 118 | |
| 119 | #define VPE_PLANE_CFG_PITCH__SHIFT 0 |
| 120 | #define VPE_PLANE_CFG_PITCH_MASK 0x00003FFF |
| 121 | |
| 122 | #define VPE_PLANE_CFG_VIEWPORT_Y__SHIFT 16 |
| 123 | #define VPE_PLANE_CFG_VIEWPORT_Y_MASK 0x3FFF0000 |
| 124 | #define VPE_PLANE_CFG_VIEWPORT_X__SHIFT 0 |
| 125 | #define VPE_PLANE_CFG_VIEWPORT_X_MASK 0x00003FFF |
| 126 | |
| 127 | |
| 128 | #define VPE_PLANE_CFG_VIEWPORT_HEIGHT__SHIFT 16 |
| 129 | #define VPE_PLANE_CFG_VIEWPORT_HEIGHT_MASK 0x1FFF0000 |
| 130 | #define VPE_PLANE_CFG_VIEWPORT_ELEMENT_SIZE__SHIFT 13 |
| 131 | #define VPE_PLANE_CFG_VIEWPORT_ELEMENT_SIZE_MASK 0x0000E000 |
| 132 | #define VPE_PLANE_CFG_VIEWPORT_WIDTH__SHIFT 0 |
| 133 | #define VPE_PLANE_CFG_VIEWPORT_WIDTH_MASK 0x00001FFF |
| 134 | |
| 135 | enum VPE_PLANE_CFG_ELEMENT_SIZE { |
| 136 | VPE_PLANE_CFG_ELEMENT_SIZE_8BPE = 0, |
| 137 | VPE_PLANE_CFG_ELEMENT_SIZE_16BPE = 1, |
| 138 | VPE_PLANE_CFG_ELEMENT_SIZE_32BPE = 2, |
| 139 | VPE_PLANE_CFG_ELEMENT_SIZE_64BPE = 3 |
| 140 | }; |
| 141 | |
| 142 | #define (subop, nps0, npd0, nps1, npd1) \ |
| 143 | (VPE_CMD_HEADER(VPE_CMD_OPCODE_PLANE_CFG, subop) | \ |
| 144 | (((nps0) << VPE_PLANE_CFG_NPS0__SHIFT) & VPE_PLANE_CFG_NPS0_MASK) | \ |
| 145 | (((npd0) << VPE_PLANE_CFG_NPD0__SHIFT) & VPE_PLANE_CFG_NPD0_MASK) | \ |
| 146 | (((nps1) << VPE_PLANE_CFG_NPS1__SHIFT) & VPE_PLANE_CFG_NPS1_MASK) | \ |
| 147 | (((npd0) << VPE_PLANE_CFG_NPD1__SHIFT) & VPE_PLANE_CFG_NPD1_MASK)) |
| 148 | |
| 149 | |
| 150 | /************************ |
| 151 | * VPEP Config |
| 152 | ************************/ |
| 153 | enum VPE_VPEP_CFG_SUBOP { |
| 154 | VPE_VPEP_CFG_SUBOP_DIR_CFG = 0x0, |
| 155 | VPE_VPEP_CFG_SUBOP_IND_CFG = 0x1 |
| 156 | }; |
| 157 | |
| 158 | |
| 159 | // Direct Config Command Header |
| 160 | #define 16 |
| 161 | #define 0xFFFF0000 |
| 162 | |
| 163 | #define (subop, arr_sz) \ |
| 164 | (VPE_CMD_HEADER(VPE_CMD_OPCODE_VPEP_CFG, subop) | \ |
| 165 | (((arr_sz) << VPE_DIR_CFG_HEADER_ARRAY_SIZE__SHIFT) & VPE_DIR_CFG_HEADER_ARRAY_SIZE_MASK)) |
| 166 | |
| 167 | |
| 168 | #define VPE_DIR_CFG_PKT_REGISTER_OFFSET__SHIFT 2 |
| 169 | #define VPE_DIR_CFG_PKT_REGISTER_OFFSET_MASK 0x000FFFFC |
| 170 | |
| 171 | #define VPE_DIR_CFG_PKT_DATA_SIZE__SHIFT 20 |
| 172 | #define VPE_DIR_CFG_PKT_DATA_SIZE_MASK 0xFFF00000 |
| 173 | |
| 174 | |
| 175 | // InDirect Config Command Header |
| 176 | #define 28 |
| 177 | #define 0xF0000000 |
| 178 | |
| 179 | #define (subop, num_dst) \ |
| 180 | (VPE_CMD_HEADER(VPE_CMD_OPCODE_VPEP_CFG, subop) | \ |
| 181 | (((num_dst) << VPE_IND_CFG_HEADER_NUM_DST__SHIFT) & VPE_IND_CFG_HEADER_NUM_DST_MASK)) |
| 182 | |
| 183 | // Indirect Buffer Command Header |
| 184 | #define 16 |
| 185 | #define 0x0000000F |
| 186 | #define (vmid) \ |
| 187 | (((vmid) & VPE_CMD_INDIRECT_HEADER_VMID_MASK) << VPE_CMD_INDIRECT_HEADER_VMID__SHIFT) |
| 188 | |
| 189 | |
| 190 | /************************** |
| 191 | * Poll Reg/Mem Sub-OpCode |
| 192 | **************************/ |
| 193 | enum VPE_POLL_REGMEM_SUBOP { |
| 194 | VPE_POLL_REGMEM_SUBOP_REGMEM = 0x0, |
| 195 | VPE_POLL_REGMEM_SUBOP_REGMEM_WRITE = 0x1 |
| 196 | }; |
| 197 | |
| 198 | #define 28 |
| 199 | #define 0x00000007 |
| 200 | #define (func) \ |
| 201 | (((func) & VPE_CMD_POLL_REGMEM_HEADER_FUNC_MASK) << VPE_CMD_POLL_REGMEM_HEADER_FUNC__SHIFT) |
| 202 | |
| 203 | #define 31 |
| 204 | #define 0x00000001 |
| 205 | #define (mem) \ |
| 206 | (((mem) & VPE_CMD_POLL_REGMEM_HEADER_MEM_MASK) << VPE_CMD_POLL_REGMEM_HEADER_MEM__SHIFT) |
| 207 | |
| 208 | #define VPE_CMD_POLL_REGMEM_DW5_INTERVAL__SHIFT 0 |
| 209 | #define VPE_CMD_POLL_REGMEM_DW5_INTERVAL_MASK 0x0000FFFF |
| 210 | #define VPE_CMD_POLL_REGMEM_DW5_INTERVAL(interval) \ |
| 211 | (((interval) & VPE_CMD_POLL_REGMEM_DW5_INTERVAL_MASK) << VPE_CMD_POLL_REGMEM_DW5_INTERVAL__SHIFT) |
| 212 | |
| 213 | #define VPE_CMD_POLL_REGMEM_DW5_RETRY_COUNT__SHIFT 16 |
| 214 | #define VPE_CMD_POLL_REGMEM_DW5_RETRY_COUNT_MASK 0x00000FFF |
| 215 | #define VPE_CMD_POLL_REGMEM_DW5_RETRY_COUNT(count) \ |
| 216 | (((count) & VPE_CMD_POLL_REGMEM_DW5_RETRY_COUNT_MASK) << VPE_CMD_POLL_REGMEM_DW5_RETRY_COUNT__SHIFT) |
| 217 | |
| 218 | #endif |
| 219 | |