mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
1786fc9ed2
This commit refactors backtracing within the panic handler so that a common function esp_backtrace_get_next_frame() is used iteratively to traverse a callstack. A esp_backtrace_print() function has also be added that allows the printing of a backtrace at runtime. The esp_backtrace_print() function allows unity to print the backtrace of failed test cases and jump back to the main test menu without the need reset the chip. esp_backtrace_print() can also be used as a debugging function by users.
73 lines
2.8 KiB
C
73 lines
2.8 KiB
C
// Copyright 2015-2019 Espressif Systems (Shanghai) PTE LTD
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#include "esp_types.h"
|
|
#include "esp_attr.h"
|
|
#include "esp_err.h"
|
|
#include "esp_panic.h"
|
|
#include "rom/ets_sys.h"
|
|
#include "soc/soc_memory_layout.h"
|
|
#include "soc/cpu.h"
|
|
|
|
bool IRAM_ATTR esp_backtrace_get_next_frame(esp_backtrace_frame_t *frame)
|
|
{
|
|
//Use frame(i-1)'s BS area located below frame(i)'s sp to get frame(i-1)'s sp and frame(i-2)'s pc
|
|
void *base_save = (void *)frame->sp; //Base save area consists of 4 words under SP
|
|
frame->pc = frame->next_pc;
|
|
frame->next_pc = *((uint32_t *)(base_save - 16)); //If next_pc = 0, indicates frame(i-1) is the last frame on the stack
|
|
frame->sp = *((uint32_t *)(base_save - 12));
|
|
|
|
//Return true if both sp and pc of frame(i-1) are sane, false otherwise
|
|
return (esp_stack_ptr_is_sane(frame->sp) && esp_ptr_executable((void*)esp_cpu_process_stack_pc(frame->pc)));
|
|
}
|
|
|
|
esp_err_t IRAM_ATTR esp_backtrace_print(int depth)
|
|
{
|
|
//Check arguments
|
|
if (depth <= 0) {
|
|
return ESP_ERR_INVALID_ARG;
|
|
}
|
|
|
|
//Initialize stk_frame with first frame of stack
|
|
esp_backtrace_frame_t stk_frame;
|
|
esp_backtrace_get_start(&(stk_frame.pc), &(stk_frame.sp), &(stk_frame.next_pc));
|
|
//esp_cpu_get_backtrace_start(&stk_frame);
|
|
ets_printf("\r\n\r\nBacktrace:");
|
|
ets_printf("0x%08X:0x%08X ", esp_cpu_process_stack_pc(stk_frame.pc), stk_frame.sp);
|
|
|
|
//Check if first frame is valid
|
|
bool corrupted = (esp_stack_ptr_is_sane(stk_frame.sp) &&
|
|
esp_ptr_executable((void*)esp_cpu_process_stack_pc(stk_frame.pc))) ?
|
|
false : true;
|
|
|
|
uint32_t i = (depth <= 0) ? INT32_MAX : depth;
|
|
while (i-- > 0 && stk_frame.next_pc != 0 && !corrupted) {
|
|
if (!esp_backtrace_get_next_frame(&stk_frame)) { //Get previous stack frame
|
|
corrupted = true;
|
|
}
|
|
ets_printf("0x%08X:0x%08X ", esp_cpu_process_stack_pc(stk_frame.pc), stk_frame.sp);
|
|
}
|
|
|
|
//Print backtrace termination marker
|
|
esp_err_t ret = ESP_OK;
|
|
if (corrupted) {
|
|
ets_printf(" |<-CORRUPTED");
|
|
ret = ESP_FAIL;
|
|
} else if (stk_frame.next_pc != 0) { //Backtrace continues
|
|
ets_printf(" |<-CONTINUES");
|
|
}
|
|
ets_printf("\r\n\r\n");
|
|
return ret;
|
|
}
|