单片机与物联网 / 系统课时

用 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。例如,相关故障处理器未使能时,原本属于可配置故障的异常就可能升级。

Cortex-M 故障升级和定位寄存器关系图

调试时先读取以下寄存器,地址均属于系统控制空间:

寄存器 地址 定位作用
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 自身的地址。

Cortex-M 基本异常栈帧与 PC 偏移图

异常处理器入口处,LR 持有 EXC_RETURN 编码。其位 2 用于判断返回时采用哪一个栈指针:0 对应 MSP,1 对应 PSP。具有 FPU 的处理器还要判断位 4:为 0 时存在扩展浮点栈帧,基本栈帧前面多出 18 个 32 位槽位。

下面是片段示例,依赖 Cortex-M4 裸机工程、CMSIS 的 core_cm4.h、GCC ARM 工具链,以及启动文件将 HardFault 向量连接到 HardFault_Handler。用于调试构建,不应作为生产环境的故障恢复实现。

c
#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 误当作出错指令。

  1. 记录 HFSR 和 CFSR,确认是否发生故障升级,以及具体错误类型。
  2. 仅当 MMARVALID 或 BFARVALID 置位时,使用对应地址寄存器定位访存目标。
  3. 从异常栈帧提取 PC,在调试器反汇编窗口跳转到该地址。
  4. 对照 ELF 文件的符号信息、源代码和反汇编,确认目标指令操作的寄存器与地址。
  5. 检查指针来源、外设地址、栈边界、MPU 配置或函数指针的 Thumb 状态。

例如,针对前面的 CFSR = 0x00008200,如果保存的 PC 对应 STR 指令,就需要检查其计算出的目标地址是否与 BFAR 一致,并核对相应存储区是否真正存在且允许写入。

可以在构建完成后使用 GNU Arm 工具链反汇编固件。以下命令假设当前目录存在带调试符号的 firmware.elf:

bash
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 的信任程度,改从栈和总线访问上下文继续追查。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 CFSR 追踪 HardFault

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通