Add missing scripts

Author: encounter

scripts/apply-symbol-mappings.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+"""Apply symbol_mappings from objdiff.json to symbols.txt, then remove them."""
+
+import json
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+OBJDIFF_PATH = ROOT / "objdiff.json"
+SYMBOLS_PATH = ROOT / "config" / "GM8E01_00" / "symbols.txt"
+
+
+def main():
+    with open(OBJDIFF_PATH, "r") as f:
+        objdiff = json.load(f)
+
+    # Collect all mappings: old_name -> new_name
+    mappings = {}
+    units_with_mappings = []
+    for unit in objdiff.get("units", []):
+        sm = unit.get("symbol_mappings")
+        if sm:
+            units_with_mappings.append(unit["name"])
+            for old, new in sm.items():
+                if old in mappings and mappings[old] != new:
+                    print(
+                        f"WARNING: conflicting mapping for '{old}':\n"
+                        f"  '{mappings[old]}' vs '{new}'",
+                        file=sys.stderr,
+                    )
+                mappings[old] = new
+
+    if not mappings:
+        print("No symbol_mappings found in objdiff.json.")
+        return
+
+    print(f"Found {len(mappings)} mapping(s) in {len(units_with_mappings)} unit(s):")
+    for name in units_with_mappings:
+        print(f"  {name}")
+
+    # Apply to symbols.txt
+    with open(SYMBOLS_PATH, "r") as f:
+        lines = f.readlines()
+
+    applied = set()
+    new_lines = []
+    for line in lines:
+        replaced = False
+        for old, new in mappings.items():
+            prefix = old + " = "
+            if line.startswith(prefix):
+                new_lines.append(new + " = " + line[len(prefix):])
+                applied.add(old)
+                replaced = True
+                break
+        if not replaced:
+            new_lines.append(line)
+
+    not_found = set(mappings.keys()) - applied
+    if not_found:
+        print(f"\nWARNING: {len(not_found)} mapping(s) not found in symbols.txt:",
+              file=sys.stderr)
+        for name in sorted(not_found):
+            print(f"  {name}", file=sys.stderr)
+
+    with open(SYMBOLS_PATH, "w") as f:
+        f.writelines(new_lines)
+
+    print(f"\nApplied {len(applied)} rename(s) to {SYMBOLS_PATH.relative_to(ROOT)}")
+
+    # Remove symbol_mappings from objdiff.json
+    for unit in objdiff.get("units", []):
+        if unit.get("symbol_mappings"):
+            unit["symbol_mappings"] = None
+
+    with open(OBJDIFF_PATH, "w") as f:
+        json.dump(objdiff, f, indent=2)
+        f.write("\n")
+
+    print(f"Cleared symbol_mappings from {OBJDIFF_PATH.relative_to(ROOT)}")
+
+
+if __name__ == "__main__":
+    main()

scripts/function-order.py

@@ -0,0 +1,101 @@
+#!/usr/bin/env python3
+
+import re
+import subprocess
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+SPLITS = ROOT / "config/GM8E01_00/splits.txt"
+SYMBOLS = ROOT / "config/GM8E01_00/symbols.txt"
+DTK = ROOT / "build/tools/dtk"
+
+
+def find_text_range(tu_path):
+    tu_header = f"{tu_path}:"
+    in_tu = False
+    start = None
+    end = None
+
+    with SPLITS.open() as f:
+        for raw_line in f:
+            line = raw_line.rstrip("\n")
+            if not line:
+                continue
+
+            if not raw_line.startswith((" ", "\t")):
+                in_tu = line == tu_header
+                continue
+
+            if not in_tu:
+                continue
+
+            match = re.match(r"\s*\.text\s+start:0x([0-9A-Fa-f]+)\s+end:0x([0-9A-Fa-f]+)", line)
+            if match:
+                start = int(match.group(1), 16)
+                end = int(match.group(2), 16)
+                break
+
+    if start is None or end is None:
+        raise SystemExit(f"Failed to find .text range for TU: {tu_path}")
+
+    return start, end
+
+
+def find_symbols_in_range(start, end):
+    out = []
+    pattern = re.compile(
+        r"^(?P<name>[^=\s]+)\s*=\s*\.text:0x(?P<addr>[0-9A-Fa-f]+);\s*//\s*(?P<meta>.*)$"
+    )
+
+    with SYMBOLS.open() as f:
+        for raw_line in f:
+            line = raw_line.rstrip("\n")
+            match = pattern.match(line)
+            if not match:
+                continue
+
+            meta = match.group("meta")
+            if "type:function" not in meta:
+                continue
+
+            addr = int(match.group("addr"), 16)
+            if start <= addr < end:
+                out.append((addr, match.group("name")))
+
+    out.sort()
+    out.reverse()
+    return out
+
+
+def demangle(symbol):
+    try:
+        result = subprocess.run(
+            [str(DTK), "demangle", symbol],
+            check=True,
+            capture_output=True,
+            text=True,
+            cwd=ROOT,
+        )
+    except FileNotFoundError:
+        raise SystemExit(f"Missing demangler: {DTK}")
+    except subprocess.CalledProcessError:
+        return symbol
+
+    return result.stdout.strip() or symbol
+
+
+def main():
+    if len(sys.argv) != 2:
+        raise SystemExit(f"Usage: {Path(sys.argv[0]).name} <TU path>")
+
+    tu_path = sys.argv[1]
+    start, end = find_text_range(tu_path)
+    symbols = find_symbols_in_range(start, end)
+
+    for _, symbol in symbols:
+        print(demangle(symbol))
+
+
+if __name__ == "__main__":
+    main()