blob: e99d7bc5718839ef36b3ffa7d2a9ff2ae9eb6805 [file] [log] [blame]
Tobin Ehlis3ed06942014-11-10 16:03:19 -07001#!/usr/bin/env python3
2#
3# XGL
4#
5# Copyright (C) 2014 LunarG, Inc.
6#
7# Permission is hereby granted, free of charge, to any person obtaining a
8# copy of this software and associated documentation files (the "Software"),
9# to deal in the Software without restriction, including without limitation
10# the rights to use, copy, modify, merge, publish, distribute, sublicense,
11# and/or sell copies of the Software, and to permit persons to whom the
12# Software is furnished to do so, subject to the following conditions:
13#
14# The above copyright notice and this permission notice shall be included
15# in all copies or substantial portions of the Software.
16#
17# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
22# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
23# DEALINGS IN THE SOFTWARE.
Tobin Ehlisee33fa52014-10-22 15:13:53 -060024import argparse
25import os
26import sys
27
28# code_gen.py overview
29# This script generates code based on input headers
30# Initially it's intended to support Mantle and XGL headers and
31# generate wrappers functions that can be used to display
32# structs in a human-readable txt format, as well as utility functions
33# to print enum values as strings
34
35
36def handle_args():
37 parser = argparse.ArgumentParser(description='Perform analysis of vogl trace.')
38 parser.add_argument('input_file', help='The input header file from which code will be generated.')
39 parser.add_argument('--rel_out_dir', required=False, default='glave_gen', help='Path relative to exec path to write output files. Will be created if needed.')
40 parser.add_argument('--abs_out_dir', required=False, default=None, help='Absolute path to write output files. Will be created if needed.')
41 parser.add_argument('--gen_enum_string_helper', required=False, action='store_true', default=False, help='Enable generation of helper header file to print string versions of enums.')
42 parser.add_argument('--gen_struct_wrappers', required=False, action='store_true', default=False, help='Enable generation of struct wrapper classes.')
43 parser.add_argument('--gen_cmake', required=False, action='store_true', default=False, help='Enable generation of cmake file for generated code.')
44 parser.add_argument('--gen_graphviz', required=False, action='store_true', default=False, help='Enable generation of graphviz dot file.')
45 #parser.add_argument('--test', action='store_true', default=False, help='Run simple test.')
46 return parser.parse_args()
47
48# TODO : Ideally these data structs would be opaque to user and could be wrapped
49# in their own class(es) to make them friendly for data look-up
50# Dicts for Data storage
51# enum_val_dict[value_name] = dict keys are the string enum value names for all enums
52# |-------->['type'] = the type of enum class into which the value falls
53# |-------->['val'] = the value assigned to this particular value_name
54# '-------->['unique'] = bool designating if this enum 'val' is unique within this enum 'type'
55enum_val_dict = {}
56# enum_type_dict['type'] = the type or class of of enum
57# '----->['val_name1', 'val_name2'...] = each type references a list of val_names within this type
58enum_type_dict = {}
59# struct_dict['struct_basename'] = the base (non-typedef'd) name of the struct
60# |->[<member_num>] = members are stored via their integer placement in the struct
61# | |->['name'] = string name of this struct member
62# ... |->['full_type'] = complete type qualifier for this member
63# |->['type'] = base type for this member
64# |->['ptr'] = bool indicating if this member is ptr
65# |->['const'] = bool indicating if this member is const
66# |->['struct'] = bool indicating if this member is a struct type
67# |->['array'] = bool indicating if this member is an array
68# '->['array_size'] = int indicating size of array members (0 by default)
69struct_dict = {}
70# typedef_fwd_dict stores mapping from orig_type_name -> new_type_name
71typedef_fwd_dict = {}
72# typedef_rev_dict stores mapping from new_type_name -> orig_type_name
73typedef_rev_dict = {} # store new_name -> orig_name mapping
74# types_dict['id_name'] = identifier name will map to it's type
75# '---->'type' = currently either 'struct' or 'enum'
76types_dict = {} # store orig_name -> type mapping
77
78
79# Class that parses header file and generates data structures that can
80# Then be used for other tasks
81class HeaderFileParser:
82 def __init__(self, header_file=None):
83 self.header_file = header_file
84 # store header data in various formats, see above for more info
85 self.enum_val_dict = {}
86 self.enum_type_dict = {}
87 self.struct_dict = {}
88 self.typedef_fwd_dict = {}
89 self.typedef_rev_dict = {}
90 self.types_dict = {}
91
92 def setHeaderFile(self, header_file):
93 self.header_file = header_file
94
95 def get_enum_val_dict(self):
96 return self.enum_val_dict
97
98 def get_enum_type_dict(self):
99 return self.enum_type_dict
100
101 def get_struct_dict(self):
102 return self.struct_dict
103
104 def get_typedef_fwd_dict(self):
105 return self.typedef_fwd_dict
106
107 def get_typedef_rev_dict(self):
108 return self.typedef_rev_dict
109
110 def get_types_dict(self):
111 return self.types_dict
112
113 # Parse header file into data structures
114 def parse(self):
115 # parse through the file, identifying different sections
116 parse_enum = False
117 parse_struct = False
118 member_num = 0
119 # TODO : Comment parsing is very fragile but handles 2 known files
120 block_comment = False
121 with open(self.header_file) as f:
122 for line in f:
123 if block_comment:
124 if '*/' in line:
125 block_comment = False
126 continue
127 if '/*' in line:
128 block_comment = True
129 elif 0 == len(line.split()):
130 #print("Skipping empty line")
131 continue
132 elif line.split()[0].strip().startswith("//"):
133 #print("Skipping commentted line %s" % line)
134 continue
135 elif 'typedef enum' in line:
136 (ty_txt, en_txt, base_type) = line.strip().split(None, 2)
137 #print("Found ENUM type %s" % base_type)
138 parse_enum = True
139 self.types_dict[base_type] = 'enum'
140 elif 'typedef struct' in line:
141 (ty_txt, st_txt, base_type) = line.strip().split(None, 2)
142 #print("Found STRUCT type: %s" % base_type)
143 parse_struct = True
144 self.types_dict[base_type] = 'struct'
145 elif '}' in line and (parse_enum or parse_struct):
146 if len(line.split()) > 1: # deals with embedded union in one struct
147 parse_enum = False
148 parse_struct = False
149 member_num = 0
150 # TODO : Can pull target of typedef here for remapping
151 (cur_char, targ_type) = line.strip().split(None, 1)
152 self.typedef_fwd_dict[base_type] = targ_type.strip(';')
153 self.typedef_rev_dict[targ_type.strip(';')] = base_type
154 elif parse_enum:
155 if '=' in line:
156 self._add_enum(line, base_type)
157 elif parse_struct:
158 if ';' in line:
159 self._add_struct(line, base_type, member_num)
160 member_num = member_num + 1
161 #elif '(' in line:
162 #print("Function: %s" % line)
163
164 # populate enum dicts based on enum lines
165 def _add_enum(self, line_txt, enum_type):
166 #print("Parsing enum line %s" % line_txt)
167 (enum_name, eq_char, enum_val) = line_txt.split(None, 2)
168 if '=' != eq_char:
169 print("ERROR: Couldn't parse enum line: %s" % line_txt)
170 self.enum_val_dict[enum_name] = {}
171 self.enum_val_dict[enum_name]['type'] = enum_type
172 # strip comma and comment, then extra split in case of no comma w/ comments
173 enum_val = enum_val.strip().split(',', 1)[0]
174 self.enum_val_dict[enum_name]['val'] = enum_val.split()[0]
Tobin Ehlis5e848502014-12-05 12:13:07 -0700175 # account for negative values surrounded by parens
176 self.enum_val_dict[enum_name]['val'] = self.enum_val_dict[enum_name]['val'].strip(')').replace('-(', '-')
177 # Try to cast to int to determine if enum value is unique
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600178 try:
179 #print("ENUM val:", self.enum_val_dict[enum_name]['val'])
180 int(self.enum_val_dict[enum_name]['val'], 0)
181 self.enum_val_dict[enum_name]['unique'] = True
182 #print("ENUM has num value")
183 except ValueError:
184 self.enum_val_dict[enum_name]['unique'] = False
185 #print("ENUM is not a number value")
186 # Update enum_type_dict as well
187 if not enum_type in self.enum_type_dict:
188 self.enum_type_dict[enum_type] = []
189 self.enum_type_dict[enum_type].append(enum_name)
190
191 # populate struct dicts based on struct lines
192 # TODO : Handle ":" bitfield, "**" ptr->ptr and "const type*const*"
193 def _add_struct(self, line_txt, struct_type, num):
194 #print("Parsing struct line %s" % line_txt)
195 if not struct_type in self.struct_dict:
196 self.struct_dict[struct_type] = {}
197 members = line_txt.strip().split(';', 1)[0] # first strip semicolon & comments
198 # TODO : Handle bitfields more correctly
199 members = members.strip().split(':', 1)[0] # strip bitfield element
200 (member_type, member_name) = members.rsplit(None, 1)
201 self.struct_dict[struct_type][num] = {}
202 self.struct_dict[struct_type][num]['full_type'] = member_type
203 if '*' in member_type:
204 self.struct_dict[struct_type][num]['ptr'] = True
205 member_type = member_type.strip('*')
206 else:
207 self.struct_dict[struct_type][num]['ptr'] = False
208 if 'const' in member_type:
209 self.struct_dict[struct_type][num]['const'] = True
210 member_type = member_type.strip('const').strip()
211 else:
212 self.struct_dict[struct_type][num]['const'] = False
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700213 # TODO : There is a bug here where it seems that at the time we do this check,
214 # the data is not in the types or typedef_rev_dict, so we never pass this if check
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600215 if is_type(member_type, 'struct'):
216 self.struct_dict[struct_type][num]['struct'] = True
217 else:
218 self.struct_dict[struct_type][num]['struct'] = False
219 self.struct_dict[struct_type][num]['type'] = member_type
220 if '[' in member_name:
221 (member_name, array_size) = member_name.split('[', 1)
222 self.struct_dict[struct_type][num]['array'] = True
223 self.struct_dict[struct_type][num]['array_size'] = array_size.strip(']')
224 else:
225 self.struct_dict[struct_type][num]['array'] = False
226 self.struct_dict[struct_type][num]['array_size'] = 0
227 self.struct_dict[struct_type][num]['name'] = member_name
228
229# check if given identifier if of specified type_to_check
230def is_type(identifier, type_to_check):
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600231 if identifier in types_dict and type_to_check == types_dict[identifier]:
232 return True
233 if identifier in typedef_rev_dict:
234 new_id = typedef_rev_dict[identifier]
235 if new_id in types_dict and type_to_check == types_dict[new_id]:
236 return True
237 return False
238
239# This is a validation function to verify that we can reproduce the original structs
240def recreate_structs():
241 for struct_name in struct_dict:
242 sys.stdout.write("typedef struct %s\n{\n" % struct_name)
243 for mem_num in sorted(struct_dict[struct_name]):
244 sys.stdout.write(" ")
245 if struct_dict[struct_name][mem_num]['const']:
246 sys.stdout.write("const ")
247 #if struct_dict[struct_name][mem_num]['struct']:
248 # sys.stdout.write("struct ")
249 sys.stdout.write (struct_dict[struct_name][mem_num]['type'])
250 if struct_dict[struct_name][mem_num]['ptr']:
251 sys.stdout.write("*")
252 sys.stdout.write(" ")
253 sys.stdout.write(struct_dict[struct_name][mem_num]['name'])
254 if struct_dict[struct_name][mem_num]['array']:
255 sys.stdout.write("[")
256 sys.stdout.write(struct_dict[struct_name][mem_num]['array_size'])
257 sys.stdout.write("]")
258 sys.stdout.write(";\n")
259 sys.stdout.write("} ")
260 sys.stdout.write(typedef_fwd_dict[struct_name])
261 sys.stdout.write(";\n\n")
262
263# class for writing common file elements
264# Here's how this class lays out a file:
265# COPYRIGHT
266# HEADER
267# BODY
268# FOOTER
269#
270# For each of these sections, there's a "set*" function
271# The class as a whole has a generate function which will write each section in order
272class CommonFileGen:
273 def __init__(self, filename=None, copyright_txt="", header_txt="", body_txt="", footer_txt=""):
274 self.filename = filename
275 self.contents = {'copyright': copyright_txt, 'header': header_txt, 'body': body_txt, 'footer': footer_txt}
276 # TODO : Set a default copyright & footer at least
277
278 def setFilename(self, filename):
279 self.filename = filename
280
281 def setCopyright(self, c):
282 self.contents['copyright'] = c
283
284 def setHeader(self, h):
285 self.contents['header'] = h
286
287 def setBody(self, b):
288 self.contents['body'] = b
289
290 def setFooter(self, f):
291 self.contents['footer'] = f
292
293 def generate(self):
294 #print("Generate to file %s" % self.filename)
295 with open(self.filename, "w") as f:
296 f.write(self.contents['copyright'])
297 f.write(self.contents['header'])
298 f.write(self.contents['body'])
299 f.write(self.contents['footer'])
300
301# class for writing a wrapper class for structures
302# The wrapper class wraps the structs and includes utility functions for
303# setting/getting member values and displaying the struct data in various formats
304class StructWrapperGen:
305 def __init__(self, in_struct_dict, prefix, out_dir):
306 self.struct_dict = in_struct_dict
307 self.include_headers = []
308 self.api = prefix
309 self.header_filename = os.path.join(out_dir, self.api+"_struct_wrappers.h")
310 self.class_filename = os.path.join(out_dir, self.api+"_struct_wrappers.cpp")
311 self.string_helper_filename = os.path.join(out_dir, self.api+"_struct_string_helper.h")
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700312 self.string_helper_no_addr_filename = os.path.join(out_dir, self.api+"_struct_string_helper_no_addr.h")
313 self.no_addr = False
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600314 self.hfg = CommonFileGen(self.header_filename)
315 self.cfg = CommonFileGen(self.class_filename)
316 self.shg = CommonFileGen(self.string_helper_filename)
317 #print(self.header_filename)
318 self.header_txt = ""
319 self.definition_txt = ""
320
321 def set_include_headers(self, include_headers):
322 self.include_headers = include_headers
323
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700324 def set_no_addr(self, no_addr):
325 self.no_addr = no_addr
326 if self.no_addr:
327 self.shg = CommonFileGen(self.string_helper_no_addr_filename)
328 else:
329 self.shg = CommonFileGen(self.string_helper_filename)
330
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600331 # Return class name for given struct name
332 def get_class_name(self, struct_name):
333 class_name = struct_name.strip('_').lower() + "_struct_wrapper"
334 return class_name
335
336 def get_file_list(self):
337 return [os.path.basename(self.header_filename), os.path.basename(self.class_filename), os.path.basename(self.string_helper_filename)]
338
339 # Generate class header file
340 def generateHeader(self):
341 self.hfg.setCopyright(self._generateCopyright())
342 self.hfg.setHeader(self._generateHeader())
343 self.hfg.setBody(self._generateClassDeclaration())
344 self.hfg.setFooter(self._generateFooter())
345 self.hfg.generate()
346
347 # Generate class definition
348 def generateBody(self):
349 self.cfg.setCopyright(self._generateCopyright())
350 self.cfg.setHeader(self._generateCppHeader())
351 self.cfg.setBody(self._generateClassDefinition())
352 self.cfg.setFooter(self._generateFooter())
353 self.cfg.generate()
354
355 # Generate c-style .h file that contains functions for printing structs
356 def generateStringHelper(self):
357 print("Generating struct string helper")
358 self.shg.setCopyright(self._generateCopyright())
359 self.shg.setHeader(self._generateStringHelperHeader())
360 self.shg.setBody(self._generateStringHelperFunctions())
361 self.shg.generate()
362
363 def _generateCopyright(self):
364 return "//This is the copyright\n"
365
366 def _generateCppHeader(self):
367 header = []
368 header.append("//#includes, #defines, globals and such...\n")
Tobin Ehlis3ed06942014-11-10 16:03:19 -0700369 header.append("#include <stdio.h>\n#include <%s>\n#include <%s_enum_string_helper.h>\n" % (os.path.basename(self.header_filename), self.api))
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600370 return "".join(header)
371
372 def _generateClassDefinition(self):
373 class_def = []
374 if 'xgl' == self.api: # Mantle doesn't have pNext to worry about
375 class_def.append(self._generateDynamicPrintFunctions())
376 for s in self.struct_dict:
377 class_def.append("\n// %s class definition" % self.get_class_name(s))
378 class_def.append(self._generateConstructorDefinitions(s))
379 class_def.append(self._generateDestructorDefinitions(s))
380 class_def.append(self._generateDisplayDefinitions(s))
381 return "\n".join(class_def)
382
383 def _generateConstructorDefinitions(self, s):
384 con_defs = []
385 con_defs.append("%s::%s() : m_struct(), m_indent(0), m_dummy_prefix('\\0'), m_origStructAddr(NULL) {}" % (self.get_class_name(s), self.get_class_name(s)))
386 # TODO : This is a shallow copy of ptrs
387 con_defs.append("%s::%s(%s* pInStruct) : m_indent(0), m_dummy_prefix('\\0')\n{\n m_struct = *pInStruct;\n m_origStructAddr = pInStruct;\n}" % (self.get_class_name(s), self.get_class_name(s), typedef_fwd_dict[s]))
388 con_defs.append("%s::%s(const %s* pInStruct) : m_indent(0), m_dummy_prefix('\\0')\n{\n m_struct = *pInStruct;\n m_origStructAddr = pInStruct;\n}" % (self.get_class_name(s), self.get_class_name(s), typedef_fwd_dict[s]))
389 return "\n".join(con_defs)
390
391 def _generateDestructorDefinitions(self, s):
392 return "%s::~%s() {}" % (self.get_class_name(s), self.get_class_name(s))
393
394 def _generateDynamicPrintFunctions(self):
395 dp_funcs = []
396 dp_funcs.append("\nvoid dynamic_display_full_txt(const XGL_VOID* pStruct, uint32_t indent)\n{\n // Cast to APP_INFO ptr initially just to pull sType off struct")
397 dp_funcs.append(" XGL_STRUCTURE_TYPE sType = ((XGL_APPLICATION_INFO*)pStruct)->sType;\n")
398 dp_funcs.append(" switch (sType)\n {")
399 for e in enum_type_dict:
400 class_num = 0
401 if "_STRUCTURE_TYPE" in e:
402 for v in sorted(enum_type_dict[e]):
403 struct_name = v.replace("_STRUCTURE_TYPE", "")
404 class_name = self.get_class_name(struct_name)
405 # TODO : Hand-coded fixes for some exceptions
406 if 'XGL_PIPELINE_CB_STATE_CREATE_INFO' in struct_name:
407 struct_name = 'XGL_PIPELINE_CB_STATE'
408 elif 'XGL_SEMAPHORE_CREATE_INFO' in struct_name:
409 struct_name = 'XGL_QUEUE_SEMAPHORE_CREATE_INFO'
410 class_name = self.get_class_name(struct_name)
411 elif 'XGL_SEMAPHORE_OPEN_INFO' in struct_name:
412 struct_name = 'XGL_QUEUE_SEMAPHORE_OPEN_INFO'
413 class_name = self.get_class_name(struct_name)
414 instance_name = "swc%i" % class_num
415 dp_funcs.append(" case %s:\n {" % (v))
416 dp_funcs.append(" %s %s((%s*)pStruct);" % (class_name, instance_name, struct_name))
417 dp_funcs.append(" %s.set_indent(indent);" % (instance_name))
418 dp_funcs.append(" %s.display_full_txt();" % (instance_name))
419 dp_funcs.append(" }")
420 dp_funcs.append(" break;")
421 class_num += 1
422 dp_funcs.append(" }")
423 dp_funcs.append("}\n")
424 return "\n".join(dp_funcs)
425
426 def _get_sh_func_name(self, struct):
427 return "%s_print_%s" % (self.api, struct.lower().strip("_"))
428
429 # Return elements to create formatted string for given struct member
430 def _get_struct_print_formatted(self, struct_member, pre_var_name="prefix", postfix = "\\n", struct_var_name="pStruct", struct_ptr=True, print_array=False):
431 struct_op = "->"
432 if not struct_ptr:
433 struct_op = "."
434 member_name = struct_member['name']
435 print_type = "p"
436 cast_type = ""
437 member_post = ""
438 array_index = ""
439 member_print_post = ""
440 if struct_member['array'] and 'CHAR' in struct_member['type']: # just print char array as string
441 print_type = "s"
442 print_array = False
443 elif struct_member['array'] and not print_array:
444 # Just print base address of array when not full print_array
445 cast_type = "(void*)"
446 elif is_type(struct_member['type'], 'enum'):
447 cast_type = "string_%s" % struct_member['type']
448 print_type = "s"
449 elif is_type(struct_member['type'], 'struct'): # print struct address for now
450 cast_type = "(void*)"
451 if not struct_member['ptr']:
452 cast_type = "(void*)&"
453 elif 'BOOL' in struct_member['type']:
454 print_type = "s"
455 member_post = ' ? "TRUE" : "FALSE"'
456 elif 'FLOAT' in struct_member['type']:
457 print_type = "f"
458 elif 'UINT64' in struct_member['type']:
459 print_type = "lu"
460 elif 'UINT8' in struct_member['type']:
461 print_type = "hu"
Chia-I Wu54ed0792014-12-27 14:14:50 +0800462 elif '_SIZE' in struct_member['type']:
463 print_type = "zu"
464 elif True in [ui_str in struct_member['type'] for ui_str in ['UINT', '_FLAGS', '_SAMPLE_MASK']]:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600465 print_type = "u"
466 elif 'INT' in struct_member['type']:
467 print_type = "i"
468 elif struct_member['ptr']:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600469 pass
470 else:
471 #print("Unhandled struct type: %s" % struct_member['type'])
472 cast_type = "(void*)"
473 if print_array and struct_member['array']:
474 member_print_post = "[%u]"
475 array_index = " i,"
476 member_post = "[i]"
477 print_out = "%%s%s%s = %%%s%s" % (member_name, member_print_post, print_type, postfix) # section of print that goes inside of quotes
478 print_arg = ", %s,%s %s(%s%s%s)%s" % (pre_var_name, array_index, cast_type, struct_var_name, struct_op, member_name, member_post) # section of print passed to portion in quotes
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700479 if self.no_addr and "p" == print_type:
480 print_out = "%%s%s%s = addr\\n" % (member_name, member_print_post) # section of print that goes inside of quotes
481 print_arg = ", %s" % (pre_var_name)
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600482 return (print_out, print_arg)
483
484 def _generateStringHelperFunctions(self):
485 sh_funcs = []
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700486 # We do two passes, first pass just generates prototypes for all the functsions
487 for s in self.struct_dict:
488 sh_funcs.append('char* %s(const %s* pStruct, const char* prefix);\n' % (self._get_sh_func_name(s), typedef_fwd_dict[s]))
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700489 sh_funcs.append('\n')
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600490 for s in self.struct_dict:
491 p_out = ""
492 p_args = ""
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700493 stp_list = [] # stp == "struct to print" a list of structs for this API call that should be printed as structs
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600494 # This isn't great but this pre-pass counts chars in struct members and flags structs w/ pNext
495 struct_char_count = 0 # TODO : Use this to vary size of memory allocations for strings?
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600496 for m in self.struct_dict[s]:
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700497 if 'pNext' == self.struct_dict[s][m]['name'] or is_type(self.struct_dict[s][m]['type'], 'struct'):
498 stp_list.append(self.struct_dict[s][m])
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600499 struct_char_count += len(self.struct_dict[s][m]['name']) + 32
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600500 sh_funcs.append('char* %s(const %s* pStruct, const char* prefix)\n{\n char* str;\n' % (self._get_sh_func_name(s), typedef_fwd_dict[s]))
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700501 sh_funcs.append(" size_t len;\n")
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700502 num_stps = len(stp_list);
503 total_strlen_str = ''
504 if 0 != num_stps:
505 sh_funcs.append(" char* tmpStr;\n")
Courtney Goeltzenleuchter64efe722014-11-18 10:39:30 -0700506 sh_funcs.append(' char* extra_indent = (char*)malloc(strlen(prefix) + 3);\n')
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700507 sh_funcs.append(' strcpy(extra_indent, " ");\n')
508 sh_funcs.append(' strncat(extra_indent, prefix, strlen(prefix));\n')
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700509 sh_funcs.append(' char* stp_strs[%i];\n' % num_stps)
510 for index in range(num_stps):
511 if (stp_list[index]['ptr']):
512 sh_funcs.append(' if (pStruct->%s) {\n' % stp_list[index]['name'])
513 if 'pNext' == stp_list[index]['name']:
Tobin Ehlis08f24042014-11-20 06:38:50 -0700514 sh_funcs.append(' tmpStr = dynamic_display((XGL_VOID*)pStruct->pNext, prefix);\n')
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700515 sh_funcs.append(' len = 256+strlen(tmpStr);\n')
516 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);\n' % index)
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700517 if self.no_addr:
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700518 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%spNext (addr)\\n%%s", prefix, tmpStr);\n' % index)
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700519 else:
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700520 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%spNext (%%p)\\n%%s", prefix, (void*)pStruct->pNext, tmpStr);\n' % index)
Tobin Ehlis08f24042014-11-20 06:38:50 -0700521 sh_funcs.append(' free(tmpStr);\n')
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700522 else:
523 sh_funcs.append(' tmpStr = %s(pStruct->%s, extra_indent);\n' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700524 sh_funcs.append(' len = 256+strlen(tmpStr)+strlen(prefix);\n')
525 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);\n' % (index))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700526 if self.no_addr:
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700527 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s (addr)\\n%%s", prefix, tmpStr);\n' % (index, stp_list[index]['name']))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700528 else:
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700529 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s (%%p)\\n%%s", prefix, (void*)pStruct->%s, tmpStr);\n' % (index, stp_list[index]['name'], stp_list[index]['name']))
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700530 sh_funcs.append(' }\n')
Chia-I Wu81f46672014-12-16 00:36:58 +0800531 sh_funcs.append(" else\n stp_strs[%i] = \"\";\n" % (index))
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700532 elif stp_list[index]['array']: # TODO : For now just printing first element of array
533 sh_funcs.append(' tmpStr = %s(&pStruct->%s[0], extra_indent);\n' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700534 sh_funcs.append(' len = 256+strlen(tmpStr);\n')
535 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);\n' % (index))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700536 if self.no_addr:
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700537 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s[0] (addr)\\n%%s", prefix, tmpStr);\n' % (index, stp_list[index]['name']))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700538 else:
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700539 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s[0] (%%p)\\n%%s", prefix, (void*)&pStruct->%s[0], tmpStr);\n' % (index, stp_list[index]['name'], stp_list[index]['name']))
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700540 else:
541 sh_funcs.append(' tmpStr = %s(&pStruct->%s, extra_indent);\n' % (self._get_sh_func_name(stp_list[index]['type']), stp_list[index]['name']))
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700542 sh_funcs.append(' len = 256+strlen(tmpStr);\n')
543 sh_funcs.append(' stp_strs[%i] = (char*)malloc(len);\n' % (index))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700544 if self.no_addr:
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700545 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s (addr)\\n%%s", prefix, tmpStr);\n' % (index, stp_list[index]['name']))
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -0700546 else:
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700547 sh_funcs.append(' snprintf(stp_strs[%i], len, " %%s%s (%%p)\\n%%s", prefix, (void*)&pStruct->%s, tmpStr);\n' % (index, stp_list[index]['name'], stp_list[index]['name']))
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700548 total_strlen_str += 'strlen(stp_strs[%i]) + ' % index
Courtney Goeltzenleuchtercde421c2014-12-01 09:31:17 -0700549 sh_funcs.append(' len = %ssizeof(char)*1024;\n' % (total_strlen_str))
550 sh_funcs.append(' str = (char*)malloc(len);\n')
551 sh_funcs.append(' snprintf(str, len, "')
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600552 for m in sorted(self.struct_dict[s]):
553 (p_out1, p_args1) = self._get_struct_print_formatted(self.struct_dict[s][m])
554 p_out += p_out1
555 p_args += p_args1
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600556 p_out += '"'
557 p_args += ");\n"
558 sh_funcs.append(p_out)
559 sh_funcs.append(p_args)
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700560 if 0 != num_stps:
Tobin Ehlis08f24042014-11-20 06:38:50 -0700561 sh_funcs.append(' for (int32_t stp_index = %i; stp_index >= 0; stp_index--) {\n' % (num_stps-1))
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700562 sh_funcs.append(' if (0 < strlen(stp_strs[stp_index])) {\n')
563 sh_funcs.append(' strncat(str, stp_strs[stp_index], strlen(stp_strs[stp_index]));\n')
564 sh_funcs.append(' free(stp_strs[stp_index]);\n')
565 sh_funcs.append(' }\n')
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600566 sh_funcs.append(' }\n')
567 sh_funcs.append(" return str;\n}\n")
568 # Add function to dynamically print out unknown struct
569 sh_funcs.append("char* dynamic_display(const XGL_VOID* pStruct, const char* prefix)\n{\n")
570 sh_funcs.append(" // Cast to APP_INFO ptr initially just to pull sType off struct\n")
571 sh_funcs.append(" XGL_STRUCTURE_TYPE sType = ((XGL_APPLICATION_INFO*)pStruct)->sType;\n")
572 sh_funcs.append(' char indent[100];\n strcpy(indent, " ");\n strcat(indent, prefix);\n')
573 sh_funcs.append(" switch (sType)\n {\n")
574 for e in enum_type_dict:
575 if "_STRUCTURE_TYPE" in e:
576 for v in sorted(enum_type_dict[e]):
577 struct_name = v.replace("_STRUCTURE_TYPE", "")
578 print_func_name = self._get_sh_func_name(struct_name)
579 # TODO : Hand-coded fixes for some exceptions
580 if 'XGL_PIPELINE_CB_STATE_CREATE_INFO' in struct_name:
581 struct_name = 'XGL_PIPELINE_CB_STATE'
582 elif 'XGL_SEMAPHORE_CREATE_INFO' in struct_name:
583 struct_name = 'XGL_QUEUE_SEMAPHORE_CREATE_INFO'
584 print_func_name = self._get_sh_func_name(struct_name)
585 elif 'XGL_SEMAPHORE_OPEN_INFO' in struct_name:
586 struct_name = 'XGL_QUEUE_SEMAPHORE_OPEN_INFO'
587 print_func_name = self._get_sh_func_name(struct_name)
588 sh_funcs.append(' case %s:\n {\n' % (v))
589 sh_funcs.append(' return %s((%s*)pStruct, indent);\n' % (print_func_name, struct_name))
590 sh_funcs.append(' }\n')
591 sh_funcs.append(' break;\n')
Chia-I Wu84d7f5c2014-12-16 00:43:20 +0800592 sh_funcs.append(" default:\n")
593 sh_funcs.append(" return NULL;\n")
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600594 sh_funcs.append(" }\n")
595 sh_funcs.append("}")
596 return "".join(sh_funcs)
597
598
599 def _genStructMemberPrint(self, member, s, array, struct_array):
600 (p_out, p_arg) = self._get_struct_print_formatted(self.struct_dict[s][member], pre_var_name="&m_dummy_prefix", struct_var_name="m_struct", struct_ptr=False, print_array=True)
601 extra_indent = ""
602 if array:
603 extra_indent = " "
604 if is_type(self.struct_dict[s][member]['type'], 'struct'): # print struct address for now
605 struct_array.insert(0, self.struct_dict[s][member])
606 elif self.struct_dict[s][member]['ptr']:
607 # Special case for VOID* named "pNext"
608 if "VOID" in self.struct_dict[s][member]['type'] and "pNext" == self.struct_dict[s][member]['name']:
609 struct_array.insert(0, self.struct_dict[s][member])
610 return (' %sprintf("%%*s %s", m_indent, ""%s);' % (extra_indent, p_out, p_arg), struct_array)
611
612 def _generateDisplayDefinitions(self, s):
613 disp_def = []
614 struct_array = []
615 # Single-line struct print function
616 disp_def.append("// Output 'structname = struct_address' on a single line")
617 disp_def.append("void %s::display_single_txt()\n{" % self.get_class_name(s))
618 disp_def.append(' printf(" %%*s%s = %%p", m_indent, "", (void*)m_origStructAddr);' % typedef_fwd_dict[s])
619 disp_def.append("}\n")
620 # Private helper function to print struct members
621 disp_def.append("// Private helper function that displays the members of the wrapped struct")
622 disp_def.append("void %s::display_struct_members()\n{" % self.get_class_name(s))
623 i_declared = False
624 for member in sorted(self.struct_dict[s]):
625 # TODO : Need to display each member based on its type
626 # TODO : Need to handle pNext which are structs, but of XGL_VOID* type
627 # Can grab struct type off of header of struct pointed to
628 # TODO : Handle Arrays
629 if self.struct_dict[s][member]['array']:
630 # Create for loop to print each element of array
631 if not i_declared:
632 disp_def.append(' uint32_t i;')
633 i_declared = True
634 disp_def.append(' for (i = 0; i<%s; i++) {' % self.struct_dict[s][member]['array_size'])
635 (return_str, struct_array) = self._genStructMemberPrint(member, s, True, struct_array)
636 disp_def.append(return_str)
637 disp_def.append(' }')
638 else:
639 (return_str, struct_array) = self._genStructMemberPrint(member, s, False, struct_array)
640 disp_def.append(return_str)
641 disp_def.append("}\n")
642 i_declared = False
643 # Basic print function to display struct members
644 disp_def.append("// Output all struct elements, each on their own line")
645 disp_def.append("void %s::display_txt()\n{" % self.get_class_name(s))
646 disp_def.append(' printf("%%*s%s struct contents at %%p:\\n", m_indent, "", (void*)m_origStructAddr);' % typedef_fwd_dict[s])
647 disp_def.append(' this->display_struct_members();')
648 disp_def.append("}\n")
649 # Advanced print function to display current struct and contents of any pointed-to structs
650 disp_def.append("// Output all struct elements, and for any structs pointed to, print complete contents")
651 disp_def.append("void %s::display_full_txt()\n{" % self.get_class_name(s))
652 disp_def.append(' printf("%%*s%s struct contents at %%p:\\n", m_indent, "", (void*)m_origStructAddr);' % typedef_fwd_dict[s])
653 disp_def.append(' this->display_struct_members();')
654 class_num = 0
655 # TODO : Need to handle arrays of structs here
656 for ms in struct_array:
657 swc_name = "class%s" % str(class_num)
658 if ms['array']:
659 if not i_declared:
660 disp_def.append(' uint32_t i;')
661 i_declared = True
662 disp_def.append(' for (i = 0; i<%s; i++) {' % ms['array_size'])
663 #disp_def.append(" if (m_struct.%s[i]) {" % (ms['name']))
664 disp_def.append(" %s %s(&(m_struct.%s[i]));" % (self.get_class_name(ms['type']), swc_name, ms['name']))
665 disp_def.append(" %s.set_indent(m_indent + 4);" % (swc_name))
666 disp_def.append(" %s.display_full_txt();" % (swc_name))
667 #disp_def.append(' }')
668 disp_def.append(' }')
669 elif 'pNext' == ms['name']:
670 # Need some code trickery here
671 # I'm thinking have a generated function that takes pNext ptr value
672 # then it checks sType and in large switch statement creates appropriate
673 # wrapper class type and then prints contents
674 disp_def.append(" if (m_struct.%s) {" % (ms['name']))
675 #disp_def.append(' printf("%*s This is where we would call dynamic print function\\n", m_indent, "");')
676 disp_def.append(' dynamic_display_full_txt(m_struct.%s, m_indent);' % (ms['name']))
677 disp_def.append(" }")
678 else:
679 if ms['ptr']:
680 disp_def.append(" if (m_struct.%s) {" % (ms['name']))
681 disp_def.append(" %s %s(m_struct.%s);" % (self.get_class_name(ms['type']), swc_name, ms['name']))
682 else:
683 disp_def.append(" if (&m_struct.%s) {" % (ms['name']))
684 disp_def.append(" %s %s(&m_struct.%s);" % (self.get_class_name(ms['type']), swc_name, ms['name']))
685 disp_def.append(" %s.set_indent(m_indent + 4);" % (swc_name))
686 disp_def.append(" %s.display_full_txt();\n }" % (swc_name))
687 class_num += 1
688 disp_def.append("}\n")
689 return "\n".join(disp_def)
690
691 def _generateStringHelperHeader(self):
692 header = []
693 header.append("//#includes, #defines, globals and such...\n")
694 for f in self.include_headers:
Tobin Ehlis3ed06942014-11-10 16:03:19 -0700695 if 'xgl_enum_string_helper' not in f:
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600696 header.append("#include <%s>\n" % f)
Tobin Ehlis6f7029b2014-11-11 12:28:12 -0700697 header.append('#include "xgl_enum_string_helper.h"\n\n// Function Prototypes\n')
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600698 header.append("char* dynamic_display(const XGL_VOID* pStruct, const char* prefix);\n")
699 return "".join(header)
700
701 def _generateHeader(self):
702 header = []
703 header.append("//#includes, #defines, globals and such...\n")
704 for f in self.include_headers:
705 header.append("#include <%s>\n" % f)
706 return "".join(header)
707
708 # Declarations
709 def _generateConstructorDeclarations(self, s):
710 constructors = []
711 constructors.append(" %s();\n" % self.get_class_name(s))
712 constructors.append(" %s(%s* pInStruct);\n" % (self.get_class_name(s), typedef_fwd_dict[s]))
713 constructors.append(" %s(const %s* pInStruct);\n" % (self.get_class_name(s), typedef_fwd_dict[s]))
714 return "".join(constructors)
715
716 def _generateDestructorDeclarations(self, s):
717 return " virtual ~%s();\n" % self.get_class_name(s)
718
719 def _generateDisplayDeclarations(self, s):
720 return " void display_txt();\n void display_single_txt();\n void display_full_txt();\n"
721
722 def _generateGetSetDeclarations(self, s):
723 get_set = []
724 get_set.append(" void set_indent(uint32_t indent) { m_indent = indent; }\n")
725 for member in sorted(self.struct_dict[s]):
726 # TODO : Skipping array set/get funcs for now
727 if self.struct_dict[s][member]['array']:
728 continue
729 get_set.append(" %s get_%s() { return m_struct.%s; }\n" % (self.struct_dict[s][member]['full_type'], self.struct_dict[s][member]['name'], self.struct_dict[s][member]['name']))
730 if not self.struct_dict[s][member]['const']:
731 get_set.append(" void set_%s(%s inValue) { m_struct.%s = inValue; }\n" % (self.struct_dict[s][member]['name'], self.struct_dict[s][member]['full_type'], self.struct_dict[s][member]['name']))
732 return "".join(get_set)
733
734 def _generatePrivateMembers(self, s):
735 priv = []
736 priv.append("\nprivate:\n")
737 priv.append(" %s m_struct;\n" % typedef_fwd_dict[s])
738 priv.append(" const %s* m_origStructAddr;\n" % typedef_fwd_dict[s])
739 priv.append(" uint32_t m_indent;\n")
740 priv.append(" const char m_dummy_prefix;\n")
741 priv.append(" void display_struct_members();\n")
742 return "".join(priv)
743
744 def _generateClassDeclaration(self):
745 class_decl = []
746 for s in self.struct_dict:
747 class_decl.append("\n//class declaration")
748 class_decl.append("class %s\n{\npublic:" % self.get_class_name(s))
749 class_decl.append(self._generateConstructorDeclarations(s))
750 class_decl.append(self._generateDestructorDeclarations(s))
751 class_decl.append(self._generateDisplayDeclarations(s))
752 class_decl.append(self._generateGetSetDeclarations(s))
753 class_decl.append(self._generatePrivateMembers(s))
754 class_decl.append("};\n")
755 return "\n".join(class_decl)
756
757 def _generateFooter(self):
758 return "\n//any footer info for class\n"
759
760class EnumCodeGen:
Tobin Ehlisbe8dded2014-12-17 07:20:23 -0700761 def __init__(self, enum_type_dict=None, enum_val_dict=None, typedef_fwd_dict=None, in_file=None, out_sh_file=None, out_vh_file=None):
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600762 self.et_dict = enum_type_dict
763 self.ev_dict = enum_val_dict
764 self.tf_dict = typedef_fwd_dict
765 self.in_file = in_file
Tobin Ehlisbe8dded2014-12-17 07:20:23 -0700766 self.out_sh_file = out_sh_file
767 self.eshfg = CommonFileGen(self.out_sh_file)
768 self.out_vh_file = out_vh_file
769 self.evhfg = CommonFileGen(self.out_vh_file)
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600770
771 def generateStringHelper(self):
Tobin Ehlisbe8dded2014-12-17 07:20:23 -0700772 self.eshfg.setHeader(self._generateSHHeader())
773 self.eshfg.setBody(self._generateSHBody())
774 self.eshfg.generate()
775
776 def generateEnumValidate(self):
777 self.evhfg.setHeader(self._generateSHHeader())
778 self.evhfg.setHeader(self._generateVHBody())
779 self.evhfg.generate()
780
781 def _generateVHBody(self):
782 body = []
783 for bet in self.et_dict:
784 fet = self.tf_dict[bet]
785 body.append("static uint32_t validate_%s(%s input_value)\n{\n switch ((%s)input_value)\n {" % (fet, fet, fet))
786 for e in sorted(self.et_dict[bet]):
787 if (self.ev_dict[e]['unique']):
788 body.append(' case %s:' % (e))
789 body.append(' return 1;\n default:\n return 0;\n }\n}\n\n')
790 return "\n".join(body)
791
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600792 def _generateSHBody(self):
793 body = []
794# with open(self.out_file, "a") as hf:
795 # bet == base_enum_type, fet == final_enum_type
796 for bet in self.et_dict:
797 fet = self.tf_dict[bet]
Chia-I Wudf142a32014-12-16 11:02:06 +0800798 body.append("static inline const char* string_%s(%s input_value)\n{\n switch ((%s)input_value)\n {\n" % (fet, fet, fet))
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600799 for e in sorted(self.et_dict[bet]):
800 if (self.ev_dict[e]['unique']):
Tobin Ehlisbe8dded2014-12-17 07:20:23 -0700801 body.append(' case %s:\n return "%s";' % (e, e))
802 body.append(' default:\n return "Unhandled %s";\n }\n}\n\n' % (fet))
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600803 return "\n".join(body)
804
805 def _generateSHHeader(self):
806 return "#pragma once\n\n#include <%s>\n\n" % self.in_file
807
808
809class CMakeGen:
810 def __init__(self, struct_wrapper=None, out_dir=None):
811 self.sw = struct_wrapper
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700812 self.include_headers = []
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600813 self.add_lib_file_list = self.sw.get_file_list()
814 self.out_dir = out_dir
815 self.out_file = os.path.join(self.out_dir, "CMakeLists.txt")
816 self.cmg = CommonFileGen(self.out_file)
817
818 def generate(self):
819 self.cmg.setBody(self._generateBody())
820 self.cmg.generate()
821
822 def _generateBody(self):
823 body = []
824 body.append("project(%s)" % os.path.basename(self.out_dir))
825 body.append("cmake_minimum_required(VERSION 2.8)\n")
826 body.append("add_library(${PROJECT_NAME} %s)\n" % " ".join(self.add_lib_file_list))
827 body.append('set(COMPILE_FLAGS "-fpermissive")')
828 body.append('set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${COMPILE_FLAGS}")\n')
829 body.append("include_directories(${SRC_DIR}/thirdparty/${GEN_API}/inc/)\n")
830 body.append("target_include_directories (%s PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})\n" % os.path.basename(self.out_dir))
831 return "\n".join(body)
832
833class GraphVizGen:
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700834 def __init__(self, struct_dict, prefix, out_dir):
835 self.struct_dict = struct_dict
836 self.api = prefix
837 self.out_file = os.path.join(out_dir, self.api+"_struct_graphviz_helper.h")
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600838 self.gvg = CommonFileGen(self.out_file)
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700839
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600840 def generate(self):
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700841 self.gvg.setCopyright("//This is the copyright\n")
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600842 self.gvg.setHeader(self._generateHeader())
843 self.gvg.setBody(self._generateBody())
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700844 #self.gvg.setFooter('}')
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600845 self.gvg.generate()
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700846
847 def set_include_headers(self, include_headers):
848 self.include_headers = include_headers
849
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600850 def _generateHeader(self):
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700851 header = []
852 header.append("//#includes, #defines, globals and such...\n")
853 for f in self.include_headers:
854 if 'xgl_enum_string_helper' not in f:
855 header.append("#include <%s>\n" % f)
856 #header.append('#include "xgl_enum_string_helper.h"\n\n// Function Prototypes\n')
857 header.append("\nchar* dynamic_gv_display(const XGL_VOID* pStruct, const char* prefix);\n")
858 return "".join(header)
859
860 def _get_gv_func_name(self, struct):
861 return "%s_gv_print_%s" % (self.api, struct.lower().strip("_"))
862
863 # Return elements to create formatted string for given struct member
864 def _get_struct_gv_print_formatted(self, struct_member, pre_var_name="", postfix = "\\n", struct_var_name="pStruct", struct_ptr=True, print_array=False, port_label=""):
865 struct_op = "->"
866 pre_var_name = '"%s "' % struct_member['full_type']
867 if not struct_ptr:
868 struct_op = "."
869 member_name = struct_member['name']
870 print_type = "p"
871 cast_type = ""
872 member_post = ""
873 array_index = ""
874 member_print_post = ""
875 if struct_member['array'] and 'CHAR' in struct_member['type']: # just print char array as string
876 print_type = "s"
877 print_array = False
878 elif struct_member['array'] and not print_array:
879 # Just print base address of array when not full print_array
880 cast_type = "(void*)"
881 elif is_type(struct_member['type'], 'enum'):
882 cast_type = "string_%s" % struct_member['type']
883 print_type = "s"
884 elif is_type(struct_member['type'], 'struct'): # print struct address for now
885 cast_type = "(void*)"
886 if not struct_member['ptr']:
887 cast_type = "(void*)&"
888 elif 'BOOL' in struct_member['type']:
889 print_type = "s"
890 member_post = ' ? "TRUE" : "FALSE"'
891 elif 'FLOAT' in struct_member['type']:
892 print_type = "f"
893 elif 'UINT64' in struct_member['type']:
894 print_type = "lu"
895 elif 'UINT8' in struct_member['type']:
896 print_type = "hu"
Chia-I Wu54ed0792014-12-27 14:14:50 +0800897 elif '_SIZE' in struct_member['type']:
898 print_type = "zu"
899 elif True in [ui_str in struct_member['type'] for ui_str in ['UINT', '_FLAGS', '_SAMPLE_MASK']]:
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700900 print_type = "u"
901 elif 'INT' in struct_member['type']:
902 print_type = "i"
903 elif struct_member['ptr']:
904 pass
905 else:
906 #print("Unhandled struct type: %s" % struct_member['type'])
907 cast_type = "(void*)"
908 if print_array and struct_member['array']:
909 member_print_post = "[%u]"
910 array_index = " i,"
911 member_post = "[i]"
912 print_out = "<TR><TD>%%s%s%s</TD><TD%s>%%%s%s</TD></TR>" % (member_name, member_print_post, port_label, print_type, postfix) # section of print that goes inside of quotes
913 print_arg = ", %s,%s %s(%s%s%s)%s" % (pre_var_name, array_index, cast_type, struct_var_name, struct_op, member_name, member_post) # section of print passed to portion in quotes
914 return (print_out, print_arg)
915
Tobin Ehlisee33fa52014-10-22 15:13:53 -0600916 def _generateBody(self):
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700917 gv_funcs = []
918 array_func_list = [] # structs for which we'll generate an array version of their print function
919 array_func_list.append('xgl_descriptor_slot_info')
920 # For first pass, generate prototype
921 for s in self.struct_dict:
922 gv_funcs.append('char* %s(const %s* pStruct, const char* myNodeName);\n' % (self._get_gv_func_name(s), typedef_fwd_dict[s]))
923 if s.lower().strip("_") in array_func_list:
924 gv_funcs.append('char* %s_array(XGL_UINT count, const %s* pStruct, const char* myNodeName);\n' % (self._get_gv_func_name(s), typedef_fwd_dict[s]))
925 gv_funcs.append('\n')
926 for s in self.struct_dict:
927 p_out = ""
928 p_args = ""
929 stp_list = [] # stp == "struct to print" a list of structs for this API call that should be printed as structs
930 # the fields below are a super-hacky way for now to get port labels into GV output, TODO : Clean this up!
931 pl_dict = {}
932 struct_num = 0
933 # This isn't great but this pre-pass counts chars in struct members and flags structs w/ pNext
934 for m in sorted(self.struct_dict[s]):
935 if 'pNext' == self.struct_dict[s][m]['name'] or is_type(self.struct_dict[s][m]['type'], 'struct'):
936 stp_list.append(self.struct_dict[s][m])
937 if 'pNext' == self.struct_dict[s][m]['name']:
938 pl_dict[m] = ' PORT=\\"pNext\\"'
939 else:
940 pl_dict[m] = ' PORT=\\"struct%i\\"' % struct_num
941 struct_num += 1
942 gv_funcs.append('char* %s(const %s* pStruct, const char* myNodeName)\n{\n char* str;\n' % (self._get_gv_func_name(s), typedef_fwd_dict[s]))
943 num_stps = len(stp_list);
944 total_strlen_str = ''
945 if 0 != num_stps:
946 gv_funcs.append(" char* tmpStr;\n")
947 gv_funcs.append(" char nodeName[100];\n")
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700948 gv_funcs.append(' char* stp_strs[%i];\n' % num_stps)
949 for index in range(num_stps):
950 if (stp_list[index]['ptr']):
951 if 'pDescriptorInfo' == stp_list[index]['name']:
952 gv_funcs.append(' if (pStruct->pDescriptorInfo && (0 != pStruct->descriptorCount)) {\n')
953 else:
954 gv_funcs.append(' if (pStruct->%s) {\n' % stp_list[index]['name'])
955 if 'pNext' == stp_list[index]['name']:
956 gv_funcs.append(' sprintf(nodeName, "pNext_%p", (void*)pStruct->pNext);\n')
957 gv_funcs.append(' tmpStr = dynamic_gv_display((XGL_VOID*)pStruct->pNext, nodeName);\n')
958 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % index)
959 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":pNext -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % index)
960 gv_funcs.append(' free(tmpStr);\n')
961 else:
962 gv_funcs.append(' sprintf(nodeName, "%s_%%p", (void*)pStruct->%s);\n' % (stp_list[index]['name'], stp_list[index]['name']))
963 if 'pDescriptorInfo' == stp_list[index]['name']:
964 gv_funcs.append(' tmpStr = %s_array(pStruct->descriptorCount, pStruct->%s, nodeName);\n' % (self._get_gv_func_name(stp_list[index]['type']), stp_list[index]['name']))
965 else:
966 gv_funcs.append(' tmpStr = %s(pStruct->%s, nodeName);\n' % (self._get_gv_func_name(stp_list[index]['type']), stp_list[index]['name']))
967 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % (index))
968 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":struct%i -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % (index, index))
969 gv_funcs.append(' }\n')
Chia-I Wu81f46672014-12-16 00:36:58 +0800970 gv_funcs.append(" else\n stp_strs[%i] = \"\";\n" % (index))
Tobin Ehlisa701ef02014-11-27 15:43:39 -0700971 elif stp_list[index]['array']: # TODO : For now just printing first element of array
972 gv_funcs.append(' sprintf(nodeName, "%s_%%p", (void*)&pStruct->%s[0]);\n' % (stp_list[index]['name'], stp_list[index]['name']))
973 gv_funcs.append(' tmpStr = %s(&pStruct->%s[0], nodeName);\n' % (self._get_gv_func_name(stp_list[index]['type']), stp_list[index]['name']))
974 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % (index))
975 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":struct%i -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % (index, index))
976 else:
977 gv_funcs.append(' sprintf(nodeName, "%s_%%p", (void*)&pStruct->%s);\n' % (stp_list[index]['name'], stp_list[index]['name']))
978 gv_funcs.append(' tmpStr = %s(&pStruct->%s, nodeName);\n' % (self._get_gv_func_name(stp_list[index]['type']), stp_list[index]['name']))
979 gv_funcs.append(' stp_strs[%i] = (char*)malloc(256+strlen(tmpStr)+strlen(nodeName)+strlen(myNodeName));\n' % (index))
980 gv_funcs.append(' sprintf(stp_strs[%i], "%%s\\n\\"%%s\\":struct%i -> \\"%%s\\" [];\\n", tmpStr, myNodeName, nodeName);\n' % (index, index))
981 total_strlen_str += 'strlen(stp_strs[%i]) + ' % index
982 gv_funcs.append(' str = (char*)malloc(%ssizeof(char)*2048);\n' % (total_strlen_str))
983 gv_funcs.append(' sprintf(str, "\\"%s\\" [\\nlabel = <<TABLE BORDER=\\"0\\" CELLBORDER=\\"1\\" CELLSPACING=\\"0\\"><TR><TD COLSPAN=\\"2\\">%s (%p)</TD></TR>')
984 p_args = ", myNodeName, myNodeName, pStruct"
985 for m in sorted(self.struct_dict[s]):
986 plabel = ""
987 if m in pl_dict:
988 plabel = pl_dict[m]
989 (p_out1, p_args1) = self._get_struct_gv_print_formatted(self.struct_dict[s][m], port_label=plabel)
990 p_out += p_out1
991 p_args += p_args1
992 p_out += '</TABLE>>\\n];\\n\\n"'
993 p_args += ");\n"
994 gv_funcs.append(p_out)
995 gv_funcs.append(p_args)
996 if 0 != num_stps:
997 gv_funcs.append(' for (int32_t stp_index = %i; stp_index >= 0; stp_index--) {\n' % (num_stps-1))
998 gv_funcs.append(' if (0 < strlen(stp_strs[stp_index])) {\n')
999 gv_funcs.append(' strncat(str, stp_strs[stp_index], strlen(stp_strs[stp_index]));\n')
1000 gv_funcs.append(' free(stp_strs[stp_index]);\n')
1001 gv_funcs.append(' }\n')
1002 gv_funcs.append(' }\n')
1003 gv_funcs.append(" return str;\n}\n")
1004 if s.lower().strip("_") in array_func_list:
1005 gv_funcs.append('char* %s_array(XGL_UINT count, const %s* pStruct, const char* myNodeName)\n{\n char* str;\n char tmpStr[1024];\n' % (self._get_gv_func_name(s), typedef_fwd_dict[s]))
1006 gv_funcs.append(' str = (char*)malloc(sizeof(char)*1024*count);\n')
1007 gv_funcs.append(' sprintf(str, "\\"%s\\" [\\nlabel = <<TABLE BORDER=\\"0\\" CELLBORDER=\\"1\\" CELLSPACING=\\"0\\"><TR><TD COLSPAN=\\"3\\">%s (%p)</TD></TR>", myNodeName, myNodeName, pStruct);\n')
1008 gv_funcs.append(' for (uint32_t i=0; i < count; i++) {\n')
1009 gv_funcs.append(' sprintf(tmpStr, "');
1010 p_args = ""
1011 p_out = ""
1012 for m in sorted(self.struct_dict[s]):
1013 if 2 == m: # TODO : Hard-coded hack to skip last element of union for xgl_descriptor_slot_info struct
1014 continue
1015 plabel = ""
1016 (p_out1, p_args1) = self._get_struct_gv_print_formatted(self.struct_dict[s][m], port_label=plabel)
1017 if 0 == m: # Add array index notation at end of first row (TODO : ROWSPAN# should be dynamic based on number of elements, but hard-coding for now)
1018 p_out1 = '%s<TD ROWSPAN=\\"2\\" PORT=\\"slot%%u\\">%%u</TD></TR>' % (p_out1[:-5])
1019 p_args1 += ', i, i'
1020 p_out += p_out1
1021 p_args += p_args1
1022 p_out += '"'
1023 p_args += ");\n"
1024 p_args = p_args.replace('->', '[i].')
1025 gv_funcs.append(p_out);
1026 gv_funcs.append(p_args);
1027 gv_funcs.append(' strncat(str, tmpStr, strlen(tmpStr));\n')
1028 gv_funcs.append(' }\n')
1029 gv_funcs.append(' strncat(str, "</TABLE>>\\n];\\n\\n", 20);\n')
1030 # TODO : Another hard-coded hack. Tie these slots to "magical" DS0_MEMORY slots that should appear separately
1031 gv_funcs.append(' for (uint32_t i=0; i < count; i++) {\n')
Tobin Ehlisf1c468a2014-12-09 17:00:33 -07001032 gv_funcs.append(' if (XGL_SLOT_UNUSED != pStruct[i].slotObjectType) {\n')
1033 gv_funcs.append(' sprintf(tmpStr, "\\"%s\\":slot%u -> \\"DS0_MEMORY\\":slot%u [];\\n", myNodeName, i, i);\n')
1034 gv_funcs.append(' strncat(str, tmpStr, strlen(tmpStr));\n')
1035 gv_funcs.append(' }\n')
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001036 gv_funcs.append(' }\n')
1037 gv_funcs.append(' return str;\n}\n')
1038 # Add function to dynamically print out unknown struct
1039 gv_funcs.append("char* dynamic_gv_display(const XGL_VOID* pStruct, const char* nodeName)\n{\n")
1040 gv_funcs.append(" // Cast to APP_INFO ptr initially just to pull sType off struct\n")
1041 gv_funcs.append(" XGL_STRUCTURE_TYPE sType = ((XGL_APPLICATION_INFO*)pStruct)->sType;\n")
1042 gv_funcs.append(" switch (sType)\n {\n")
1043 for e in enum_type_dict:
1044 if "_STRUCTURE_TYPE" in e:
1045 for v in sorted(enum_type_dict[e]):
1046 struct_name = v.replace("_STRUCTURE_TYPE", "")
1047 print_func_name = self._get_gv_func_name(struct_name)
1048 # TODO : Hand-coded fixes for some exceptions
1049 if 'XGL_PIPELINE_CB_STATE_CREATE_INFO' in struct_name:
1050 struct_name = 'XGL_PIPELINE_CB_STATE'
1051 elif 'XGL_SEMAPHORE_CREATE_INFO' in struct_name:
1052 struct_name = 'XGL_QUEUE_SEMAPHORE_CREATE_INFO'
1053 print_func_name = self._get_gv_func_name(struct_name)
1054 elif 'XGL_SEMAPHORE_OPEN_INFO' in struct_name:
1055 struct_name = 'XGL_QUEUE_SEMAPHORE_OPEN_INFO'
1056 print_func_name = self._get_gv_func_name(struct_name)
1057 gv_funcs.append(' case %s:\n' % (v))
1058 gv_funcs.append(' return %s((%s*)pStruct, nodeName);\n' % (print_func_name, struct_name))
1059 #gv_funcs.append(' }\n')
1060 #gv_funcs.append(' break;\n')
Chia-I Wu84d7f5c2014-12-16 00:43:20 +08001061 gv_funcs.append(" default:\n")
1062 gv_funcs.append(" return NULL;\n")
Tobin Ehlisa701ef02014-11-27 15:43:39 -07001063 gv_funcs.append(" }\n")
1064 gv_funcs.append("}")
1065 return "".join(gv_funcs)
1066
1067
1068
1069
1070
1071# def _generateHeader(self):
1072# hdr = []
1073# hdr.append('digraph g {\ngraph [\nrankdir = "LR"\n];')
1074# hdr.append('node [\nfontsize = "16"\nshape = "plaintext"\n];')
1075# hdr.append('edge [\n];\n')
1076# return "\n".join(hdr)
1077#
1078# def _generateBody(self):
1079# body = []
1080# for s in self.struc_dict:
1081# field_num = 1
1082# body.append('"%s" [\nlabel = <<TABLE BORDER="0" CELLBORDER="1" CELLSPACING="0"> <TR><TD COLSPAN="2" PORT="f0">%s</TD></TR>' % (s, typedef_fwd_dict[s]))
1083# for m in sorted(self.struc_dict[s]):
1084# body.append('<TR><TD PORT="f%i">%s</TD><TD PORT="f%i">%s</TD></TR>' % (field_num, self.struc_dict[s][m]['full_type'], field_num+1, self.struc_dict[s][m]['name']))
1085# field_num += 2
1086# body.append('</TABLE>>\n];\n')
1087# return "".join(body)
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001088
1089def main(argv=None):
1090 opts = handle_args()
1091 # Parse input file and fill out global dicts
1092 hfp = HeaderFileParser(opts.input_file)
1093 hfp.parse()
1094 # TODO : Don't want these to be global, see note at top about wrapper classes
1095 global enum_val_dict
1096 global enum_type_dict
1097 global struct_dict
1098 global typedef_fwd_dict
1099 global typedef_rev_dict
1100 global types_dict
1101 enum_val_dict = hfp.get_enum_val_dict()
1102 enum_type_dict = hfp.get_enum_type_dict()
1103 struct_dict = hfp.get_struct_dict()
Tobin Ehlis6f7029b2014-11-11 12:28:12 -07001104 # TODO : Would like to validate struct data here to verify that all of the bools for struct members are correct at this point
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001105 typedef_fwd_dict = hfp.get_typedef_fwd_dict()
1106 typedef_rev_dict = hfp.get_typedef_rev_dict()
1107 types_dict = hfp.get_types_dict()
1108 #print(enum_val_dict)
1109 #print(typedef_dict)
1110 #print(struct_dict)
1111 if (opts.abs_out_dir is not None):
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001112 enum_sh_filename = os.path.join(opts.abs_out_dir, os.path.basename(opts.input_file).strip(".h")+"_enum_string_helper.h")
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001113 else:
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001114 enum_sh_filename = os.path.join(os.getcwd(), opts.rel_out_dir, os.path.basename(opts.input_file).strip(".h")+"_enum_string_helper.h")
1115 enum_sh_filename = os.path.abspath(enum_sh_filename)
1116 if not os.path.exists(os.path.dirname(enum_sh_filename)):
1117 print("Creating output dir %s" % os.path.dirname(enum_sh_filename))
1118 os.mkdir(os.path.dirname(enum_sh_filename))
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001119 if opts.gen_enum_string_helper:
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001120 print("Generating enum string helper to %s" % enum_sh_filename)
1121 enum_vh_filename = os.path.join(os.path.dirname(enum_sh_filename), os.path.basename(opts.input_file).strip(".h")+"_enum_validate_helper.h")
1122 print("Generating enum validate helper to %s" % enum_vh_filename)
1123 eg = EnumCodeGen(enum_type_dict, enum_val_dict, typedef_fwd_dict, os.path.basename(opts.input_file), enum_sh_filename, enum_vh_filename)
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001124 eg.generateStringHelper()
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001125 eg.generateEnumValidate()
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001126 #for struct in struct_dict:
1127 #print(struct)
1128 if opts.gen_struct_wrappers:
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001129 sw = StructWrapperGen(struct_dict, os.path.basename(opts.input_file).strip(".h"), os.path.dirname(enum_sh_filename))
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001130 #print(sw.get_class_name(struct))
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001131 sw.set_include_headers([os.path.basename(opts.input_file),os.path.basename(enum_sh_filename),"stdint.h","stdio.h","stdlib.h"])
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001132 print("Generating struct wrapper header to %s" % sw.header_filename)
1133 sw.generateHeader()
1134 print("Generating struct wrapper class to %s" % sw.class_filename)
1135 sw.generateBody()
1136 sw.generateStringHelper()
Tobin Ehlis07fe9ab2014-11-25 17:43:26 -07001137 # Generate a 2nd helper file that excludes addrs
1138 sw.set_no_addr(True)
1139 sw.generateStringHelper()
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001140 if opts.gen_cmake:
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001141 cmg = CMakeGen(sw, os.path.dirname(enum_sh_filename))
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001142 cmg.generate()
1143 if opts.gen_graphviz:
Tobin Ehlisbe8dded2014-12-17 07:20:23 -07001144 gv = GraphVizGen(struct_dict, os.path.basename(opts.input_file).strip(".h"), os.path.dirname(enum_sh_filename))
1145 gv.set_include_headers([os.path.basename(opts.input_file),os.path.basename(enum_sh_filename),"stdint.h","stdio.h","stdlib.h"])
Tobin Ehlisee33fa52014-10-22 15:13:53 -06001146 gv.generate()
1147 print("DONE!")
1148 #print(typedef_rev_dict)
1149 #print(types_dict)
1150 #recreate_structs()
1151
1152if __name__ == "__main__":
1153 sys.exit(main())