在 Cadence Virtuoso 中使用 Spectre 进行电路仿真时，如果设计中包含进行文件读写操作的 Verilog-A 模块，有时会遇到与文件路径或描述符相关的致命错误。本文将介绍 ASL-3213 错误的成因及解决方法，并详细说明 Spectre 在处理 Verilog-A 文件系统操作时的默认路径读取与写入规则。

1. 错误现象 (Error Code & Message)

Error Code: ASL-3213

Error Message: 在瞬态仿真 (tran) 期间，Spectre 报告了以下致命错误：

1
2

Fatal error found by spectre during IC analysis, during transient analysis `tran'.
    FATAL (ASL-3213): "/MyPath/MyLib/MyCell/veriloga/veriloga.va" 14: I0:  Invalid file descriptor. Correct the problem and try again.

或更详细的提示：

1
2

Fatal error found by spectre during IC analysis, during transient analysis `tran'.
    FATAL (ASL-3213): "/MyPath/MyLib/MyCell/veriloga/veriloga.va" 52: I66:  Invalid file descriptor. This is because either the file does not exist, or you do not have read permission on the file. Ensure that the file exists and that you have the required permission on it. Next, rerun the simulation.

2. 问题分析 (Definition)

在 ADE 中运行 Spectre 仿真时，如果 Verilog-A 模块包含文件读取或写入操作，却没有正确处理文件路径，就会引发此错误。例如，下面的 Verilog-A 代码尝试读取一个输入文件：

1
2
3

file = $fopen("input.data", "r");
rr = $fscanf(file,"x=%d,y=%d,z=%d",int1,int2,int3);
$fclose(file);

$fopen 无法返回有效文件描述符，通常源于以下两类原因：

2.1 文件存在但路径未包含在搜索路径中

如果在默认的搜索路径中找不到目标文件，或者当前用户没有相应的读写权限，$fopen 将返回无效的文件描述符，进而导致后续的 $fscanf 或 $fwrite 报出 Invalid file descriptor 错误。

核心问题在于：如何确定和解析 Verilog-A 文件操作的最佳默认路径？（详见第 3 节）

2.2 目标文件本身不存在

另一种常见原因是 $fopen 所打开的目标文件根本不存在于文件系统中。这种情况下，即使搜索路径配置完全正确，$fopen 同样会返回无效的文件描述符。

需要特别注意的是：veriloga.va 中传递给 $fopen 的文件路径，有时并非硬编码的字符串，而是通过参数（parameter）或变量来指定的，例如：

1
2
3

parameter filename = "input.data";
// ...
file = $fopen(filename, "r");

在这种情况下，testbench 中有可能对该参数重新赋值（override），从而改变了实际被打开的文件路径。排查步骤如下：

  1. 检查 veriloga.va 源码：确认 $fopen 使用的是字面量路径还是参数/变量。
  2. 检查 testbench：如果使用了参数，在 testbench（.scs 网表或 ADE 参数设置）中搜索该参数名，确认是否被覆盖赋值。
  3. 确认实际文件路径：根据最终生效的参数值，确认对应路径下的文件确实存在并且有相应的权限。

3. 解决方法 (Solution)

要解决此问题，需要了解 Spectre 在进行 Verilog-A 文件读取和写入操作时的默认目录搜索机制。

3.1 文件读取操作 (Read Operation)

在 Spectre 的 Verilog-A 文件读取操作期间，（非绝对路径）文件的搜索顺序如下：

  1. Spectre 启动目录： 在 ADE 仿真环境中，这通常是包含 runSimulation 脚本的 netlist 目录。

  2. 设计输入目录： 这是包含输入网表 input.scs 文件的目录。在 ADE 仿真中，它同样也是 netlist 目录。

  3. 命令行参数指定目录： 通过在 Spectre 命令行中添加 -I 参数指定的目录。用户可以通过该参数来指定外部读取文件所在的统一路径。

如果文件不在上述任何目录中，读取操作将会失败并引发 ASL-3213 错误。可以在仿真时将输入文件（如 input.data）放置在启动目录/netlist目录中，或者通过包含路径参数 -I /path/to/data 来指定。

3.2 文件写入操作 (Write Operation)

对于 Verilog-A 的文件写入操作（如使用 $fopen(..., "w")）：

  • Spectre 始终会将文件写入到“输出目录” (Output Directory) 中。
  • 除非显式指定，默认的“输出目录”就是 Spectre 启动时所在的目录（即 ADE 仿真中的 netlist 目录）。

如果需要更改结果的写入位置，可以使用 Spectre 的命令行参数 -outdir：

1

spectre input.scs -outdir /custom/output/path

更改后，Verilog-A 生成的文件以及 Spectre 的其他仿真输出数据，均会被写入到指定的 /custom/output/path 中。

4. 总结与建议

遇到 ASL-3213 错误时，建议按以下顺序逐步排查：

  1. 确认目标文件是否存在：
    • 检查 veriloga.va 源码，找到 $fopen 使用的文件路径（字面量或参数）。
    • 如果是参数/变量，在 testbench 或 ADE 参数设置中确认是否被覆盖，找到实际生效的路径。
    • 确认该路径对应的文件在文件系统中真实存在。

  2. 确认文件在搜索路径中：检查目标文件是否位于 ADE 的 netlist 目录，或者通过 -I 参数将其所在目录纳入搜索路径。

  3. 确认读写权限：确保当前用户对目标文件拥有相应的读（r）或写（w）权限。

  4. 合理利用命令行参数：使用 -I（指定读取搜索路径）和 -outdir（指定输出路径），避免在 Verilog-A 代码中硬编码绝对路径，以提高模型可移植性。

  5. 查阅手册：可以在终端中输入 spectre -help 了解更多关于 -outdir 和 -I 选项的详细信息，或参考《Spectre User Guide》获取完整指南。