RVBacktrace RISC-V极简栈回溯组件

发布于 2024-08-30 15:40:19 浏览：597 订阅该版

[tocm]

# RVBacktrace

## 组件简介

一个极简的RISC-V栈回溯组件。

## 组件源码

组件源码：https://github.com/Yaochenger/RvBacktrace

## 组件功能

1.在需要的地方调用组件提供的唯一API，开始当前环境的栈回溯

2.支持输出addr2line需要的命令，使用addr2line进行栈回溯

3.支持结合反汇编，栈回溯信息图表化

TODO List:

1. 支持打印指定线程的栈回溯信息
2. 支持对接RT_ASSERT
3. 支持输出更多的符号信息
4. 支持文件跳转

## 添加组件

当前组件暂未做成软件包，所以这里介绍一下临时的使用方法：

首先下载源码，为了方便下文我以RT-Studio环境使用举例：

组件的根目录已经存在`Scons`脚本，所以可以直接放在`applications`目录下:

![screenshot_image-20240830144004987.png](https://oss-club.rt-thread.org/uploads/20240830/84c5bb48ca6291b6a116e0e922fd4dce.png)

修改applications目录下的Scons脚本，示例如下：

```python
import rtconfig
from building import *

cwd = GetCurrentDir()
src = Glob('*.c')

CPPDEFINES=[]
CPPPATH = [cwd]

group = DefineGroup('Applications', src, depend = [''], CPPPATH = CPPPATH, CPPDEFINES=CPPDEFINES)

list = os.listdir(cwd)
for item in list:
    if os.path.isfile(os.path.join(cwd, item, 'SConscript')):
        group = group + SConscript(os.path.join(item, 'SConscript'))

Return('group')
```

完成上述工作，只要组件参与编译且编译没问题，组件添加成功。

## 使用示例

当前组件C的内容极其简单，同时对用户仅提供单个API：void rvbacktrace(void),用户在需要的地方调用该API就可以将当前的调用栈信息输出，示例（下文演示为HPM6750）：

### 1.在示例代码适当位置调用rvbacktrace

```c
int main(void)
{
    extern void rvbacktrace(void);
    rvbacktrace();
    return 0;
}
```

### 2.运行代码，终端输出调用栈信息

![screenshot_image-20240830145139827.png](https://oss-club.rt-thread.org/uploads/20240830/6db3a193841d6390a4f6298e82792cc2.png)

### 3.栈回溯信息直观化

可以看到的是当前shell输出的信息没有符号信息，不太直观，当前组件提供了两种方法：1.使用addr2line工具 2.结合返汇编文件中的信息输出调用栈符号。当然还有更好的想法，已经在路上了.接下来详细介绍这俩中方法的使用

#### 3.1 addr2line工具

可以看到shell输出的信息中包含addr2line需要的信息，我们将其拷贝，然后在当前rtthread.elf目录下使用该工具，我的环境中在wsl有该工具，则使用该工具打开，打开后将之前复制的信息拷贝至终端执行，输出如下：

![screenshot_image-20240830150158749.png](https://oss-club.rt-thread.org/uploads/20240830/9390f49baa4d252f1abd1880f97df927.png)

可以看到输出的信息已经很丰富了，在调试过程中还是很有帮助的。

#### 3.2 结合反汇编图形化

在RT-Studio配置输出反汇编命令

```SHELL
D:/RT-ThreadStudio/repo/Extract/ToolChain_Support_Packages/RISC-V/RISC-V-GCC-RV32/2022-04-12/bin/riscv32-unknown-elf-objdump -d rtthread.elf > rtthread.asm
```

![screenshot_image-20240830150422955.png](https://oss-club.rt-thread.org/uploads/20240830/40c81002d5bf80312b237fc768af51db.png.webp)

在反汇编文件同级目录下创建一个txt文本将shell输出的信息拷贝至txt文本

![screenshot_image-20240830150710510.png](https://oss-club.rt-thread.org/uploads/20240830/119dd1244967848eed108d325d1f1db1.png)

rvbacktrace.txt中的内容如下：

![screenshot_image-20240830151500431.png](https://oss-club.rt-thread.org/uploads/20240830/4c45075dba6c1c22aa27875ed25cb83b.png)

然后点击工程目录下的RVBacktrace.py

![screenshot_image-20240830150854537.png](https://oss-club.rt-thread.org/uploads/20240830/5b8e28e992f5bef7d115169ff0359289.png)

运行界面：

![screenshot_image-20240830150917658.png](https://oss-club.rt-thread.org/uploads/20240830/855146675b724326ce3a901c9d20ae78.png)

这里我们输入rvbacktrace.txt与rtthread.asm的路径，为了方便将它俩放在了同一目录下，

复制它两的路径并输入到上述终端中：

```c
D:\RT-ThreadStudio\workspace\HPM6750\flash_debug
```