circuitpython/tools/chart_code_size.py

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

486 lines
19 KiB
Python
Raw Permalink Normal View History

2020-06-03 18:40:05 -04:00
# SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
#
# SPDX-License-Identifier: MIT
# This script renders a graph of the CircuitPython rom image.
# It takes the single elf file and uses objdump to get its contents.
import pygraphviz as pgv
import click
import sh
# Replace dashes with underscores
objdump = sh.arm_none_eabi_objdump
2021-03-15 09:57:36 -04:00
def parse_hex(h):
return int("0x" + h, 0)
2021-03-15 09:57:36 -04:00
BAD_JUMPS = ["UNPREDICTABLE", "_etext"]
2021-03-15 09:57:36 -04:00
SPECIAL_NODE_COLORS = {"main": "pink", "exception_table": "green"}
@click.command()
@click.argument("elf_filename")
def do_all_the_things(elf_filename):
symbol = None
last_address = 0
all_symbols = {}
symbols_by_debug_address = {}
symbols_by_memory_address = {}
symbols_by_linkage_name = {}
# Gather type info so we know how to treat the disassembly
debug_dump = objdump("--dwarf=info", elf_filename)
debug_dump_lines = debug_dump.stdout.decode("utf-8").split("\n")
symbol_stack = []
symbol = None
ignore = False
min_call_site_param = 0x20000000
for line in debug_dump_lines:
if not line:
continue
parts = line.split()
if line[1] == "<":
if parts[-1] == "0":
symbol = symbol_stack.pop()
continue
debug_type = parts[-1].strip("()")
ignore = False
# skip info about function parameters
if debug_type == "DW_TAG_formal_parameter":
ignore = True
depth = int(parts[0].split(">")[0].strip("<"))
if len(symbol_stack) == (depth - 1) and depth > 0:
symbol_stack.append(symbol)
elif symbol and "name" in symbol:
if symbol["debug_type"] == "DW_TAG_variable":
if "start_address" not in symbol:
pass
else:
symbols_by_memory_address[symbol["start_address"]] = symbol
2021-03-15 09:57:36 -04:00
elif symbol["debug_type"] in [
"DW_TAG_member",
"DW_TAG_label",
"DW_TAG_typedef",
"DW_TAG_enumerator",
"DW_TAG_enumeration_type",
"DW_TAG_base_type",
"DW_TAG_structure_type",
"DW_TAG_compile_unit",
"DW_TAG_union_type",
]:
# skip symbols that don't end up in memory. the type info is available through the debug address map
pass
else:
if symbol["name"] in all_symbols:
# print(depth, symbol["name"])
# print(symbol)
# print(all_symbols[symbol["name"]])
# print()
pass
all_symbols[symbol["name"]] = symbol
2021-03-15 09:57:36 -04:00
elif (
symbol
and symbol["debug_type"] == "DW_TAG_GNU_call_site_parameter"
and "call_site_value" in symbol
):
parent = -1
while symbol_stack[parent]["debug_type"] != "DW_TAG_subprogram":
parent -= 1
parent = symbol_stack[parent]
# Only point to ROM
addr = symbol["call_site_value"]
if 0x2000 <= addr < 0x20000000:
if "outgoing_pointers" not in parent:
parent["outgoing_pointers"] = set()
parent["outgoing_pointers"].add(addr)
if addr not in symbols_by_memory_address:
symbols_by_memory_address[addr] = symbol
min_call_site_param = min(addr, min_call_site_param)
symbol["name"] = "name{:x}".format(addr)
address = parse_hex(parts[0].split("<")[-1].strip(">:"))
symbol = {"debug_address": address, "debug_type": debug_type, "other": []}
if debug_type == "DW_TAG_structure_type":
symbol["struct"] = {}
elif debug_type == "DW_TAG_array_type":
symbol["subtype"] = None
symbol["bound_count"] = 0
symbol["maxlen"] = 0
elif debug_type == "DW_TAG_subrange_type":
symbol_stack[-1]["subtype"] = symbol
symbols_by_debug_address[address] = symbol
elif ignore:
continue
elif line[:4] == " ":
tag = parts[1].strip(":")
if tag == "DW_AT_name":
symbol["name"] = parts[-1]
elif tag == "DW_AT_type":
symbol["type"] = int(parts[-1].strip("<>"), 0)
if symbol["debug_type"] == "DW_TAG_subrange_type":
if not symbol_stack[-1]["subtype"]:
symbol_stack[-1]["subtype"] = symbol
elif symbol_stack[-1]["subtype"]["type"] == symbol["type"]:
second_subtype = True
else:
raise RuntimeError()
elif tag == "DW_AT_upper_bound":
# Skip arrays with length defined by other variables
if parts[-1][0] != "<":
upper_bound = int(parts[-1])
if symbol_stack[-1]["bound_count"] > 0:
symbol_stack[-1]["maxlen"] *= upper_bound + 1
else:
symbol_stack[-1]["maxlen"] = upper_bound + 1
symbol_stack[-1]["bound_count"] += 1
elif tag == "DW_AT_byte_size":
symbol["size"] = int(parts[-1])
elif tag == "DW_AT_inline":
symbol["inlined"] = True
elif tag == "DW_AT_low_pc":
addr = int(parts[-1], 0)
symbols_by_memory_address[addr] = symbol
elif tag == "DW_AT_location":
if parts[-2] == "(DW_OP_addr:":
addr = parse_hex(parts[-1].strip(")"))
if addr > 0:
symbol["start_address"] = addr
elif tag == "DW_AT_linkage_name":
symbol["linkage_name"] = parts[-1]
symbols_by_linkage_name[symbol["linkage_name"]] = symbol
elif tag == "DW_AT_data_member_location":
symbol_stack[-1]["struct"][int(parts[-1])] = symbol
elif tag == "DW_AT_GNU_call_site_value":
if parts[-2] == "(DW_OP_addr:":
symbol["call_site_value"] = parse_hex(parts[-1].strip(")"))
else:
symbol["other"].append(line)
2021-03-15 09:57:36 -04:00
# print(parts)
pass
else:
2021-03-15 09:57:36 -04:00
# print(line)
pass
MEMORY_NONE = 0
MEMORY_POINTER = 1
MEMORY_PY_OBJECT = 2
def get_size(t):
if "size" in t:
return t["size"]
return get_size(symbols_by_debug_address[t["type"]])
def get_pointer_map(t, depth=0):
if t["debug_type"] == "DW_TAG_pointer_type":
return {0: MEMORY_POINTER}
2021-03-15 09:57:36 -04:00
elif t["debug_type"] in [
"DW_TAG_const_type",
"DW_TAG_typedef",
"DW_TAG_member",
"DW_TAG_subrange_type",
"DW_TAG_volatile_type",
]:
if "name" in t and t["name"] == "mp_rom_obj_t":
return {0: MEMORY_PY_OBJECT}
2021-03-15 09:57:36 -04:00
return get_pointer_map(symbols_by_debug_address[t["type"]], depth + 1)
elif t["debug_type"] in ["DW_TAG_base_type", "DW_TAG_enumeration_type"]:
return {}
elif t["debug_type"] == "DW_TAG_union_type":
# skip for now
return {}
elif "struct" in t:
combined_map = {}
for offset in t["struct"]:
member = t["struct"][offset]
submap = get_pointer_map(member)
for suboffset in submap:
combined_map[offset + suboffset] = submap[suboffset]
return combined_map
elif "subtype" in t:
subtype = symbols_by_debug_address[t["type"]]
2021-03-15 09:57:36 -04:00
pmap = get_pointer_map(subtype, depth + 1)
size = get_size(subtype)
expanded_map = {}
for i in range(t["maxlen"]):
for offset in pmap:
expanded_map[size * i + offset] = pmap[offset]
return expanded_map
else:
print("no recurse", t)
pass
return {}
# Do a second pass to dereference the types
for symbol_address in symbols_by_memory_address:
symbol = symbols_by_memory_address[symbol_address]
if "type" in symbol:
if symbol["debug_type"] == "DW_TAG_variable":
symbol["pointer_map"] = get_pointer_map(symbols_by_debug_address[symbol["type"]])
type_string = []
t = symbol["type"]
offset = []
while t != None:
t_symbol = symbols_by_debug_address[t]
t = t_symbol.get("type", None)
if "name" in t_symbol:
type_string.append(t_symbol["name"])
elif t_symbol["debug_type"] == "DW_TAG_array_type":
type_string.append("[]")
elif t_symbol["debug_type"] == "DW_TAG_pointer_type":
type_string.append("*")
elif t_symbol["debug_type"] == "DW_TAG_const_type":
type_string.append("const")
elif t_symbol["debug_type"] == "DW_TAG_volatile_type":
type_string.append("volatile")
else:
2021-03-15 09:57:36 -04:00
# print(" ", t_symbol)
pass
type_string.reverse()
symbol["type_string"] = " ".join(type_string)
2021-03-15 09:57:36 -04:00
# print(symbol_name, symbol["debug_type"], symbol.get("type_string", ""))
# print()
# print()
# print(all_symbols["mp_builtin_module_table"])
# return
# Gather size and call info
text_dump = objdump("-Dz", "-j", ".text", elf_filename)
text_dump_lines = text_dump.stdout.decode("utf-8").split("\n")
section = None
symbol = None
symbol_type = None
for line in text_dump_lines[4:]:
if line.startswith("Disassembly of section"):
section = line.split()[-1].strip(":")
elif not line:
if symbol and "end_address" not in symbol:
symbol["end_address"] = last_address
symbol["size"] = last_address - symbol["start_address"]
symbol = None
continue
elif line[0].isnumeric():
symbol_address, symbol_name = line.split()
symbol_address = parse_hex(symbol_address)
symbol_name = symbol_name.strip("<>:")
if symbol_name in symbols_by_linkage_name:
linked_name = symbol_name
symbol = symbols_by_linkage_name[symbol_name]
if "name" in symbol:
non_linkage = symbol["name"]
if not non_linkage.startswith("__builtin"):
symbol_name = non_linkage
all_symbols[symbol_name] = symbol
if "name" not in symbol:
symbol["name"] = symbol_name
elif symbol_address in symbols_by_memory_address:
all_symbols[symbol_name] = symbols_by_memory_address[symbol_address]
if "name" not in all_symbols[symbol_name]:
all_symbols[symbol_name]["name"] = symbol_name
elif symbol_name not in all_symbols:
if symbol_name == "nlr_push_tail_var":
fake_type = all_symbols["mp_obj_get_type"]["type"]
2021-03-15 09:57:36 -04:00
symbol = {
"debug_type": "DW_TAG_variable",
"name": symbol_name,
"type": fake_type,
}
else:
print(line)
print(symbol_name, symbol_address)
symbol = {"debug_type": "DW_TAG_subprogram", "name": symbol_name}
all_symbols[symbol_name] = symbol
2021-03-15 09:57:36 -04:00
# raise RuntimeError()
symbol = all_symbols[symbol_name]
symbol["start_address"] = symbol_address
symbols_by_memory_address[symbol_address] = symbol
symbol["section"] = section
if symbol["debug_type"] == "DW_TAG_subprogram":
symbol["outgoing_jumps"] = set()
symbol["incoming_jumps"] = set()
symbol_type = None
elif symbol["debug_type"] == "DW_TAG_variable":
symbol["outgoing_pointers"] = set()
symbol_type = symbols_by_debug_address[symbol["type"]]
all_symbols[symbol_name] = symbol
elif line[0] == " ":
parts = line.strip().split()
last_address = parse_hex(parts[0].strip(":"))
offset = last_address - symbol["start_address"]
if "pointer_map" in symbol:
if offset not in symbol["pointer_map"]:
2021-03-15 09:57:36 -04:00
# print(offset, symbol)
pass
else:
ref = parse_hex(parts[1])
pointer_style = symbol["pointer_map"][offset]
if pointer_style == MEMORY_POINTER:
2021-03-15 09:57:36 -04:00
symbol["outgoing_pointers"].add(ref & 0xFFFFFFFE)
elif pointer_style == MEMORY_PY_OBJECT and ref & 0x3 == 0:
symbol["outgoing_pointers"].add(ref)
if len(parts[1]) == 8 and parts[1][0] == "0":
addr = parse_hex(parts[1])
if 0x2000 <= addr < 0x20000000:
if "outgoing_pointers" not in symbol:
symbol["outgoing_pointers"] = set()
symbol["outgoing_pointers"].add(addr)
elif "<" in line and symbol["debug_type"] == "DW_TAG_subprogram":
if line[-1] == ">":
jump_to = parts[-1].strip("<>").split("+")[0]
if "name" not in symbol:
print(jump_to)
print(symbol)
if jump_to != symbol["name"] and jump_to not in BAD_JUMPS:
symbol["outgoing_jumps"].add(jump_to)
2021-03-15 09:57:36 -04:00
# print(symbol_name, jump_to)
if jump_to == "_etext":
print(line)
elif "UNDEFINED" in line:
continue
elif parts[2] == "ldr":
continue
else:
print(line)
else:
2021-03-15 09:57:36 -04:00
# print(line)
pass
# print()
print(hex(min_call_site_param))
print(all_symbols["exception_table"])
# return
print("converting outgoing pointers to names")
# Convert outgoing pointers to names from addresses
for symbol_name in all_symbols:
symbol = all_symbols[symbol_name]
if "outgoing_pointers" not in symbol:
continue
converted = set()
for outgoing in symbol["outgoing_pointers"]:
if outgoing in symbols_by_memory_address:
outgoing = symbols_by_memory_address[outgoing]
2021-03-15 09:57:36 -04:00
# print(outgoing)
if outgoing["debug_type"] in ["DW_TAG_GNU_call_site", "DW_TAG_lexical_block"]:
continue
if outgoing["name"] == "audioio_wavefile_type":
print(outgoing)
converted.add(outgoing["name"])
symbol["outgoing_pointers"] = converted
print("linking back")
# Link back
for symbol_name in all_symbols:
symbol = all_symbols[symbol_name]
if "outgoing_jumps" in symbol:
for outgoing in symbol["outgoing_jumps"]:
if outgoing not in all_symbols:
2021-03-15 09:57:36 -04:00
# print(outgoing, symbol_name)
continue
2021-03-15 09:57:36 -04:00
# print(all_symbols[outgoing], symbol_name)
referenced_symbol = all_symbols[outgoing]
if "incoming_jumps" not in referenced_symbol:
2021-03-15 09:57:36 -04:00
# print(symbol_name, "->", outgoing)
referenced_symbol["incoming_jumps"] = set()
referenced_symbol["incoming_jumps"].add(symbol_name)
if "outgoing_pointers" in symbol:
for outgoing in symbol["outgoing_pointers"]:
if outgoing not in all_symbols:
2021-03-15 09:57:36 -04:00
# print(outgoing, symbol_name)
continue
2021-03-15 09:57:36 -04:00
# print(all_symbols[outgoing], symbol_name)
referenced_symbol = all_symbols[outgoing]
if "incoming_pointers" not in referenced_symbol:
2021-03-15 09:57:36 -04:00
# print(symbol_name, "->", outgoing)
referenced_symbol["incoming_pointers"] = set()
referenced_symbol["incoming_pointers"].add(symbol_name)
print(all_symbols["exception_table"])
# Chart it all
print("charting {} symbols".format(len(all_symbols)))
callgraph = pgv.AGraph(directed=True)
for i, symbol_name in enumerate(all_symbols):
symbol = all_symbols[symbol_name]
# print(i, symbol_name)
# if "outgoing_jumps" in symbol:
# print(" ", len(symbol["outgoing_jumps"]), "jumps")
# if "outgoing_pointers" in symbol:
# print(" ", len(symbol["outgoing_pointers"]), "ptrs")
# if i > 3000:
# break
2021-03-15 09:57:36 -04:00
if ("incoming_jumps" not in symbol or len(symbol["incoming_jumps"]) == 0) and (
"incoming_pointers" not in symbol or len(symbol["incoming_pointers"]) == 0
):
# print(symbol_name)
continue
if "start_address" not in symbol:
continue
callgraph.add_node(symbol_name)
if "outgoing_jumps" in symbol:
for outgoing in symbol["outgoing_jumps"]:
callgraph.add_edge(symbol_name, outgoing)
if "outgoing_pointers" in symbol:
for outgoing in symbol["outgoing_pointers"]:
callgraph.add_edge(symbol_name, outgoing, color="red")
2021-03-15 09:57:36 -04:00
# print(symbol_name, symbol)
# Style all of the nodes
print("styling")
for node in callgraph.iternodes():
if node.name not in all_symbols:
continue
symbol = all_symbols[node.name]
node.attr["shape"] = "box"
text_width_ish = len(node.name) * 0.1
if "size" not in symbol:
print(symbol)
size = symbol["size"] / 8
square_size = size**0.5
if text_width_ish > square_size:
w = text_width_ish
h = size / text_width_ish
else:
w = square_size
h = square_size
node.attr["width"] = w
node.attr["height"] = h
node.attr["label"] = node.name + "\r\n" + str(symbol["size"]) + " bytes"
node.attr["style"] = "filled"
incoming = 0
if "incoming_jumps" in symbol:
incoming += len(symbol["incoming_jumps"])
if "incoming_pointers" in symbol:
incoming += len(symbol["incoming_pointers"])
if node.name in SPECIAL_NODE_COLORS:
node.attr["color"] = SPECIAL_NODE_COLORS[node.name]
elif incoming == 1:
node.attr["color"] = "lightblue"
elif incoming > 25:
print("delete", node.name, "because it has {} incoming".format(incoming))
callgraph.delete_node(node.name)
elif incoming > 15:
node.attr["color"] = "red"
print("drawing")
callgraph.layout(prog="dot")
fn = "callgraph.svg"
print(fn)
callgraph.draw(fn)
2021-03-15 09:57:36 -04:00
if __name__ == "__main__":
do_all_the_things()