1/* 2 * Copyright 2015 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 * on the rights to use, copy, modify, merge, publish, distribute, sub 8 * license, and/or sell copies of the Software, and to permit persons to whom 9 * the 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 NON-INFRINGEMENT. IN NO EVENT SHALL 18 * THE AUTHOR(S) AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM, 19 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 20 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 21 * USE OR OTHER DEALINGS IN THE SOFTWARE. 22 * 23 * Authors: 24 * Marek Olšák <maraeo@gmail.com> 25 */ 26 27#include "ac_debug.h" 28 29#include "sid.h" 30#include "sid_tables.h" 31#include "util/u_math.h" 32#include "util/u_memory.h" 33 34/* Parsed IBs are difficult to read without colors. Use "less -R file" to 35 * read them, or use "aha -b -f file" to convert them to html. 36 */ 37#define COLOR_RESET "\033[0m" 38#define COLOR_RED "\033[31m" 39#define COLOR_GREEN "\033[1;32m" 40#define COLOR_YELLOW "\033[1;33m" 41#define COLOR_CYAN "\033[1;36m" 42 43#define INDENT_PKT 8 44 45static void print_spaces(FILE *f, unsigned num) 46{ 47 fprintf(f, "%*s", num, ""); 48} 49 50static void print_value(FILE *file, uint32_t value, int bits) 51{ 52 /* Guess if it's int or float */ 53 if (value <= (1 << 15)) { 54 if (value <= 9) 55 fprintf(file, "%u\n", value); 56 else 57 fprintf(file, "%u (0x%0*x)\n", value, bits / 4, value); 58 } else { 59 float f = uif(value); 60 61 if (fabs(f) < 100000 && f*10 == floor(f*10)) 62 fprintf(file, "%.1ff (0x%0*x)\n", f, bits / 4, value); 63 else 64 /* Don't print more leading zeros than there are bits. */ 65 fprintf(file, "0x%0*x\n", bits / 4, value); 66 } 67} 68 69static void print_named_value(FILE *file, const char *name, uint32_t value, 70 int bits) 71{ 72 print_spaces(file, INDENT_PKT); 73 fprintf(file, COLOR_YELLOW "%s" COLOR_RESET " <- ", name); 74 print_value(file, value, bits); 75} 76 77void ac_dump_reg(FILE *file, unsigned offset, uint32_t value, 78 uint32_t field_mask) 79{ 80 int r, f; 81 82 for (r = 0; r < ARRAY_SIZE(sid_reg_table); r++) { 83 const struct si_reg *reg = &sid_reg_table[r]; 84 const char *reg_name = sid_strings + reg->name_offset; 85 86 if (reg->offset == offset) { 87 bool first_field = true; 88 89 print_spaces(file, INDENT_PKT); 90 fprintf(file, COLOR_YELLOW "%s" COLOR_RESET " <- ", 91 reg_name); 92 93 if (!reg->num_fields) { 94 print_value(file, value, 32); 95 return; 96 } 97 98 for (f = 0; f < reg->num_fields; f++) { 99 const struct si_field *field = sid_fields_table + reg->fields_offset + f; 100 const int *values_offsets = sid_strings_offsets + field->values_offset; 101 uint32_t val = (value & field->mask) >> 102 (ffs(field->mask) - 1); 103 104 if (!(field->mask & field_mask)) 105 continue; 106 107 /* Indent the field. */ 108 if (!first_field) 109 print_spaces(file, 110 INDENT_PKT + strlen(reg_name) + 4); 111 112 /* Print the field. */ 113 fprintf(file, "%s = ", sid_strings + field->name_offset); 114 115 if (val < field->num_values && values_offsets[val] >= 0) 116 fprintf(file, "%s\n", sid_strings + values_offsets[val]); 117 else 118 print_value(file, val, 119 util_bitcount(field->mask)); 120 121 first_field = false; 122 } 123 return; 124 } 125 } 126 127 print_spaces(file, INDENT_PKT); 128 fprintf(file, COLOR_YELLOW "0x%05x" COLOR_RESET " <- 0x%08x\n", offset, value); 129} 130 131static void ac_parse_set_reg_packet(FILE *f, uint32_t *ib, unsigned count, 132 unsigned reg_offset) 133{ 134 unsigned reg = (ib[1] << 2) + reg_offset; 135 int i; 136 137 for (i = 0; i < count; i++) 138 ac_dump_reg(f, reg + i*4, ib[2+i], ~0); 139} 140 141static uint32_t *ac_parse_packet3(FILE *f, uint32_t *ib, int *num_dw, 142 int trace_id, enum chip_class chip_class, 143 ac_debug_addr_callback addr_callback, 144 void *addr_callback_data) 145{ 146 unsigned count = PKT_COUNT_G(ib[0]); 147 unsigned op = PKT3_IT_OPCODE_G(ib[0]); 148 const char *predicate = PKT3_PREDICATE(ib[0]) ? "(predicate)" : ""; 149 int i; 150 151 /* Print the name first. */ 152 for (i = 0; i < ARRAY_SIZE(packet3_table); i++) 153 if (packet3_table[i].op == op) 154 break; 155 156 if (i < ARRAY_SIZE(packet3_table)) { 157 const char *name = sid_strings + packet3_table[i].name_offset; 158 159 if (op == PKT3_SET_CONTEXT_REG || 160 op == PKT3_SET_CONFIG_REG || 161 op == PKT3_SET_UCONFIG_REG || 162 op == PKT3_SET_SH_REG) 163 fprintf(f, COLOR_CYAN "%s%s" COLOR_CYAN ":\n", 164 name, predicate); 165 else 166 fprintf(f, COLOR_GREEN "%s%s" COLOR_RESET ":\n", 167 name, predicate); 168 } else 169 fprintf(f, COLOR_RED "PKT3_UNKNOWN 0x%x%s" COLOR_RESET ":\n", 170 op, predicate); 171 172 /* Print the contents. */ 173 switch (op) { 174 case PKT3_SET_CONTEXT_REG: 175 ac_parse_set_reg_packet(f, ib, count, SI_CONTEXT_REG_OFFSET); 176 break; 177 case PKT3_SET_CONFIG_REG: 178 ac_parse_set_reg_packet(f, ib, count, SI_CONFIG_REG_OFFSET); 179 break; 180 case PKT3_SET_UCONFIG_REG: 181 ac_parse_set_reg_packet(f, ib, count, CIK_UCONFIG_REG_OFFSET); 182 break; 183 case PKT3_SET_SH_REG: 184 ac_parse_set_reg_packet(f, ib, count, SI_SH_REG_OFFSET); 185 break; 186 case PKT3_ACQUIRE_MEM: 187 ac_dump_reg(f, R_0301F0_CP_COHER_CNTL, ib[1], ~0); 188 ac_dump_reg(f, R_0301F4_CP_COHER_SIZE, ib[2], ~0); 189 ac_dump_reg(f, R_030230_CP_COHER_SIZE_HI, ib[3], ~0); 190 ac_dump_reg(f, R_0301F8_CP_COHER_BASE, ib[4], ~0); 191 ac_dump_reg(f, R_0301E4_CP_COHER_BASE_HI, ib[5], ~0); 192 print_named_value(f, "POLL_INTERVAL", ib[6], 16); 193 break; 194 case PKT3_SURFACE_SYNC: 195 if (chip_class >= CIK) { 196 ac_dump_reg(f, R_0301F0_CP_COHER_CNTL, ib[1], ~0); 197 ac_dump_reg(f, R_0301F4_CP_COHER_SIZE, ib[2], ~0); 198 ac_dump_reg(f, R_0301F8_CP_COHER_BASE, ib[3], ~0); 199 } else { 200 ac_dump_reg(f, R_0085F0_CP_COHER_CNTL, ib[1], ~0); 201 ac_dump_reg(f, R_0085F4_CP_COHER_SIZE, ib[2], ~0); 202 ac_dump_reg(f, R_0085F8_CP_COHER_BASE, ib[3], ~0); 203 } 204 print_named_value(f, "POLL_INTERVAL", ib[4], 16); 205 break; 206 case PKT3_EVENT_WRITE: 207 ac_dump_reg(f, R_028A90_VGT_EVENT_INITIATOR, ib[1], 208 S_028A90_EVENT_TYPE(~0)); 209 print_named_value(f, "EVENT_INDEX", (ib[1] >> 8) & 0xf, 4); 210 print_named_value(f, "INV_L2", (ib[1] >> 20) & 0x1, 1); 211 if (count > 0) { 212 print_named_value(f, "ADDRESS_LO", ib[2], 32); 213 print_named_value(f, "ADDRESS_HI", ib[3], 16); 214 } 215 break; 216 case PKT3_DRAW_INDEX_AUTO: 217 ac_dump_reg(f, R_030930_VGT_NUM_INDICES, ib[1], ~0); 218 ac_dump_reg(f, R_0287F0_VGT_DRAW_INITIATOR, ib[2], ~0); 219 break; 220 case PKT3_DRAW_INDEX_2: 221 ac_dump_reg(f, R_028A78_VGT_DMA_MAX_SIZE, ib[1], ~0); 222 ac_dump_reg(f, R_0287E8_VGT_DMA_BASE, ib[2], ~0); 223 ac_dump_reg(f, R_0287E4_VGT_DMA_BASE_HI, ib[3], ~0); 224 ac_dump_reg(f, R_030930_VGT_NUM_INDICES, ib[4], ~0); 225 ac_dump_reg(f, R_0287F0_VGT_DRAW_INITIATOR, ib[5], ~0); 226 break; 227 case PKT3_INDEX_TYPE: 228 ac_dump_reg(f, R_028A7C_VGT_DMA_INDEX_TYPE, ib[1], ~0); 229 break; 230 case PKT3_NUM_INSTANCES: 231 ac_dump_reg(f, R_030934_VGT_NUM_INSTANCES, ib[1], ~0); 232 break; 233 case PKT3_WRITE_DATA: 234 ac_dump_reg(f, R_370_CONTROL, ib[1], ~0); 235 ac_dump_reg(f, R_371_DST_ADDR_LO, ib[2], ~0); 236 ac_dump_reg(f, R_372_DST_ADDR_HI, ib[3], ~0); 237 for (i = 2; i < count; i++) { 238 print_spaces(f, INDENT_PKT); 239 fprintf(f, "0x%08x\n", ib[2+i]); 240 } 241 break; 242 case PKT3_CP_DMA: 243 ac_dump_reg(f, R_410_CP_DMA_WORD0, ib[1], ~0); 244 ac_dump_reg(f, R_411_CP_DMA_WORD1, ib[2], ~0); 245 ac_dump_reg(f, R_412_CP_DMA_WORD2, ib[3], ~0); 246 ac_dump_reg(f, R_413_CP_DMA_WORD3, ib[4], ~0); 247 ac_dump_reg(f, R_414_COMMAND, ib[5], ~0); 248 break; 249 case PKT3_DMA_DATA: 250 ac_dump_reg(f, R_500_DMA_DATA_WORD0, ib[1], ~0); 251 ac_dump_reg(f, R_501_SRC_ADDR_LO, ib[2], ~0); 252 ac_dump_reg(f, R_502_SRC_ADDR_HI, ib[3], ~0); 253 ac_dump_reg(f, R_503_DST_ADDR_LO, ib[4], ~0); 254 ac_dump_reg(f, R_504_DST_ADDR_HI, ib[5], ~0); 255 ac_dump_reg(f, R_414_COMMAND, ib[6], ~0); 256 break; 257 case PKT3_INDIRECT_BUFFER_SI: 258 case PKT3_INDIRECT_BUFFER_CONST: 259 case PKT3_INDIRECT_BUFFER_CIK: 260 ac_dump_reg(f, R_3F0_IB_BASE_LO, ib[1], ~0); 261 ac_dump_reg(f, R_3F1_IB_BASE_HI, ib[2], ~0); 262 ac_dump_reg(f, R_3F2_CONTROL, ib[3], ~0); 263 264 if (addr_callback) { 265 uint64_t addr = ((uint64_t)ib[2] << 32) | ib[1]; 266 void *data = addr_callback(addr_callback_data, addr); 267 const char *name = G_3F2_CHAIN(ib[3]) ? "chained" : "nested"; 268 269 if (data) 270 ac_parse_ib(f, data, G_3F2_IB_SIZE(ib[3]), 271 trace_id, name, chip_class, 272 addr_callback, addr_callback_data); 273 } 274 break; 275 case PKT3_CLEAR_STATE: 276 case PKT3_INCREMENT_DE_COUNTER: 277 case PKT3_PFP_SYNC_ME: 278 break; 279 case PKT3_NOP: 280 if (ib[0] == 0xffff1000) { 281 count = -1; /* One dword NOP. */ 282 break; 283 } else if (count == 0 && AC_IS_TRACE_POINT(ib[1])) { 284 unsigned packet_id = AC_GET_TRACE_POINT_ID(ib[1]); 285 286 print_spaces(f, INDENT_PKT); 287 fprintf(f, COLOR_RED "Trace point ID: %u\n", packet_id); 288 289 if (trace_id == -1) 290 break; /* tracing was disabled */ 291 292 print_spaces(f, INDENT_PKT); 293 if (packet_id < trace_id) 294 fprintf(f, COLOR_RED 295 "This trace point was reached by the CP." 296 COLOR_RESET "\n"); 297 else if (packet_id == trace_id) 298 fprintf(f, COLOR_RED 299 "!!!!! This is the last trace point that " 300 "was reached by the CP !!!!!" 301 COLOR_RESET "\n"); 302 else if (packet_id+1 == trace_id) 303 fprintf(f, COLOR_RED 304 "!!!!! This is the first trace point that " 305 "was NOT been reached by the CP !!!!!" 306 COLOR_RESET "\n"); 307 else 308 fprintf(f, COLOR_RED 309 "!!!!! This trace point was NOT reached " 310 "by the CP !!!!!" 311 COLOR_RESET "\n"); 312 break; 313 } 314 /* fall through, print all dwords */ 315 default: 316 for (i = 0; i < count+1; i++) { 317 print_spaces(f, INDENT_PKT); 318 fprintf(f, "0x%08x\n", ib[1+i]); 319 } 320 } 321 322 ib += count + 2; 323 *num_dw -= count + 2; 324 return ib; 325} 326 327/** 328 * Parse and print an IB into a file. 329 * 330 * \param f file 331 * \param ib IB 332 * \param num_dw size of the IB 333 * \param chip_class chip class 334 * \param trace_id the last trace ID that is known to have been reached 335 * and executed by the CP, typically read from a buffer 336 * \param addr_callback Get a mapped pointer of the IB at a given address. Can 337 * be NULL. 338 * \param addr_callback_data user data for addr_callback 339 */ 340void ac_parse_ib(FILE *f, uint32_t *ib, int num_dw, int trace_id, 341 const char *name, enum chip_class chip_class, 342 ac_debug_addr_callback addr_callback, void *addr_callback_data) 343{ 344 fprintf(f, "------------------ %s begin ------------------\n", name); 345 346 while (num_dw > 0) { 347 unsigned type = PKT_TYPE_G(ib[0]); 348 349 switch (type) { 350 case 3: 351 ib = ac_parse_packet3(f, ib, &num_dw, trace_id, 352 chip_class, addr_callback, 353 addr_callback_data); 354 break; 355 case 2: 356 /* type-2 nop */ 357 if (ib[0] == 0x80000000) { 358 fprintf(f, COLOR_GREEN "NOP (type 2)" COLOR_RESET "\n"); 359 ib++; 360 num_dw--; 361 break; 362 } 363 /* fall through */ 364 default: 365 fprintf(f, "Unknown packet type %i\n", type); 366 return; 367 } 368 } 369 370 fprintf(f, "------------------- %s end -------------------\n", name); 371 if (num_dw < 0) { 372 printf("Packet ends after the end of IB.\n"); 373 exit(0); 374 } 375 fprintf(f, "\n"); 376} 377