Main Content

このページは機械翻訳を使用して翻訳されました。元の英語を参照するには、ここをクリックします。

nclaunch

HDL Verifier ソフトウェアで使用するために Cadence Xcelium シミュレータを起動して設定します

ページ内をすべて折りたたむ

構文

nclaunch
nclaunch(Name,Value)

説明

nclaunch は、HDL Verifier™ ソフトウェアの MATLAB® および Simulink® 機能で使用するために Cadence® Xcelium™ シミュレータを起動します。明示的な rundir パラメータを指定しない場合、Xcelium シミュレータの最初のフォルダは MATLAB の現在のフォルダと一致します。

例

nclaunch(Name,Value) は、Xcelium シミュレータの起動に使用する Tcl コマンド、使用する xmsim 実行可能ファイル、起動コマンドを格納する Tcl スクリプトのパスと名前、および Simulink アプリケーションの場合はアプリケーションで使用される通信モードの詳細をカスタマイズできる名前と値のペアの引数を指定します。

この関数を呼び出した後、HDL シミュレータの HDL Verifier 関数 (たとえば、hdlsimmatlab、hdlsimulink) を使用して対話型のデバッグ設定を行うことができます。

例

すべて折りたたむ

デザインをコンパイルし、Simulink を起動します。

nclaunch('tclstart',{'exec xmvlog -64bit -c +access+rw +linedebug top.v','hdlsimulink' ...
     -gui work.top'},'socketsimulink','4449','rundir','/proj');

この例では、nclaunch は次のことを実行します。

  • デザイン top.v: exec xmvlog -64bit -c +access+rw +linedebug top.v をコンパイルします。

  • モデル hdlsimulink -gui work.top および 'rundir', '/proj' がロードされた proj フォルダーから GUI を使用して Simulink を起動します。

  • Simulink にソケット ポート 4449: 'socketsimulink','4449' 上の HDL Verifier インターフェイスと通信するように指示します。

これらのコマンドはすべて、tclstart のプロパティ値として単一の文字ベクトルで指定されます。

nclaunch を使用して Tcl シェルから HDL シミュレーターを起動するための Tcl スクリプトを作成します。

Tcl スクリプトの名前と、それに含まれるコマンドを nclaunch へのパラメータとして指定します。

nclaunch('tclstart','xxx','startupfile','myTclscript','starthdlsim','yes')

この例では、Tcl スクリプトが作成され、HDL シミュレータを起動するコマンドが含まれています。起動 Tcl ファイルの名前は「myTclscript」です。

Tcl シェルでスクリプトを実行します。

shell> Tclsh myTclscript

これにより、HDL シミュレータが起動します。

MATLAB から nclaunch を呼び出した後、Tcl シェルで実行される一連の Tcl コマンドを構築します。

nclaunch の Tclcmd パラメータに Tcl コマンド値を割り当てます。

Tclcmd{1} = 'exec xmvlog -64bit vlogtestbench_top.v'
Tclcmd{2} = 'exec xmelab -64bit -access +wc vlogtestbench_top'
Tclcmd{3} = ['hdlsimmatlab -gui vlogtestbench_top ' '-input "{@matlabcp... 
     vlogtestbench_top.u_matlab_component -mfunc vlogmatlabc...
     -socket 32864}" ' '-input "{@run 50}"']
Tclcmd = 

    'exec xmvlog -64bit vlogtestbench_top.v'  'exec xmelab -64bit -access +wc vlogtestbench_top'

Tclcmd = 

    'exec xmvlog -64bit vlogtestbench_top.v'  'exec xmelab -64bit -access +wc vlogtestbench_top'

Tclcmd = 

    [1x31 char]    [1x41 char]    [1x145 char]

  • tclcmd{1} は vlogtestbench_top をコンパイルします。

  • tclcmd{2} がモデルを詳しく説明します。

  • tclcmd{3} は gui モードで hdlsimmatlab を呼び出し、精巧な vlogtestbench_top をシミュレータにロードします。

nclaunch コマンドを発行し、先ほど設定した tclcmd 変数を渡します。

nclaunch('hdlsimdir','local.IUS.glnx.tools.bin','tclstart',tclcmd);

この例では、nclaunch は tclcmd に割り当てられた Tcl コマンドを通じて次のタスクを起動します。

  • -input (matlabtb および run) で渡される引数を xmsim Tcl シェルで実行します。

  • matlabcp への呼び出しを発行し、関数 vlogmatlabc をモジュール インスタンス u_matlab_component に関連付けます。

  • MATLABのhdldaemonがポート32864でリッスンしていると仮定します

  • run 関数に 50 解像度単位 (ティック) を実行するように指示します。

入力引数

すべて折りたたむ

名前と値の引数

引数のオプションのペアを Name1=Value1,...,NameN=ValueN として指定します。Name は引数名、Value は対応する値です。名前と値の引数は他の引数の後に表示されなければなりませんが、ペアの順序は重要ではありません。

R2021a より前は、名前と値をそれぞれコンマを使って区切り、Name を引用符で囲みます。

例: nclaunch('runmode','GUI') はグラフィカル ユーザー インターフェイスを使用して HDL シミュレーターを起動します。

Xcelium シミュレータ実行可能ファイルへのパス。'hdlsimdir' とパス名で構成されるコンマ区切りのペアとして指定されます。デフォルトでは、関数はシステム パスで見つかったシミュレータの最初のバージョンを実行します。

データ型: char

Xcelium シミュレータ実行可能ファイルの名前。'hdlsimexe' とシミュレータ名で構成されるコンマ区切りのペアとして指定されます。デフォルトでは、関数は 'xmsim' シミュレータを使用します。

データ型: char

起動 Tcl ファイル内のエントリ。'libdir' とフォルダー名で構成されるコンマ区切りのペアとして指定されます。これは、MATLAB がないマシンで Xcelium シミュレータが実行されているときに、Xcelium シミュレータが MATLAB と通信するための共有ライブラリを含むフォルダーを指します。

データ型: char

HDL シミュレーション用のライブラリ ファイル。'libfile' とライブラリ ファイル名で構成されるコンマ区切りのペアとして指定されます。HDL シミュレータが、HDL シミュレータに付属のコンパイラを使用してビルドされた SystemC ライブラリを含む他のライブラリをリンクする場合、このプロパティを使用して代替ライブラリ ファイルを指定できます。デフォルトでは、関数は MATLAB 自体が使用するのと同じコンパイラを使用して構築されたライブラリ ファイルのバージョンを使用します。

データ型: char

HDL シミュレーターを実行する場所。'rundir' とフォルダー名で構成されるコンマ区切りのペアとして指定します。

この名前と値のペアには次の条件が適用されます。

  • dirname の値が "TEMPDIR" の場合、関数は HDL シミュレーターを実行する一時フォルダーを作成します。

  • dirname を指定してもディレクトリが 存在しない 場合は、エラーが発生します。

データ型: char

HDL シミュレーターの実行モード。'runmode' と次のいずれかの値で構成されるコンマ区切りのペアとして指定します。

  • 'Batch' – ウィンドウなしでバックグラウンドで HDL シミュレータを起動します

  • 'Batch with Xterm' – ウィンドウなしでバックグラウンドで HDL シミュレータを起動します

  • 'CLI' – 対話型ターミナルウィンドウでHDLシミュレータを起動します

  • 'GUI' – グラフィカルユーザーインターフェースでHDLシミュレータを起動します

Xcelium シミュレータと Simulink 間の TCP/IP ソケット通信。'socketsimulink' とポート番号またはサービス名で構成されるコンマ区切りのペアとして指定されます。デフォルトでは、関数は共有メモリ通信を使用します。

データ型: char

Xcelium を開始するオプション。'starthdlsim' と次のいずれかの値で構成されるコンマ区切りのペアとして指定します。

  • 'yes' – Xcelium シミュレータを起動した後に起動 Tcl ファイルを作成します。

  • 'no' – Xcelium シミュレータを起動せずに起動 Tcl ファイルを作成します。

生成された Tcl ファイルの名前と場所。'startupfile' とパス名で構成されるコンマ区切りのペアとして指定されます。生成された Tcl スクリプトを実行すると、Xcelium シミュレータがコンパイルされ、起動されます。

データ型: char

Xcelium シミュレータが起動する前に、'tclstart' と Tcl コマンドで構成されるコンマ区切りのペアとして指定された TCL コマンドを実行します。

メモ

非 Tcl システム シェル コマンドの前に exec と入力する必要があります。次に例を示します。

exec -xmvlog -64bit -c +access+rw +linedebug top.v
hdlsimulink -gui work.top

少なくとも 1 つのコマンドを指定する必要があります。指定しないと、アクションは発生しません。

データ型: char

バージョン履歴

R2008a で導入