v3d: Add a separate flag for CLIF ABI output versus human-readable CLs.
[mesa.git] / src / broadcom / clif / clif_private.h
1 /*
2 * Copyright © 2016-2018 Broadcom
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
24 #ifndef CLIF_PRIVATE_H
25 #define CLIF_PRIVATE_H
26
27 #include <stdint.h>
28 #include <stdarg.h>
29 #include "util/list.h"
30
31 struct clif_bo {
32 const char *name;
33 uint32_t offset;
34 uint32_t size;
35 void *vaddr;
36 };
37
38 struct clif_dump {
39 const struct v3d_device_info *devinfo;
40 FILE *out;
41
42 struct v3d_spec *spec;
43
44 /* List of struct reloc_worklist_entry */
45 struct list_head worklist;
46
47 struct clif_bo *bo;
48 int bo_count;
49 int bo_array_size;
50
51 /**
52 * Flag to switch from CLIF ABI to slightly more human-readable
53 * output.
54 */
55 bool pretty;
56 };
57
58 enum reloc_worklist_type {
59 reloc_cl,
60 reloc_gl_shader_state,
61 reloc_generic_tile_list,
62 };
63
64 struct reloc_worklist_entry {
65 struct list_head link;
66
67 enum reloc_worklist_type type;
68 uint32_t addr;
69
70 union {
71 struct {
72 uint32_t end;
73 } cl;
74 struct {
75 uint32_t num_attrs;
76 } shader_state;
77 struct {
78 uint32_t end;
79 } generic_tile_list;
80 };
81 };
82
83 struct clif_bo *
84 clif_lookup_bo(struct clif_dump *clif, uint32_t addr);
85
86 struct reloc_worklist_entry *
87 clif_dump_add_address_to_worklist(struct clif_dump *clif,
88 enum reloc_worklist_type type,
89 uint32_t addr);
90
91 bool v3d33_clif_dump_packet(struct clif_dump *clif, uint32_t offset,
92 const uint8_t *cl, uint32_t *size);
93 bool v3d41_clif_dump_packet(struct clif_dump *clif, uint32_t offset,
94 const uint8_t *cl, uint32_t *size);
95 bool v3d42_clif_dump_packet(struct clif_dump *clif, uint32_t offset,
96 const uint8_t *cl, uint32_t *size);
97
98 static inline void
99 out(struct clif_dump *clif, const char *fmt, ...)
100 {
101 va_list args;
102
103 va_start(args, fmt);
104 vfprintf(clif->out, fmt, args);
105 va_end(args);
106 }
107
108 #endif /* CLIF_PRIVATE_H */