From 7b0407567695e84e6b97f2bffd25f579e757469f Mon Sep 17 00:00:00 2001 From: Alexey Lapshin Date: Mon, 22 Aug 2022 14:33:36 +0400 Subject: [PATCH] docs: update link for ESP ROM ELF releases --- docs/conf_common.py | 1 - docs/en/api-guides/core_dump.rst | 4 +--- 2 files changed, 1 insertion(+), 4 deletions(-) diff --git a/docs/conf_common.py b/docs/conf_common.py index 9f24529622..7c84489f48 100644 --- a/docs/conf_common.py +++ b/docs/conf_common.py @@ -182,7 +182,6 @@ linkcheck_exclude_documents = ['index', # several false positives due to the wa linkcheck_ignore = ['https://webhome.phy.duke.edu/~rgb/General/dieharder.php', # Certificate error - 'https://dl.espressif.com/dl/esp32s3_rom.elf', # Not published ] diff --git a/docs/en/api-guides/core_dump.rst b/docs/en/api-guides/core_dump.rst index d38791ce0b..98372200a9 100644 --- a/docs/en/api-guides/core_dump.rst +++ b/docs/en/api-guides/core_dump.rst @@ -1,8 +1,6 @@ Core Dump ========= -{IDF_TARGET_ROM_ELF:default="https://dl.espressif.com/dl/esp32_rom.elf", esp32="https://dl.espressif.com/dl/esp32_rom.elf", esp32s2="https://dl.espressif.com/dl/esp32s2_rom.elf", esp32s3="https://dl.espressif.com/dl/esp32s3_rom.elf", esp32c3="https://dl.espressif.com/dl/esp32c3_rev3_rom.elf"} - Overview -------- @@ -116,7 +114,7 @@ ROM Functions in Backtraces It is possible situation that at the moment of crash some tasks or/and crashed task itself have one or more ROM functions in their callstacks. Since ROM is not part of the program ELF it will be impossible for GDB to parse such callstacks, because it tries to analyse functions' prologues to accomplish that. In that case callstack printing will be broken with error message at the first ROM function. -To overcome this issue you can use ROM ELF provided by Espressif ({IDF_TARGET_ROM_ELF}) and pass it to 'espcoredump.py'. +To overcome this issue, you can use the `ROM ELF `_ provided by Espressif. You can find the {IDF_TARGET_PATH_NAME}'s corresponding ROM ELF file from the list of released archives. The ROM ELF file can then be passed to ``espcoredump.py``. More details about ROM ELFs can be found `here `_. Dumping variables on demand ---------------------------