单片机与物联网 / 系统课时
用 CFSR 追踪 HardFault
用 CFSR 追踪 HardFault
程序进入 HardFault_Handler 后,不能只盯着当前 PC 猜测错误位置。本课使用 Cortex-M 的 CFSR、HFSR 和异常堆栈现场,区分非法内存访问、无效指令和故障升级,并通过一个可放入裸机工程的处理器保存关键证据。
学习目标
- 理解 CFSR、HFSR 和异常堆栈中 PC 的定位职责。
- 编写 HardFault 处理器,保存故障寄存器与异常现场。
- 根据实际寄存器值判断故障类型,并验证定位结果。
先判断 HardFault 从哪里来
以下操作以 ARMv7-M 的 Cortex-M3/M4/M7 为主要适用范围,示例代码针对 Cortex-M4、GCC 和 CMSIS。Cortex-M0/M0+ 不具备相同的可配置故障寄存器集合,不能照搬此方法。
HardFault 有两类常见来源:一类是直接产生硬故障,另一类是 MemManage、BusFault 或 UsageFault 无法被正常处理后升级为 HardFault。例如,相关故障处理器未使能时,原本属于可配置故障的异常就可能升级。

调试时先读取以下寄存器,地址均属于系统控制空间:
| 寄存器 | 地址 | 定位作用 |
|---|---|---|
| CFSR | 0xE000ED28 | 记录内存管理、总线和使用错误 |
| HFSR | 0xE000ED2C | 记录硬故障原因及升级标志 |
| MMFAR | 0xE000ED34 | 在有效标志置位时提供内存管理故障地址 |
| BFAR | 0xE000ED38 | 在有效标志置位时提供总线故障地址 |
解码 CFSR 和 HFSR
CFSR 是一个 32 位寄存器,可以分为低 8 位的 MMFSR、中间 8 位的 BFSR 和高 16 位的 UFSR。以下位号均为完整 CFSR 中的位置,而不是各子寄存器内部的局部编号。
| CFSR 位 | 标志 | 常见含义 |
|---|---|---|
| 0 | IACCVIOL | 指令访问违反内存保护规则 |
| 1 | DACCVIOL | 数据访问违反内存保护规则 |
| 7 | MMARVALID | MMFAR 内的地址有效 |
| 8 | IBUSERR | 指令读取发生总线错误 |
| 9 | PRECISERR | 精确数据总线错误 |
| 10 | IMPRECISERR | 非精确数据总线错误 |
| 15 | BFARVALID | BFAR 内的地址有效 |
| 16 | UNDEFINSTR | 执行了未定义指令 |
| 17 | INVSTATE | 执行状态不合法 |
| 18 | INVPC | 异常返回时完整性检查失败 |
| 19 | NOCP | 使用了不可用的协处理器 |
| 24 | UNALIGNED | 发生受检查约束的非对齐访问 |
| 25 | DIVBYZERO | 启用除零捕获时出现整数除零 |
另外,CFSR 的位 3~5 和 11~13 可报告异常入栈、出栈或浮点延迟保存相关错误。它们出现时,异常堆栈也可能不完整,不能无条件相信保存的 PC。
HFSR 重点关注两个位:位 1 的 VECTTBL 表示异常向量读取时发生总线故障;位 30 的 FORCED 表示可配置故障升级为 HardFault。
例如,调试器显示:
- HFSR =
0x40000000,说明 FORCED 已置位。 - CFSR =
0x00008200,说明 PRECISERR 与 BFARVALID 已置位。 - BFAR =
0x20010000,给出发生精确数据总线错误的访问地址。
这组数据表明需要沿精确数据访问错误排查,并检查 PC 对应的访存指令。0x20010000 是否非法取决于芯片的实际内存映射,不能只凭地址数值直接认定越界。
从异常堆栈找出 PC
Cortex-M 进入异常时,硬件通常会保存 R0、R1、R2、R3、R12、LR、PC 和 xPSR,形成基本异常栈帧。保存的 PC 是异常发生前的执行现场,而不是 HardFault_Handler 自身的地址。

异常处理器入口处,LR 持有 EXC_RETURN 编码。其位 2 用于判断返回时采用哪一个栈指针:0 对应 MSP,1 对应 PSP。具有 FPU 的处理器还要判断位 4:为 0 时存在扩展浮点栈帧,基本栈帧前面多出 18 个 32 位槽位。
下面是片段示例,依赖 Cortex-M4 裸机工程、CMSIS 的 core_cm4.h、GCC ARM 工具链,以及启动文件将 HardFault 向量连接到 HardFault_Handler。用于调试构建,不应作为生产环境的故障恢复实现。
#include <stdint.h>
#include "core_cm4.h"
typedef struct {
uint32_t exc_return;
uint32_t cfsr;
uint32_t hfsr;
uint32_t mmfar;
uint32_t bfar;
uint32_t pc;
uint32_t lr;
uint32_t xpsr;
} FaultSnapshot;
volatile FaultSnapshot g_fault;
__attribute__((noinline, used))
void hardfault_capture(uint32_t *sp, uint32_t exc_return) {
// 先保存状态寄存器,避免后续诊断操作覆盖证据。
g_fault.exc_return = exc_return;
g_fault.cfsr = SCB->CFSR;
g_fault.hfsr = SCB->HFSR;
g_fault.mmfar = (g_fault.cfsr & (1UL << 7)) ? SCB->MMFAR : 0;
g_fault.bfar = (g_fault.cfsr & (1UL << 15)) ? SCB->BFAR : 0;
// 扩展浮点栈帧的基本寄存器区位于后面 18 个字处。
uint32_t *basic = sp + ((exc_return & (1UL << 4)) ? 0 : 18);
g_fault.pc = basic[6];
g_fault.lr = basic[5];
g_fault.xpsr = basic[7];
while (1) {
__NOP();
}
}
__attribute__((naked))
void HardFault_Handler(void) {
__asm volatile (
"tst lr, #4\n"
"ite eq\n"
"mrseq r0, msp\n"
"mrsne r0, psp\n"
"mov r1, lr\n"
"b hardfault_capture\n"
);
}预期结果:发生普通且入栈成功的 HardFault 后,程序停留在 hardfault_capture 的无限循环中。暂停调试器,查看全局变量 g_fault,即可读取 CFSR、HFSR、异常现场 PC 和 LR。具体数值由实际故障决定,不存在固定的预期地址。
用 PC 和故障位定位指令
得到现场后,按下面的顺序排查,避免把 Handler 的当前 PC 误当作出错指令。
- 记录 HFSR 和 CFSR,确认是否发生故障升级,以及具体错误类型。
- 仅当 MMARVALID 或 BFARVALID 置位时,使用对应地址寄存器定位访存目标。
- 从异常栈帧提取 PC,在调试器反汇编窗口跳转到该地址。
- 对照 ELF 文件的符号信息、源代码和反汇编,确认目标指令操作的寄存器与地址。
- 检查指针来源、外设地址、栈边界、MPU 配置或函数指针的 Thumb 状态。
例如,针对前面的 CFSR = 0x00008200,如果保存的 PC 对应 STR 指令,就需要检查其计算出的目标地址是否与 BFAR 一致,并核对相应存储区是否真正存在且允许写入。
可以在构建完成后使用 GNU Arm 工具链反汇编固件。以下命令假设当前目录存在带调试符号的 firmware.elf:
arm-none-eabi-objdump -d -S firmware.elf > firmware.dis预期结果:命令成功时通常没有终端输出,并生成 firmware.dis 文件。文件中的地址、指令与源代码对应关系取决于编译结果;使用调试器取得的 PC 搜索对应地址即可。建议使用 -g -Og 构建调试版本,优化可能改变源代码与机器指令的对应关系。
不同故障类型需要不同的定位策略:
- PRECISERR:保存的 PC 通常能指向相关访存指令。
- IMPRECISERR:错误可能延迟报告,保存的 PC 不一定是引发总线写入错误的指令。
- UNDEFINSTR:检查 PC 附近指令是否损坏、函数指针是否跳错位置。
- INVSTATE:检查分支目标、异常返回现场与 Thumb 执行状态。
- INVPC:重点核对 EXC_RETURN、堆栈内容及异常返回过程。
对于 IMPRECISERR,部分 Cortex-M3/M4 实现可利用 ACTLR 的 DISDEFWBUF 控制默认存储器的写缓冲行为,以辅助定位,但该功能并非所有 Cortex-M 都提供;不能把 Cortex-M7 当成具有完全相同的开关。
验证修复是否真正有效
修复代码后,不应只看系统能否重新启动。建议在调试版中执行完整回归,至少包含正常业务运行、原先触发故障的输入,以及中断密集或栈占用较高的场景。
| 检查项 | 合格判据 |
|---|---|
| 原故障复现路径 | 连续执行 100 次不再进入 HardFault_Handler |
| 关键内存访问 | 地址落在芯片手册定义的有效区域,权限正确 |
| 主栈和进程栈 | 高水位检查未越过配置的栈边界 |
| 异常处理 | 连续触发 1000 次目标中断,无异常嵌套或返回失败 |
| 故障记录 | 在测试固件中人为制造可控故障,仍可取得有效状态信息 |
上述次数是本课的示例验收门槛,不是 Cortex-M 硬件规定的可靠性标准。人为故障注入应只在测试固件和可恢复的开发板上执行。
还要注意,CFSR 中的状态位可能保留此前尚未清除的错误记录。在完成调试、准备新的故障注入测试前,应按寄存器的写 1 清除规则处理相关位,并重新开始一次干净的测试,不要把历史故障与当前故障混在一起。
实际定位时,最可靠的证据组合是 HFSR 判断升级原因、CFSR 确认错误类别、有效的 MMFAR/BFAR 确认目标地址,再由异常堆栈 PC 对照反汇编找到相关指令。只要出现异常入栈失败或非精确总线错误,就必须降低对 PC 的信任程度,改从栈和总线访问上下文继续追查。