2
* Copyright © 2016 Intel Corporation
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:
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
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
33
#include <util/macros.h>
34
#include <util/ralloc.h>
36
#include "intel_decoder.h"
39
#include "genxml/genX_xml.h"
41
#define XML_BUFFER_SIZE 4096
42
#define MAX_VALUE_ITEMS 128
49
struct parser_context {
54
struct intel_group *group;
55
struct intel_enum *enoom;
57
int n_values, n_allocated_values;
58
struct intel_value **values;
60
struct intel_field *last_field;
62
struct intel_spec *spec;
66
intel_group_get_name(struct intel_group *group)
72
intel_group_get_opcode(struct intel_group *group)
78
intel_spec_find_struct(struct intel_spec *spec, const char *name)
80
struct hash_entry *entry = _mesa_hash_table_search(spec->structs,
82
return entry ? entry->data : NULL;
86
intel_spec_find_register(struct intel_spec *spec, uint32_t offset)
88
struct hash_entry *entry =
89
_mesa_hash_table_search(spec->registers_by_offset,
90
(void *) (uintptr_t) offset);
91
return entry ? entry->data : NULL;
95
intel_spec_find_register_by_name(struct intel_spec *spec, const char *name)
97
struct hash_entry *entry =
98
_mesa_hash_table_search(spec->registers_by_name, name);
99
return entry ? entry->data : NULL;
103
intel_spec_find_enum(struct intel_spec *spec, const char *name)
105
struct hash_entry *entry = _mesa_hash_table_search(spec->enums,
107
return entry ? entry->data : NULL;
111
intel_spec_get_gen(struct intel_spec *spec)
116
static void __attribute__((noreturn))
117
fail(struct location *loc, const char *msg, ...)
122
fprintf(stderr, "%s:%d: error: ",
123
loc->filename, loc->line_number);
124
vfprintf(stderr, msg, ap);
125
fprintf(stderr, "\n");
131
get_array_offset_count(const char **atts, uint32_t *offset, uint32_t *count,
132
uint32_t *size, bool *variable)
134
for (int i = 0; atts[i]; i += 2) {
137
if (strcmp(atts[i], "count") == 0) {
138
*count = strtoul(atts[i + 1], &p, 0);
141
} else if (strcmp(atts[i], "start") == 0) {
142
*offset = strtoul(atts[i + 1], &p, 0);
143
} else if (strcmp(atts[i], "size") == 0) {
144
*size = strtoul(atts[i + 1], &p, 0);
150
static struct intel_group *
151
create_group(struct parser_context *ctx,
154
struct intel_group *parent,
157
struct intel_group *group;
159
group = rzalloc(ctx->spec, struct intel_group);
161
group->name = ralloc_strdup(group, name);
163
group->spec = ctx->spec;
164
group->variable = false;
165
group->fixed_length = fixed_length;
166
group->dword_length_field = NULL;
167
group->dw_length = 0;
168
group->engine_mask = I915_ENGINE_CLASS_TO_MASK(I915_ENGINE_CLASS_RENDER) |
169
I915_ENGINE_CLASS_TO_MASK(I915_ENGINE_CLASS_VIDEO) |
170
I915_ENGINE_CLASS_TO_MASK(I915_ENGINE_CLASS_COPY);
173
for (int i = 0; atts[i]; i += 2) {
175
if (strcmp(atts[i], "length") == 0) {
176
group->dw_length = strtoul(atts[i + 1], &p, 0);
177
} else if (strcmp(atts[i], "bias") == 0) {
178
group->bias = strtoul(atts[i + 1], &p, 0);
179
} else if (strcmp(atts[i], "engine") == 0) {
180
void *mem_ctx = ralloc_context(NULL);
181
char *tmp = ralloc_strdup(mem_ctx, atts[i + 1]);
183
char *tok = strtok_r(tmp, "|", &save_ptr);
185
group->engine_mask = 0;
186
while (tok != NULL) {
187
if (strcmp(tok, "render") == 0) {
188
group->engine_mask |= I915_ENGINE_CLASS_TO_MASK(I915_ENGINE_CLASS_RENDER);
189
} else if (strcmp(tok, "video") == 0) {
190
group->engine_mask |= I915_ENGINE_CLASS_TO_MASK(I915_ENGINE_CLASS_VIDEO);
191
} else if (strcmp(tok, "blitter") == 0) {
192
group->engine_mask |= I915_ENGINE_CLASS_TO_MASK(I915_ENGINE_CLASS_COPY);
194
fprintf(stderr, "unknown engine class defined for instruction \"%s\": %s\n", name, atts[i + 1]);
197
tok = strtok_r(NULL, "|", &save_ptr);
200
ralloc_free(mem_ctx);
205
group->parent = parent;
206
get_array_offset_count(atts,
207
&group->array_offset,
209
&group->array_item_size,
216
static struct intel_enum *
217
create_enum(struct parser_context *ctx, const char *name, const char **atts)
219
struct intel_enum *e;
221
e = rzalloc(ctx->spec, struct intel_enum);
223
e->name = ralloc_strdup(e, name);
229
get_register_offset(const char **atts, uint32_t *offset)
231
for (int i = 0; atts[i]; i += 2) {
234
if (strcmp(atts[i], "num") == 0)
235
*offset = strtoul(atts[i + 1], &p, 0);
241
get_start_end_pos(int *start, int *end)
243
/* start value has to be mod with 32 as we need the relative
244
* start position in the first DWord. For the end position, add
245
* the length of the field to the start position to get the
246
* relative postion in the 64 bit address.
248
if (*end - *start > 32) {
249
int len = *end - *start;
250
*start = *start % 32;
253
*start = *start % 32;
260
static inline uint64_t
261
mask(int start, int end)
265
v = ~0ULL >> (63 - end + start);
270
static inline uint64_t
271
field_value(uint64_t value, int start, int end)
273
get_start_end_pos(&start, &end);
274
return (value & mask(start, end)) >> (start);
277
static struct intel_type
278
string_to_type(struct parser_context *ctx, const char *s)
281
struct intel_group *g;
282
struct intel_enum *e;
284
if (strcmp(s, "int") == 0)
285
return (struct intel_type) { .kind = INTEL_TYPE_INT };
286
else if (strcmp(s, "uint") == 0)
287
return (struct intel_type) { .kind = INTEL_TYPE_UINT };
288
else if (strcmp(s, "bool") == 0)
289
return (struct intel_type) { .kind = INTEL_TYPE_BOOL };
290
else if (strcmp(s, "float") == 0)
291
return (struct intel_type) { .kind = INTEL_TYPE_FLOAT };
292
else if (strcmp(s, "address") == 0)
293
return (struct intel_type) { .kind = INTEL_TYPE_ADDRESS };
294
else if (strcmp(s, "offset") == 0)
295
return (struct intel_type) { .kind = INTEL_TYPE_OFFSET };
296
else if (sscanf(s, "u%d.%d", &i, &f) == 2)
297
return (struct intel_type) { .kind = INTEL_TYPE_UFIXED, .i = i, .f = f };
298
else if (sscanf(s, "s%d.%d", &i, &f) == 2)
299
return (struct intel_type) { .kind = INTEL_TYPE_SFIXED, .i = i, .f = f };
300
else if (g = intel_spec_find_struct(ctx->spec, s), g != NULL)
301
return (struct intel_type) { .kind = INTEL_TYPE_STRUCT, .intel_struct = g };
302
else if (e = intel_spec_find_enum(ctx->spec, s), e != NULL)
303
return (struct intel_type) { .kind = INTEL_TYPE_ENUM, .intel_enum = e };
304
else if (strcmp(s, "mbo") == 0)
305
return (struct intel_type) { .kind = INTEL_TYPE_MBO };
306
else if (strcmp(s, "mbz") == 0)
307
return (struct intel_type) { .kind = INTEL_TYPE_MBZ };
309
fail(&ctx->loc, "invalid type: %s", s);
312
static struct intel_field *
313
create_field(struct parser_context *ctx, const char **atts)
315
struct intel_field *field;
317
field = rzalloc(ctx->group, struct intel_field);
318
field->parent = ctx->group;
320
for (int i = 0; atts[i]; i += 2) {
323
if (strcmp(atts[i], "name") == 0) {
324
field->name = ralloc_strdup(field, atts[i + 1]);
325
if (strcmp(field->name, "DWord Length") == 0) {
326
field->parent->dword_length_field = field;
328
} else if (strcmp(atts[i], "start") == 0) {
329
field->start = strtoul(atts[i + 1], &p, 0);
330
} else if (strcmp(atts[i], "end") == 0) {
331
field->end = strtoul(atts[i + 1], &p, 0);
332
} else if (strcmp(atts[i], "type") == 0) {
333
field->type = string_to_type(ctx, atts[i + 1]);
334
} else if (strcmp(atts[i], "default") == 0 &&
335
field->start >= 16 && field->end <= 31) {
336
field->has_default = true;
337
field->default_value = strtoul(atts[i + 1], &p, 0);
344
static struct intel_field *
345
create_array_field(struct parser_context *ctx, struct intel_group *array)
347
struct intel_field *field;
349
field = rzalloc(ctx->group, struct intel_field);
350
field->parent = ctx->group;
352
field->array = array;
353
field->start = field->array->array_offset;
358
static struct intel_value *
359
create_value(struct parser_context *ctx, const char **atts)
361
struct intel_value *value = rzalloc(ctx->values, struct intel_value);
363
for (int i = 0; atts[i]; i += 2) {
364
if (strcmp(atts[i], "name") == 0)
365
value->name = ralloc_strdup(value, atts[i + 1]);
366
else if (strcmp(atts[i], "value") == 0)
367
value->value = strtoul(atts[i + 1], NULL, 0);
373
static struct intel_field *
374
create_and_append_field(struct parser_context *ctx,
376
struct intel_group *array)
378
struct intel_field *field = array ?
379
create_array_field(ctx, array) : create_field(ctx, atts);
380
struct intel_field *prev = NULL, *list = ctx->group->fields;
382
while (list && field->start > list->start) {
389
ctx->group->fields = field;
397
start_element(void *data, const char *element_name, const char **atts)
399
struct parser_context *ctx = data;
400
const char *name = NULL;
401
const char *gen = NULL;
403
ctx->loc.line_number = XML_GetCurrentLineNumber(ctx->parser);
405
for (int i = 0; atts[i]; i += 2) {
406
if (strcmp(atts[i], "name") == 0)
408
else if (strcmp(atts[i], "gen") == 0)
412
if (strcmp(element_name, "genxml") == 0) {
414
fail(&ctx->loc, "no platform name given");
416
fail(&ctx->loc, "no gen given");
419
int n = sscanf(gen, "%d.%d", &major, &minor);
421
fail(&ctx->loc, "invalid gen given: %s", gen);
425
ctx->spec->gen = intel_make_gen(major, minor);
426
} else if (strcmp(element_name, "instruction") == 0) {
427
ctx->group = create_group(ctx, name, atts, NULL, false);
428
} else if (strcmp(element_name, "struct") == 0) {
429
ctx->group = create_group(ctx, name, atts, NULL, true);
430
} else if (strcmp(element_name, "register") == 0) {
431
ctx->group = create_group(ctx, name, atts, NULL, true);
432
get_register_offset(atts, &ctx->group->register_offset);
433
} else if (strcmp(element_name, "group") == 0) {
434
struct intel_group *group = create_group(ctx, "", atts, ctx->group, false);
435
ctx->last_field = create_and_append_field(ctx, NULL, group);
437
} else if (strcmp(element_name, "field") == 0) {
438
ctx->last_field = create_and_append_field(ctx, atts, NULL);
439
} else if (strcmp(element_name, "enum") == 0) {
440
ctx->enoom = create_enum(ctx, name, atts);
441
} else if (strcmp(element_name, "value") == 0) {
442
if (ctx->n_values >= ctx->n_allocated_values) {
443
ctx->n_allocated_values = MAX2(2, ctx->n_allocated_values * 2);
444
ctx->values = reralloc_array_size(ctx->spec, ctx->values,
445
sizeof(struct intel_value *),
446
ctx->n_allocated_values);
448
assert(ctx->n_values < ctx->n_allocated_values);
449
ctx->values[ctx->n_values++] = create_value(ctx, atts);
455
end_element(void *data, const char *name)
457
struct parser_context *ctx = data;
458
struct intel_spec *spec = ctx->spec;
460
if (strcmp(name, "instruction") == 0 ||
461
strcmp(name, "struct") == 0 ||
462
strcmp(name, "register") == 0) {
463
struct intel_group *group = ctx->group;
464
struct intel_field *list = group->fields;
466
ctx->group = ctx->group->parent;
468
while (list && list->end <= 31) {
469
if (list->start >= 16 && list->has_default) {
470
group->opcode_mask |=
471
mask(list->start % 32, list->end % 32);
472
group->opcode |= list->default_value << list->start;
477
if (strcmp(name, "instruction") == 0)
478
_mesa_hash_table_insert(spec->commands, group->name, group);
479
else if (strcmp(name, "struct") == 0)
480
_mesa_hash_table_insert(spec->structs, group->name, group);
481
else if (strcmp(name, "register") == 0) {
482
_mesa_hash_table_insert(spec->registers_by_name, group->name, group);
483
_mesa_hash_table_insert(spec->registers_by_offset,
484
(void *) (uintptr_t) group->register_offset,
487
} else if (strcmp(name, "group") == 0) {
488
ctx->group = ctx->group->parent;
489
} else if (strcmp(name, "field") == 0) {
490
struct intel_field *field = ctx->last_field;
491
ctx->last_field = NULL;
492
field->inline_enum.values = ctx->values;
493
field->inline_enum.nvalues = ctx->n_values;
494
ctx->values = ralloc_array(ctx->spec, struct intel_value*, ctx->n_allocated_values = 2);
496
} else if (strcmp(name, "enum") == 0) {
497
struct intel_enum *e = ctx->enoom;
498
e->values = ctx->values;
499
e->nvalues = ctx->n_values;
500
ctx->values = ralloc_array(ctx->spec, struct intel_value*, ctx->n_allocated_values = 2);
503
_mesa_hash_table_insert(spec->enums, e->name, e);
508
character_data(void *data, const XML_Char *s, int len)
512
static uint32_t zlib_inflate(const void *compressed_data,
513
uint32_t compressed_len,
516
struct z_stream_s zstream;
519
memset(&zstream, 0, sizeof(zstream));
521
zstream.next_in = (unsigned char *)compressed_data;
522
zstream.avail_in = compressed_len;
524
if (inflateInit(&zstream) != Z_OK)
528
zstream.next_out = out;
529
zstream.avail_out = 4096;
532
switch (inflate(&zstream, Z_SYNC_FLUSH)) {
538
inflateEnd(&zstream);
542
if (zstream.avail_out)
545
out = realloc(out, 2*zstream.total_out);
547
inflateEnd(&zstream);
551
zstream.next_out = (unsigned char *)out + zstream.total_out;
552
zstream.avail_out = zstream.total_out;
555
inflateEnd(&zstream);
557
return zstream.total_out;
560
static uint32_t _hash_uint32(const void *key)
562
return (uint32_t) (uintptr_t) key;
565
static struct intel_spec *
566
intel_spec_init(void)
568
struct intel_spec *spec;
569
spec = rzalloc(NULL, struct intel_spec);
574
_mesa_hash_table_create(spec, _mesa_hash_string, _mesa_key_string_equal);
576
_mesa_hash_table_create(spec, _mesa_hash_string, _mesa_key_string_equal);
577
spec->registers_by_name =
578
_mesa_hash_table_create(spec, _mesa_hash_string, _mesa_key_string_equal);
579
spec->registers_by_offset =
580
_mesa_hash_table_create(spec, _hash_uint32, _mesa_key_pointer_equal);
582
_mesa_hash_table_create(spec, _mesa_hash_string, _mesa_key_string_equal);
584
_mesa_hash_table_create(spec, _mesa_hash_string, _mesa_key_string_equal);
590
intel_spec_load(const struct intel_device_info *devinfo)
592
struct parser_context ctx;
594
uint8_t *text_data = NULL;
595
uint32_t text_offset = 0, text_length = 0;
596
ASSERTED uint32_t total_length;
597
uint32_t ver_10 = devinfo->verx10;
599
for (int i = 0; i < ARRAY_SIZE(genxml_files_table); i++) {
600
if (genxml_files_table[i].ver_10 == ver_10) {
601
text_offset = genxml_files_table[i].offset;
602
text_length = genxml_files_table[i].length;
607
if (text_length == 0) {
608
fprintf(stderr, "unable to find gen (%u) data\n", ver_10);
612
memset(&ctx, 0, sizeof ctx);
613
ctx.parser = XML_ParserCreate(NULL);
614
XML_SetUserData(ctx.parser, &ctx);
615
if (ctx.parser == NULL) {
616
fprintf(stderr, "failed to create parser\n");
620
XML_SetElementHandler(ctx.parser, start_element, end_element);
621
XML_SetCharacterDataHandler(ctx.parser, character_data);
623
ctx.spec = intel_spec_init();
624
if (ctx.spec == NULL) {
625
fprintf(stderr, "Failed to create intel_spec\n");
629
total_length = zlib_inflate(compress_genxmls,
630
sizeof(compress_genxmls),
631
(void **) &text_data);
632
assert(text_offset + text_length <= total_length);
634
buf = XML_GetBuffer(ctx.parser, text_length);
635
memcpy(buf, &text_data[text_offset], text_length);
637
if (XML_ParseBuffer(ctx.parser, text_length, true) == 0) {
639
"Error parsing XML at line %ld col %ld byte %ld/%u: %s\n",
640
XML_GetCurrentLineNumber(ctx.parser),
641
XML_GetCurrentColumnNumber(ctx.parser),
642
XML_GetCurrentByteIndex(ctx.parser), text_length,
643
XML_ErrorString(XML_GetErrorCode(ctx.parser)));
644
XML_ParserFree(ctx.parser);
649
XML_ParserFree(ctx.parser);
656
intel_spec_load_filename(const char *filename)
658
struct parser_context ctx;
663
input = fopen(filename, "r");
665
fprintf(stderr, "failed to open xml description\n");
669
memset(&ctx, 0, sizeof ctx);
670
ctx.parser = XML_ParserCreate(NULL);
671
XML_SetUserData(ctx.parser, &ctx);
672
if (ctx.parser == NULL) {
673
fprintf(stderr, "failed to create parser\n");
678
XML_SetElementHandler(ctx.parser, start_element, end_element);
679
XML_SetCharacterDataHandler(ctx.parser, character_data);
680
ctx.loc.filename = filename;
682
ctx.spec = intel_spec_init();
683
if (ctx.spec == NULL) {
684
fprintf(stderr, "Failed to create intel_spec\n");
689
buf = XML_GetBuffer(ctx.parser, XML_BUFFER_SIZE);
690
len = fread(buf, 1, XML_BUFFER_SIZE, input);
692
fprintf(stderr, "fread: %m\n");
693
intel_spec_destroy(ctx.spec);
696
} else if (len == 0 && feof(input))
699
if (XML_ParseBuffer(ctx.parser, len, len == 0) == 0) {
701
"Error parsing XML at line %ld col %ld: %s\n",
702
XML_GetCurrentLineNumber(ctx.parser),
703
XML_GetCurrentColumnNumber(ctx.parser),
704
XML_ErrorString(XML_GetErrorCode(ctx.parser)));
705
intel_spec_destroy(ctx.spec);
712
XML_ParserFree(ctx.parser);
716
/* free ctx.spec if genxml is empty */
718
_mesa_hash_table_num_entries(ctx.spec->commands) == 0 &&
719
_mesa_hash_table_num_entries(ctx.spec->structs) == 0) {
721
"Error parsing XML: empty spec.\n");
722
intel_spec_destroy(ctx.spec);
730
intel_spec_load_from_path(const struct intel_device_info *devinfo,
733
size_t filename_len = strlen(path) + 20;
734
char *filename = malloc(filename_len);
736
ASSERTED size_t len = snprintf(filename, filename_len, "%s/gen%i.xml",
738
assert(len < filename_len);
740
struct intel_spec *spec = intel_spec_load_filename(filename);
746
void intel_spec_destroy(struct intel_spec *spec)
752
intel_spec_find_instruction(struct intel_spec *spec,
753
enum drm_i915_gem_engine_class engine,
756
hash_table_foreach(spec->commands, entry) {
757
struct intel_group *command = entry->data;
758
uint32_t opcode = *p & command->opcode_mask;
759
if ((command->engine_mask & I915_ENGINE_CLASS_TO_MASK(engine)) &&
760
opcode == command->opcode)
768
intel_group_find_field(struct intel_group *group, const char *name)
771
snprintf(path, sizeof(path), "%s/%s", group->name, name);
773
struct intel_spec *spec = group->spec;
774
struct hash_entry *entry = _mesa_hash_table_search(spec->access_cache,
779
struct intel_field *field = group->fields;
781
if (strcmp(field->name, name) == 0) {
782
_mesa_hash_table_insert(spec->access_cache,
783
ralloc_strdup(spec, path),
794
intel_group_get_length(struct intel_group *group, const uint32_t *p)
797
if (group->fixed_length)
798
return group->dw_length;
800
struct intel_field *field = group->dword_length_field;
802
return field_value(p[0], field->start, field->end) + group->bias;
808
uint32_t type = field_value(h, 29, 31);
812
uint32_t opcode = field_value(h, 23, 28);
816
return field_value(h, 0, 7) + 2;
821
return field_value(h, 0, 7) + 2;
824
case 3: /* Render */ {
825
uint32_t subtype = field_value(h, 27, 28);
826
uint32_t opcode = field_value(h, 24, 26);
827
uint16_t whole_opcode = field_value(h, 16, 31);
830
if (whole_opcode == 0x6104 /* PIPELINE_SELECT_965 */)
833
return field_value(h, 0, 7) + 2;
843
return field_value(h, 0, 7) + 2;
845
return field_value(h, 0, 15) + 2;
850
if (whole_opcode == 0x780b)
853
return field_value(h, 0, 7) + 2;
864
intel_get_enum_name(struct intel_enum *e, uint64_t value)
866
for (int i = 0; i < e->nvalues; i++) {
867
if (e->values[i]->value == value) {
868
return e->values[i]->name;
875
iter_more_fields(const struct intel_field_iterator *iter)
877
return iter->field != NULL && iter->field->next != NULL;
881
iter_array_offset_bits(const struct intel_field_iterator *iter)
883
if (iter->level == 0)
887
const struct intel_group *group = iter->groups[1];
888
for (int level = 1; level <= iter->level; level++, group = iter->groups[level]) {
889
uint32_t array_idx = iter->array_iter[level];
890
offset += group->array_offset + array_idx * group->array_item_size;
896
/* Checks whether we have more items in the array to iterate, or more arrays to
899
/* descend into a non-array field */
901
iter_push_array(struct intel_field_iterator *iter)
903
assert(iter->level >= 0);
905
iter->group = iter->field->array;
907
assert(iter->level < DECODE_MAX_ARRAY_DEPTH);
908
iter->groups[iter->level] = iter->group;
909
iter->array_iter[iter->level] = 0;
911
assert(iter->group->fields != NULL); /* an empty <group> makes no sense */
912
iter->field = iter->group->fields;
913
iter->fields[iter->level] = iter->field;
917
iter_pop_array(struct intel_field_iterator *iter)
919
assert(iter->level > 0);
922
iter->field = iter->fields[iter->level];
923
iter->group = iter->groups[iter->level];
927
iter_start_field(struct intel_field_iterator *iter, struct intel_field *field)
930
iter->fields[iter->level] = field;
932
while (iter->field->array)
933
iter_push_array(iter);
935
int array_member_offset = iter_array_offset_bits(iter);
937
iter->start_bit = array_member_offset + iter->field->start;
938
iter->end_bit = array_member_offset + iter->field->end;
939
iter->struct_desc = NULL;
943
iter_advance_array(struct intel_field_iterator *iter)
945
assert(iter->level > 0);
946
int lvl = iter->level;
948
if (iter->group->variable)
949
iter->array_iter[lvl]++;
951
if ((iter->array_iter[lvl] + 1) < iter->group->array_count) {
952
iter->array_iter[lvl]++;
956
iter_start_field(iter, iter->group->fields);
960
iter_more_array_elems(const struct intel_field_iterator *iter)
962
int lvl = iter->level;
965
if (iter->group->variable) {
966
int length = intel_group_get_length(iter->group, iter->p);
967
assert(length >= 0 && "error the length is unknown!");
968
return iter_array_offset_bits(iter) + iter->group->array_item_size <
971
return (iter->array_iter[lvl] + 1) < iter->group->array_count;
976
iter_advance_field(struct intel_field_iterator *iter)
978
/* Keep looping while we either have more fields to look at, or we are
979
* inside a <group> and can go up a level.
981
while (iter_more_fields(iter) || iter->level > 0) {
982
if (iter_more_fields(iter)) {
983
iter_start_field(iter, iter->field->next);
987
assert(iter->level >= 0);
989
if (iter_more_array_elems(iter)) {
990
iter_advance_array(iter);
994
/* At this point, we reached the end of the <group> and were on the last
995
* iteration. So it's time to go back to the parent and then advance the
998
iter_pop_array(iter);
1005
iter_decode_field_raw(struct intel_field_iterator *iter, uint64_t *qw)
1009
int field_start = iter->p_bit + iter->start_bit;
1010
int field_end = iter->p_bit + iter->end_bit;
1012
const uint32_t *p = iter->p + (iter->start_bit / 32);
1013
if (iter->p_end && p >= iter->p_end)
1016
if ((field_end - field_start) > 32) {
1017
if (!iter->p_end || (p + 1) < iter->p_end)
1018
*qw = ((uint64_t) p[1]) << 32;
1023
*qw = field_value(*qw, field_start, field_end);
1025
/* Address & offset types have to be aligned to dwords, their start bit is
1026
* a reminder of the alignment requirement.
1028
if (iter->field->type.kind == INTEL_TYPE_ADDRESS ||
1029
iter->field->type.kind == INTEL_TYPE_OFFSET)
1030
*qw <<= field_start % 32;
1036
iter_decode_field(struct intel_field_iterator *iter)
1043
if (iter->field->name)
1044
snprintf(iter->name, sizeof(iter->name), "%s", iter->field->name);
1046
memset(iter->name, 0, sizeof(iter->name));
1048
memset(&v, 0, sizeof(v));
1050
if (!iter_decode_field_raw(iter, &iter->raw_value))
1053
const char *enum_name = NULL;
1055
v.qw = iter->raw_value;
1056
switch (iter->field->type.kind) {
1057
case INTEL_TYPE_UNKNOWN:
1058
case INTEL_TYPE_INT: {
1059
snprintf(iter->value, sizeof(iter->value), "%"PRId64, v.qw);
1060
enum_name = intel_get_enum_name(&iter->field->inline_enum, v.qw);
1063
case INTEL_TYPE_MBZ:
1064
case INTEL_TYPE_UINT: {
1065
snprintf(iter->value, sizeof(iter->value), "%"PRIu64, v.qw);
1066
enum_name = intel_get_enum_name(&iter->field->inline_enum, v.qw);
1069
case INTEL_TYPE_BOOL: {
1070
const char *true_string =
1071
iter->print_colors ? "\e[0;35mtrue\e[0m" : "true";
1072
snprintf(iter->value, sizeof(iter->value), "%s",
1073
v.qw ? true_string : "false");
1076
case INTEL_TYPE_FLOAT:
1077
snprintf(iter->value, sizeof(iter->value), "%f", v.f);
1079
case INTEL_TYPE_ADDRESS:
1080
case INTEL_TYPE_OFFSET:
1081
snprintf(iter->value, sizeof(iter->value), "0x%08"PRIx64, v.qw);
1083
case INTEL_TYPE_STRUCT:
1084
snprintf(iter->value, sizeof(iter->value), "<struct %s>",
1085
iter->field->type.intel_struct->name);
1087
intel_spec_find_struct(iter->group->spec,
1088
iter->field->type.intel_struct->name);
1090
case INTEL_TYPE_UFIXED:
1091
snprintf(iter->value, sizeof(iter->value), "%f",
1092
(float) v.qw / (1 << iter->field->type.f));
1094
case INTEL_TYPE_SFIXED: {
1095
/* Sign extend before converting */
1096
int bits = iter->field->type.i + iter->field->type.f + 1;
1097
int64_t v_sign_extend = ((int64_t)(v.qw << (64 - bits))) >> (64 - bits);
1098
snprintf(iter->value, sizeof(iter->value), "%f",
1099
(float) v_sign_extend / (1 << iter->field->type.f));
1102
case INTEL_TYPE_MBO:
1104
case INTEL_TYPE_ENUM: {
1105
snprintf(iter->value, sizeof(iter->value), "%"PRId64, v.qw);
1106
enum_name = intel_get_enum_name(iter->field->type.intel_enum, v.qw);
1111
if (strlen(iter->group->name) == 0) {
1112
int length = strlen(iter->name);
1113
assert(iter->level >= 0);
1116
char *buf = iter->name + length;
1117
while (level <= iter->level) {
1118
int printed = snprintf(buf, sizeof(iter->name) - length,
1119
"[%i]", iter->array_iter[level]);
1127
int length = strlen(iter->value);
1128
snprintf(iter->value + length, sizeof(iter->value) - length,
1129
" (%s)", enum_name);
1130
} else if (strcmp(iter->name, "Surface Format") == 0 ||
1131
strcmp(iter->name, "Source Element Format") == 0) {
1132
if (isl_format_is_valid((enum isl_format)v.qw)) {
1133
const char *fmt_name = isl_format_get_name((enum isl_format)v.qw);
1134
int length = strlen(iter->value);
1135
snprintf(iter->value + length, sizeof(iter->value) - length,
1144
intel_field_iterator_init(struct intel_field_iterator *iter,
1145
struct intel_group *group,
1146
const uint32_t *p, int p_bit,
1149
memset(iter, 0, sizeof(*iter));
1151
iter->groups[iter->level] = group;
1152
iter->group = group;
1154
iter->p_bit = p_bit;
1156
int length = intel_group_get_length(iter->group, iter->p);
1157
assert(length >= 0 && "error the length is unknown!");
1158
iter->p_end = length >= 0 ? &p[length] : NULL;
1159
iter->print_colors = print_colors;
1163
intel_field_iterator_next(struct intel_field_iterator *iter)
1165
/* Initial condition */
1167
if (iter->group->fields)
1168
iter_start_field(iter, iter->group->fields);
1170
bool result = iter_decode_field(iter);
1171
if (!result && iter->p_end) {
1172
/* We're dealing with a non empty struct of length=0 (BLEND_STATE on
1175
assert(iter->group->dw_length == 0);
1181
if (!iter_advance_field(iter))
1184
if (!iter_decode_field(iter))
1191
print_dword_header(FILE *outfile,
1192
struct intel_field_iterator *iter,
1193
uint64_t offset, uint32_t dword)
1195
fprintf(outfile, "0x%08"PRIx64": 0x%08x : Dword %d\n",
1196
offset + 4 * dword, iter->p[dword], dword);
1200
intel_field_is_header(struct intel_field *field)
1204
/* Instructions are identified by the first DWord. */
1205
if (field->start >= 32 ||
1209
bits = (1ULL << (field->end - field->start + 1)) - 1;
1210
bits <<= field->start;
1212
return (field->parent->opcode_mask & bits) != 0;
1216
intel_print_group(FILE *outfile, struct intel_group *group, uint64_t offset,
1217
const uint32_t *p, int p_bit, bool color)
1219
struct intel_field_iterator iter;
1220
int last_dword = -1;
1222
intel_field_iterator_init(&iter, group, p, p_bit, color);
1223
while (intel_field_iterator_next(&iter)) {
1224
int iter_dword = iter.end_bit / 32;
1225
if (last_dword != iter_dword) {
1226
for (int i = last_dword + 1; i <= iter_dword; i++)
1227
print_dword_header(outfile, &iter, offset, i);
1228
last_dword = iter_dword;
1230
if (!intel_field_is_header(iter.field)) {
1231
fprintf(outfile, " %s: %s\n", iter.name, iter.value);
1232
if (iter.struct_desc) {
1233
int struct_dword = iter.start_bit / 32;
1234
uint64_t struct_offset = offset + 4 * struct_dword;
1235
intel_print_group(outfile, iter.struct_desc, struct_offset,
1236
&p[struct_dword], iter.start_bit % 32, color);