export_simulation - 2022.1 日本語

ターゲット シミュレータのシミュレーション スクリプトをエクスポートします。生成されたスクリプトには、デザインをコンパイル、エラボレート、シミュレーションするためのシミュレータ コマンドが含まれます。

このコマンドは、指定したオブジェクトのシミュレーション コンパイル順を取得して、この情報をコンパイラ コマンドとターゲット シミュレータのデフォルト オプションを使用してシェル スクリプトにエクスポートします。オブジェクトとしては、シミュレーション ファイルセットまたは IP を指定できます。Vivado IDE 外でシミュレーションを実行する場合は、スクリプト ファイルの生成に launch_simulation -scripts_only ではなく export_simulation を使用できます。

export_simulation  [-simulator <arg>] [-of_objects <arg>]
                   [-ip_user_files_dir <arg>] [-ipstatic_source_dir <arg>]
                   [-lib_map_path <arg>] [-script_name <arg>]
                   [-directory <arg>] [-runtime <arg>] [-define <arg>]
                   [-generic <arg>] [-include <arg>] [-use_ip_compiled_libs]
                   [-absolute_path] [-export_source_files]
                   [-generate_hier_access] [-32bit] [-force] [-quiet]
                   [-verbose][-gcc_install_path <arg>] [-more_options <arg>]

使用法

説明

ターゲット シミュレータのシミュレーション スクリプト ファイルをエクスポートします。サポートされるシミュレータは、下のリストを参照してください。生成されたスクリプトには、デザインをコンパイル、エラボレート、シミュレーションするためのシミュレータ コマンドが含まれます。

このコマンドは、指定したオブジェクトのシミュレーション コンパイル順を取得して、この情報をコンパイラ コマンドとターゲット シミュレータのデフォルト オプションを使用してシェル スクリプトにエクスポートします。オブジェクトとしては、シミュレーション ファイルセット、IP、または BD (ブロック デザイン) を指定できます。

オブジェクトを指定しない場合、アクティブなシミュレーション top のスクリプトが生成されます。Verilog のインクルード ディレクトリまたは Verilog の define 文を含むファイルへのパスは、コンパイラ コマンド ラインに追加されます。

デフォルトでは、コンパイラ コマンド ラインのデザイン ソース ファイルおよびインクルード ディレクトリ パスは、生成されるスクリプトで定義される reference_dir 変数に相対するパスとして設定されます。これらのパスを絶対パスにするには、-absolute_path オプションを使用します。

このコマンドでは、ファイルセットからのデータ ファイル (存在する場合) も出力ディレクトリにコピーされます。デザインに Verilog ソースが含まれる場合は、生成されるスクリプトにより glbl.v もソフトウェア インストール パスから出力ディレクトリにコピーされます。

ターゲット シミュレータ用のシミュレーション スクリプトのコンパイラ コマンドで使用されるデフォルト .do ファイルが出力ディレクトリに作成されます。

サポートされるシミュレータ

• Vivado シミュレータ (xsim)
• ModelSim シミュレータ (modelsim)
• Questa Advanced Simulator (questa)
• Verilog Compiler Simulator (vcs)
• Riviera-PRO Simulator (riviera)
• Active-HDL Simulator (activehdl)
• Cadence 社 Xcelium Parallel Simulator (xcelium)

引数

-of_objects

(オプション) シミュレーション スクリプト ファイルを生成する必要のあるターゲット オブジェクトを指定します。ターゲット オブジェクトとしては、シミュレーション ファイルセット (simset) または IP を指定できます。このオプションを使用しない場合、現在のシミュレーション ファイルセットに対するファイルが生成されます。

-lib_map_path

(オプション) 選択したシミュレータ用のザイリンクスコンパイル済みシミュレーション ライブラリへのパスを指定します。シミュレーション ライブラリは、compile_simlib を使用してコンパイルします。詳細は、生成されたスクリプトのヘッダー セクションを参照してください。このオプションを指定しない場合、生成されたスクリプトでコンパイル済みシミュレーション ライブラリが参照されず、スタティック IP ファイルがローカルでコンパイルされます。

-script_name

(オプション) 生成されたスクリプトの名前を指定します。デフォルト名は <simulation_top>.sh です。-of_objects オプションを指定した場合、スクリプトのデフォルト構文は次のようになります。

-of_objects [current_fileset -simset] .sh
-of_objects [get_ips ] .sh
-of_objects [get_files .xci] .sh
-of_objects [get_files .bd] .sh

-absolute_path

(オプション) ソースおよびインクルード ディレクトリ パスを絶対パスにするよう指定します。デフォルトでは、すべてのパスは、-directory オプションで指定された出力ディレクトリに相対するパスとして設定されます。

-32bit

(オプション) 32 ビット シミュレーションを実行するよう指定します。このオプションを指定しない場合、デフォルトの 64 ビット オプションがシミュレーション コマンド ラインに追加されます。

-force

(オプション) 指定したスクリプト ファイルが存在する場合に上書きします。スクリプト ファイルが存在する場合に -force が指定されていないと、エラー メッセージが表示されます。

-directory

(必須) スクリプト ファイルをエクスポートするディレクトリ パスを指定します。

-simulator

(必須) シミュレーション スクリプトのターゲット シミュレータを指定します。有効なシミュレータ名は xsim、modelsim、questa、および vcs (または vcs_mx) です。

-quiet

(オプション) コマンドをメッセージを表示せずに実行します。コマンド ライン エラーは無視され、エラー メッセージは表示されません。実行中にエラーが発生しても、TCL_OK が返されます。

-verbose

(オプション) メッセージの非表示設定を一時的に解除し、コマンドからのすべてのメッセージを返します。

-generate_hier_access

(オプション) 階層アクセス シミュレーション用にパスを抽出します。

-runtime

(オプション) シミュレーション ランタイムを指定します。

-define

(オプション) デザインで使用される Verilog 定義のリストを指定します。

-generic

(オプション) デザインで使用される VHDL ジェネリックのリストを指定します。

-include

(オプション) デザインの Verilog インクルード ファイルへのインクルード ディレクトリ パスのリストを指定します。

-export_source_files

(オプション) 生成されたスクリプトのディレクトリの srcs というサブディレクトリに IP デザイン ファイルをコピーするよう指定します。生成されたスクリプトでは、この srcs ディレクトリからのデザイン ファイルを参照します。