シミュレーション制御:$finish, $stop

システムタスク呼び出し形式タスク説明
シミュレーション終了$finish( type ) ;シミュレーションを終了します。パラメータ type で、終了時に情報を出力するかどうかを選択できます
type=0: 直接終了して出力しない
type=1: シミュレーション時間と、そのステートメントが存在する位置・行情報を出力
type=2: シミュレーション時間、位置、メモリと CPU 時間の使用状況を出力
シミュレーション一時停止$stop( type ) ;シミュレーションを一時停止します。使用方法・形式は $finish と同じです

$finish と $stop はどちらもシミュレーションを停止する機能がありますが、両者には違いがあります。

$finish は今回のシミュレーションを終了します。$stop は現在のシミュレーションを一時停止します。シミュレーションを一時停止した後は、Verilog シミュレーションツールやコマンドラインによってシミュレーションを続行できますが、終了した後はどのようにしてもシミュレーションを再開できません。$stop は C 言語のブレークポイントデバッグ機能に似ています。

以下、シミュレーションを用いて type の種類に対応する出力情報を説明します。

例

   initial begin
      forever begin
         #100;
         if ($time >= 10000)  $finish(0) ;
         //if ($time >= 10000)  $finish(1) ;
         //if ($time >= 10000)  $finish(2) ;
      end
   end

$finish(0) は、シミュレーション終了時に何も情報を出力しません。

$finish(1) は、シミュレーション終了時にシミュレーション時間と $finish が存在する行の情報を出力します。以下のようになります。

モジュール test の時間精度は ns ですが、シミュレータの時間精度は ps であるため、出力される時間情報は 1000 倍異なります。

$finish(2) は、シミュレーション終了時にシミュレーション時間と行情報だけでなく、PC が使用した時間とメモリの使用状況も出力します。以下のようになります。

時間フォーマット:$printtimescale, $timeformat

システムタスク呼び出し形式と説明 
時間の出力
単位と精度
$printtimescale( hierarchy ) ; 
 このシステムタスクは以下の形式で timescale 情報を出力します。
TimeScale of ( hierarchy ) is 1 ( unit ) / 1 ( precision )
hierarchy はモジュールへのアクセス階層で、省略可能です。省略した場合は現在のモジュールの timescale 情報を出力します。
 
時間の設定
単位と精度
$timeformat(unit_num, precision_num, suffix_string, min_field_width) 
 unit_num は時間単位を設定します。デフォルトでは `timescale に従います。
precision_num は時間単位における小数の有効桁数を設定します。デフォルトは 0 です。
suffix_string は時間の接尾辞情報を設定します。例えば "ns" などです。デフォルトは空です。
min_field_width は時間情報が占める文字幅を設定します。デフォルトは 20 です。
 

表示タスク($display、$monitor など)やファイル書き込みタスク($display など)が "%t" 形式でデータを出力する場合、$timeformat は時間単位情報の出力形式を指定できます。

$timeformat の unit_num は符号付き数値を使用して時間単位を指定します。その対応関係は次の表のとおりです。

unit_num時間単位unit_num時間単位
01 s-810 ns
-1100 ms-91 ns
-210 ms-10100 ps
-31 ms-1110 ps
-4100 us-121 ps
-510 us-13100 fs
-61 us-1410 fs
-7100 ns-151 fs

以下のコードを使用して、時間スケールに関する 2 つのシステムタスクを簡単にシミュレーションします。

例

   //change timescale
   initial begin
      # 10 ;
      //ps精度、小数は有効数字5桁、単位の接尾辞は"my-ps"を表示、15文字の長さを占める
      $timeformat(-12, 5, " my-ps", 15) ;
   end
   initial begin
      # 5 ;
      $printtimescale() ;
      $display("Time before resetup: %t", $time);
      # 10 ;
      $printtimescale() ;
      $display("Time after resetup: %t", $time);
   end

シミュレーションログは以下のようになります。

図から、$timeformat 設定前後の時間の表示形式を比較できます。

また、この過程で timescale は常に変わっておらず、$timeformat は時間の表示形式を変更しただけです。

シミュレーション時間:$time, $stime, $realtime

システムタスク呼び出し説明
$time64bit 整数型の時間値を返す
$stime32bit 整数型の時間値を返す
$realtime実数型の時間値を返す。浮動小数点数も可

シミュレーションコードは以下のとおりです:

例

   initial begin
      #10;
      $display("$time output1: %t", $time);
      $display("$stime output1: %t", $stime);
      $display("$realtime output1: %t", $realtime);
      #3.2;
      $display("$time output2: %t", $time);
      $display("$stime output2: %t", $stime);
      $display("$realtime output2: %t", $realtime);
      #5.6;
      $display("$time output2: %t", $time);
      $display("$stime output2: %t", $stime);
      $display("$realtime output2: %t", $realtime);
   end

シミュレーションログは以下のようになります。

シミュレーション時間が短いため、$time と $stime に違いはありません。

ただし、$realtime は現在の時間精度に従ってシミュレーション時間を正確に読み取りますが、$time と $stime は時間精度に基づいて現在時間を四捨五入して読み取ります。

コマンドライン引数渡し:$test$plusargs, $value$plusargs

Verilog はさらにインタラクティブタスク $test$plusargs と $value$plusargs を提供しています。シミュレーション時にコマンドラインから引数を渡すことでパラメータを伝達でき、シミュレーションデバッグに大きな利便性をもたらします。

システムタスク呼び出し形式タスク説明
文字列引数の受け渡し$test$plusargs( str ) ;シミュレーション時にコマンドラインから渡された文字列データが str と一致する場合、戻り値は 1、それ以外は 0 です。
数値引数の受け渡し$value$plusargs( str, var ) ;シミュレーション時にコマンドラインから渡された文字列データが str と一致する場合、戻り値は 1、それ以外は 0 です。
str 内部でモジュール内の var 変数に渡す値の型を指定する必要があります。形式は表示タスク $display を参照してください。

$test$plusargs( str ) を使用する場合、シミュレーションのコマンドラインに "+str" を追加するだけで済みます。

$value$plusargs( str,var ) を使用する場合、str 内部で引数として渡す数値の型を指定する必要があります。コマンドラインで引数を渡す際、数値に基数に関する説明を追加する必要はなく、対応する基数の数値のみを保持すればよいです。コマンドラインで引数を渡す形式は、$value$plusargs の str で宣言された形式に従う必要があります。

以下、シミュレーションを用いて説明します:

例

   initial begin
      if ($test$plusargs("DISPLAY_CTRL")) begin
          $display("Display simulation information!!!");
      end
   end
   reg  [1:0]   display_sel ;
   initial begin
      if ($value$plusargs("INFO_SEL=%b", display_sel)) begin
          $display("Parameter transfer succeeds!!!");
      end
      else begin
         display_sel = 2'b0 ;
      end
   end
   initial begin
      #1 ;
      if (display_sel == 2'b01)
          $display("You have selected サンプル!!!");
      else if (display_sel == 2'b10)
          $display("You have selected Verilog!!!");
      else if (display_sel == 2'b11)
          $display("You have selected Me!!!");
      else
          $display("What do you really what???");
   end

シミュレーションのコマンドラインに追加: +DISPLAY_CTRL +INFO_SEL=01

するとシミュレーションログは以下のようになります。これにより、文字列パラメータとバイナリパラメータがどちらも正しく渡されていることがわかります。

本章のソースコードダウンロード

Download