Implement coredump analysis targets with CLI support.

builder/frameworks/espidf.py

@@ -88,11 +88,16 @@
 
 IDF_ENV_VERSION = "1.0.0"
 _framework_pkg_dir = platform.get_package_dir("framework-espidf")
+_rom_elfs_dir = platform.get_package_dir("tool-esp-rom-elfs")
 if not _framework_pkg_dir or not os.path.isdir(_framework_pkg_dir):
     sys.stderr.write(f"Error: Missing framework directory '{_framework_pkg_dir}'\n")
     env.Exit(1)
 FRAMEWORK_DIR_PATH = Path(_framework_pkg_dir).resolve()
+ROM_ELFS_DIR_PATH = Path(_rom_elfs_dir).resolve()
 FRAMEWORK_DIR = str(FRAMEWORK_DIR_PATH)
+ROM_ELFS_DIR = str(ROM_ELFS_DIR_PATH)
+os.environ['IDF_PATH'] = FRAMEWORK_DIR
+os.environ['ESP_ROM_ELF_DIR'] = ROM_ELFS_DIR
 TOOLCHAIN_DIR = platform.get_package_dir(
     "toolchain-xtensa-esp-elf"
     if mcu in ("esp32", "esp32s2", "esp32s3")

builder/main.py

@@ -650,6 +650,89 @@ def firmware_metrics(target, source, env):
         print(f'Make sure esp-idf-size is installed: uv pip install --python "{PYTHON_EXE}" esp-idf-size')
 
 
+def coredump_analysis(target, source, env):
+    """
+    Custom target to run esp-coredump with support for command line parameters.
+    Usage: pio run -t coredump -- [esp-coredump arguments]
+
+    Args:
+        target: SCons target
+        source: SCons source
+        env: SCons environment object
+    """
+    if terminal_cp != "utf-8":
+        print("Coredump analysis can not be shown. Set the terminal codepage to \"utf-8\"")
+        return
+
+    elf_file = str(Path(env.subst("$BUILD_DIR")) / (env.subst("$PROGNAME") + ".elf"))
+    if not Path(elf_file).is_file():
+        # elf file can be in project dir
+        elf_file = str(Path(get_project_dir()) / (env.subst("$PROGNAME") + ".elf"))
+
+    if not Path(elf_file).is_file():
+        print(f"Error: ELF file not found: {elf_file}")
+        print("Make sure the project is built first with 'pio run'")
+        return
+
+    try:        
+        cmd = [PYTHON_EXE, "-m", "esp_coredump"]
+
+        # Command Line Parameter, after --
+        cli_args = []
+        if "--" in sys.argv:
+            dash_index = sys.argv.index("--")
+            if dash_index + 1 < len(sys.argv):
+                cli_args = sys.argv[dash_index + 1:]
+
+        # Add CLI arguments or use defaults
+        if cli_args:
+            cmd.extend(cli_args)
+            # ELF file should be at the end as positional argument
+            if not any(arg.endswith('.elf') for arg in cli_args):
+                cmd.append(elf_file)
+        else:
+            # Default arguments if none provided
+            # Parameters from platformio.ini
+            extra_args = env.GetProjectOption("custom_esp_coredump_args", "")
+            if extra_args:
+                # Parse extra args and add ELF file at the end
+                cmd.extend(shlex.split(extra_args))
+                cmd.append(elf_file)
+            else:
+                # Use defaults: --chip <mcu> info_corefile <elf_file>
+                cmd.extend(["--chip", mcu, "info_corefile", elf_file])
+
+        # Set up ESP-IDF environment variables when ESP-IDF framework is used
+        coredump_env = os.environ.copy()
+        if env.get("PIOFRAMEWORK") and "espidf" in env.get("PIOFRAMEWORK", []):
+            _framework_pkg_dir = platform.get_package_dir("framework-espidf")
+            _rom_elfs_dir = platform.get_package_dir("tool-esp-rom-elfs")
+            if _framework_pkg_dir and os.path.isdir(_framework_pkg_dir):
+                coredump_env['IDF_PATH'] = str(Path(_framework_pkg_dir).resolve())
+                if _rom_elfs_dir and os.path.isdir(_rom_elfs_dir):
+                    coredump_env['ESP_ROM_ELF_DIR'] = str(Path(_rom_elfs_dir).resolve())
+
+        # Debug-Info if wanted
+        if env.GetProjectOption("custom_esp_coredump_verbose", False):
+            print(f"Running command: {' '.join(cmd)}")
+            if 'IDF_PATH' in coredump_env:
+                print(f"IDF_PATH: {coredump_env['IDF_PATH']}")
+                print(f"ESP_ROM_ELF_DIR: {coredump_env.get('ESP_ROM_ELF_DIR', 'Not set')}")
+
+        # Execute esp-coredump with ESP-IDF environment
+        result = subprocess.run(cmd, check=False, capture_output=False, env=coredump_env)
+
+        if result.returncode != 0:
+            print(f"Warning: esp-coredump exited with code {result.returncode}")
+
+    except FileNotFoundError:
+        print("Error: Python executable not found.")
+        print("Check your Python installation.")
+    except Exception as e:
+        print(f"Error: Failed to run coredump analysis: {e}")
+        print(f'Make sure esp-coredump is installed: uv pip install --python "{PYTHON_EXE}" esp-coredump')
+
+
 #
 # Target: Build executable and linkable firmware or FS image
 #
@@ -931,6 +1014,27 @@ def firmware_metrics(target, source, env):
     always_build=True,
 )
 
+# Register Custom Target for coredump analysis
+env.AddCustomTarget(
+    name="coredump",
+    dependencies="$BUILD_DIR/${PROGNAME}.elf",
+    actions=coredump_analysis,
+    title="Coredump Analysis",
+    description="Analyze coredumps using esp-coredump "
+    "(supports CLI args after --)",
+    always_build=True,
+)
+
+# Additional Target without Build-Dependency when already compiled
+env.AddCustomTarget(
+    name="coredump-only",
+    dependencies=None,
+    actions=coredump_analysis,
+    title="Coredump Analysis (No Build)",
+    description="Analyze coredumps without building first",
+    always_build=True,
+)
+
 # Override memory inspection behavior
 env.SConscript("sizedata.py", exports="env")
 

builder/penv_setup.py

@@ -55,7 +55,8 @@
     "ecdsa": ">=0.19.1",
     "bitstring": ">=4.3.1",
     "reedsolo": ">=1.5.3,<1.8",
-    "esp-idf-size": ">=1.6.1"
+    "esp-idf-size": ">=1.6.1",
+    "esp-coredump": ">=1.14.0"
 }