1. 串口不够用的时候,我把 printf 挪到了 J-LINK 上
这几年做 MCU 项目,我手上的代码开发工具基本固定在 MDK 这一套,调试探针用 J-LINK 走 SWD 口。Event Recorder 是这个组合里最容易被忽略的组件,很多人装完 MDK 只用过断点和串口 printf,压根没打开过它。我第一次认真用它,是因为一个偶发卡死:业务协议已经把唯一的串口占满,临时加的 printf 打几个点就把时序搅乱,问题反而更难复现。
Event Recorder 解决的就是这个位置上的矛盾——事件不往串口写,而是记录到单片机 RAM 里的缓冲,再由 J-LINK 通过 SWD 读出来。它不占外设引脚,不阻塞执行,时间戳还比手动打点准。适合时序敏感、串口紧张、或者需要长时间挂机观察的 C 语言工程,对调试工具链熟一点的人上手很快,新手照着配置也能跑通。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具里的第二路输出:Event Recorder 的运行机制与选型
2.1 事件写进 RAM,再由 SWD 取走
Event Recorder 的本质是一个跑在目标芯片上的轻量记录器。组件在 MCU 的 RAM 里划出一块环形缓冲区,每次打点把事件 ID、两个 32 位参数和当前时间戳写进去,写完立刻返回,不等待任何外设。调试会话建立后,J-LINK 通过 SWD 在后台把这块缓冲区读上来,MDK 再把它还原成带时间顺序的事件列表。
这个结构决定了它的几个特性。第一,它不占用 UART、SPI 这类外设,也就不会和业务代码抢资源。第二,写入动作是纯内存操作,耗时基本可控,放在中断里也不至于把时序打乱。第三,数据只有在调试器连着的时候才有人取,脱离调试会话就只是内存里的一块数据,不会影响正常运行。
缓冲区的规模和时间戳的精度都在配置文件里定。常见做法是改 EventRecorderConf.h 里的几个宏:EVENT_RECORD_NUM_RECORDS 控制记录条数,EVENT_RECORD_TIMESTAMP_FREQ 校准时间戳频率,还有一对开关控制是否让组件参与记录。这几个值不需要一次调到位,先按默认跑起来,观察事件密度之后再动。
提示:记录条数是硬上限,缓冲区满了以后新事件会被丢弃,不会把目标卡住。丢事件是正常的,看到事件断续先怀疑这里,而不是怀疑芯片。
2.2 和串口 printf、断点、SWO 摆在一起比
同样是看程序内部发生了什么,四条通道的代价完全不同。下面这张表是我自己选型时用的判断依据:
| 输出方式 | 占用资源 | 是否阻塞目标 | 时间戳 | 典型场景 |
|---|---|---|---|---|
| 串口 printf | 一组 UART 引脚和固定波特率 | 是,逐字节等待发送 | 靠打点前后自己读时基 | 没有调试器、需要接外部记录设备 |
| Event Recorder | J-LINK 的 SWD 口 | 否,写 RAM 后立即返回 | 由组件在写入时打点 | 时序敏感、长时间观察、串口已被占用 |
| 断点 | 无 | 完全停机 | 无 | 单点状态确认 |
| SWO / ITM | 额外一根 SWO 引脚 | 较弱 | 有 | 芯片支持、且引脚没被占用 |
串口 printf 的问题不只是慢。波特率一旦定死,输出的信息量就有上限,打点一多,主循环的节拍立刻变形,原本几十微秒的周期被拉长到毫秒级,这时候看到的时序已经不是真实的时序。断点更极端,它把整个系统停住,多任务和中断的交互全被打断,很多竞态问题在断点下根本复现不出来。
SWO 是一条不错的中间路线,但它需要芯片本身支持 ITM,还得多占一根引脚。项目里引脚经常是紧的,尤其是小封装 MCU。Event Recorder 走的是本来就要接的 SWD,不额外要引脚,这一点在实际布板上很省事。
2.3 什么时候值得把 printf 挪过去
不是所有工程都值得折腾。如果项目还在功能验证阶段,串口空着,printf 直接打最省事,没必要为了调试去动 RTE 配置。但下面几种情况,我会优先切到 Event Recorder:
第一种是串口已经被业务协议占满的。Modbus、自定义帧协议这类应用,串口上多插一个 printf 就可能破坏帧间隔,这时候另开一路输出是刚需。
第二种是对时序敏感的。电机控制、采样同步、通信超时判定,这些场景里 printf 的阻塞会把问题掩盖掉,你测出来的超时和现场的根本不是一回事。
第三种是需要挂机观察的。设备跑几个小时才出一次异常,串口日志要么刷屏要么丢,Event Recorder 的环形缓冲反而更适合回溯——出问题那一刻往前的一批事件都还在。
第四种是低功耗场景。串口外设在睡眠时往往要关掉,而事件记录只写内存,配合调试器可以在唤醒窗口里把之前的事件一次性读出来。
3. 在 MDK 里把 Event Recorder 跑起来:RTE 勾选到主函数初始化
3.1 前置条件先确认:MDK 版本、J-LINK 与 SWD 连线
组件本身依附在 MDK 的 RTE 机制上,版本太老就没有这个入口。我这边的要求是 MDK 5.25 以上,而且工程要能被这个版本正确打开——有些从更老版本迁移过来的工程,打开时组件树是残缺的,RTE 窗口里根本找不到 Event Recorder 那一项,这种情况先把工程在目标版本里重新保存一次。
硬件这边是 J-LINK 接 SWD。SWD 只需要 SWCLK 和 SWDIO 两根信号线加地线,比 JTAG 省引脚,也是绝大多数小封装 MCU 唯一能用的调试口。连线之后先在调试配置里确认能连上、能读到芯片 ID,连不上就别往下走,组件配置得再对也看不到数据。
还有一点容易被忽略:确认调试器在下载完成后不会立刻断开。有些配置里下载完就释放连接,程序是跑起来了,但事件没人读,窗口自然一直是空的。
3.2 打开 RTE,在 Compiler 组件下勾上 Event Recorder
配置入口是 Manage Run-Time Environment 窗口,工具栏上那个 RTE 按钮就是。展开 Compiler 组件,里面能找到 Event Recorder 一项,勾上它。
具体操作顺序如下:
- 打开工程,先编译一次,确认当前代码是能过的,避免后面把编译错误误判成组件问题。
- 点开 RTE 窗口,在 Compiler 分组下找到 Event Recorder,勾选。
- 勾选后确认右侧没有黄色或红色提示,有冲突会当场标出来。
- 关掉窗口,重新编译,观察工程树里是否多出了 Event Recorder 的源文件和配置头文件。
这一步做完,组件代码就进了工程。此时还没有任何输出,因为初始化函数没被调用,记录器处于未启动状态。很多人卡在这一步,以为勾上就自动生效,实际上还差主函数里的两次调用。
3.3 主函数里的两次调用:Initialize 与 Start
组件加进来之后,在 main 函数开头补上初始化和启动。下面这段是我现在工程里的固定写法:
c复制#include "EventRecorder.h"
int main(void)
{
/* 系统时钟、外设初始化放在前面,保证时间戳基准已经稳定 */
SystemInit();
/* 第一个参数是记录过滤器,EventRecordAll 表示事件、API、错误都记录
* 第二个参数给时间戳计数频率,常见做法是按核心频率填,
* 也可以留 0 由 EventRecorderConf.h 里的默认值决定 */
EventRecorderInitialize(EventRecordAll, 1U);
/* 启动记录器,这一步之后 printf 的输出才会进入事件缓冲 */
EventRecorderStart();
while (1)
{
/* 轻量打点:事件 ID 加两个 32 位参数,不做字符串格式化 */
EventRecord2(0x01U, 0x01U, 0x02U);
}
}
这段代码里有两处需要说明。EventRecorderInitialize 的第一个参数是过滤器,决定哪些类别的事件被记录,EventRecordAll 是全部记录;如果只想保留自己打的点,可以换成更窄的过滤器,减少缓冲占用。第二个参数和时间戳频率有关,它必须和配置文件里的设定对得上,对不上就会出现时间戳跳变或者干脆为 0,后面排查那一节会专门讲这个现象。
EventRecorderStart 必须调用,而且要放在初始化之后。少了它,EventRecord2 写进去的东西不会进缓冲,窗口里什么都看不到。这个顺序反了也不行,先 Start 再 Initialize 会被初始化过程重置掉。
EventRecord2 是打点用的轻量接口,第一个参数是事件 ID,后两个是随事件带走的 32 位值。它不做字符串格式化,所以开销很小,适合放在中断或者高频循环里。自定义 ID 的取值建议用宏或者枚举集中管理,别在东一处西一处写裸数字,后面在窗口里看事件名会非常痛苦。
3.4 进调试会话,把 Event Recorder 窗口拉出来
配置完成后点下载并进入调试,然后在 MDK 的 Analysis Windows 下打开 Event Recorder 窗口。全速运行,窗口里应该开始出现事件,带时间戳和参数。
如果窗口是空的,先别怀疑配置,按顺序确认三件事:调试会话是否真的建立、EventRecorderStart 是否被执行到、以及缓冲区里有没有数据被读上来。这三步的排查方法放在第 5 章。
4. printf 重定向的三个开关:STDOUT、MicroLib 与重定向函数
4.1 把 STDOUT 的 Variant 改成 EVR
Event Recorder 最实用的地方,是能把工程里已有的 printf 直接接过来,不用把每一处输出都改写成 API 调用。做到这一点的开关在 RTE 窗口里:Compiler 组件下的 I/O 分组里有一项 STDOUT,把它的 Variant 从默认值改成 EVR。
这一步的含义是告诉 C 库的重定向层,标准输出走 Event Recorder,而不是默认通道。改完之后,原来那些 printf("state=%d\n", s) 不需要动一行代码,输出会直接出现在事件窗口里。
改 Variant 的时候有个细节要注意:STDOUT 和 Event Recorder 必须在同一个 RTE 配置里同时勾选,只改 Variant 而不勾组件,编译阶段就会报找不到实现。我一般先把 Event Recorder 勾上、编译通过,再回来改 STDOUT,分两步走,出错时好定位是哪一步引入的。
4.2 勾上 MicroLib,把 printf 的实现换成精简版
改完 STDOUT 之后,还要在工程的 Target 选项里勾上 MicroLib。这一步是把 printf 背后的库实现换成精简版本。
标准 C 库的 printf 实现体积大,而且在没有正确配置半主机(semihosting)的情况下,某些调用会停在等待调试器的状态,表现出来就是程序卡在 printf 里不动。MicroLib 是面向嵌入式裁剪过的版本,体积小,也不会引入那套半主机依赖。材料里对这一点的要求很直接:需要勾选 MicroLib,并删掉主工程里的重定向函数。
顺序上我的习惯是先勾 MicroLib 再编译,因为不勾的时候往往先炸出一堆链接相关的报错,先把库换掉,剩下的问题才看得清。
4.3 删掉主工程里的 UART 重定向函数
这一步最容易被漏掉,也是最容易引发冲突的地方。绝大多数工程在接入 Event Recorder 之前,都已经写过一段把 printf 导向串口的重定向代码,通常是 fputc 的实现,里面直接调串口发送函数。
这段代码必须删掉。原因有两层:一是它和 EVR 的 STDOUT 实现在链接阶段会撞车,出现重复定义的报错;二是即使侥幸编过了,输出到底走串口还是走事件缓冲就变成了不确定的事,排查起来非常费劲。
删除的时候注意连带清理。有些工程不止一个 fputc,还有 fgetc、__io_putchar 之类的变体,散落在不同的源文件里。我的做法是全局搜一遍重定向相关的函数名,确认没有残留,再编译。删完之后,串口那边确实不会再出 printf 的内容了,这是预期行为,不要误以为坏了。
4.4 用 printf 打点时要留意的格式化边界
printf 接过来之后很顺手,但它和 EventRecord2 是两个量级的东西。格式化字符串本身要消耗栈和 CPU,浮点格式化更重,在中断里调用尤其危险。我的界线是:主循环里的状态输出可以用 printf,中断里、高频采样点上只用 EventRecord2。
另外字符串长度也要收着点。事件缓冲是按条数算的,一条长字符串占的空间和一条短事件完全不一样,打得太密太快,缓冲区很快就满,后面的关键事件反而被丢掉。
注意:切到 EVR 之后不要再指望串口上有输出。想同时保留串口日志,就得自己另写一套不受 STDOUT 影响的发送函数,而不是把重定向函数留着。
5. 调试口上的常见翻车:Event Recorder 排查五条
5.1 窗口一片空白,连初始化事件都没有
现象:进入调试会话,全速运行,Event Recorder 窗口始终空的,一条事件都不出。
原因通常有三个层次。最外层是调试会话没真正建立,或者调试器在下载完成后就断开了,没人去读目标内存。中间层是 EventRecorderInitialize 或 EventRecorderStart 根本没被执行到,比如初始化代码被放在了某个永远进不去的条件分支里。最内层是记录过滤器把事件全过滤掉了,缓冲区里其实有数据,但读上来被丢掉。
解决顺序是从外往内:先在调试配置里确认连接正常、下载后保持连接;再在 EventRecorderStart 后面下一个断点,确认代码确实走到了;最后检查 EventRecorderInitialize 的第一个参数是不是被改成了过窄的过滤器。
5.2 printf 既没进事件窗口,串口也不输出
现象:改完配置,程序里到处是 printf,结果事件窗口没有,串口也没有,像是输出被吞了。
原因是 STDOUT 的 Variant 没有真正改成 EVR,或者改了但没重新编译生效;同时主工程里原来的 UART 重定向函数已经被删掉,两条路都断了,输出自然消失。
解决方法是回到 RTE 窗口核对 STDOUT 的 Variant 当前值,确认是 EVR;确认 Event Recorder 组件仍处于勾选状态;然后做一次完整重新编译,不要只做增量编译,配置类的改动增量编译有时不生效。
5.3 编译或链接阶段报重复定义
现象:编译时报某个重定向函数重复定义,或者链接阶段提示符号冲突,位置指向 Event Recorder 的库文件和自己的源文件。
原因是主工程里旧的 UART 重定向实现没有删干净,和 EVR 提供的 STDOUT 实现同时存在。常见于从别的工程拷贝过来的驱动文件,重定向函数藏在某个不显眼的 .c 里。
解决办法是全局搜索重定向函数名,逐个确认并删除;删除后清理一次编译产物再全量编译,避免旧的中间文件还在参与链接。
5.4 事件断续、时间戳跳变,像是丢了帧
现象:事件窗口里能看到事件,但中间有大段空白,时间戳出现明显跳变或者干脆全是 0。
原因分两种。一种是缓冲区满了,新事件被丢弃,表现出来就是断续;这通常是因为打点太密,或者用 printf 打了太多长字符串。另一种是时间戳频率没配对,EventRecorderInitialize 的第二个参数和 EventRecorderConf.h 里的设定不一致。
解决上先降密度:把高频位置上的 printf 换成 EventRecord2,只保留关键状态迁移。然后按实际事件量调大 EVENT_RECORD_NUM_RECORDS。时间戳问题则把两处的频率值对齐,重新编译后再看时间戳是否连续递增。
5.5 跑一段时间变慢,甚至卡在 printf 里
现象:刚跑起来正常,运行几十秒后主循环明显变慢,用调试器暂停一看,PC 停在 printf 内部。
原因是 MicroLib 没勾,库实现走了标准版本,在缺少半主机配置的情况下停在等待状态;或者是中断里调用了 printf,格式化开销把中断时间拉长,累积起来拖垮了整体节拍。
解决办法是先在 Target 选项里确认 MicroLib 已勾选,再检查中断服务函数里是否还有 printf 调用,有的话一律换成轻量打点接口。改完观察主循环周期是否恢复,通常这一步做完问题就消失。
6. 用 System Analyzer 验证时间线:进阶用法与我的固定习惯
Event Recorder 窗口适合看单条事件的细节,但要判断事件密度和整体节奏,我会切到 Analysis Windows 下的 System Analyzer。它把事件按时间轴铺开,能直观看出某个状态停留了多久、两次打点之间的间隔是否稳定。
自定义事件 ID 是另一项值得投入的事。我一般把状态机的迁移、异常分支、通信超时各分配一段 ID 区间,用宏集中定义:
c复制/* 事件 ID 集中管理,窗口里显示名字,排查时不用回头查裸数字 */
#define EVT_SM_IDLE_TO_RUN 0x10U
#define EVT_SM_RUN_TO_FAULT 0x11U
#define EVT_COMM_TIMEOUT 0x20U
/* 状态迁移打点:参数一放旧状态,参数二放新状态 */
EventRecord2(EVT_SM_IDLE_TO_RUN, 0x00U, 0x01U);
这样即使不看源码,事件窗口里也能读出完整的状态轨迹。参数位只放状态值和计数,不放指针地址——地址在不同编译之间会变,回溯时没有意义。
我自己的验证顺序固定为三步。第一步,上电后先确认有初始化事件,证明记录器活着。第二步,人为触发一次已知分支,确认对应事件出现在窗口里,证明打点位置正确。第三步,全速跑一段足够长的时间,看时间戳是否单调递增、事件是否连续,确认缓冲配置扛得住实际密度。
这三步做完再谈排查实际问题。从那以后我每次接新板子、换新工程,都强制走一遍这个顺序,先确认通道通了,再去怀疑代码——不然很容易把“通道没通”误判成“程序没跑到”,白耗半天。希望帮到你。
