Intel Agilex® 7デバイスのプロトコル経由コンフィグレーション (CvP) 実装ユーザーガイド

ダウンロード PDF
ID 683763
日付 7/07/2023
Public
ドキュメント目次
ドキュメント目次 x
1. 概要 2. CvPの説明 3. CvPトポロジー 4. デザインの考慮事項 5. CvPドライバーおよびレジスター 6. Intel Agilex® 7デバイスでサポートされているPCIeタイルを使用したCvP Initializationのデザイン手順について 7. Intel Agilex® 7デバイスのプロトコル経由コンフィグレーション (CvP) 実装ユーザーガイドのアーカイブ 8. Intel Agilex® 7デバイスのプロトコル経由コンフィグレーション (CvP) 実装ユーザーガイドの改訂履歴
1. 概要 x
1.1. CvPを使用する利点 1.2. CvPシステム 1.3. CvPモード
1.3. CvPモード x
1.3.1. CvPの制限事項
1.3.1. CvPの制限事項 x
1.3.1.1. CvPエラーの回復
2. CvPの説明 x
2.1. コンフィグレーション・イメージ 2.2. CvPモード 2.3. 圧縮機能 2.4. ピンの説明
2.2. CvPモード x
2.2.1. CvP Initializationモード 2.2.2. CvP Updateモード
3. CvPトポロジー x
3.1. シングル・エンドポイント 3.2. マルチ・エンドポイント
4. デザインの考慮事項 x
4.1. オープンシステム用CvPのデザイン 4.2. クローズドシステム用CvPのデザイン
4.1. オープンシステム用CvPのデザイン x
4.1.1. FPGA電源ランプ時間要件 4.1.2. PCIeウェイクアップ時間要件
4.1.2. PCIeウェイクアップ時間要件 x
4.1.2.1. CvP Initializationモードの場合 4.1.2.2. CvP Updateモード
5. CvPドライバーおよびレジスター x
5.1. CvPドライバーのサポート 5.2. CvPドライバーフロー 5.3. CvP用VSECレジスター
5.3. CvP用VSECレジスター x
5.3.1. Vendor Specific Capability Headerレジスター 5.3.2. Vendor Specific Headerレジスター 5.3.3. Intel Markerレジスター 5.3.4. User Configurable Device/Board IDレジスター 5.3.5. CvP Statusレジスター 5.3.6. CvP Mode Controlレジスター 5.3.7. CvP Dataレジスター 5.3.8. CvP Programming Controlレジスター 5.3.9. CvP Creditレジスター
6. Intel Agilex® 7デバイスでサポートされているPCIeタイルを使用したCvP Initializationのデザイン手順について x
6.1. CvP Initializationモードの実装 6.2. CvP Updateモードの実装
6.1. CvP Initializationモードの実装 x
6.1.1. PCIe* Express用インテルFPGA Pタイル Avalon® Streamingインターフェイスの合成HDLファイルの生成 6.1.2. Device and Pin OptionsでのCvPパラメーターのセットアップ 6.1.3. デザインのコンパイル 6.1.4. SOFファイルの変換 6.1.5. ハードウェアの立ち上げ
6.1.5. ハードウェアの立ち上げ x
6.1.5.1. オープンソースのCvPアップストリーム・ドライバーのLinuxシステムへのインストール 6.1.5.2. 正しいMSELスイッチステートのセットアップ 6.1.5.3. CvPイメージのプログラミング
6.2. CvP Updateモードの実装 x
6.2.1. PCIe Hard IPのインスタンス化 6.2.2. CvPパラメーターのセットアップ 6.2.3. ベースリビジョンのセットアップ 6.2.4. 更新リビジョンのセットアップおよびコンパイル 6.2.5. SOFファイルの変換 6.2.6. PCIe* リンクを介した更新リビジョンからのコアRBFファイルのプログラミング
6.2.3. ベースリビジョンのセットアップ x
6.2.3.1. 予約済みコア・パーティションの作成 6.2.3.2. Logic Lock領域の定義 6.2.3.3. ルート・パーティションのコンパイルとエクスポート
1. 概要
2. CvPの説明
3. CvPトポロジー
4. デザインの考慮事項
5. CvPドライバーおよびレジスター
6. Intel Agilex® 7デバイスでサポートされているPCIeタイルを使用したCvP Initializationのデザイン手順について
7. Intel Agilex® 7デバイスのプロトコル経由コンフィグレーション (CvP) 実装ユーザーガイドのアーカイブ
8. Intel Agilex® 7デバイスのプロトコル経由コンフィグレーション (CvP) 実装ユーザーガイドの改訂履歴

6.1.5.1. オープンソースのCvPアップストリーム・ドライバーのLinuxシステムへのインストール

CvPドライバーのインストールは、同じカーネルバージョンに対して1度だけ行う必要があります。

  1. Ubuntuを使用していて、カーネルをビルドするためにツールのインストールが必要な場合は、次を実行します。 
    sudo apt-get install bison
sudo apt-get install libncurses5-dev 
sudo apt-get install libssl-dev
sudo apt-get install libncursesw5-dev
sudo apt-get install -y libelf-dev
sudo apt-get install git
sudo apt-get install flex
sudo apt-get install -y xz-utils
  2. カーネルソースをダウンロードします。インテルは、github4 のaltera-opensourceのデフォルトのカーネルバージョンを使用することをお勧めします。次のコマンドは、githubのaltera-opensourceからカーネル・ソースコードを取得します。
    コマンド例: 
    git clone https://github.com/altera-opensource/linux-socfpga
  3. カーネル・コード・フォルダーを /usr/src に保存します。
  4. 以下を使用して、ブランチをチェックアウトします。 
    cd linux-socfpga
git checkout socfpga-v5.15.30-lts
  5. (この手順は、kernel.orgからバージョン5.9以下をダウンロードした場合にのみ必要です。5) 次のパッチをインストールする必要があります。
    1. Patch1およびPatch2をダウンロードし、カーネル・ソース・フォルダーに保存します。
    2. カーネル・ソース・ディレクトリー (例: /usr/src/linux-5.9-tt) で、次のコマンドを使用してパッチをインストールします。
      • 次を実行します。
        patch -p1 < 2-2-fpga-add-FPGA-manager-debugfs.patch
      • 次を実行します。
        patch -p1 < 1-2-fpga-doc-documentation-for-FPGA-debugfs.patch
  6. カーネルモジュールをビルドしてインストールします。
    1. カーネル・ソース・フォルダーに移動します。cd /usr/src/linux-socfpga を実行します。
    2. 既存のコンフィグレーションを新しいカーネルにコピーします。cp -v /boot/config-$(uname -r) .config を実行します。
    3. 次のコマンドと手順を使用して、Altera CvP FPGA Managerをカーネルモジュールとしてイネーブルします。
      • make menuconfig を実行します。
      • GUIで、Device Drivers > FPGA Configuration Frameworkに移動します。Altera CvP FPGA ManagerおよびFPGA Manager DebugFSを * に設定します。コンフィグレーション設定を .config ファイルに保存します。
      • .config ファイルを確認します。次の3つの行項目をイネーブルする必要があります。
        • CONFIG_FPGA=y
        • CONFIG_FPGA_MGR_DEBUG_FS=y
        • CONFIG_FPGA_MGR_ALTERA_CVP=y
    4. カーネルをコンパイルします。Make -j 12 を実行します。
    5. カーネルモジュールをインストールします。
      • export INSTALL_MOD_PATH=/usr/src/linux-socfpga を実行します。
      • MODPATH="INSTALL_MOD_PATH=/usr/src/linux-socfpga" を実行します。
      • ARGS="$MODPATH" を実行します。
      • make $ARGS modules を実行します。
      • sudo make modules_install を実行します。モジュールのバージョンをConsoleウィンドウの最後の行で確認します。名前は、カーネルビルドのバージョンと .config ファイルによって異なる場合があります。
      • "sudo make install" を実行します。Linuxイメージとinitrdイメージが、モジュールバージョンに従って作成されていることを確認します。
    6. (この手順は、Ubuntuを使用している場合にのみ必要です) Grand Unified Bootloader (Grub) Boot Loaderの設定を変更します。この手順は、Linuxの初めてのカーネル・インストールで適切なカーネルバージョンで起動するために必須です。
      1. 指定するカーネルモジュールのバージョンを特定します。
        1. grub-mkconfig を実行します。
        2. cat /boot/grub/grub.cfg を実行します。
        3. submenu と menuentryを検索して、カーネルのインストール中に作成されたLinuxイメージとinitrdイメージを特定します。以下に示す例では、submenu 'Advanced options for Ubuntu' と menuentry 'Ubuntu, with Linux 5.15.30+' は、指定するカーネルバージョンが Advanced options for Ubuntu>Ubuntu, with Linux 5.15.30+ であることを示しています。
      2. 元に戻す必要がある場合に備えて、Grubファイルをバックアップしてください。
        • sudo cp /etc/default/grub /etc/default/grub.bak を実行します。
      3. Grubファイルを表示します。
        • cat /etc/default/grub を実行します。
      4. Grubファイルを更新します。
        1. gedit/etc/default/grub を実行します。
        2. 前で特定したとおり、目的のカーネル・モジュール・バージョンを指定するように GRUB_DEFAULT を変更します。
          • 例: GRUB_DEFAULT = "Advanced options for Ubuntu>Ubuntu, with Linux 5.15.30+"
        3. 変更を保存します。
      5. Grubの変更が有効になっていることを確認します。
        • sudo update-grub を実行します。
    7. システムを再起動し、インストールされているカーネルでシステムが再起動することを確認します。
      • reboot を実行します。PCが正常に再起動できるようにします。
      • uname -mrs を実行します。以下に示すように、インストールされているカーネルバージョンでシステムを再起動する必要があります。
4 socfpga-v5.15.30-ltsおよびsocfpga-v5.10.110-ltsは、インテルQuartus Primeのバージョン22.2以降のインテル・ハードウェアでテストされたバージョンです。
5 インテルは、githubのaltera-opensourceのデフォルトのカーネルバージョンを使用することをお勧めします。
レベル 2 の表題