はじめに
このページは、カスタム IP コア (custom IP core) のクイックスタートガイドです。カスタム IP コアの詳細は、カスタム Xillybus IP コア定義ガイドに記載されています。
Xillybus の正しい開始方法は別のページで説明しています。特に、FPGA 用のスタータープロジェクトはデモバンドル (demo bundle) であり、Xillybus のウェブサイトからダウンロードできます。
後の段階で、IP コア (IP core) を変更したくなることがあります。たとえば、アプリケーションに適したストリームをいくつか追加したい場合などです。これが、IP Core Factory の目的です。これは、ニーズに応じてカスタム IP コアを作成できる Web アプリケーションです。このツールで IP コアを設定し、IP Core バンドルを zip ファイルとしてダウンロードします。
IP コアの各パラメータの意味は、カスタム Xillybus IP コア定義ガイドで詳しく説明されています。
Linux または Microsoft Windows 用のドライバは、すべてのカスタム IP コアで同じものが使えることに注意してください。ドライバは、初期化時に IP コア自身から IP コアに関する情報を取得します。したがって、ドライバを一度インストールした後は、コンピュータに新しいものをインストールする必要はありません。
また、IP Core Factory の zip ファイルを使うには、対応するデモバンドルが必要になることにも注意してください。これは、別のページで提案されているように、デモバンドルから始めるべき理由のひとつです。
カスタム IP コアのデモバンドルへの組み込み
IP Core Factory からカスタム IP コアをダウンロードしたら、この IP コアを含めるようにデモバンドルを変更する必要があります。その手順はいくつかの簡単なステップで、以下に示します。
同様の手順が、IP Core Factory の zip ファイルに含まれる README.TXT にも書かれています。この README ファイルには、他にも役立つ情報が含まれています。
- Core ID は 5 桁の数字です。この番号は IP コアの一意な識別子です。Core ID は、価格の見積もりを依頼するときに伝える必要があります。
- IP コアのデバイスファイルの一覧が記載されています。各デバイスファイルの技術的な詳細も示されています。これが IP コアの実際の特性に関する正確な情報です。
カスタム IP コアをデモバンドルに組み込むには、次の手順に従います。
- デモバンドル内の 2 つのファイルを、IP Core バンドル内のファイルで置き換えます:xillybus.v と xillybus_core.v(または xillybus_xl_core.v / xillybus_xxl_core.v)。
- IP コア本体を置き換えます。このファイルは、デモバンドルの core/ というサブディレクトリにあります。置き換えるファイルは、xillybus_core.ngc、xillybus_core.edf、xillybus_core.qxp、xillybus_core.vqm のような名前です。
- xillydemo.v(または xillydemo.vhd)を編集して、目的のアプリケーションをこのカスタム IP コアに組み込みます。参考にするには、IP Core バンドルの「instantiation templates」ディレクトリを見てください。template.v(または template.vhd)というファイルに、従うべきインスタンシエーションテンプレート (instantiation) が含まれています。
インスタンシエーションテンプレートには FIFO が含まれていないことに注意してください。ただし、データ収集 (data acquisition) のページで提案されているように、Xillybus の IP コアとのやり取りには FIFO を使うことをお勧めします。
一般的なガイドライン
カスタム IP コアを扱う際に時間を節約できる、一般的なアドバイスのリストです。
- カスタム Xillybus IP コア定義ガイドを読みましょう。
- IP Core Factory の「Autoset internals」オプションを使いましょう。このオプションをオフにできるのは、経験豊富な Xillybus ユーザー向けです。そうでなければ、Web ツールの自動判断のほうが良い結果になる可能性が高いです。
- それでも、Web ツールがどのような判断をしたかを知るために、README ファイルは読んでください。
- 特に、各 DMA バッファのサイズと、送信しようとしているデータとの間に関係を持たせる必要はありません。そうしたくなる場合は、これらのデータ収集に関する説明が役立つかもしれません。
- IP Core Factory では、アプリケーションに最も合う「Use」(ドロップダウンメニュー)を選択してください。これにより、デバイスファイルが同期ストリームになるか非同期ストリームになるかが決まります。これらの用語については、別のページで簡単に、ドキュメントでより詳しく説明されています。