003. gen_uvm_model.rb

（追記：2018/05/04）

GitHubに公開しているツールを修正しました。multi指定を"y"にした場合に出力されるコードも、サンプルを修正することなく実行できるようになりました。以下に書いていた追記は削除しましたので、multiオプションを"y"にして問題が出る方は、最新版のツールをGitHubから持ってきて実行してください。

－－－－－

なんちゃって、UVMモデル生成ヘルパーです。ツールはGitHubに置いてあります。→ 一応GitHubにアップしている最新のコードをページ最後尾にコピペしておきました。表示設定に「小」が追加されて、コードを置くのが便利になりました。

簡単に作れると思ったのですが、どこまでサポートしようかと悩みつつ書いてたら、結構時間がかかり＋汚いコードになりました。

以下の手順に沿うと、誰でもなんちゃってUVMモデルを作成して動かすことができますが、それをベースに展開するにはその人のスキルが必要です。なので、あまり実用的ではないかもです。

ベータ版リリースなので、作者の気まぐれでバージョンアップする可能性はあります。

このツールのオススメは、「新規にモデルを作るときに、既存モデルを変更して作るのが面倒」なとき。指定した名前のモデルとモデルの単体検証環境ひな形を生成するので、それを修正する方が早いかも…し れません。

とりあえず動かしてみるときの推奨オプション。ツールは引数なしで実行します。そして

• エージェントの種類は１つにする
• そのエージェントは複数使用しない

でお願いします。ツール実行後、カレントディレクトリに「uvm-1.1d」を展開していれば、以下の手順で動作させることができます。

• 「モデル名」_model/ ディレクトリに移動し、
  • ./create_pkg
  • ./compile
  • ./run

これで動きます。上記３つのツールは、このページの最後にコードを貼り付けておきますので、使いたい方はコピーして使ってください。ただし、modelsim用です。Questaでも動くとは思います。

1. 動かす環境
   1. このツールは、Ruby1.9で動かすことを想定して書き、動作確認しています。最低でも1.9以上のRuby上で動かしてください。
   2. 生成コードは、modelsim-ase 10.0dで動作確認しています。
2. ツールでできること
   1. ツールを実行すると、いくつか問い合わせてきます。問い合わせは、なんちゃって英語（間違いあり）です。
      1. モデル名は？
      2. エージェントは何個使う？
      3. エージェント名は？
      4. そのエージェントは複数で使う？（→ 汎用バスなどで、複数のマスタ、スレーブを使うケースの人はyを押します）
      5. そのエージェントで使うインターフェース名は？（virtual interfaceのことを聞いています）
      6. ２番で指定した数分、３－５をループする
   2. 質問が終わると、以下のディレクトリを作成し、ファイルを生成します。
      1. model_name
         1. body（モデル本体）：以下の種類のファイルの先頭に、model_nameがつきます。
            1. env
            2. agent(s)
            3. driver
            4. sequencer
            5. monitor
            6. seq_lib
            7. 指定した interface 定義ファイル（中身は決め打ち）
         2. tb（テストベンチ）
            1. tb_top.sv：module
            2. test_lib.sv：uvm_test定義テストライブラリ
            3. tb_env.sv：テストベンチのuvm_env
         3. seq
      2. seqは掘っていますが、ツールが出力するファイルはありません。
3. 気をつけること
   1. エージェントを複数で使う、と選択した時、該当エージェントは動的配列定義され、int num_エージェント名s、が定義され、uvm_field_int定義が付加されます。が、このメンバに値をセットするサ ンプル記述を生成していません。
   2. driverとmonitorが参照するvirtual interfaceについて。tb_top.svからuvm_config_dbのsetを使ってvifをセットし、各モデルのbuild_phaseでuvm_config_dbのgetをしています。エージェントを複数種類 セットする、とした場合でも、setするときのサーチ対象がenv名レベルになっているため、ユーザーが修正する必要があります。

--- create_pkg

#!/usr/bin/tcsh -f

if ( ! ( -d work ) ) vlib work

set dir = ../uvm-1.1d/src

vlog -sv $dir/uvm_pkg.sv +incdir+$dir +define+UVM_HDL_NO_DPI+UVM_NO_DPI+UVM_CMDLINE_NO_DPI+UVM_REGEX_NO_DPI+UVM_NO_DEPRECATED

--- compile

#!/usr/bin/tcsh -f

vlog -sv body/*_if.sv

vlog -sv tb/tb_top.sv +incdir+./body+./tb+./seq+../uvm-1.1d/src

--- run

#!/usr/bin/tcsh -f

set TEST = $1

if ( $1 == "" ) set TEST = sample_test

vsim -c tb_top +UVM_TESTNAME=$TEST -do "run -all;quit"

ーーーーー

以下は、以前書いた追記の保存です（消そうと思いましたが、残しておきます）

（追記：2018/04/15）

ツールのオプションで、"multi?"と聞かれた際に"y"で答えたとき、出力されるコードの間違いがあります。ツールを直せばいいのですが、取り急ぎ出力コードの修正方法を書いておきます。

1. tb/test_lib.sv line.33

`set_seq(tb.sample.masters[0].sequencer.run_phase, master_sample_seq)

出力コードは、「master」になっていました。

2. tb/tb_env.sv

build_phaseで、sample_envを生成する前に以下の行を追加します（これは間違いではなくて、ツールの都合で入れてなかった）

uvm_config_db#(int)::set(this, "sample", "num_masters*", 1);

3. body/sample_env.sv

for文の定義で、num_masters-1と出力していましたが、"-1"が余計でした。

また、mastersを生成する記述で、最後に"parent"を指定するところ、"this"と入れれば良いのですが、入れ忘れてました…。

修正前

for(i=0; i<num_masters-1; i++)begin

masters[i] = sample_master_agent::type_id::create($sformatf("masters[%0d]", i));

end

修正後

for(i=0; i<num_masters; i++)begin

masters[i] = sample_master_agent::type_id::create($sformatf("masters[%0d]", i),this);

end

以下にもコードを置いておきます。