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

• 支持的错误包括：
  & u4 k& `  ?$ g9 @
  • 断言（assert）
  • 故障（Hard Fault, Memory Management Fault, Bus Fault, Usage Fault, Debug Fault）
    : r) j( D3 I* i  J" Z0 q+ X' F$ M1 f
• 故障原因 自动诊断 ：可在故障发生时，自动分析出故障的原因，定位发生故障的代码位置，而无需再手动分析繁杂的故障寄存器；
• 输出错误现场的 函数调用栈（需配合 addr2line 工具进行精确定位），还原发生错误时的现场信息，定位问题代码位置、逻辑更加快捷、精准。也可以在正常状态下使用该库，获取当前的函数调用栈；
• 支持 裸机 及以下操作系统平台：
  4 q+ z& C  V9 c: M. ^
  • RT-Thread
  • UCOS
  • FreeRTOS（需修改源码）
    
• 根据错误现场状态，输出对应的 线程栈 或 C 主栈；
• 故障诊断信息支持多国语言（目前：简体中文、英文）；
• 适配 Cortex-M0/M3/M4/M7 MCU；
• 支持 IAR、KEIL、GCC 编译器；
  

1、为什么选择 CmBacktrace入门新人 ：对于从 C51 、MSP430 等简单单片机转而使用更加复杂的 ARM  新人来说，时不时出现的 "hard falut" 死机会让新人瞬间懵掉。定位错误的方法也往往是连接上仿真器，一步步 F10/F11 单步，定位到具体的错误代码，再去猜测、排除、推敲错误原因，这种过程十分痛苦。
熟练老手 ：慢慢的大家知道可以通过故障寄存器信息来定位故障原因及故障代码地址，虽然这样能解决一小部分问题，但是重复的、繁琐的分析过程也会耽误很多时间。而且对于一些复杂问题，只依靠代码地址是无法解决的，必须得还原错误现场的函数调用逻辑关系。虽然连接仿真器可以查看到的函数调用栈，但故障状态下是无法显示的，所以还是得一步步 F10/F11 单步去定位错误代码的位置。另外，还有两种场景，

• 1、很多产品真机调试时必须断开仿真器
• 2、问题确实存在，但是极难被重现
  6 q7 Y" _  w( o/ U* ?' Z6 C

所以定位这类问题就显得难上加难。
使用本库 ：上述所有问题都迎刃而解，可以将错误信息输出到控制台上，还可以将错误信息使用 EasyFlash 的 Log 功能保存至 Flash 中，设备死机后重启依然能够读取上次的错误信息。CmBacktrace 输出的信息包括函数调用栈、故障诊断结果、堆栈、故障寄存器及产品固件信息，极大的提升了错误定位的效率及准确性。
俗话说，工欲善其事，必先利其器。所以有时候做事效率低的原因也许是，你会用的工具种类太少。
合作、贡献 ：开源软件的发展离不开大家的支持，欢迎大家多提建议，也希望更多的人一起参与进来，共同提高  。如果觉得这个开源项目很赞，可以点击 项目主页 (Github|OSChina|Coding)  右上角的 Star ，同时把它推荐给更多有需要的朋友。
2、CmBacktrace 如何使用2.1 演示该演示分如下几个步骤：

• 1、制造除零异常（IAR 工程，点击查看源码）
• 2、查看错误诊断信息
• 3、查看函数调用栈基本信息
• 4、通过命令行工具进入项目工程存放可执行文件的路径
• 5、使用 addr2line 命令，查看函数调用栈详细信息，并定位错误代码
  

: S. b( l- _2 U; E6 u. k2.2 Demo

目录

平台

链接

! f8 Y# k" e  `1 B: o

\demos\non_os\stm32f10x

裸机 STM32 Cortex-M3

点击查看

\demos\os\rtthread\stm32f4xx

RT-Thread STM32 Cortex-M4

点击查看

& O: ^1 g& V2 u9 s0 q

\demos\os\ucosii\stm32f10x

UCOSII STM32 Cortex-M3

点击查看

\demos\os\freertos\stm32f10x

FreeRTOS STM32 Cortex-M3

点击查看

2.3 移植说明2.3.1 准备工作

• 1、查看 \demos 目录下有没有合适自己的 Demo ，如有类似，则建议在其基础上修改
• 2、明确操作系统/裸机平台及 CPU 平台
• 3、将 \src 下的全部源文件添加至产品工程中，并保证源码目录被添加至头文件路径
• 4、cmb_fault.s 汇编文件（点击查看）可以选择性添加至工程，添加后需要把项目原有的 HardFault_Handler 注释掉
• 5、把 cm_backtrace_init 函数放在项目初始化地方执行
• 6、将 cm_backtrace_assert 放在项目的断言函数中执行，具体使用方法参照下面的 API 说明
• 7、如果第 4 步骤没有将 cmb_fault.s 汇编文件启用，则需要将 cm_backtrace_fault 放到故障处理函数（例如： HardFault_Handler ）中执行，具体使用方法参照下面的 API 说明
  5 C* z; T9 [3 f: S2 O9 e5 Z8 f

2.3.2 配置说明配置文件名： cmb_cfg.h ，针对不同的平台和场景，用户需要自自行手动配置，常用配置如下：
4 G0 k. X6 d% g- q( m' S; U

配置名称

功能

备注

- Z0 R+ C) ]4 l5 {( P

cmb_println(...)

错误及诊断信息输出

必须配置

CMB_USING_BARE_METAL_PLATFORM

是否使用在裸机平台

使用则定义该宏

CMB_USING_OS_PLATFORM

是否使用在操作系统平台

操作系统与裸机必须二选一

5 t3 k  ~! d! o- @+ G* m

CMB_OS_PLATFORM_TYPE

操作系统平台

RTT/UCOSII/UCOSIII/FREERTOS

CMB_CPU_PLATFORM_TYPE

CPU平台

M0/M3/M4/M7

CMB_USING_DUMP_STACK_INFO

是否使用 Dump 堆栈的功能

使用则定义该宏

  f9 x/ n" E6 i" {) t9 f# G6 C

CMB_PRINT_LANGUAGE

输出信息时的语言

CHINESE/ENGLISH

注意：以上部分配置的内容可以在 cmb_def.h 中选择，更多灵活的配置请阅读源码
- c( y8 c6 x% [

2.4 API 说明2.4.1 库初始化void cm_backtrace_init(const char *firmware_name, const char *hardware_ver, const char *software_ver)

  X) k% x! L$ M0 y- w, I" d( L( c

参数

描述

) s- l- f5 Z- c3 i& f: a* M

firmware_name

固件名称，需与编译器生成的固件名称对应

2 t8 {* ]! X, H/ V& w8 R, V

hardware_ver

固件对应的硬件版本号

* B: s$ q( s; }, I6 z

software_ver

固件的软件版本号

注意 ：以上入参将会在断言或故障时输出，主要起了追溯的作用

2.4.2 获取函数调用栈size_t cm_backtrace_call_stack(uint32_t *buffer, size_t size, uint32_t sp)

参数

描述

0 i3 Y1 O$ F( }4 ^4 H

buffer

存储函数调用栈的缓冲区

size

缓冲区大小

sp

待获取的堆栈指针

示例：
/* 建立深度为 16 的函数调用栈缓冲区，深度大小不应该超过 CMB_CALL_STACK_MAX_DEPTH（默认16） */uint32_t call_stack[16] = {0};size_t i, depth = 0;/* 获取当前环境下的函数调用栈，每个元素将会以 32 位地址形式存储， depth 为函数调用栈实际深度 */depth = cm_backtrace_call_stack(call_stack, sizeof(call_stack), __get_SP());/* 输出当前函数调用栈信息 * 注意：查看函数名称及具体行号时，需要使用 addr2line 工具转换 */for (i = 0; i < depth; i++) {    printf("%08x ", call_stack);}

2.4.3 追踪断言错误信息void cm_backtrace_assert(uint32_t sp)
! w2 I8 q+ f- }6 ^  m4 K0 g

参数

描述

sp

断言环境时的堆栈指针

注意 ：入参 SP 尽量在断言函数内部获取，而且尽可能靠近断言函数开始的位置。当在断言函数的子函数中（例如：在 RT-Thread 的断言钩子方法中）使用时，由于函数嵌套会存在寄存器入栈的操作，此时再获取 SP 将发生变化，就需要人为调整（加减固定的偏差值）入参值，所以作为新手 不建议在断言的子函数 中使用该函数。

2.4.4 追踪故障错误信息void cm_backtrace_fault(uint32_t fault_handler_lr, uint32_t fault_handler_sp)
" {- b# Q5 k. S9 t( T$ U

参数

描述

) C$ t( M7 |6 y7 O0 x' y

fault_handler_lr

故障处理函数环境下的 LR 寄存器值

fault_handler_sp

故障处理函数环境下的 SP 寄存器值

该函数可以在故障处理函数（例如： HardFault_Handler）中调用。另外，库本身提供了 HardFault 处理的汇编文件（点击查看，需根据自己编译器进行选择），会在故障时自动调用 cm_backtrace_fault 方法。所以移植时，最简单的方式就是直接使用该汇编文件。
2.5 常见问题2.5.1 编译出错，提示需要 C99 支持点击查看教程：一步开启 Keil/IAR/GCC 的 C99 支持
2.5.2 如何查看到函数调用栈中函数的具体名称及代码行号点击查看教程：如何使用 addr2line 工具获取函数调用栈详细信息
6 K" `, r7 M% }3 V- M2.5.3 故障处理函数：HardFault_Handler 重复定义在使用了本库提供的 cmb_fault.s 汇编文件时，因为该汇编文件内部已经定义了 HardFault_Handler ，所以如果项目中还有其他地方定义了该函数，则会提示 HardFault_Handler 被重复定义的错误。此时有两种解决方法：

• 1、注释/删除其他文件中定义的 HardFault_Handler 函数，仅保留 cmb_fault.s 中的；
• 2、将 cmb_fault.s 移除工程，手动添加 cm_backtrace_fault 函数至现有的故障处理函数，但需要注意的是，务必 保证该函数数入参的准备性 ，否则可能会导致故障诊断功能及堆栈打印功能无法正常运行。所以如果是新手，不推荐第二种解决方法。
  

2.6 许可采用 MIT 开源协议，细节请阅读项目中的 LICENSE 文件内容。

$ a7 r1 v, @3 b6 p

谢谢分享，先收藏了

这个不错，谢谢分享。。。。。。。。。。

对于硬件错误，查看堆栈寄存器的值能找到确定点的位置么？我现在通过使用这个，系统为rt-thread，使用addr2line命令定位在rt_hw_interrupt_enable关闭系统中断函数上，这就让我费解了，所以怀疑正确性

int main(void)
2 d: ?# i; `! o{
#if 0
    NVIC_SetVectorTable(NVIC_VectTab_FLASH, 0x20000);   
    __enable_irq();
  C! ?2 I9 R" U) j% \#endif
    mainInit();
    delay_ms(2000);
    delay_ms(2000);
0 U' E' N* x- x0 a) c* F% B    OSInit();
    OSTaskCreate(start_task, (void *) 0,(OS_STK *) &START_TASK_STK[START_STK_SIZE - 1], START_TASK_PRIO);
    OSStart();
}
. L; c9 _4 E* D+ [
' m4 E, _1 m- q* I3 xvoid start_task(void *pdata)
$ h5 D. N! u8 S& x{
. z3 A$ q0 I: ]! z3 R) f$ H6 C    u8 *sta;
6 j  M' m, L+ S    DEBUG("PC_process", " enter start_task function !!!");
    OSStatInit();                    
    while (1)
    {
        delay_ms(2000);
# J( x! `0 _+ `: w( L+ |9 V4 p% v        DEBUG("PC_process", " sta = %d",*sta);
    }
}
& Y% `) w! g# ?6 `2 p
8 X7 z+ g# t- j, v  U
为什么用这个工具 定位出来的 代码 位置： OSStart(),  但是错误应该是 这句：DEBUG("PC_process", " sta = %d",*sta); 啊， 这是为什么啊？？？
* X0 |; t1 q0 Y$ V8 P. q+ R' a下面是定位出来的内容：
E:\工作\MCU 资料\stm32 资料\cmBacktrack_project_test\cmbackTrace\online_gprs\Objects>addr2line -e charger.axf -a -f 08000352 0800252b 0800428f 080002ff
0x08000352
OSStartHighRdy
E:\工作\MCU 资料\stm32 资料\cmBacktrack_project_test\cmbackTrace\online_gprs/..\src_common\ucosii\port\/os_cpu_a.asm:110
0x0800252b
OSStart
1 ]/ \+ {" y2 @2 E) }: i* CE:\宸ヤ綔\MCU 璧勬枡\stm32 璧勬枡\cmBacktrack_project_test\cmbackTrace\online_gprs/..\src_common\ucosii\core\/os_core.c:830
0x0800428f
# Z  R8 [5 N. ]; ]" Gmain
E:\宸ヤ綔\MCU 璧勬枡\stm32 璧勬枡\cmBacktrack_project_test\cmbackTrace\online_gprs/src\main.c:52
0x080002ff
__rt_entry_main
( |! c/ |/ y8 h
! @: V0 I$ t% m2 I


# z$ D3 \0 }: A4 y

mark

你好，我在MDK 5.29 编译器AC6.13.1下。初始化时提示无法定义标签 STACK
请问怎样才能正确引用该标签？

启动文件startup_stm32f103xe.s头部已经明确定义了 STACK
Stack_Size                EQU     0x1000

7 o+ Y. r3 p8 {3 G' X( G                AREA    STACK, NOINIT, READWRITE, ALIGN=3
2 H% h4 Y9 ~4 yStack_Mem       SPACE   Stack_Size
/ w* |+ r8 O( R+ e5 {__initial_sp
4 P0 p* I  r6 W+ w8 G& \

非常好的资料，对初学者很有帮助；
希望楼主多多分享，赠人玫瑰，手有余香，念念不忘，必有回响;.

赞赞赞
' H; x! p4 w+ t7 _) u