Function main

ci/decode_esp32_backtrace.py:204–252

()

def main():
    import argparse

    parser = argparse.ArgumentParser(
        description="Decode ESP32 crash dumps using addr2line",
        formatter_class=argparse.RawDescriptionHelpFormatter,
        epilog="""
Examples:
    %(prog)s firmware.elf 0x42002a3c 0x42001234
    %(prog)s firmware.elf --build-info build_info.json 0x42002a3c
    cat crash.log | %(prog)s firmware.elf --build-info build_info.json
        """,
    )
    parser.add_argument("elf_file", type=Path, help="Path to firmware.elf file")
    parser.add_argument(
        "--build-info",
        type=Path,
        help="Path to build_info.json for finding addr2line tool",
    )
    parser.add_argument(
        "addresses",
        nargs="*",
        help="Addresses to decode (or pipe crash log to stdin)",
    )

    args = parser.parse_args()

    # Check if addresses provided on command line
    if args.addresses:
        decode_addresses(args.elf_file, args.addresses, args.build_info)
    else:
        # Read from stdin
        if sys.stdin.isatty():
            print("Error: No addresses provided and stdin is empty", file=sys.stderr)
            print(
                "Provide addresses as arguments or pipe crash log to stdin",
                file=sys.stderr,
            )
            sys.exit(1)

        log = sys.stdin.read()
        addresses = extract_addresses_from_crash_log(log)

        if not addresses:
            print("Error: No addresses found in crash log", file=sys.stderr)
            sys.exit(1)

        print(f"Found {len(addresses)} addresses to decode")
        decode_addresses(args.elf_file, addresses, args.build_info)


if __name__ == "__main__":