0e72ca08b2279f517b34fe733273ea37cb38bae6
[mesa.git] / src / mesa / drivers / dri / intel / intel_decode.c
1 /* -*- c-basic-offset: 4 -*- */
2 /*
3 * Copyright © 2007 Intel Corporation
4 *
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9 * and/or sell copies of the Software, and to permit persons to whom the
10 * Software is furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice (including the next
13 * paragraph) shall be included in all copies or substantial portions of the
14 * Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
21 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
22 * IN THE SOFTWARE.
23 *
24 * Authors:
25 * Eric Anholt <eric@anholt.net>
26 *
27 */
28
29 /** @file intel_decode.c
30 * This file contains code to print out batchbuffer contents in a
31 * human-readable format.
32 *
33 * The current version only supports i915 packets, and only pretty-prints a
34 * subset of them. The intention is for it to make just a best attempt to
35 * decode, but never crash in the process.
36 */
37
38 #include <stdio.h>
39 #include <stdarg.h>
40 #include <inttypes.h>
41
42 #include "intel_decode.h"
43 #include "intel_chipset.h"
44
45 #define BUFFER_FAIL(_count, _len, _name) do { \
46 fprintf(out, "Buffer size too small in %s (%d < %d)\n", \
47 (_name), (_count), (_len)); \
48 (*failures)++; \
49 return count; \
50 } while (0)
51
52 static FILE *out;
53 static uint32_t saved_s2 = 0, saved_s4 = 0;
54 static char saved_s2_set = 0, saved_s4_set = 0;
55
56 static float
57 int_as_float(uint32_t intval)
58 {
59 union intfloat {
60 uint32_t i;
61 float f;
62 } uval;
63
64 uval.i = intval;
65 return uval.f;
66 }
67
68 static void
69 instr_out(uint32_t *data, uint32_t hw_offset, unsigned int index,
70 char *fmt, ...)
71 {
72 va_list va;
73
74 fprintf(out, "0x%08x: 0x%08x:%s ", hw_offset + index * 4, data[index],
75 index == 0 ? "" : " ");
76 va_start(va, fmt);
77 vfprintf(out, fmt, va);
78 va_end(va);
79 }
80
81
82 static int
83 decode_mi(uint32_t *data, int count, uint32_t hw_offset, int *failures)
84 {
85 unsigned int opcode;
86
87 struct {
88 uint32_t opcode;
89 int min_len;
90 int max_len;
91 char *name;
92 } opcodes_mi[] = {
93 { 0x08, 1, 1, "MI_ARB_ON_OFF" },
94 { 0x0a, 1, 1, "MI_BATCH_BUFFER_END" },
95 { 0x31, 2, 2, "MI_BATCH_BUFFER_START" },
96 { 0x14, 3, 3, "MI_DISPLAY_BUFFER_INFO" },
97 { 0x04, 1, 1, "MI_FLUSH" },
98 { 0x22, 3, 3, "MI_LOAD_REGISTER_IMM" },
99 { 0x13, 2, 2, "MI_LOAD_SCAN_LINES_EXCL" },
100 { 0x12, 2, 2, "MI_LOAD_SCAN_LINES_INCL" },
101 { 0x00, 1, 1, "MI_NOOP" },
102 { 0x11, 2, 2, "MI_OVERLAY_FLIP" },
103 { 0x07, 1, 1, "MI_REPORT_HEAD" },
104 { 0x18, 2, 2, "MI_SET_CONTEXT" },
105 { 0x20, 3, 4, "MI_STORE_DATA_IMM" },
106 { 0x21, 3, 4, "MI_STORE_DATA_INDEX" },
107 { 0x24, 3, 3, "MI_STORE_REGISTER_MEM" },
108 { 0x02, 1, 1, "MI_USER_INTERRUPT" },
109 { 0x03, 1, 1, "MI_WAIT_FOR_EVENT" },
110 };
111
112
113 for (opcode = 0; opcode < sizeof(opcodes_mi) / sizeof(opcodes_mi[0]);
114 opcode++) {
115 if ((data[0] & 0x1f800000) >> 23 == opcodes_mi[opcode].opcode) {
116 unsigned int len = 1, i;
117
118 instr_out(data, hw_offset, 0, "%s\n", opcodes_mi[opcode].name);
119 if (opcodes_mi[opcode].max_len > 1) {
120 len = (data[0] & 0x000000ff) + 2;
121 if (len < opcodes_mi[opcode].min_len ||
122 len > opcodes_mi[opcode].max_len)
123 {
124 fprintf(out, "Bad length in %s\n",
125 opcodes_mi[opcode].name);
126 }
127 }
128
129 for (i = 1; i < len; i++) {
130 if (i >= count)
131 BUFFER_FAIL(count, len, opcodes_mi[opcode].name);
132 instr_out(data, hw_offset, i, "dword %d\n", i);
133 }
134
135 return len;
136 }
137 }
138
139 instr_out(data, hw_offset, 0, "MI UNKNOWN\n");
140 (*failures)++;
141 return 1;
142 }
143
144 static int
145 decode_2d(uint32_t *data, int count, uint32_t hw_offset, int *failures)
146 {
147 unsigned int opcode, len;
148 char *format = NULL;
149
150 struct {
151 uint32_t opcode;
152 int min_len;
153 int max_len;
154 char *name;
155 } opcodes_2d[] = {
156 { 0x40, 5, 5, "COLOR_BLT" },
157 { 0x43, 6, 6, "SRC_COPY_BLT" },
158 { 0x01, 8, 8, "XY_SETUP_BLT" },
159 { 0x11, 9, 9, "XY_SETUP_MONO_PATTERN_SL_BLT" },
160 { 0x03, 3, 3, "XY_SETUP_CLIP_BLT" },
161 { 0x24, 2, 2, "XY_PIXEL_BLT" },
162 { 0x25, 3, 3, "XY_SCANLINES_BLT" },
163 { 0x26, 4, 4, "Y_TEXT_BLT" },
164 { 0x31, 5, 134, "XY_TEXT_IMMEDIATE_BLT" },
165 { 0x50, 6, 6, "XY_COLOR_BLT" },
166 { 0x51, 6, 6, "XY_PAT_BLT" },
167 { 0x76, 8, 8, "XY_PAT_CHROMA_BLT" },
168 { 0x72, 7, 135, "XY_PAT_BLT_IMMEDIATE" },
169 { 0x77, 9, 137, "XY_PAT_CHROMA_BLT_IMMEDIATE" },
170 { 0x52, 9, 9, "XY_MONO_PAT_BLT" },
171 { 0x59, 7, 7, "XY_MONO_PAT_FIXED_BLT" },
172 { 0x53, 8, 8, "XY_SRC_COPY_BLT" },
173 { 0x54, 8, 8, "XY_MONO_SRC_COPY_BLT" },
174 { 0x71, 9, 137, "XY_MONO_SRC_COPY_IMMEDIATE_BLT" },
175 { 0x55, 9, 9, "XY_FULL_BLT" },
176 { 0x55, 9, 137, "XY_FULL_IMMEDIATE_PATTERN_BLT" },
177 { 0x56, 9, 9, "XY_FULL_MONO_SRC_BLT" },
178 { 0x75, 10, 138, "XY_FULL_MONO_SRC_IMMEDIATE_PATTERN_BLT" },
179 { 0x57, 12, 12, "XY_FULL_MONO_PATTERN_BLT" },
180 { 0x58, 12, 12, "XY_FULL_MONO_PATTERN_MONO_SRC_BLT" },
181 };
182
183 switch ((data[0] & 0x1fc00000) >> 22) {
184 case 0x50:
185 instr_out(data, hw_offset, 0,
186 "XY_COLOR_BLT (rgb %sabled, alpha %sabled, dst tile %d)\n",
187 (data[0] & (1 << 20)) ? "en" : "dis",
188 (data[0] & (1 << 21)) ? "en" : "dis",
189 (data[0] >> 11) & 1);
190
191 len = (data[0] & 0x000000ff) + 2;
192 if (len != 6)
193 fprintf(out, "Bad count in XY_COLOR_BLT\n");
194 if (count < 6)
195 BUFFER_FAIL(count, len, "XY_COLOR_BLT");
196
197 switch ((data[1] >> 24) & 0x3) {
198 case 0:
199 format="8";
200 break;
201 case 1:
202 format="565";
203 break;
204 case 2:
205 format="1555";
206 break;
207 case 3:
208 format="8888";
209 break;
210 }
211
212 instr_out(data, hw_offset, 1, "format %s, pitch %d, "
213 "clipping %sabled\n", format,
214 (short)(data[1] & 0xffff),
215 data[1] & (1 << 30) ? "en" : "dis");
216 instr_out(data, hw_offset, 2, "(%d,%d)\n",
217 data[2] & 0xffff, data[2] >> 16);
218 instr_out(data, hw_offset, 3, "(%d,%d)\n",
219 data[3] & 0xffff, data[3] >> 16);
220 instr_out(data, hw_offset, 4, "offset 0x%08x\n", data[4]);
221 instr_out(data, hw_offset, 5, "color\n");
222 return len;
223 case 0x53:
224 instr_out(data, hw_offset, 0,
225 "XY_SRC_COPY_BLT (rgb %sabled, alpha %sabled, "
226 "src tile %d, dst tile %d)\n",
227 (data[0] & (1 << 20)) ? "en" : "dis",
228 (data[0] & (1 << 21)) ? "en" : "dis",
229 (data[0] >> 15) & 1,
230 (data[0] >> 11) & 1);
231
232 len = (data[0] & 0x000000ff) + 2;
233 if (len != 8)
234 fprintf(out, "Bad count in XY_SRC_COPY_BLT\n");
235 if (count < 8)
236 BUFFER_FAIL(count, len, "XY_SRC_COPY_BLT");
237
238 switch ((data[1] >> 24) & 0x3) {
239 case 0:
240 format="8";
241 break;
242 case 1:
243 format="565";
244 break;
245 case 2:
246 format="1555";
247 break;
248 case 3:
249 format="8888";
250 break;
251 }
252
253 instr_out(data, hw_offset, 1, "format %s, dst pitch %d, "
254 "clipping %sabled\n", format,
255 (short)(data[1] & 0xffff),
256 data[1] & (1 << 30) ? "en" : "dis");
257 instr_out(data, hw_offset, 2, "dst (%d,%d)\n",
258 data[2] & 0xffff, data[2] >> 16);
259 instr_out(data, hw_offset, 3, "dst (%d,%d)\n",
260 data[3] & 0xffff, data[3] >> 16);
261 instr_out(data, hw_offset, 4, "dst offset 0x%08x\n", data[4]);
262 instr_out(data, hw_offset, 5, "src (%d,%d)\n",
263 data[5] & 0xffff, data[5] >> 16);
264 instr_out(data, hw_offset, 6, "src pitch %d\n",
265 (short)(data[6] & 0xffff));
266 instr_out(data, hw_offset, 7, "src offset 0x%08x\n", data[7]);
267 return len;
268 }
269
270 for (opcode = 0; opcode < sizeof(opcodes_2d) / sizeof(opcodes_2d[0]);
271 opcode++) {
272 if ((data[0] & 0x1fc00000) >> 22 == opcodes_2d[opcode].opcode) {
273 unsigned int i;
274
275 len = 1;
276 instr_out(data, hw_offset, 0, "%s\n", opcodes_2d[opcode].name);
277 if (opcodes_2d[opcode].max_len > 1) {
278 len = (data[0] & 0x000000ff) + 2;
279 if (len < opcodes_2d[opcode].min_len ||
280 len > opcodes_2d[opcode].max_len)
281 {
282 fprintf(out, "Bad count in %s\n", opcodes_2d[opcode].name);
283 }
284 }
285
286 for (i = 1; i < len; i++) {
287 if (i >= count)
288 BUFFER_FAIL(count, len, opcodes_2d[opcode].name);
289 instr_out(data, hw_offset, i, "dword %d\n", i);
290 }
291
292 return len;
293 }
294 }
295
296 instr_out(data, hw_offset, 0, "2D UNKNOWN\n");
297 (*failures)++;
298 return 1;
299 }
300
301 static int
302 decode_3d_1c(uint32_t *data, int count, uint32_t hw_offset, int *failures)
303 {
304 switch ((data[0] & 0x00f80000) >> 19) {
305 case 0x11:
306 instr_out(data, hw_offset, 0, "3DSTATE_DEPTH_SUBRECTANGLE_DISALBE\n");
307 return 1;
308 case 0x10:
309 instr_out(data, hw_offset, 0, "3DSTATE_SCISSOR_ENABLE\n");
310 return 1;
311 case 0x01:
312 instr_out(data, hw_offset, 0, "3DSTATE_MAP_COORD_SET_I830\n");
313 return 1;
314 case 0x0a:
315 instr_out(data, hw_offset, 0, "3DSTATE_MAP_CUBE_I830\n");
316 return 1;
317 case 0x05:
318 instr_out(data, hw_offset, 0, "3DSTATE_MAP_TEX_STREAM_I830\n");
319 return 1;
320 }
321
322 instr_out(data, hw_offset, 0, "3D UNKNOWN\n");
323 (*failures)++;
324 return 1;
325 }
326
327 static int
328 decode_3d_1d(uint32_t *data, int count, uint32_t hw_offset, int *failures, int i830)
329 {
330 unsigned int len, i, c, opcode, word, map, sampler, instr;
331
332 struct {
333 uint32_t opcode;
334 int i830_only;
335 int min_len;
336 int max_len;
337 char *name;
338 } opcodes_3d_1d[] = {
339 { 0x8e, 0, 3, 3, "3DSTATE_BUFFER_INFO" },
340 { 0x86, 0, 4, 4, "3DSTATE_CHROMA_KEY" },
341 { 0x9c, 0, 1, 1, "3DSTATE_CLEAR_PARAMETERS" },
342 { 0x88, 0, 2, 2, "3DSTATE_CONSTANT_BLEND_COLOR" },
343 { 0x99, 0, 2, 2, "3DSTATE_DEFAULT_DIFFUSE" },
344 { 0x9a, 0, 2, 2, "3DSTATE_DEFAULT_SPECULAR" },
345 { 0x98, 0, 2, 2, "3DSTATE_DEFAULT_Z" },
346 { 0x97, 0, 2, 2, "3DSTATE_DEPTH_OFFSET_SCALE" },
347 { 0x85, 0, 2, 2, "3DSTATE_DEST_BUFFER_VARIABLES" },
348 { 0x80, 0, 5, 5, "3DSTATE_DRAWING_RECTANGLE" },
349 { 0x8e, 0, 3, 3, "3DSTATE_BUFFER_INFO" },
350 { 0x9d, 0, 65, 65, "3DSTATE_FILTER_COEFFICIENTS_4X4" },
351 { 0x9e, 0, 4, 4, "3DSTATE_MONO_FILTER" },
352 { 0x89, 0, 4, 4, "3DSTATE_FOG_MODE" },
353 { 0x8f, 0, 2, 16, "3DSTATE_MAP_PALLETE_LOAD_32" },
354 { 0x81, 0, 3, 3, "3DSTATE_SCISSOR_RECTANGLE" },
355 { 0x83, 0, 2, 2, "3DSTATE_SPAN_STIPPLE" },
356 { 0x8c, 1, 2, 2, "3DSTATE_MAP_COORD_TRANSFORM_I830" },
357 { 0x8b, 1, 2, 2, "3DSTATE_MAP_VERTEX_TRANSFORM_I830" },
358 { 0x8d, 1, 3, 3, "3DSTATE_W_STATE_I830" },
359 { 0x01, 1, 2, 2, "3DSTATE_COLOR_FACTOR_I830" },
360 { 0x02, 1, 2, 2, "3DSTATE_MAP_COORD_SETBIND_I830" },
361 };
362
363 switch ((data[0] & 0x00ff0000) >> 16) {
364 case 0x07:
365 /* This instruction is unusual. A 0 length means just 1 DWORD instead of
366 * 2. The 0 length is specified in one place to be unsupported, but
367 * stated to be required in another, and 0 length LOAD_INDIRECTs appear
368 * to cause no harm at least.
369 */
370 instr_out(data, hw_offset, 0, "3DSTATE_LOAD_INDIRECT\n");
371 len = (data[0] & 0x000000ff) + 1;
372 i = 1;
373 if (data[0] & (0x01 << 8)) {
374 if (i + 2 >= count)
375 BUFFER_FAIL(count, len, "3DSTATE_LOAD_INDIRECT");
376 instr_out(data, hw_offset, i++, "SIS.0\n");
377 instr_out(data, hw_offset, i++, "SIS.1\n");
378 }
379 if (data[0] & (0x02 << 8)) {
380 if (i + 1 >= count)
381 BUFFER_FAIL(count, len, "3DSTATE_LOAD_INDIRECT");
382 instr_out(data, hw_offset, i++, "DIS.0\n");
383 }
384 if (data[0] & (0x04 << 8)) {
385 if (i + 2 >= count)
386 BUFFER_FAIL(count, len, "3DSTATE_LOAD_INDIRECT");
387 instr_out(data, hw_offset, i++, "SSB.0\n");
388 instr_out(data, hw_offset, i++, "SSB.1\n");
389 }
390 if (data[0] & (0x08 << 8)) {
391 if (i + 2 >= count)
392 BUFFER_FAIL(count, len, "3DSTATE_LOAD_INDIRECT");
393 instr_out(data, hw_offset, i++, "MSB.0\n");
394 instr_out(data, hw_offset, i++, "MSB.1\n");
395 }
396 if (data[0] & (0x10 << 8)) {
397 if (i + 2 >= count)
398 BUFFER_FAIL(count, len, "3DSTATE_LOAD_INDIRECT");
399 instr_out(data, hw_offset, i++, "PSP.0\n");
400 instr_out(data, hw_offset, i++, "PSP.1\n");
401 }
402 if (data[0] & (0x20 << 8)) {
403 if (i + 2 >= count)
404 BUFFER_FAIL(count, len, "3DSTATE_LOAD_INDIRECT");
405 instr_out(data, hw_offset, i++, "PSC.0\n");
406 instr_out(data, hw_offset, i++, "PSC.1\n");
407 }
408 if (len != i) {
409 fprintf(out, "Bad count in 3DSTATE_LOAD_INDIRECT\n");
410 (*failures)++;
411 return len;
412 }
413 return len;
414 case 0x04:
415 instr_out(data, hw_offset, 0, "3DSTATE_LOAD_STATE_IMMEDIATE_1\n");
416 len = (data[0] & 0x0000000f) + 2;
417 i = 1;
418 for (word = 0; word <= 7; word++) {
419 if (data[0] & (1 << (4 + word))) {
420 if (i >= count)
421 BUFFER_FAIL(count, len, "3DSTATE_LOAD_STATE_IMMEDIATE_1");
422
423 /* save vertex state for decode */
424 if (word == 2) {
425 saved_s2_set = 1;
426 saved_s2 = data[i];
427 }
428 if (word == 4) {
429 saved_s4_set = 1;
430 saved_s4 = data[i];
431 }
432
433 instr_out(data, hw_offset, i++, "S%d\n", word);
434 }
435 }
436 if (len != i) {
437 fprintf(out, "Bad count in 3DSTATE_LOAD_INDIRECT\n");
438 (*failures)++;
439 }
440 return len;
441 case 0x00:
442 instr_out(data, hw_offset, 0, "3DSTATE_MAP_STATE\n");
443 len = (data[0] & 0x0000003f) + 2;
444
445 i = 1;
446 for (map = 0; map <= 15; map++) {
447 if (data[1] & (1 << map)) {
448 if (i + 3 >= count)
449 BUFFER_FAIL(count, len, "3DSTATE_MAP_STATE");
450 instr_out(data, hw_offset, i++, "map %d MS2\n", map);
451 instr_out(data, hw_offset, i++, "map %d MS3\n", map);
452 instr_out(data, hw_offset, i++, "map %d MS4\n", map);
453 }
454 }
455 if (len != i) {
456 fprintf(out, "Bad count in 3DSTATE_MAP_STATE\n");
457 (*failures)++;
458 return len;
459 }
460 return len;
461 case 0x06:
462 instr_out(data, hw_offset, 0, "3DSTATE_PIXEL_SHADER_CONSTANTS\n");
463 len = (data[0] & 0x000000ff) + 2;
464
465 i = 1;
466 for (c = 0; c <= 31; c++) {
467 if (data[1] & (1 << c)) {
468 if (i + 4 >= count)
469 BUFFER_FAIL(count, len, "3DSTATE_PIXEL_SHADER_CONSTANTS");
470 instr_out(data, hw_offset, i, "C%d.X = %f\n",
471 c, int_as_float(data[i]));
472 i++;
473 instr_out(data, hw_offset, i, "C%d.Y = %f\n",
474 c, int_as_float(data[i]));
475 i++;
476 instr_out(data, hw_offset, i, "C%d.Z = %f\n",
477 c, int_as_float(data[i]));
478 i++;
479 instr_out(data, hw_offset, i, "C%d.W = %f\n",
480 c, int_as_float(data[i]));
481 i++;
482 }
483 }
484 if (len != i) {
485 fprintf(out, "Bad count in 3DSTATE_MAP_STATE\n");
486 (*failures)++;
487 }
488 return len;
489 case 0x05:
490 instr_out(data, hw_offset, 0, "3DSTATE_PIXEL_SHADER_PROGRAM\n");
491 len = (data[0] & 0x000000ff) + 2;
492 if ((len - 1) % 3 != 0 || len > 370) {
493 fprintf(out, "Bad count in 3DSTATE_PIXEL_SHADER_PROGRAM\n");
494 (*failures)++;
495 }
496 i = 1;
497 for (instr = 0; instr < (len - 1) / 3; instr++) {
498 if (i + 3 >= count)
499 BUFFER_FAIL(count, len, "3DSTATE_MAP_STATE");
500 instr_out(data, hw_offset, i++, "PS%03x\n", instr);
501 instr_out(data, hw_offset, i++, "PS%03x\n", instr);
502 instr_out(data, hw_offset, i++, "PS%03x\n", instr);
503 }
504 return len;
505 case 0x01:
506 if (i830)
507 break;
508 instr_out(data, hw_offset, 0, "3DSTATE_SAMPLER_STATE\n");
509 len = (data[0] & 0x0000003f) + 2;
510 i = 1;
511 for (sampler = 0; sampler <= 15; sampler++) {
512 if (data[1] & (1 << sampler)) {
513 if (i + 3 >= count)
514 BUFFER_FAIL(count, len, "3DSTATE_SAMPLER_STATE");
515 instr_out(data, hw_offset, i++, "sampler %d SS2\n",
516 sampler);
517 instr_out(data, hw_offset, i++, "sampler %d SS3\n",
518 sampler);
519 instr_out(data, hw_offset, i++, "sampler %d SS4\n",
520 sampler);
521 }
522 }
523 if (len != i) {
524 fprintf(out, "Bad count in 3DSTATE_SAMPLER_STATE\n");
525 (*failures)++;
526 }
527 return len;
528 }
529
530 for (opcode = 0; opcode < sizeof(opcodes_3d_1d) / sizeof(opcodes_3d_1d[0]);
531 opcode++)
532 {
533 if (opcodes_3d_1d[opcode].i830_only && !i830)
534 continue;
535
536 if (((data[0] & 0x00ff0000) >> 16) == opcodes_3d_1d[opcode].opcode) {
537 len = 1;
538
539 instr_out(data, hw_offset, 0, "%s\n", opcodes_3d_1d[opcode].name);
540 if (opcodes_3d_1d[opcode].max_len > 1) {
541 len = (data[0] & 0x0000ffff) + 2;
542 if (len < opcodes_3d_1d[opcode].min_len ||
543 len > opcodes_3d_1d[opcode].max_len)
544 {
545 fprintf(out, "Bad count in %s\n",
546 opcodes_3d_1d[opcode].name);
547 (*failures)++;
548 }
549 }
550
551 for (i = 1; i < len; i++) {
552 if (i >= count)
553 BUFFER_FAIL(count, len, opcodes_3d_1d[opcode].name);
554 instr_out(data, hw_offset, i, "dword %d\n", i);
555 }
556
557 return len;
558 }
559 }
560
561 instr_out(data, hw_offset, 0, "3D UNKNOWN\n");
562 (*failures)++;
563 return 1;
564 }
565
566 static int
567 decode_3d_primitive(uint32_t *data, int count, uint32_t hw_offset,
568 int *failures)
569 {
570 char immediate = (data[0] & (1 << 23)) == 0;
571 unsigned int len, i;
572 char *primtype;
573
574 switch ((data[0] >> 18) & 0xf) {
575 case 0x0: primtype = "TRILIST"; break;
576 case 0x1: primtype = "TRISTRIP"; break;
577 case 0x2: primtype = "TRISTRIP_REVERSE"; break;
578 case 0x3: primtype = "TRIFAN"; break;
579 case 0x4: primtype = "POLYGON"; break;
580 case 0x5: primtype = "LINELIST"; break;
581 case 0x6: primtype = "LINESTRIP"; break;
582 case 0x7: primtype = "RECTLIST"; break;
583 case 0x8: primtype = "POINTLIST"; break;
584 case 0x9: primtype = "DIB"; break;
585 case 0xa: primtype = "CLEAR_RECT"; break;
586 default: primtype = "unknown"; break;
587 }
588
589 /* XXX: 3DPRIM_DIB not supported */
590 if (immediate) {
591 len = (data[0] & 0x0003ffff) + 2;
592 instr_out(data, hw_offset, 0, "3DPRIMITIVE inline %s\n", primtype);
593 if (count < len)
594 BUFFER_FAIL(count, len, "3DPRIMITIVE inline");
595 if (!saved_s2_set || !saved_s4_set) {
596 fprintf(out, "unknown vertex format\n");
597 for (i = 1; i < len; i++) {
598 instr_out(data, hw_offset, i,
599 " vertex data (%f float)\n",
600 int_as_float(data[i]));
601 }
602 } else {
603 unsigned int vertex = 0;
604 for (i = 1; i < len;) {
605 unsigned int tc;
606
607 #define VERTEX_OUT(fmt, ...) do { \
608 if (i < len) \
609 instr_out(data, hw_offset, i, " V%d."fmt"\n", vertex, __VA_ARGS__); \
610 else \
611 fprintf(out, " missing data in V%d\n", vertex); \
612 i++; \
613 } while (0)
614
615 VERTEX_OUT("X = %f", int_as_float(data[i]));
616 VERTEX_OUT("Y = %f", int_as_float(data[i]));
617 switch (saved_s4 >> 6 & 0x7) {
618 case 0x1:
619 VERTEX_OUT("Z = %f", int_as_float(data[i]));
620 break;
621 case 0x2:
622 VERTEX_OUT("Z = %f", int_as_float(data[i]));
623 VERTEX_OUT("W = %f", int_as_float(data[i]));
624 break;
625 case 0x3:
626 break;
627 case 0x4:
628 VERTEX_OUT("W = %f", int_as_float(data[i]));
629 break;
630 default:
631 fprintf(out, "bad S4 position mask\n");
632 }
633
634 if (saved_s4 & (1 << 10)) {
635 VERTEX_OUT("color = (A=0x%02x, R=0x%02x, G=0x%02x, "
636 "B=0x%02x)",
637 data[i] >> 24,
638 (data[i] >> 16) & 0xff,
639 (data[i] >> 8) & 0xff,
640 data[i] & 0xff);
641 }
642 if (saved_s4 & (1 << 11)) {
643 VERTEX_OUT("spec = (A=0x%02x, R=0x%02x, G=0x%02x, "
644 "B=0x%02x)",
645 data[i] >> 24,
646 (data[i] >> 16) & 0xff,
647 (data[i] >> 8) & 0xff,
648 data[i] & 0xff);
649 }
650 if (saved_s4 & (1 << 12))
651 VERTEX_OUT("width = 0x%08x)", data[i]);
652
653 for (tc = 0; tc <= 7; tc++) {
654 switch ((saved_s2 >> (tc * 4)) & 0xf) {
655 case 0x0:
656 VERTEX_OUT("T%d.X = %f", tc, int_as_float(data[i]));
657 VERTEX_OUT("T%d.Y = %f", tc, int_as_float(data[i]));
658 break;
659 case 0x1:
660 VERTEX_OUT("T%d.X = %f", tc, int_as_float(data[i]));
661 VERTEX_OUT("T%d.Y = %f", tc, int_as_float(data[i]));
662 VERTEX_OUT("T%d.Z = %f", tc, int_as_float(data[i]));
663 break;
664 case 0x2:
665 VERTEX_OUT("T%d.X = %f", tc, int_as_float(data[i]));
666 VERTEX_OUT("T%d.Y = %f", tc, int_as_float(data[i]));
667 VERTEX_OUT("T%d.Z = %f", tc, int_as_float(data[i]));
668 VERTEX_OUT("T%d.W = %f", tc, int_as_float(data[i]));
669 break;
670 case 0x3:
671 VERTEX_OUT("T%d.X = %f", tc, int_as_float(data[i]));
672 break;
673 case 0x4:
674 VERTEX_OUT("T%d.XY = 0x%08x half-float", tc, data[i]);
675 break;
676 case 0x5:
677 VERTEX_OUT("T%d.XY = 0x%08x half-float", tc, data[i]);
678 VERTEX_OUT("T%d.ZW = 0x%08x half-float", tc, data[i]);
679 break;
680 case 0xf:
681 break;
682 default:
683 fprintf(out, "bad S2.T%d format\n", tc);
684 }
685 }
686 vertex++;
687 }
688 }
689 } else {
690 /* indirect vertices */
691 len = data[0] & 0x0000ffff; /* index count */
692 if (data[0] & (1 << 17)) {
693 /* random vertex access */
694 if (count < (len + 1) / 2 + 1) {
695 BUFFER_FAIL(count, (len + 1) / 2 + 1,
696 "3DPRIMITIVE random indirect");
697 }
698 instr_out(data, hw_offset, 0,
699 "3DPRIMITIVE random indirect %s (%d)\n", primtype, len);
700 if (len == 0) {
701 /* vertex indices continue until 0xffff is found */
702 for (i = 1; i < count; i++) {
703 if ((data[i] & 0xffff) == 0xffff) {
704 instr_out(data, hw_offset, i,
705 " indices: (terminator)\n");
706 return i;
707 } else if ((data[i] >> 16) == 0xffff) {
708 instr_out(data, hw_offset, i,
709 " indices: 0x%04x, "
710 "(terminator)\n",
711 data[i] & 0xffff);
712 return i;
713 } else {
714 instr_out(data, hw_offset, i,
715 " indices: 0x%04x, 0x%04x\n",
716 data[i] & 0xffff, data[i] >> 16);
717 }
718 }
719 fprintf(out,
720 "3DPRIMITIVE: no terminator found in index buffer\n");
721 (*failures)++;
722 return count;
723 } else {
724 /* fixed size vertex index buffer */
725 for (i = 0; i < len; i += 2) {
726 if (i * 2 == len - 1) {
727 instr_out(data, hw_offset, i,
728 " indices: 0x%04x\n",
729 data[i] & 0xffff);
730 } else {
731 instr_out(data, hw_offset, i,
732 " indices: 0x%04x, 0x%04x\n",
733 data[i] & 0xffff, data[i] >> 16);
734 }
735 }
736 }
737 return (len + 1) / 2 + 1;
738 } else {
739 /* sequential vertex access */
740 if (count < 2)
741 BUFFER_FAIL(count, 2, "3DPRIMITIVE seq indirect");
742 instr_out(data, hw_offset, 0,
743 "3DPRIMITIVE sequential indirect %s, %d starting from "
744 "%d\n", primtype, len, data[1] & 0xffff);
745 instr_out(data, hw_offset, 1, " start\n");
746 return 2;
747 }
748 }
749
750 return len;
751 }
752
753 static int
754 decode_3d(uint32_t *data, int count, uint32_t hw_offset, int *failures)
755 {
756 unsigned int opcode;
757
758 struct {
759 uint32_t opcode;
760 int min_len;
761 int max_len;
762 char *name;
763 } opcodes_3d[] = {
764 { 0x06, 1, 1, "3DSTATE_ANTI_ALIASING" },
765 { 0x08, 1, 1, "3DSTATE_BACKFACE_STENCIL_OPS" },
766 { 0x09, 1, 1, "3DSTATE_BACKFACE_STENCIL_MASKS" },
767 { 0x16, 1, 1, "3DSTATE_COORD_SET_BINDINGS" },
768 { 0x15, 1, 1, "3DSTATE_FOG_COLOR" },
769 { 0x0b, 1, 1, "3DSTATE_INDEPENDENT_ALPHA_BLEND" },
770 { 0x0d, 1, 1, "3DSTATE_MODES_4" },
771 { 0x0c, 1, 1, "3DSTATE_MODES_5" },
772 { 0x07, 1, 1, "3DSTATE_RASTERIZATION_RULES" },
773 };
774
775 switch ((data[0] & 0x1f000000) >> 24) {
776 case 0x1f:
777 return decode_3d_primitive(data, count, hw_offset, failures);
778 case 0x1d:
779 return decode_3d_1d(data, count, hw_offset, failures, 0);
780 case 0x1c:
781 return decode_3d_1c(data, count, hw_offset, failures);
782 }
783
784 for (opcode = 0; opcode < sizeof(opcodes_3d) / sizeof(opcodes_3d[0]);
785 opcode++) {
786 if ((data[0] & 0x1f000000) >> 24 == opcodes_3d[opcode].opcode) {
787 unsigned int len = 1, i;
788
789 instr_out(data, hw_offset, 0, "%s\n", opcodes_3d[opcode].name);
790 if (opcodes_3d[opcode].max_len > 1) {
791 len = (data[0] & 0xff) + 2;
792 if (len < opcodes_3d[opcode].min_len ||
793 len > opcodes_3d[opcode].max_len)
794 {
795 fprintf(out, "Bad count in %s\n", opcodes_3d[opcode].name);
796 }
797 }
798
799 for (i = 1; i < len; i++) {
800 if (i >= count)
801 BUFFER_FAIL(count, len, opcodes_3d[opcode].name);
802 instr_out(data, hw_offset, i, "dword %d\n", i);
803 }
804 return len;
805 }
806 }
807
808 instr_out(data, hw_offset, 0, "3D UNKNOWN\n");
809 (*failures)++;
810 return 1;
811 }
812
813 static const char *
814 get_965_surfacetype(unsigned int surfacetype)
815 {
816 switch (surfacetype) {
817 case 0: return "1D";
818 case 1: return "2D";
819 case 2: return "3D";
820 case 3: return "CUBE";
821 case 4: return "BUFFER";
822 case 7: return "NULL";
823 default: return "unknown";
824 }
825 }
826
827 static const char *
828 get_965_depthformat(unsigned int depthformat)
829 {
830 switch (depthformat) {
831 case 0: return "s8_z24float";
832 case 1: return "z32float";
833 case 2: return "z24s8";
834 case 5: return "z16";
835 default: return "unknown";
836 }
837 }
838
839 static int
840 decode_3d_965(uint32_t *data, int count, uint32_t hw_offset, int *failures)
841 {
842 unsigned int opcode, len;
843
844 struct {
845 uint32_t opcode;
846 int min_len;
847 int max_len;
848 char *name;
849 } opcodes_3d[] = {
850 { 0x6000, 3, 3, "URB_FENCE" },
851 { 0x6001, 2, 2, "CS_URB_STATE" },
852 { 0x6002, 2, 2, "CONSTANT_BUFFER" },
853 { 0x6101, 6, 6, "STATE_BASE_ADDRESS" },
854 { 0x6102, 2, 2 , "STATE_SIP" },
855 { 0x6104, 1, 1, "3DSTATE_PIPELINE_SELECT" },
856 { 0x680b, 1, 1, "3DSTATE_VF_STATISTICS" },
857 { 0x6904, 1, 1, "3DSTATE_PIPELINE_SELECT" },
858 { 0x7800, 7, 7, "3DSTATE_PIPELINED_POINTERS" },
859 { 0x7801, 6, 6, "3DSTATE_BINDING_TABLE_POINTERS" },
860 { 0x780b, 1, 1, "3DSTATE_VF_STATISTICS" },
861 { 0x7808, 5, 257, "3DSTATE_VERTEX_BUFFERS" },
862 { 0x7809, 3, 256, "3DSTATE_VERTEX_ELEMENTS" },
863 /* 0x7808: 3DSTATE_VERTEX_BUFFERS */
864 /* 0x7809: 3DSTATE_VERTEX_ELEMENTS */
865 { 0x7900, 4, 4, "3DSTATE_DRAWING_RECTANGLE" },
866 { 0x7901, 5, 5, "3DSTATE_CONSTANT_COLOR" },
867 { 0x7905, 5, 7, "3DSTATE_DEPTH_BUFFER" },
868 { 0x7906, 2, 2, "3DSTATE_POLY_STIPPLE_OFFSET" },
869 { 0x7907, 33, 33, "3DSTATE_POLY_STIPPLE_PATTERN" },
870 { 0x7908, 3, 3, "3DSTATE_LINE_STIPPLE" },
871 { 0x7909, 2, 2, "3DSTATE_GLOBAL_DEPTH_OFFSET_CLAMP" },
872 { 0x790a, 3, 3, "3DSTATE_AA_LINE_PARAMETERS" },
873 { 0x7b00, 6, 6, "3DPRIMITIVE" },
874 };
875
876 len = (data[0] & 0x0000ffff) + 2;
877
878 switch ((data[0] & 0xffff0000) >> 16) {
879 case 0x6101:
880 if (len != 6)
881 fprintf(out, "Bad count in STATE_BASE_ADDRESS\n");
882 if (count < 6)
883 BUFFER_FAIL(count, len, "STATE_BASE_ADDRESS");
884
885 instr_out(data, hw_offset, 0,
886 "STATE_BASE_ADDRESS\n");
887
888 if (data[1] & 1) {
889 instr_out(data, hw_offset, 1, "General state at 0x%08x\n",
890 data[1] & ~1);
891 } else
892 instr_out(data, hw_offset, 1, "General state not updated\n");
893
894 if (data[2] & 1) {
895 instr_out(data, hw_offset, 2, "Surface state at 0x%08x\n",
896 data[2] & ~1);
897 } else
898 instr_out(data, hw_offset, 2, "Surface state not updated\n");
899
900 if (data[3] & 1) {
901 instr_out(data, hw_offset, 3, "Indirect state at 0x%08x\n",
902 data[3] & ~1);
903 } else
904 instr_out(data, hw_offset, 3, "Indirect state not updated\n");
905
906 if (data[4] & 1) {
907 instr_out(data, hw_offset, 4, "General state upper bound 0x%08x\n",
908 data[4] & ~1);
909 } else
910 instr_out(data, hw_offset, 4, "General state not updated\n");
911
912 if (data[5] & 1) {
913 instr_out(data, hw_offset, 5, "Indirect state upper bound 0x%08x\n",
914 data[5] & ~1);
915 } else
916 instr_out(data, hw_offset, 5, "Indirect state not updated\n");
917
918 return len;
919 case 0x7800:
920 if (len != 7)
921 fprintf(out, "Bad count in 3DSTATE_PIPELINED_POINTERS\n");
922 if (count < 7)
923 BUFFER_FAIL(count, len, "3DSTATE_PIPELINED_POINTERS");
924
925 instr_out(data, hw_offset, 0,
926 "3DSTATE_PIPELINED_POINTERS\n");
927 instr_out(data, hw_offset, 1, "VS state\n");
928 instr_out(data, hw_offset, 2, "GS state\n");
929 instr_out(data, hw_offset, 3, "Clip state\n");
930 instr_out(data, hw_offset, 4, "SF state\n");
931 instr_out(data, hw_offset, 5, "WM state\n");
932 instr_out(data, hw_offset, 6, "CC state\n");
933 return len;
934 case 0x7801:
935 if (len != 6)
936 fprintf(out, "Bad count in 3DSTATE_BINDING_TABLE_POINTERS\n");
937 if (count < 6)
938 BUFFER_FAIL(count, len, "3DSTATE_BINDING_TABLE_POINTERS");
939
940 instr_out(data, hw_offset, 0,
941 "3DSTATE_BINDING_TABLE_POINTERS\n");
942 instr_out(data, hw_offset, 1, "VS binding table\n");
943 instr_out(data, hw_offset, 2, "GS binding table\n");
944 instr_out(data, hw_offset, 3, "Clip binding table\n");
945 instr_out(data, hw_offset, 4, "SF binding table\n");
946 instr_out(data, hw_offset, 5, "WM binding table\n");
947
948 return len;
949
950 case 0x7900:
951 if (len != 4)
952 fprintf(out, "Bad count in 3DSTATE_DRAWING_RECTANGLE\n");
953 if (count < 4)
954 BUFFER_FAIL(count, len, "3DSTATE_DRAWING_RECTANGLE");
955
956 instr_out(data, hw_offset, 0,
957 "3DSTATE_DRAWING_RECTANGLE\n");
958 instr_out(data, hw_offset, 1, "top left: %d,%d\n",
959 data[1] & 0xffff,
960 (data[1] >> 16) & 0xffff);
961 instr_out(data, hw_offset, 2, "bottom right: %d,%d\n",
962 data[2] & 0xffff,
963 (data[2] >> 16) & 0xffff);
964 instr_out(data, hw_offset, 3, "origin: %d,%d\n",
965 (int)data[3] & 0xffff,
966 ((int)data[3] >> 16) & 0xffff);
967
968 return len;
969
970 case 0x7905:
971 if (len != 5)
972 fprintf(out, "Bad count in 3DSTATE_DEPTH_BUFFER\n");
973 if (count < 5)
974 BUFFER_FAIL(count, len, "3DSTATE_DEPTH_BUFFER");
975
976 instr_out(data, hw_offset, 0,
977 "3DSTATE_DEPTH_BUFFER\n");
978 instr_out(data, hw_offset, 1, "%s, %s, pitch = %d bytes, %stiled\n",
979 get_965_surfacetype(data[1] >> 29),
980 get_965_depthformat((data[1] >> 18) & 0x7),
981 (data[1] & 0x0001ffff) + 1,
982 data[1] & (1 << 27) ? "" : "not ");
983 instr_out(data, hw_offset, 2, "depth offset\n");
984 instr_out(data, hw_offset, 3, "%dx%d\n",
985 ((data[3] & 0x0007ffc0) >> 6) + 1,
986 ((data[3] & 0xfff80000) >> 19) + 1);
987 instr_out(data, hw_offset, 4, "volume depth\n");
988
989 return len;
990 }
991
992 for (opcode = 0; opcode < sizeof(opcodes_3d) / sizeof(opcodes_3d[0]);
993 opcode++) {
994 if ((data[0] & 0xffff0000) >> 16 == opcodes_3d[opcode].opcode) {
995 unsigned int i;
996 len = 1;
997
998 instr_out(data, hw_offset, 0, "%s\n", opcodes_3d[opcode].name);
999 if (opcodes_3d[opcode].max_len > 1) {
1000 len = (data[0] & 0xff) + 2;
1001 if (len < opcodes_3d[opcode].min_len ||
1002 len > opcodes_3d[opcode].max_len)
1003 {
1004 fprintf(out, "Bad count in %s\n", opcodes_3d[opcode].name);
1005 }
1006 }
1007
1008 for (i = 1; i < len; i++) {
1009 if (i >= count)
1010 BUFFER_FAIL(count, len, opcodes_3d[opcode].name);
1011 instr_out(data, hw_offset, i, "dword %d\n", i);
1012 }
1013 return len;
1014 }
1015 }
1016
1017 instr_out(data, hw_offset, 0, "3D UNKNOWN\n");
1018 (*failures)++;
1019 return 1;
1020 }
1021
1022 static int
1023 decode_3d_i830(uint32_t *data, int count, uint32_t hw_offset, int *failures)
1024 {
1025 unsigned int opcode;
1026
1027 struct {
1028 uint32_t opcode;
1029 int min_len;
1030 int max_len;
1031 char *name;
1032 } opcodes_3d[] = {
1033 { 0x02, 1, 1, "3DSTATE_MODES_3" },
1034 { 0x03, 1, 1, "3DSTATE_ENABLES_1"},
1035 { 0x04, 1, 1, "3DSTATE_ENABLES_2"},
1036 { 0x05, 1, 1, "3DSTATE_VFT0"},
1037 { 0x06, 1, 1, "3DSTATE_AA"},
1038 { 0x07, 1, 1, "3DSTATE_RASTERIZATION_RULES" },
1039 { 0x08, 1, 1, "3DSTATE_MODES_1" },
1040 { 0x09, 1, 1, "3DSTATE_STENCIL_TEST" },
1041 { 0x0a, 1, 1, "3DSTATE_VFT1"},
1042 { 0x0b, 1, 1, "3DSTATE_INDPT_ALPHA_BLEND" },
1043 { 0x0c, 1, 1, "3DSTATE_MODES_5" },
1044 { 0x0d, 1, 1, "3DSTATE_MAP_BLEND_OP" },
1045 { 0x0e, 1, 1, "3DSTATE_MAP_BLEND_ARG" },
1046 { 0x0f, 1, 1, "3DSTATE_MODES_2" },
1047 { 0x15, 1, 1, "3DSTATE_FOG_COLOR" },
1048 { 0x16, 1, 1, "3DSTATE_MODES_4" },
1049 };
1050
1051 switch ((data[0] & 0x1f000000) >> 24) {
1052 case 0x1f:
1053 return decode_3d_primitive(data, count, hw_offset, failures);
1054 case 0x1d:
1055 return decode_3d_1d(data, count, hw_offset, failures, 1);
1056 case 0x1c:
1057 return decode_3d_1c(data, count, hw_offset, failures);
1058 }
1059
1060 for (opcode = 0; opcode < sizeof(opcodes_3d) / sizeof(opcodes_3d[0]);
1061 opcode++) {
1062 if ((data[0] & 0x1f000000) >> 24 == opcodes_3d[opcode].opcode) {
1063 unsigned int len = 1, i;
1064
1065 instr_out(data, hw_offset, 0, "%s\n", opcodes_3d[opcode].name);
1066 if (opcodes_3d[opcode].max_len > 1) {
1067 len = (data[0] & 0xff) + 2;
1068 if (len < opcodes_3d[opcode].min_len ||
1069 len > opcodes_3d[opcode].max_len)
1070 {
1071 fprintf(out, "Bad count in %s\n", opcodes_3d[opcode].name);
1072 }
1073 }
1074
1075 for (i = 1; i < len; i++) {
1076 if (i >= count)
1077 BUFFER_FAIL(count, len, opcodes_3d[opcode].name);
1078 instr_out(data, hw_offset, i, "dword %d\n", i);
1079 }
1080 return len;
1081 }
1082 }
1083
1084 instr_out(data, hw_offset, 0, "3D UNKNOWN\n");
1085 (*failures)++;
1086 return 1;
1087 }
1088
1089 /**
1090 * Decodes an i830-i915 batch buffer, writing the output to stdout.
1091 *
1092 * \param data batch buffer contents
1093 * \param count number of DWORDs to decode in the batch buffer
1094 * \param hw_offset hardware address for the buffer
1095 */
1096 int
1097 intel_decode(uint32_t *data, int count, uint32_t hw_offset, uint32_t devid)
1098 {
1099 int index = 0;
1100 int failures = 0;
1101
1102 out = stderr;
1103
1104 while (index < count) {
1105 switch ((data[index] & 0xe0000000) >> 29) {
1106 case 0x0:
1107 index += decode_mi(data + index, count - index,
1108 hw_offset + index * 4, &failures);
1109 break;
1110 case 0x2:
1111 index += decode_2d(data + index, count - index,
1112 hw_offset + index * 4, &failures);
1113 break;
1114 case 0x3:
1115 if (IS_965(devid)) {
1116 index += decode_3d_965(data + index, count - index,
1117 hw_offset + index * 4, &failures);
1118 } else if (IS_9XX(devid)) {
1119 index += decode_3d(data + index, count - index,
1120 hw_offset + index * 4, &failures);
1121 } else {
1122 index += decode_3d_i830(data + index, count - index,
1123 hw_offset + index * 4, &failures);
1124 }
1125 break;
1126 default:
1127 instr_out(data, hw_offset, index, "UNKNOWN\n");
1128 failures++;
1129 index++;
1130 break;
1131 }
1132 fflush(out);
1133 }
1134
1135 return failures;
1136 }
1137
1138 void intel_decode_context_reset(void)
1139 {
1140 saved_s2_set = 0;
1141 saved_s4_set = 1;
1142 }
1143