CmBackTrace的移植与使用（转自https://zhuanlan.zhihu.com/p/366558691）

最新推荐文章于 2025-06-24 08:58:47 发布

eliote_C

最新推荐文章于 2025-06-24 08:58:47 发布

阅读量872

点赞数

CC 4.0 BY-SA版权

分类专栏：嵌入式c 文章标签： stm32

原文链接：https://zhuanlan.zhihu.com/p/366558691

嵌入式c 专栏收录该内容

12 篇文章

订阅专栏

本文介绍CmBacktrace，一款专为Cortex-M系列MCU设计的错误追踪库，能自动诊断故障原因并解析调用栈。通过添加到Keil工程，简化移植并演示了如何配置、使用和分析硬故障。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

CmBacktrace （Cortex Microcontroller Backtrace）是一款针对 ARM Cortex-M 系列 MCU 的错误代码自动追踪、定位，错误原因自动分析的开源库。主要特性如下：

支持的错误包括：
- 断言（assert）
- 故障（Hard Fault, Memory Management Fault, Bus Fault, Usage Fault, Debug Fault）
故障原因自动诊断：可在故障发生时，自动分析出故障的原因，定位发生故障的代码位置，而无需再手动分析繁杂的故障寄存器；
输出错误现场的函数调用栈（需配合 addr2line 工具进行精确定位），还原发生错误时的现场信息，定位问题代码位置、逻辑更加快捷、精准。也可以在正常状态下使用该库，获取当前的函数调用栈；

移植部分：

项目地址：

https://github.com/armink/CmBacktracegithub.com/armink/CmBacktrace

模块移植比较简单，只需要把cmbacktrace内的文件添加进keil工程，相应的头文件路径添加完毕，添加对应的hardfault.s以及cmbacktrace.c文件进入keil工程即可。

keil工程添加的内容

cmb_cfg.h为模块配置文件，为了方便查阅本人添加进keil工程。不添加也可

头文件路径

注意：使用本模块需要勾线c99支持。

注释用户自己编写的hardfault处理函数，若无法注释应当在hardfault处理函数中添加cmb模块的函数。参考链接：https://github.com/armink/CmBacktrace/blob/master/README_ZH.md

在初始化部分添加init函数

#include <cm_backtrace.h>
#define HARDWARE_VERSION "V1.0.0" #define SOFTWARE_VERSION "V0.1.0" cm_backtrace_init("SPD1188_test", HARDWARE_VERSION, SOFTWARE_VERSION);

在断言函数内执行如下函数

// assert断言重定向
void __aeabi_assert(const char *expr, const char *file, int line) { uint32_t __msp = 0; __msp = __get_MSP(); cm_backtrace_assert(__msp); printf("assert in file:%s expr:%s line:%d\n", file, expr, line); for(;;); }

在cfg.h内配置模块的相应选项

/* print line, must config by user */
#define cmb_println(...) printf(__VA_ARGS__);printf("\r\n") //输出选项配置 /* enable bare metal(no OS) platform */ #define CMB_USING_BARE_METAL_PLATFORM //不使用os /* enable OS platform */ /* #define CMB_USING_OS_PLATFORM */ //使用os /* OS platform type, must config when CMB_USING_OS_PLATFORM is enable */ /* #define CMB_OS_PLATFORM_TYPE CMB_OS_PLATFORM_RTT or CMB_OS_PLATFORM_UCOSII or CMB_OS_PLATFORM_UCOSIII or CMB_OS_PLATFORM_FREERTOS *///使用哪种os /* cpu platform type, must config by user */ #define CMB_CPU_PLATFORM_TYPE CMB_CPU_ARM_CORTEX_M4 //cpu类型 /* enable dump stack information */ #define CMB_USING_DUMP_STACK_INFO //追踪堆栈信息 /* language of print information */ #define CMB_PRINT_LANGUAGE CMB_PRINT_LANGUAGE_ENGLISH //打印语言选择英文 // #define CMB_PRINT_LANGUAGE CMB_PRINT_LANGUAGE_CHINESE //打印语言选择中文（中文支持较差，建议英文打印）

用户自行设置printf函数重定向

使用教程：

在出现硬件异常的时候，cmb模块会在输出端进行错误信息的打印。帮助用户排查hardfault的原因，打印出来的结果如下图所示：