作者：armink

編輯整理：strongerHuang

相信有不少讀者都遇到過 “HardFault” 的問題，而且不止一次，有時(shí)候可能因?yàn)樗B續(xù)幾日加班，甚至通宵。

那么今天就來分享一個由armink（也就是現(xiàn)在RTT里面的那位朱大神）整理的開源庫，借花獻(xiàn)佛分享給大家。

該庫采用采用 MIT 開源協(xié)議，開源地址：

一、CmBacktrace 是什么

CmBacktrace （Cortex Microcontroller Backtrace）是一款針對 ARM Cortex-M 系列 MCU 的錯誤代碼自動追蹤、定位，錯誤原因自動分析的開源庫。主要特性如下：

1.支持的錯誤包括

• 斷言（assert）

• 故障（Hard Fault, Memory Management Fault, Bus Fault, Usage Fault, Debug Fault）

2.故障原因自動診斷

可在故障發(fā)生時(shí)，自動分析出故障的原因，定位發(fā)生故障的代碼位置，而無需再手動分析繁雜的故障寄存器；

3.輸出錯誤現(xiàn)場的函數(shù)調(diào)用棧（需配合 addr2line 工具進(jìn)行精確定位），還原發(fā)生錯誤時(shí)的現(xiàn)場信息，定位問題代碼位置、邏輯更加快捷、精準(zhǔn)。也可以在正常狀態(tài)下使用該庫，獲取當(dāng)前的函數(shù)調(diào)用棧；

4.支持 裸機(jī) 及以下操作系統(tǒng)平臺：

• RT-Thread

• UCOS

• FreeRTOS（需修改源碼）

5.根據(jù)錯誤現(xiàn)場狀態(tài)，輸出對應(yīng)的 線程棧 或 C 主棧；

6.故障診斷信息支持多國語言（目前：簡體中文、英文）；

7.適配 Cortex-M0/M3/M4/M7 MCU；

8.支持 IAR、KEIL、GCC 編譯器；

二、為什么選擇 CmBacktrace

入門新人：對于從 C51 、MSP430 等簡單單片機(jī)轉(zhuǎn)而使用更加復(fù)雜的 ARM 新人來說，時(shí)不時(shí)出現(xiàn)的 "hard falut" 死機(jī)會讓新人瞬間懵掉。定位錯誤的方法也往往是連接上仿真器，一步步 F10/F11 單步，定位到具體的錯誤代碼，再去猜測、排除、推敲錯誤原因，這種過程十分痛苦。

熟練老手：慢慢的大家知道可以通過故障寄存器信息來定位故障原因及故障代碼地址，雖然這樣能解決一小部分問題，但是重復(fù)的、繁瑣的分析過程也會耽誤很多時(shí)間。而且對于一些復(fù)雜問題，只依靠代碼地址是無法解決的，必須得還原錯誤現(xiàn)場的函數(shù)調(diào)用邏輯關(guān)系。雖然連接仿真器可以查看到的函數(shù)調(diào)用棧，但故障狀態(tài)下是無法顯示的，所以還是得一步步 F10/F11 單步去定位錯誤代碼的位置。另外，還有兩種場景，

1、很多產(chǎn)品真機(jī)調(diào)試時(shí)必須斷開仿真器

2、問題確實(shí)存在，但是極難被重現(xiàn)

所以定位這類問題就顯得難上加難。

使用本庫：上述所有問題都迎刃而解，可以將錯誤信息輸出到控制臺上，還可以將錯誤信息使用 EasyFlash 的 Log 功能保存至 Flash 中，設(shè)備死機(jī)后重啟依然能夠讀取上次的錯誤信息。CmBacktrace 輸出的信息包括函數(shù)調(diào)用棧、故障診斷結(jié)果、堆棧、故障寄存器及產(chǎn)品固件信息，極大的提升了錯誤定位的效率及準(zhǔn)確性。

俗話說，工欲善其事，必先利其器。所以有時(shí)候做事效率低的原因也許是，你會用的工具種類太少。

三、CmBacktrace 如何使用

本文就簡單演示一下，演示分如下幾個步驟：

1、制造除零異常（IAR 工程，點(diǎn)擊查看源碼）

2、查看錯誤診斷信息

3、查看函數(shù)調(diào)用?；拘畔?/span>

4、通過命令行工具進(jìn)入項(xiàng)目工程存放可執(zhí)行文件的路徑

5、使用 addr2line 命令，查看函數(shù)調(diào)用棧詳細(xì)信息，并定位錯誤代碼

具體的使用方法，請見原始說明文檔，里面描述了很多細(xì)節(jié)內(nèi)容。

開源地址：

center;color: rgb(0, 0, 0);line-height: normal;letter-spacing: 1.5px;font-family: Optima-Regular, Optima, PingFangSC-light, PingFangTC-light, "PingFang SC", Cambria, Cochin, Georgia, Times, "Times New Roman", serif;">長按前往圖中包含的公眾號關(guān)注