$test$plusargs和$value$plusargs用法小结

Abstract

$test$plusargs和$value$plusargs作为进行Verilog和SystemVerilog仿真运行时调用的系统函数，可以在仿真命令中直接通过进行赋值的方式将参数传递进入到设计中，并且不局限于不同仿真器对于参数在仿真命令中定义格式不同的限制，也避免了调换参数带来的频繁编译等问题。使用这两条函数对于搭建测试平台有一定的便利，同时对于理解Factory中用例是如何传递进ProxyClass有一定的帮助。

本文将对$test$plusargs和$value$plusargs使用过程中遇到的问题进行小结。

Introduction

首先，在进行宏定义时，我们经常使用`ifdef等命令在代码中，参看下例：

test.v
    initial begin
        `ifdef dumpon
            $dumpfile("results.vcd");
            $dumpvars;
        `ednif
    end

如果要能够成功调用$dump等函数，需要在编译（compile）时指定`define的宏定义，其使用方法如下：

<compile-option> -define dumpon test.v

但是，在仿真过程中不需要该部分定义时该如何处理呢？

当需要改变编译条件时，经常需要重新编译。并且一旦编译通过，在编译阶段指定的宏定义在整个仿真运行过程中一直有效，因此，如果需要修改宏定义，则需要重新进行编译，从而降低了仿真的效率。

为此，可以使用$test$plusargs和$value$plusargs进行解决，该函数的调用发生在仿真运行（run）阶段。这样仅需要对设计进行一次编译即可，如果需要改变相应的条件，可以在run的时候动态指定，这样有利于脚本处理进行回归的验证，同时也有利于object的动态construct。

1 $test$plusargs

在运行（run）仿真时指定要选择的条件，即只需要在仿真运行命令（run-options）中指定参数需要选择的条件即可。

例如下例中，如果要将test01.dat、test02.dat、test03.dat分别load到各自的men中，仅需要如下命令在运行命令中加入“<+test01+test02+test03>”即可，当仿真运行时，$test$plusargs会在命令行中搜索指定的字符，若找到相应字符，在函数返回“1”，否则返回“0”。如果下次仿真时不需要test01时，仅需要将test01从运行命令中删除即可。

test.v
    initial begin
        if($test$plusargs("test01"))
            $readmemh("test01.dat",mem01);
        if($test$plusargs("test02"))
            $readmemh("test02.dat",mem02);
        if($test$pluargs("test03"))
            $readmemh("test03.dat",mem03);
    end

<run-options>+test01+test02+test03...

2 $value$plusargs

$value$plusargs可以讲运行命令（run-options）中的参数值传递给指定的信号或者字符，其语法格式如下：

Integer=$value$plusargs(“string”,signalname);

其中string=”plusarg_format”+”format_string”,”plusarg_format”指定了用户定义的要进行传递的值，”format_string”指定了要传递的值的格式（类似$display中定义的%s、%h、etc.），并且string中”plusarg_format”和”format_string”格式应该为”plusarg_format”（=/+）"format_string”。如果转换后的位宽和传递的值不一致，则按照如下规则转换：

plusargs位宽与signalname的关系	signalname值
<	plusarg左补零
>	plusarg截位
plusargs为负数	按照正数处理
不匹配	若为指定默认值，则reg类型为x

$value$plusargs使用示例如下：

test.v
    if ($value$plusarg("FINISH=%d",stop_clk))  begin
        repeat (stop_clk) @(posedge clk);
        $finish;
    end

if($value$plusargs("TESTNAME=%s",testname))
    begin
        $display("Running test %0s ,testname");
        ....
    end

if($value$plusargs("FREQ=%0f",frequency))
    begin
        frequency=8.3333333;
        .....
    end

若使用的运行命令如下：

<run-options>+FINISH=10000+TESTNAME=this_test+FREQ=5.6666

则上例的运行结果为：

 stop_clk ： 10000

testname：this_test

frequency：5.6666（如果run-options中没有增加“FREQ=5.6666”，那么frequency为8.333333）。

3 Conclusion

在实际使用$test$plusargs和$value$plusargs时，需要在编写代码初期考虑好使用的范围，否则，实际仿真时未必可以对仿真带来便捷。 作者：IC修真院 https://www.bilibili.com/read/cv12114914/ 出处：bilibili