在 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);

如果在默认的搜索路径中找不到 input.data，或者没有权限读取/写入，$fopen 将无法返回有效的文件描述符，进而导致后续的 $fscanf 或 $fwrite 报出 Invalid file descriptor 错误。

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

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 错误时，首先检查 $fopen 的目标文件是否在 ADE 的 netlist 文件夹中。可以通过在环境变量中使用绝对路径或拷贝文件来解决。
  • 命令行参数：合理利用 -I（用于读取搜索路径）和 -outdir（用于输出路径），避免在 Verilog-A 代码中硬编码绝对路径，以提高模型在不同仿真环境中的可移植性。
  • 查阅手册：可以在终端中输入 spectre -help 了解更多关于 -outdir 和 -I 选项的详细信息，或参考《Spectre User Guide》获取完整指南。