3. Verilog HDL 进阶语法（二）：系统函数 `$display`、`$monitor`、`$readmemh`、`$fwrite` 的使用
调试，是RTL设计里最磨人的环节之一。你写了一大堆代码，仿真跑起来，结果波形一看，全乱套了。这时候，系统函数就是你的救命稻草。今天咱们聊聊四个最常用的：$display、$monitor、$readmemh 和 $fwrite。它们能帮你把仿真过程中的数据抓出来、存起来、甚至喂进去。
核心观点：系统函数不是语法糖，是调试利器。用好了，能省你一半的仿真时间。
3.1 $display：打印信息，像C语言的printf
$display 是最基础的打印函数。它的用法和C语言的 printf 几乎一样。你可以在任何时刻调用它，把变量值、状态信息打印到仿真控制台。
我个人习惯在状态机跳转时加几个 $display，这样一眼就能看到当前状态和下一状态。比如：
always @(posedge clk or negedge rst_n) begin
if (!rst_n) begin
state <= IDLE;
end else begin
case (state)
IDLE: begin
if (start) begin
state <= READ;
$display("[%0t] IDLE -> READ, start=%b", $time, start);
end
end
READ: begin
// ...
end
endcase
end
end
这里有个小细节：$display 默认会在末尾自动换行。如果你不想换行，可以用 $write。另外，格式化符号和C语言一样：%d 十进制、%h 十六进制、%b 二进制、%t 时间。
我的经验：我在项目中遇到过一个问题——仿真跑了几百万个时钟周期，结果某个信号只在特定时刻出错。如果不用 $display 打印关键信息，你根本不知道问题出在哪。后来我在每个关键节点都加了条件打印，问题很快就定位到了。
注意：$display 只在仿真时有效，综合工具会忽略它。所以放心用，不会影响最终电路。
3.2 $monitor：自动监控，变量一变就打印
$monitor 和 $display 很像，但有一个关键区别：$monitor 是自动触发的。只要它监控的变量发生变化，它就会自动打印一次。你不需要在每个 always 块里手动调用。
我一般会在仿真开始时调用一次 $monitor，然后整个仿真过程它都会自动工作。比如：
initial begin
$monitor("[%0t] a=%d, b=%d, sum=%d", $time, a, b, sum);
end
这样，只要 a、b 或 sum 中任何一个发生变化，控制台就会自动打印一行。你想想看，这比手动在每个地方加 $display 省事多了。
不过要注意，$monitor 在整个仿真中只能有一个活跃实例。如果你调用了两次，后面的会覆盖前面的。所以，我建议只在顶层测试模块里调用一次。
避坑指南：我曾经在多个模块里都调用了 $monitor，结果发现只有最后一个生效。后来查手册才知道，$monitor 是全局唯一的。所以，统一放在顶层吧。
3.3 $readmemh：从文件加载数据到存储器
做数字芯片设计，经常需要给ROM或RAM初始化数据。手动在代码里写几百个十六进制数？太傻了。$readmemh 就是干这个的——它可以从文本文件里读取十六进制数据，直接加载到你的存储器数组里。
用法很简单：
reg [7:0] mem [0:255];
initial begin
$readmemh("data.hex", mem);
end
文件 data.hex 的格式也很简单，每行一个十六进制数，比如：
FF
A5
3C
00
...
嗯，这里要注意：文件里的数据个数不能超过存储器深度，否则会报错。另外，$readmemh 只认十六进制，如果你有二进制文件，可以用 $readmemb。
我的习惯：我通常用Python或MATLAB生成测试数据，然后保存成 .hex 文件，再用 $readmemh 加载。这样，测试向量可以灵活调整，不用改RTL代码。
3.4 $fwrite：把仿真结果写入文件
仿真跑完了，数据怎么看？总不能一直盯着控制台吧。尤其是数据量大的时候，你需要把结果保存到文件里，方便后续分析。$fwrite 就是干这个的。
它和 $display 的格式化方式一样，但输出目标是文件，不是控制台。基本用法：
integer fd;
initial begin
fd = $fopen("output.txt", "w");
if (fd == 0) begin
$display("Error: cannot open file");
$finish;
end
end
always @(posedge clk) begin
if (valid) begin
$fwrite(fd, "%0t %d %d\n", $time, data_in, data_out);
end
end
final begin
$fclose(fd);
end
这里有几个关键点：
$fopen返回一个文件描述符，如果返回0，说明打开失败。$fwrite的用法和$display一样，但第一个参数是文件描述符。- 别忘了在仿真结束时调用
$fclose，否则数据可能没写完。
注意：如果你用 $fwrite 写文件，记得在仿真结束后检查文件内容。我曾经因为忘记 $fclose，导致最后几行数据丢失，白跑了一整天仿真。
3.5 知识体系：系统函数的核心逻辑
这四个函数，说白了就是帮你打通仿真和外部世界的桥梁。下面这张图能帮你理清它们的关系：
这张图展示了四个函数的分工：$readmemh 负责输入，$fwrite 负责输出到文件，$display 和 $monitor 负责输出到控制台。它们共同构成了仿真调试的完整工具链。
3.6 实战建议：怎么用最顺手？
说了这么多，我总结一下我的个人经验：
- 调试阶段：多用
$display和$monitor。前者适合定点打印，后者适合持续监控。 - 数据准备：用
$readmemh加载测试向量。别在代码里硬编码数据，维护起来太痛苦。 - 结果保存：用
$fwrite把仿真结果写出去。后续用Python或MATLAB分析，效率高得多。
最后提醒一句：系统函数是仿真专用的，综合工具会忽略它们。所以，放心大胆地用，别怕影响最终电路。但要注意，过多的 $display 会拖慢仿真速度，调试完记得删掉或注释掉。
好了，这四个函数就聊到这儿。它们不难，但用好了，能让你在调试时少走很多弯路。下次仿真遇到问题，先想想能不能用它们把数据抓出来看看。