主题
调试与烧录
调试能力决定开发速度。能定位问题的人一天收工,只能靠猜的人一周还在改代码。
三种下载方式
| 方式 | 接口 | 优点 | 限制 |
|---|---|---|---|
| SWD | SWDIO / SWCLK / GND / 3V3(+NRST) | 可单步、可读内存、占用引脚少 | 需要调试器(ST-Link/DAP-Link) |
| JTAG | TCK/TMS/TDI/TDO 等 5 线 | 支持边界扫描 | 引脚多,速度不占优 |
| ISP | UART + 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)1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
printf 的代价
sprintf 家族在 8 位机上可能占用几百字节栈并耗时毫秒级。中断里绝不能打印;实时性要求高的循环里,先把数据存环形缓冲,主循环再统一输出。
逻辑分析仪:看清时序
串口乱码、I2C NACK、SPI 错位这类问题,用分析仪抓一次波形比读十遍代码快。
常用配置:
| 协议 | 采样率 | 触发条件 |
|---|---|---|
| UART 115200 | ≥2MHz | 起始位下降沿 |
| I2C 400kHz | ≥10MHz | SDA 下降沿(START) |
| SPI 10MHz | ≥50MHz | CS 下降沿 |
| 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 对应源码 */
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
再看三个寄存器缩小范围:
| 寄存器 | 含义 | 典型值解读 |
|---|---|---|
CFSR | 可配置故障状态 | 0x8200 → 非对齐访问 |
HFSR | 硬故障状态 | bit30 置位表示由其它故障升级而来 |
MMFAR / BFAR | 出错地址 | 空指针、野指针直接指向这里 |
常见触发原因排序:空指针解引用、数组越界、栈溢出、未对齐访问(packed 结构体强转)、函数指针未初始化。
下载失败排查
| 报错/现象 | 原因 | 处理 |
|---|---|---|
No target connected | 供电、接线、SWD 被复用 | 检查 3V3/GND,接 NRST 后选「Connect under reset」 |
Cannot access target | 芯片处于低功耗或被读保护 | 用 ISP 全片擦除,或复位时连接 |
Flash Download failed | Flash 算法选错、容量不符 | 换对应型号算法,确认 Flash Size |
| 下载成功但不运行 | BOOT0 电平、向量表偏移 | 确认从 Flash 启动,VTOR 指向正确 |
| 偶发下载失败 | 杜邦线过长、时钟太快 | SWD 降速到 1MHz 以下 |
救砖顺序
- 用
BOOT0 = 1进 ISP,串口全片擦除; - 擦除后
BOOT0 = 0正常启动; - 若仍连不上,检查是否误配了调试引脚为普通 IO,此时必须靠
NRST复位连接。
调试习惯
- 一次只改一个变量,改完立即验证。
- 关键路径加「心跳」:主循环翻转一个 IO,用示波器看周期,比打印更不干扰时序。
- 保留一份能跑的版本,改动前打 tag 或复制目录,避免「改坏了回不去」。