使い始めユーザーガイド: インテル® Quartus® Prime プロ・エディション

ID 683463
日付 5/07/2018
Public
ドキュメント目次

2.11. プロジェクト管理のベスト・プラクティス

インテル® Quartus® Primeソフトウェアは、プロジェクトを設定するためのさまざまなオプションを提供します。 以下のベスト・プラクティスは、プロジェクト・ファイルの効率的な管理と移植性を保証するのに役立ちます。

設定ファイルとプロジェクトファイルのベスト・プラクティス

  • インテル® Quartus® Prime Project File(.qpf)、 インテル® Quartus® Prime Settings File(.qsf)、Quartus IPファイル(.qip)、またはPlatform Designer System File(.qsys)などの インテル® Quartus® Primeデータファイルを編集する場合、非常に注意してください。 これらのファイルのタイプミスはソフトウェア・エラーを引き起こす可能性があります。 たとえば、ソフトウェアは設定や割り当てを無視することがあります。

    すべての インテル® Quartus® Primeのプロジェクト・リビジョンには、GUIに入力するかTclコマンドで追加するさまざまなプロジェクト設定と制約を保持するサポート.qpfが自動的に含まれます。 このファイルには、現在のソフトウェアのバージョン、日付、プロジェクト全体およびエンティティー・レベルの設定に関する基本情報が含まれています。 .qpf.qsfの依存関係のため、.qsfファイルを手動で編集しないでください。

  • 複数のプロジェクトを同じディレクトリーにコンパイルしないでください。 代わりに、プロジェクトごとに別々のディレクトリーを使用してください。

  • デフォルトでは、 インテル® Quartus® PrimeソフトウェアはText-Format Report Files(.rpt)などのすべてのプロジェクト出力ファイルをプロジェクト・ディレクトリーに保存します。 プロジェクトの出力ファイルを手動で移動する代わりに、プロジェクトのコンパイル設定を変更して別のディレクトリーに保存します。

    これらのファイルを別のディレクトリーに保存するには、Assignments > Settings > Compilation Process Settingsを選択します。Save project output files in specified directoryをオンにして、出力ファイルのディレクトリーを指定します。

プロジェクト・アーカイブとソース管理のベスト・プラクティス

プロジェクトをリビジョン管理用にアーカイブするには、Project > Archive Projectをクリックします。

デザインを開発するときに、 インテル® Quartus® Primeプロジェクト・ディレクトリーにはさまざまなソースファイルと設定ファイル、コンパイル・データベース・ファイル、出力ファイル、およびレポートファイルが含まれています。 アーカイブ機能を使用してこれらのファイルをアーカイブし、後で使用するためにアーカイブを保存したり、リビジョン管理下に置くことができます。

  1. Project > Archive Project > Advancedを選択してAdvanced Archive Settingsダイアログボックスを開きます。
  2. アーカイブするファイルセットを選択します。 たとえば、Rapid Recompileリビジョンでプロジェクトを再作成するために必要なソースファイルとデータベース・ファイルを保存するには、File set > Source control with incremental compilation and Rapid Recompile databaseを選択します。
  3. Addをクリックしてファイルを追加します(オプション)。

アーカイブされたプロジェクトを復元するには、Project > Restore Archived Projectを選択します。プロジェクトを空の新しいディレクトリーに復元します。

IPコアのベスト・プラクティス

  • 独自の.qsys.ip、または.qipファイルを手動で編集または書き込まないでください。 これらのファイルを作成および編集するには、 インテル® Quartus® Primeソフトウェア・ツールを使用します。
    注: IPコアを生成するときは、ディレクトリー名またはパスにスペースを含むディレクトリーにファイルを生成しないでください。 スペースは、IPコアのパスまたは名前には有効な文字ではありません。
  • IPカタログを使用してIPコアを生成すると、 インテル® Quartus® Primeソフトウェアは.qsysPlatform Designer生成IPコアの場合)または.ipファイル( インテル® Quartus® Prime プロ・エディションの場合)または.qipファイルを生成します。 インテル® Quartus® Prime プロ・エディションのソフトウェアは、生成された.ipをプロジェクトに自動的に追加します。 インテル® Quartus® Prime スタンダード・エディションのソフトウェアで、.qipをプロジェクトに追加します。.qsysファイルまたは.qipファイルを使用せずに、パラメーター・エディターで生成されたファイル(.vまたは.vhd)をデザインに追加しないでください。 それ以外の場合は、IPアップグレードまたはIPパラメーター・エディター機能を使用できません。
  • 事前にディレクトリー構造をプランニングします。.qsysファイルとその生成出力ディレクトリーの相対パスを変更しないでください。.qsysファイルを移動する必要がある場合、生成出力ディレクトリーに.qsysファイルが残っていることを確認します。
  • プロジェクトの/quartus/libraries/megafunctionsディレクトリーからIPコアファイルを直接追加しないでください。 それ以外の場合、それ以降のソフトウェア・リリースごとにファイルを更新する必要があります。 代わりに、IPカタログを使用し、.qipをプロジェクトに追加します。
  • 古いデバイスファミリーを対象としたRAMまたはFIFOブロック用に インテル® Quartus® Primeソフトウェアが生成するIPファイルを使用しないでください( インテル® Quartus® Primeソフトウェアではエラーが発生しなくても)。 インテル® Quartus® Primeが古いデバイスファミリー用に生成するRAMブロックは、最新のデバイスファミリー用に最適化されていません。
  • ROM機能を生成する場合、結果の.mifまたは..hexファイルを、対応するIPコアの.qsysまたは.qipファイルと同じフォルダーに保存します。 たとえば、プロジェクトの.mifファイルまたは.hexファイルをすべて同じディレクトリーに移動すると、デザインをアーカイブした後に相対パスの問題が発生します。
  • デザイン内のIPコアまたはPlatform Designerシステムごとにシミュレーション・スクリプトを生成するには、常に インテル® Quartus® Prime ip-setup-simulationユーティリティとip-make-simscriptユーティリティを使用します。 これらのユーティリティは、 インテル® Quartus® PrimeソフトウェアまたはIPバージョンへのアップグレードのための手動アップデートを必要としない単一のシミュレーション・スクリプトを生成します。