Skip to content

调试与烧录 ​

调试能力决定开发速度。能定位问题的人一天收工,只能靠猜的人一周还在改代码。

三种下载方式 ​

方式接口优点限制
SWDSWDIO / SWCLK / GND / 3V3(+NRST)可单步、可读内存、占用引脚少需要调试器(ST-Link/DAP-Link)
JTAGTCK/TMS/TDI/TDO 等 5 线支持边界扫描引脚多,速度不占优
ISPUART + BOOT0 电平无需调试器,救砖方便不能在线调试

SWD 接线的三条经验:

  • 一定要接 GND,只接两根信号线时好时坏。
  • NRST 建议接上:程序进入低功耗或关掉调试引脚后,靠复位连接才能救回来。
  • 目标板与调试器不要同时用两个电源,除非确认没有电位差。

串口日志:最低成本的观测手段 ​

分级输出,避免日志把时序打乱:

c
#define LOG_LEVEL_ERROR 1
#define LOG_LEVEL_WARN  2
#define LOG_LEVEL_INFO  3
#define LOG_LEVEL_DEBUG 4

#ifndef LOG_LEVEL
#define LOG_LEVEL LOG_LEVEL_INFO
#endif

#define LOG_E(fmt, ...) do { if (LOG_LEVEL >= 1) printf("[E] " fmt "\r\n", ##__VA_ARGS__); } while (0)
#define LOG_W(fmt, ...) do { if (LOG_LEVEL >= 2) printf("[W] " fmt "\r\n", ##__VA_ARGS__); } while (0)
#define LOG_I(fmt, ...) do { if (LOG_LEVEL >= 3) printf("[I] " fmt "\r\n", ##__VA_ARGS__); } while (0)
#define LOG_D(fmt, ...) do { if (LOG_LEVEL >= 4) printf("[D] " fmt "\r\n", ##__VA_ARGS__); } while (0)

printf 的代价

sprintf 家族在 8 位机上可能占用几百字节栈并耗时毫秒级。中断里绝不能打印;实时性要求高的循环里,先把数据存环形缓冲,主循环再统一输出。

逻辑分析仪:看清时序 ​

串口乱码、I2C NACK、SPI 错位这类问题,用分析仪抓一次波形比读十遍代码快。

常用配置:

协议采样率触发条件
UART 115200≥2MHz起始位下降沿
I2C 400kHz≥10MHzSDA 下降沿(START)
SPI 10MHz≥50MHzCS 下降沿
CAN 500k≥10MHz帧起始显性位

抓不到波形的常见原因:地线没接、探头接在串联电阻之后、采样率低于信号频率的 4 倍。

HardFault 定位 ​

程序跑飞进入 HardFault_Handler 时,栈里保存着出错现场。核心思路是从 MSP/PSP 取出压栈的 8 个寄存器,找到出错 PC。

c
void HardFault_Handler(void)
{
    __asm volatile (
        "tst lr, #4          \n"   /* 判断出错时用的是 MSP 还是 PSP */
        "ite eq              \n"
        "mrseq r0, msp       \n"
        "mrsne r0, psp       \n"
        "mov r1, lr          \n"
        "b hardfault_report  \n"
    );
}

void hardfault_report(unsigned int *frame, unsigned int lr)
{
    volatile unsigned int pc  = frame[6];   /* 出错指令地址 */
    volatile unsigned int lr_ = frame[5];
    volatile unsigned int psr = frame[7];
    (void)lr; (void)lr_; (void)psr;

    LOG_E("HardFault pc=0x%08X", pc);
    for (;;) { }   /* 在此处打断点,用调试器反查 pc 对应源码 */
}

再看三个寄存器缩小范围:

寄存器含义典型值解读
CFSR可配置故障状态0x8200 → 非对齐访问
HFSR硬故障状态bit30 置位表示由其它故障升级而来
MMFAR / BFAR出错地址空指针、野指针直接指向这里

常见触发原因排序:空指针解引用、数组越界、栈溢出、未对齐访问(packed 结构体强转)、函数指针未初始化。

下载失败排查 ​

报错/现象原因处理
No target connected供电、接线、SWD 被复用检查 3V3/GND,接 NRST 后选「Connect under reset」
Cannot access target芯片处于低功耗或被读保护用 ISP 全片擦除,或复位时连接
Flash Download failedFlash 算法选错、容量不符换对应型号算法,确认 Flash Size
下载成功但不运行BOOT0 电平、向量表偏移确认从 Flash 启动,VTOR 指向正确
偶发下载失败杜邦线过长、时钟太快SWD 降速到 1MHz 以下

救砖顺序

  1. 用 BOOT0 = 1 进 ISP,串口全片擦除;
  2. 擦除后 BOOT0 = 0 正常启动;
  3. 若仍连不上,检查是否误配了调试引脚为普通 IO,此时必须靠 NRST 复位连接。

调试习惯 ​

  • 一次只改一个变量,改完立即验证。
  • 关键路径加「心跳」:主循环翻转一个 IO,用示波器看周期,比打印更不干扰时序。
  • 保留一份能跑的版本,改动前打 tag 或复制目录,避免「改坏了回不去」。

以资料沉淀经验,用产品验证想法 · 嵌入式资料与产品文档