相信有不少讀者都遇到過 “HardFault”的問題，而且不止一次，有時候可能因為它連續幾日加班，甚至通宵。 那么今天就來分享一個由armink（也就是現在RTT里面的那位朱大神）整理的開源庫，借花獻佛分享給大家。一、CmBacktrace 是什么

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

1. 支持的錯誤包括

斷言（assert）

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

2. 故障原因自動診斷可在故障發生時，自動分析出故障的原因，定位發生故障的代碼位置，而無需再手動分析繁雜的故障寄存器；3. 輸出錯誤現場的函數調用棧（需配合 addr2line 工具進行精確定位），還原發生錯誤時的現場信息，定位問題代碼位置、邏輯更加快捷、精準。也可以在正常狀態下使用該庫，獲取當前的函數調用棧；4. 支持 裸機 及以下操作系統平臺：

RT-Thread

UCOS

FreeRTOS（需修改源碼）

5. 根據錯誤現場狀態，輸出對應的 線程棧 或 C 主棧；6.故障診斷信息支持多國語言（目前：簡體中文、英文）；7.適配Cortex-M0/M3/M4/M7 MCU；

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

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

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

另外，還有兩種場景：1、很多產品真機調試時必須斷開仿真器2、問題確實存在，但是極難被重現

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

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

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

三、CmBacktrace 如何使用

本文就簡單演示一下，演示分如下幾個步驟：1、制造除零異常（IAR 工程，點擊查看源碼）2、查看錯誤診斷信息3、查看函數調用棧基本信息4、通過命令行工具進入項目工程存放可執行文件的路徑

5、使用 addr2line 命令，查看函數調用棧詳細信息，并定位錯誤代碼

具體的使用方法，請見原始說明文檔，里面描述了很多細節內容。

原文標題：專治MCU各種 HardFault 的庫：CmBacktrace（錯誤追蹤庫）

文章出處：【微信公眾號：MCU開發加油站】歡迎添加關注！文章轉載請注明出處。

責任編輯：haq