波形与日志：波形文件格式选择、保存层级与日志轮转

波形文件和日志，是仿真调试的两只眼睛。我见过不少工程师，花大把时间调代码，结果波形没存对，日志没开全，白白浪费一整天。今天咱们就把这两件事聊透。

波形文件格式：VCD vs FSDB

先说波形格式。目前主流就两种：VCD 和 FSDB。VCD 是 IEEE 标准，所有工具都支持。FSDB 是 Synopsys 的专有格式，压缩率高，加载快。

我个人的习惯是：小模块调试用 VCD，全芯片回归用 FSDB。为什么？

• VCD：纯文本，可读性强。你拿文本编辑器打开都能看。但文件体积大，跑个百万门级设计，VCD 轻松上 GB。
• FSDB：二进制压缩，体积只有 VCD 的 1/5 到 1/10。加载速度快，但需要 Synopsys 工具链支持。

嗯，这里要注意：如果你用开源工具（比如 GTKWave），FSDB 是打不开的。必须转成 VCD 或 LXT。我在项目中遇到过，客户发来一个 FSDB，我这边只有 GTKWave，折腾了半天才找到转换工具。

特性	VCD	FSDB
标准	IEEE 1364	Synopsys 专有
文件大小	大（文本）	小（二进制压缩）
加载速度	慢	快
工具兼容性	所有工具	Synopsys 工具为主
适用场景	小模块、跨平台	大规模、回归测试

波形保存层级：存多少才够？

波形保存层级，说白了就是「存哪些信号」。全存？文件太大。存太少？问题查不出来。

我建议分三级：

1. 顶层信号：时钟、复位、关键控制信号。用于快速定位问题范围。
2. 模块边界信号：模块的输入输出。用于隔离问题模块。
3. 内部关键信号：状态机、计数器、数据通路。用于精确定位 bug。

实际操作中，我一般这样设置：

// 保存所有顶层信号
$dumpvars(0, top);

// 只保存特定模块的层次
$dumpvars(1, top.u_cpu);
$dumpvars(1, top.u_mem);

// 排除某些信号（减少体积）
$dumpoff(0, top.u_debug_bus);

为什么这样设？你想想看，全芯片仿真时，如果每个模块都存内部信号，波形文件轻松上百 GB。我曾在一次回归测试中，忘了限制层级，结果磁盘爆了，整个回归中断。从那以后，我每次跑仿真前都会检查 dump 配置。

日志文件重定向与轮转

日志这事，看着简单，坑不少。我见过最离谱的：仿真跑了三天，日志文件写了 200 GB，把服务器硬盘撑爆了。

日志重定向，核心就两件事：

• 标准输出 vs 文件：仿真时用 > 或 tee 把输出同时打到终端和文件。
• 日志级别：INFO、WARNING、ERROR、FATAL。调试时开 DEBUG，回归时只开 WARNING 以上。

举个例子：

# 同时输出到终端和文件
vsim -c top +UVM_VERBOSITY=UVM_MEDIUM -l sim.log

# 只保存错误和警告
vsim -c top +UVM_VERBOSITY=UVM_NONE -l sim.log \
     -msgmode both -msgset "uvm_warning+uvm_error"

日志轮转，说白了就是防止单个文件无限增长。我习惯用 logrotate 或仿真工具自带的轮转功能：

# 使用 logrotate 配置
/path/to/sim.log {
    daily
    rotate 7
    compress
    missingok
    notifempty
    copytruncate
}

这样每天轮转一次，保留最近 7 天的日志，旧的自动压缩。磁盘压力小很多。

知识结构图：波形与日志的核心逻辑

下面这张图，帮你理清波形和日志的决策流程：

这张图的核心逻辑很简单：先决定用波形还是日志，然后各自做格式、层级、轮转的配置。最后别忘了检查磁盘空间和文件命名。

总结几个实用原则

• 波形格式：小模块用 VCD，大项目用 FSDB。团队统一格式。
• 保存层级：先粗后细。顶层信号定位问题范围，模块边界隔离问题，内部信号精确定位。
• 日志轮转：时间戳命名 + logrotate 轮转。别让日志撑爆磁盘。
• 避坑：每次跑仿真前检查 dump 配置和日志路径。我吃过亏，所以现在都写成脚本自动检查。

波形和日志，是仿真调试的「眼睛」和「耳朵」。配置好了，事半功倍。配置不好，寸步难行。希望今天的内容能帮你少走弯路。