This is an automated email from the ASF dual-hosted git repository. xiaoxiang pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit 27858f913b819da09d528d31e05f4e0d1613bdbd Author: Tiago Medicci Serrano <[email protected]> AuthorDate: Fri Sep 20 13:56:35 2024 -0300 tools: Add generic tool to decode the backtrace dump The script can decode the backtrace dump, considering the syntax of the backtrace format (properly handle the dump when SMP is enabled, for instance) based on chip name or the toolchains's addr2line tool. --- tools/btdecode.sh | 158 ++++++++++++++++++++++++++++++++++++++++++++++++ tools/esp32/btdecode.sh | 71 ---------------------- 2 files changed, 158 insertions(+), 71 deletions(-) diff --git a/tools/btdecode.sh b/tools/btdecode.sh new file mode 100755 index 0000000000..964b0a3d0d --- /dev/null +++ b/tools/btdecode.sh @@ -0,0 +1,158 @@ +#!/usr/bin/env bash +############################################################################ +# tools/btdecode.sh +# +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. The +# ASF licenses this file to you 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. +# +############################################################################ + +# This script can be used to decode the backtrace that's dumped on assertions. +# +# On assertions we can find the raw backtrace dump similar to: +# ... +# sched_dumpstack: backtrace| 0: 0x400e1a2a 0x40082912 +# sched_dumpstack: backtrace| 1: 0x400e39ac 0x400ef7c3 0x400ef7fc 0x400e8116 0x400e7910 0x400e7be8 0x400e6c5c 0x400e6ad6 +# sched_dumpstack: backtrace| 1: 0x400e6a99 0x400e4005 0x400e2754 +# sched_dumpstack: backtrace| 2: 0x400f13ee 0x400e4005 0x400e2754 +# ... +# +# Copy that to a file and call this script as: +# ./tools/btdecode.sh esp32 backtrace_file +# +# The result should be similar to the following: +# 0x400e1a2a: function_name at file.c:line +# 0x40082912: function_name at file.c:line + +USAGE="USAGE: ${0} chip|toolchain-addr2line backtrace_file +If the first argument contains 'addr2line', it will be used as the toolchain's addr2line tool. +Otherwise, the script will try to identify the toolchain based on the chip name." + +VALID_CHIPS=( + "esp32" + "esp32s2" + "esp32s3" + "esp32c3" + "esp32c6" + "esp32h2" +) + +# Make sure we have the required argument(s) + +if [ -z "$2" ]; then + echo "No backtrace supplied!" + echo "$USAGE" + exit 1 +fi + +# Check if the first argument is an addr2line tool or a chip + +chip_or_tool=$1 +if [[ $chip_or_tool == *addr2line* ]]; then + ADDR2LINE_TOOL=$chip_or_tool +else + chip=$chip_or_tool + if [[ ! " ${VALID_CHIPS[@]} " =~ " ${chip} " ]]; then + echo "Invalid chip specified! Valid options are: ${VALID_CHIPS[*]}" + echo "$USAGE" + exit 4 + fi + + # Set the appropriate addr2line tool based on the chip + case $chip in + esp32) + ADDR2LINE_TOOL="xtensa-esp32-elf-addr2line" + ;; + esp32s2) + ADDR2LINE_TOOL="xtensa-esp32s2-elf-addr2line" + ;; + esp32s3) + ADDR2LINE_TOOL="xtensa-esp32s3-elf-addr2line" + ;; + esp32c3) + ADDR2LINE_TOOL="riscv-none-elf-addr2line" + ;; + esp32c6) + ADDR2LINE_TOOL="riscv-none-elf-addr2line" + ;; + esp32h2) + ADDR2LINE_TOOL="riscv-none-elf-addr2line" + ;; + esac +fi + +# Make sure the project was built + +if [ ! -f nuttx ]; then + echo "NuttX binaries not found!" + exit 2 +fi + +# Check that the toolchain is in the PATH + +if [ ! -x "$(command -v $ADDR2LINE_TOOL)" ]; then + echo "Toolchain for $chip_or_tool not found!" + exit 3 +fi + +# Decode backtrace + +declare -A backtraces_before +declare -A backtraces_after +in_dump_tasks_section=false + +while read -r line; do + if [[ $line =~ (\[CPU[0-9]+\]\ )?dump_tasks: ]]; then + in_dump_tasks_section=true + fi + + if [[ $line =~ (\[CPU[0-9]+\]\ )?sched_dumpstack: ]]; then + task_id=$(echo $line | grep -oP 'backtrace\|\s*\K\d+') + addresses=$(echo $line | grep -oP '0x[0-9a-fA-F]+') + if $in_dump_tasks_section; then + if [[ -n "${backtraces_after[$task_id]}" ]]; then + backtraces_after[$task_id]="${backtraces_after[$task_id]} $addresses" + else + backtraces_after[$task_id]="$addresses" + fi + else + if [[ -n "${backtraces_before[$task_id]}" ]]; then + backtraces_before[$task_id]="${backtraces_before[$task_id]} $addresses" + else + backtraces_before[$task_id]="$addresses" + fi + fi + fi +done < "$2" + +for task_id in "${!backtraces_before[@]}"; do + echo "Backtrace for task $task_id:" + for bt in ${backtraces_before[$task_id]}; do + $ADDR2LINE_TOOL -pfiaCs -e nuttx $bt + done + echo "" +done + +if $in_dump_tasks_section; then + echo "Backtrace dump for all tasks:" + echo "" + for task_id in "${!backtraces_after[@]}"; do + echo "Backtrace for task $task_id:" + for bt in ${backtraces_after[$task_id]}; do + $ADDR2LINE_TOOL -pfiaCs -e nuttx $bt + done + echo "" + done +fi \ No newline at end of file diff --git a/tools/esp32/btdecode.sh b/tools/esp32/btdecode.sh deleted file mode 100755 index bbde9f11dc..0000000000 --- a/tools/esp32/btdecode.sh +++ /dev/null @@ -1,71 +0,0 @@ -#!/usr/bin/env bash -############################################################################ -# tools/esp32/btdecode.sh -# -# SPDX-License-Identifier: Apache-2.0 -# -# Licensed to the Apache Software Foundation (ASF) under one or more -# contributor license agreements. See the NOTICE file distributed with -# this work for additional information regarding copyright ownership. The -# ASF licenses this file to you 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. -# -############################################################################ - -# This script can be used to decode the backtrace that's dumped on assertions. -# -# On assertions we can find the raw backtrace dump similar to: -# ... -# xtensa_btdump: Backtrace0: 400d3ed7:3ffb1300 -# xtensa_btdump: Backtrace1: 400d3f33:3ffb1320 -# xtensa_btdump: Backtrace2: 400d2875:3ffb1340 -# xtensa_btdump: BACKTRACE CONTINUES... -# ... -# -# Copy that to a file and call this script as: -# ./tools/esp32/btdecode.sh backtrace_file -# -# The result should be similar to the following: -# 0x400d3ed7: xtensa_assert at xtensa_assert.c:108 -# 0x400d3f33: up_assert at xtensa_assert.c:184 (discriminator 2) -# 0x400d2875: _assert at lib_assert.c:36 - -USAGE="USAGE: ${0} backtrace_file" - -# Make sure we have the required argument(s) - -if [ -z "$1" ]; then - echo "No backtrace supplied!" - echo "$USAGE" - exit 1 -fi - -# Make sure the project was built - -if [ ! -f nuttx ]; then - echo "NuttX binaries not found!" - exit 2 -fi - -# Check that the toolchain is in the PATH - -if [ ! -x "$(command -v xtensa-esp32-elf-addr2line)" ]; then - echo "ESP32 toolchain not found!" - exit 3 -fi - -# Decode backtrace - -for bt in `cat $1 | cut -d':' -f3`; do - xtensa-esp32-elf-addr2line -pfiaCs -e nuttx $bt -done -
