ビルド設定

ハードウェアアプレットを実際に生成(ビルド)するために(「ビルド」を参照)、VisualAppletsはバックグラウンドで動作する一連のツールチェーンを使用します。

VisualAppletsでは、各ハードウェアプラットフォーム向けに、その特定のハードウェアプラットフォームに最適化されたデフォルトのビルドセットアップが用意されています。

デザイン設定で選択したハードウェアプラットフォームに基づいて、対応するデフォルトのビルドセットアップがVisualAppletsによって提案されます。このセットアップはユーザーが変更することはできませんが、ユーザー定義のセットアップに置き換えることができます。

[注] 次の場合、デフォルトのビルドセットアップを独自の設定に置き換える必要があります...
  • microEnable 5(ironmanおよびmarathon)またはLightBridgeプラットフォーム向けのデザインを作成する場合。

  • Xilinx Vivadoを使用する場合。

  • バージョン9.2より新しいXilinx ISEを使用する場合。

[注] 推奨されるXilinxツール

どのハードウェアプラットフォーム向けにアプレットをビルドするためにどのXilinxツールが必要かについての詳細は、どのフレームグラバープラットフォームにどのXilinxツールチェーンとバージョンを使用するかを参照してください。

mE5 marathonおよびLightBridge: mE5 marathonおよびLightBridge向けのアプレットビルドはISE 14.7でも可能ですが、Vivadoを使用したアプレットビルド(合成)の方がこれらのプラットフォームでははるかに高速であるため、BaslerではXilinx Vivadoの使用を推奨しています。

ビルド設定の定義

1つのパラメータセットをアクティブ設定として使用する

プログラムがビルドステップを実行するたびに、特定のビルドパラメータのセットが使用されます。

VisualAppletsには複数のビルドパラメータセットが付属しています。さらにセットを追加することもできます。

アプレットをビルドするには、これらのセットのいずれかを「アクティブな設定」として指定する必要があります。この設定が使用され、それに応じてツールチェーンが制御されます。

すべての設定情報は、ローカルインストールの「SynthesizeSettings.xml」ファイルに保存されます。

[注] アクティブ化された現在のパラメータセット

[Build Settings]ダイアログを開くには、[Settings] → [Build Settings]をクリックします。

ダイアログが開きます。アクティブ化されたパラメータセットが表示されます:

  • アクティブ化されたパラメータセットは、[Build Settings]ダイアログの左側パネルにある緑色のチェックマークで示されます。

  • アクティブ化されたパラメータセットはビルドに使用されます。

  • アクティブ化されたパラメータセットは、表示する別のパラメータセットを選択した場合でも、アクティブなまま維持されます。(パラメータセットを表示するには、[Build Settings]ダイアログの左側パネルでその名前をクリックします。選択したパラメータセットが[Build Settings]ダイアログの右側パネルに表示されます。)

  • 表示されているパラメータセットは、編集、コピー、保存、または削除できます(下記参照)。

以下では、表示されているパラメータセットを「現在のパラメータセット」と呼びます。

新しいパラメータセットの定義

パラメータセット自体は、ワークフローの特定の手順を実行する外部アプリケーション(Xilinxツール)を起動するためのパラメータと、それらのツールを制御するためのパラメータで構成されています。「アクティブな設定」にチェックを入れることで、特定の設定をデフォルト設定(現在のデザインのビルドを開始するため)として定義でき、この特定のセットの目的を説明するコメントを追加することもできます。

  1. [Build Settings]ダイアログを開くには、メニューの[Settings] → [Build Settings]をクリックします。

    ダイアログが開きます。アクティブ化されたパラメータセットが表示されます。

    [注] 最初代わりのパラメータセットを追加する前に

    デザインのターゲットハードウェア用の追加パラメータセットが作成されていない限り、デフォルトのビルド設定が表示されます。

    これらのデフォルト設定を変更することはできないため、すべての入力フィールドが無効になっています。

    また、デフォルトの代替がまだ存在しないため、「Active configuration」のチェックを外すこともできません。

  2. 新しいパラメータセットを作成するには、Addをクリックします。

    ハードウェアプラットフォーム情報が求められます。ここでは、独自のパラメータセットを作成するための基礎として読み込みたいパラメータセットを指定できます。ほとんどの場合、ここでデザインのターゲットハードウェアを選択するのが非常に合理的です。

    ハードウェアプラットフォームの選択

    図 160: ハードウェアプラットフォームの選択


  1. OKをクリックします。

    これで、最初のフィールドを編集できるようになります。

ビルド設定ウィンドウ

図 161: ビルド設定ウィンドウ


  1. Name: 識別用に新しいPropertyセットに名前を付けます。この名前は、設定ダイアログおよびビルドプロトコルに表示されます。

  2. Active configuration: アプレットのビルド時にこのパラメータセットを使用する場合は、Active Configurationチェックボックスをオンにします。

    [重要] アクティブな設定

    Active configurationとして定義したパラメータセットは、ビルドを実行するたびに見なされて使用されます。

    デザインのターゲットハードウェアプラットフォームとして選択したハードウェアプラットフォームを変更する場合: この新しいプラットフォーム用の新しいビルド設定を定義します。

  3. Precondition Check: デフォルトモードでは、Precondition Checkが有効になっています。Precondition Checkは、デザインのターゲットハードウェア上のFPGAタイプがXilinxツールチェーンでサポートされているかどうかを検証します。さらに、mE5またはLightBridgeプラットフォームのすべてのデザインにおいて、このチェックボックスがオンになっている場合、オペレーターAppletProperties内の情報(具体的にはBuildTimeおよびAppletUidフィールド)がビルドごとに更新されます。そのため、ビルドの完了後、オペレーターAppletProperties内のパラメータ値がビルド中に変更されているため、デザインは「未保存」モードになります。

    [注] AppletPropertiesの更新の回避

    特定の状況では、ビルドによってAppletPropertiesオペレーターを更新したくない場合があります。この場合、単にPreconditions Checkチェックボックスをオフにします。

  4. Xilinx ISE/Xilinx Vivado: 使用するXilinxツールチェーンを選択します。Vivadoは、すべてのmarathonおよびLightBridgeプラットフォームでサポートされています。オープンデザインのターゲットハードウェアでVivadoがサポートされていない場合は、GUIに直接その旨が表示されます。

    ターゲットハードウェアデザインでサポートされているVivado

    図 162: ターゲットハードウェアデザインでサポートされているVivado


    ターゲットハードウェアデザインでサポートされていないVivado

    図 163: ターゲットハードウェアデザインでサポートされていないVivado


  5. ビルド環境:

    • 新しいXilinxツールを使用する場合(つまり、Xilinx Vivado、またはバージョン9.2より後のXilinx ISEを使用して開発する場合):

      • 「Use system environment」チェックボックスをオフにして、

      • ファイルシステムから、外部ツールを起動するための環境を設定するXilinx設定バッチファイルを選択します。

      最適な選択を行うために、Xilinxのマニュアルに従ってください。

      バッチファイルは、Xilinxのインストールフォルダーにあります:

      • ISE: \Xilinx\14.7\ISE_DS\settings64.bat。

      • Vivado: \Xilinx\Vivado\2020.2\settings64.bat。

      microEnable 5プラットフォーム用のアップレットを開発する場合、Baslerは64ビットWindowsオペレーティングシステムの使用を推奨しています。使用しているオペレーティングシステムに一致するバッチファイル(例:64ビットWindows OS用のファイルである「settings64.bat」)を選択するようにしてください。

    • 古いXilinx ISEバージョン(バージョン9.2以前)を使用しておりかつすべての環境変数がオペレーティングシステムに設定されている場合は、「Use system environment」チェックボックスをオンにします。

  6. ビルドフロー:Build Flowの下にあるすべてのオプションを有効にします。通常、すべてのステップを有効にする必要があります。

    Baslerでは、Multi place and routeの設定を20イテレーションにすることを推奨しています。

    Command ModeをUse platform default valueのままにします。

  7. アップレット生成:Applet Generationを有効にします。

  8. コメント:作成したパラメータのセットを説明するコメントを入力します。ここに入力した内容は、実際のビルドプロセスには影響しません。

  9. OKボタンをクリックします。

例:microEnable 5またはLightBridge用に開発する場合、次のパラメータ値を設定する必要があります:

パラメータセットの例:microEnable 5またはLightBridge向けの開発

図164. パラメータセットの例:microEnable 5またはLightBridge向けの開発


[重要] ビルドフローステップの無効化

デフォルトでは、すべてのビルドフローステップ(トランスレーション、マッピングなど)が有効になっています:

デフォルト:すべてのビルドフローステップが有効

図165. デフォルト:すべてのビルドフローステップが有効


ExpertライセンスまたはVisualApplets 4ライセンスを使用すると、個別のステップの選択を解除できます。ただし、ビルドステップには依存関係があります。依存関係の順にリストされています:

  • トランスレーションは、常に最初に実行できるステップです。

  • Mappingは、事前にTranslationのステップが実行されている場合にのみ実行できます。

  • Place and routeは、事前にMappingのステップが実行されている場合にのみ実行でき、以降も同様です。

後続のビルドステップが無効になりました

図 166. 後続のビルドステップが無効になりました


ただし、前のステップを同じビルド実行内で実行する必要はありません。以前のビルド実行で実行されていた場合でも構いません。以前のビルド実行中に生成されたファイル(トレースファイル)が利用可能なままである限り、「Build Flow」リストで前にあるステップを無効にし、リストで後にあるステップを有効にすることが可能です。

以前のビルド実行のトレースファイルを保持するには:メニューのSettings → System Settings → Global Buildに移動します。Build Trace Filesの下にあるKeep build trace filesを有効にします。Compress build trace filesを無効にします。

個々のビルドステップのビルドファイルを保持する

図 167. 個々のビルドステップのビルドファイルを保持する


ビルドトレースファイルを保持し、以前のすべてのビルドフローステップを一度実行している場合は、後続のステップのみを有効にすることもできます。例:

個々のビルドステップのビルドファイルを保持する

図 168. 個々のビルドステップのビルドファイルを保持する


[重要] コマンドモードのオプション

ExpertライセンスまたはVisualApplets 4ライセンスを使用すると、Command Modeを変更できます。

Command Modeを変更するには、Build Flowエリアの右上隅にあるCommand Mode に移動します。

コマンドモードのオプション

図 169. コマンドモードのオプション


リストには、3つの異なるオプションがあります。

  • プラットフォームのデフォルト値を使用する(Default)

  • プラットフォームのデフォルト値に追加する

  • プラットフォームのデフォルト値を上書きする

----------

Use platform default value(Default):

このオプションを保持または選択した場合、VisualAppletsは、オープンデザインのターゲットプラットフォームとして指定したハードウェアプラットフォームに推奨されるデフォルト値を表示します。

VisualAppletsは、Xilinxツールを実行する際(つまり、オープンデザインから実際のアップレットがビルド(合成)される際)にも、これらのデフォルト値を使用します。

デフォルトセットは変更できないため、Use platform default valueモードでArgumentsフィールドを編集することはできません。

コマンドモード「Use platform default value」

図 170. コマンドモード「Use platform default value」


Append to platform default value:

このオプションを選択すると、VisualAppletsによって提供される基本引数に、MappingおよびPlace and routeツールの情報を追加できます。

ビルド中、VisualAppletsはツールを呼び出す際に、Argumentsフィールドで定義したパラメータをプラットフォームのデフォルト値に追加します。この設定は経験豊富なユーザー専用です。

コマンドモード「Append to platform default value」

図 171:コマンドモード「Append to platform default value」


Overwrite platform default value:

このオプションを選択すると、新しいアプレットセットの作成直後に、選択したターゲットハードウェアプラットフォームのMappingおよびPlace and routeのデフォルト引数がVisualAppletsに表示されます。ここで指定されているMappingおよびPlace and routeの引数を定義(上書き)できます。VisualAppletsは、ツールを呼び出す際に、これらのArgumentsフィールドで指定したパラメータのみを使用するようになります。この設定は経験豊富なユーザー専用です。

コマンドモード「Overwrite platform default value」

図 172:コマンドモード「Overwrite platform default value」


パラメータセットの再利用

Build Settingsウィンドウでは、パラメータセットの処理に関するいくつかのオプションが用意されています。

処理オプション

図 173:処理オプション


クリックすると

  • Add:(選択したハードウェアプラットフォームに基づいて)必要に応じて変更できる新しいパラメータセットを作成します。

  • Copy:現在のセットのパラメータをコピーし、新しいセットを作成して、コピーしたセットのパラメータを新しいセットに貼り付けます。

  • Import:特定のパラメータセットを現在のVisualAppletsのインストール環境にインポートできます。

  • Export selected:現在のパラメータセットをファイルに保存します。このファイルは、データを別のPCやインストール環境に移行する場合や、バックアップの目的で使用できます。ファイル名と保存先を指定するためのダイアログが表示されます。

  • Delete:現在のパラメータセットを削除します。

経験豊富なユーザー向け:同じビルドを使用して異なるオペレーティングシステム用の *.hap ファイルを作成する(mE 5 ironman、mE5 marathon、およびLightBridge)

mE 5 ironman、mE5 marathon、およびLightBridgeの場合、Precondition Checkチェックボックスには特定の機能があります:

  • Precondition Checkが有効な場合、合成(ビルド)の開始ごとにBuildTimeとAppletUidのエントリが更新されます。(ネットリスト生成からアプレット生成までの)完全なビルドを開始する場合は、Precondition Checkを有効にする必要があります。有効にしないと、後で(フレームグラバーでアプレットを使用する際に)ロードされたアプレットがランタイム環境によって信頼性の高い検証を受けられなくなります。

  • 特定のオプション:すでにアプレットを完全にビルドしたものの、別のターゲットオペレーティングシステム用に別の *.hap ファイルが必要になった場合:完全なビルドから新しいOS固有のhapファイルをビルドすることで、他のターゲットオペレーティングシステム(つまり別のターゲットランタイム)でデザインを使用できるようにすることができます。手順は以下の通りです:

    1. Settingsメニューで、System Settingsを選択します。

    2. 開いたウィンドウで、Global Buildカテゴリを選択します。

    3. ここで、Build Trace Filesの下にあるKeep build trace filesオプションを有効にし、パスを指定します。

    4. メニューの Settings、およびメニュー項目の Build Settings に移動します。

    5. Precondition Check オプションを Deactivate します。

    6. Xilinx Build Flow の下にある他のすべてのオプションを非有効化します。

    7. Applet Generation を有効化します。

    8. [Defaults] で、Active Configuration を有効化します。

    9. OS 固有の *.hap ファイルのビルドを開始します。

    特に複雑なデザインの場合、このオプションを使用することで時間を節約できます。