インテルのみ表示可能 — GUID: kra1521532794056
Ixiasoft
インテルのみ表示可能 — GUID: kra1521532794056
Ixiasoft
5.3.1. 操作コマンド
クアッドSPIフラッシュのリセット
RSU SDMコマンドの使用例
コマンド | コード (16進数) | コマンド長 14 | 応答長 14 | 説明 | |||
---|---|---|---|---|---|---|---|
RSU_IMAGE_UPDATE | 5C | 2 | 0 | ファクトリーまたはアプリケーション・イメージのいずれかであるデータソースからリコンフィグレーションをトリガーします。 このコマンドは、フラッシュ内のリコンフィグレーション・データ・アドレスを指定するための64ビットのオプションの引数を取ります。引数をIPに送信する際は、最初にビット[31:0]を送信し、次にビット[63:32]を送信します。この引数が指定されていない場合、その値は0と見なされます。
デバイスがこのコマンドを処理すると、デバイスのリコンフィグレーションに進む前に、応答ヘッダーを応答FIFOに返します。ホストPCまたはホスト・コントローラーが他の割り込みの処理を停止して応答ヘッダーデータの読み出しに集中し、コマンドが正常に完了したことを示していることを確認します。そうしないと、リコンフィグレーション・プロセスが開始されると、ホストPCまたはホスト・コントローラーが応答を受信できない場合があります。 デバイスがリコンフィグレーションを進めると、外部ホストとFPGA間のリンクが失われます。デザインでPCIeを使用する場合は、PCIeリンクを再列挙する必要があります。
重要: クアッドSPIをリセットするときは、クアッドSPIフラッシュのリセット で指定されている指示に従う必要があります。
|
|||
RSU_GET_SPT | 5A | 0 | 4 | RSU_GET_SPT は、RSUが使用する2つのサブ・パーティション表 (SPT0とSPT1) のクアッドSPIフラッシュの位置を取得します。 4ワードの応答には、次の情報が含まれます。 |
|||
ワード | 名前 | 説明 | |||||
0 | SPT0[63:32] | クアッドSPIフラッシュのSPT0アドレスです。 | |||||
1 | SPT0[31:0] | ||||||
2 | SPT1[63:32] | クアッドSPIフラッシュのSPT1アドレスです。 | |||||
3 | SPT1[31:0] | ||||||
CONFIG_STATUS | 4 | 0 | 6 | 最後のリコンフィグレーションの状態を報告します。このコマンドを使用し、コンフィグレーション中および終了後のコンフィグレーション状態を確認することができます。応答には次の情報が含まれます。 |
|||
ワード | 名前 | 説明 | |||||
0 | State | 最新のコンフィグレーションに関連するエラーについて説明します。コンフィグレーション・エラーがない場合は0が返されます。
エラーフィールドには2つのフィールドがあります。
詳細については、 Mailbox Client Intel® FPGA IPユーザーガイド Appendix: CONFIG_STATUS and RSU_STATUS Error Code Descriptionsを参照してください。 |
|||||
1 | Quartus Version |
19.4から21.2の間の Quartus® Prime開発ソフトウェアのバージョンで使用可能です。フィールドでは次のように表示されます。
Quartus® Prime開発ソフトウェアのバージョン21.3以降で使用可能です。Quartusバージョンでは次のように表示されます。
例えば、 Quartus® Prime開発ソフトウェアのバージョン21.3.1において次の値が示すのは、Quartusのメジャーリリース番号とマイナーリリース番号、およびQuartusの更新番号です。
|
|||||
2 | Pin status |
|
|||||
3 | ソフト機能の状態 | SDMピンに機能が割り当てられているかどうかにかかわらず、各ソフト機能の値を含みます。
|
|||||
4 | エラー位置 | エラーの位置を含みます。エラーがなければ0を返します。 | |||||
5 | エラー詳細 | エラーの詳細を含みます。エラーがなければ0を返します。 | |||||
RSU_STATUS | 5B | 0 | 9 | 現在のリモート・システム・アップグレードの状態を報告します。このコマンドを使用し、コンフィグレーション中および終了後のコンフィグレーション状態を確認することができます。このコマンドは次の応答を返します。 | |||
ワード | 名前 | 説明 | |||||
0-1 | Current image | 現在実行中のアプリケーション・イメージのフラッシュオフセットです。 | |||||
2-3 | Failing image | 最後に失敗したアプリケーション・イメージのフラッシュオフセットです。フラッシュメモリーに複数のイメージがある場合は、最初に失敗したイメージの値を格納します。値がすべて0であれば、失敗したイメージがないことを示します。失敗したイメージがない場合、続くワードのステータス情報に意味のあるデータは含まれていません。
注: AS x4からリコンフィグレーションするための nCONFIG の立ち上がりエッジでは、このフィールドはクリアされません。失敗したイメージに関する情報が更新されるのは、Mailbox Client Intel® FPGA IPが新しい RSU_IMAGE_UPDATE コマンドを受信し、更新イメージから正常にコンフィグレーションされた場合のみです。
|
|||||
4 | State | 失敗したイメージの失敗コードです。
エラーフィールドには2つの部分があります。
失敗がない場合は0を返します。詳細については、 Mailbox Client Intel® FPGA IPユーザーガイド Appendix: CONFIG_STATUS and RSU_STATUS Error Code Descriptionsを参照してください。 |
|||||
5 | Version | RSUインターフェイスのバージョンとエラーソースです。 詳細については、ハード・プロセッサー・システム (HPS) のリモート・システム・アップデート・ユーザーガイドを参照してください。 |
|||||
6 | Error location | 失敗したイメージのエラー位置を格納します。エラーがない場合は0を返します。 | |||||
7 | Error details | 失敗したイメージのエラー詳細を格納します。エラーがない場合は0を返します。 | |||||
8 | Current image retry counter | 現在のイメージに対して試行された再試行の数です。カウンターは最初は0です。カウンターは、最初の再試行後は1に設定され、2回目の再試行後には2に設定されます。 Quartus® Prime Settings File (.qsf) での再試行の最大数を指定します。コマンドは次のとおりです。set_global_assignment -name RSU_MAX_RETRY_COUNT 3。MAX_RETRY カウンターの有効な値は1から3です。使用可能な再試行の実際の数は MAX_RETRY -1 です。 This field was added in version 19.3 of the Quartus® Primeプロ・エディション software. |
|||||
RSU_NOTIFY | 5D | 1 | 0 |
RSU_STATUS 応答のすべてのエラー情報をクリアし、再試行カウンターをリセットします。1ワードの引数には、次のフィールドがあります。
このコマンドは、 Quartus® Primeプロ・エディション開発ソフトウェアの19.3より前のバージョンでは使用できません。 |
|||
QSPI_OPEN | 32 | 0 | 0 | クアッドSPIへの排他的アクセスを要求します。この要求は、他のQSPI要求の前に発行します。クアッドSPIが使用されておらず、SDMがデバイスをコンフィグレーションしていない場合、SDMは要求を受け入れます。SDMがアクセスを許可した場合はOKを返します。OK応答を受信すると、フラッシュデバイスを選択するために QSPI_SET_CS コマンドを発行します。 SDMは、このメールボックスを使用するクライアントに排他的アクセスを許可します。他のクライアントは、QSPI_CLOSE コマンドを使用したアクティブなクライアントによりアクセスが閉じられるまで、クアッドSPIにアクセスできません。 SDM_IOピンを使用するQSPIフラッシュデバイスへのアクセスは、AS x4コンフィグレーション・スキーム、JTAGコンフィグレーション、およびAS x4コンフィグレーション用にコンパイルされたデザインにのみ使用可能です。 Avalon® ストリーミング・インターフェイス ( Avalon® ST) コンフィグレーションでは、QSPIフラッシュメモリーをGPIOピンに接続する必要があります。. デフォルトでは、HPSのソフトウェア・コンフィグレーションでQSPIをディスエーブルしない限り、HPSを含むデザインでは、メールボックス・クライアントIPを介したクアッドSPIフラッシュメモリー・デバイスへのアクセスは使用できません。
重要: クアッドSPIをリセットするときは、クアッドSPIフラッシュのリセット で指定されている指示に従う必要があります。
|
|||
QSPI_CLOSE | 33 | 0 | 0 | クアッドSPIインターフェイスへの排他的アクセスを閉じます。
重要: クアッドSPIをリセットするときは、クアッドSPIフラッシュのリセット で指定された指示に従う必要があります。
|
|||
QSPI_SET_CS | 34 | 1 | 0 | チップ・セレクト・ラインを介して、接続されているクアッドSPIデバイスの1つを指定します。以下に説明するように、1語の引数を取ります。
注: Agilex 7デバイスは、nCSO[0] に接続されたクアッドSPIデバイスからのASコンフィグレーションに向けて1つのAS x4フラッシュメモリー・デバイスをサポートします。デバイスがユーザーモードに入ると、最大4つのAS x4フラッシュメモリーをMailbox Client Intel® FPGA IPまたはHPSと共にデータストレージとして使用できます。Mailbox Client Intel® FPGA IPまはたHPSは、クアッドSPIデバイスへのアクセスに nCSO[3:0] を使用することができます。
Agilex™ 7デバイスでのAS x4コンフィグレーション・スキーム実行中は、このコマンドはすべての QSPI_OPEN コマンドの後に必要です。 JTAGコンフィグレーション・スキーム実行中は、このコマンドはすべての QSPI_OPEN コマンドの後に必要です。
重要: クアッドSPIをリセットする際、クアッドSPIフラッシュのリセットで指定された手順に従う必要があります。
|
|||
QSPI_READ | 3A | 2 | N | 接続されているクアッドSPIデバイスを読み出します。最大転送サイズは4キロバイト (KB) または1024ワードです。
2つの引数を取ります。
部分的に読み出しが成功した場合、QSPI_READ が誤って OK ステータスを返すことがあります。
注: デバイス・コンフィグレーションの進行中は、QSPI_READ を実行することはできません。
重要: クアッドSPIをリセットするときは、クアッドSPIフラッシュのリセット で指定されている指示に従う必要があります。
|
|||
QSPI_WRITE | 39 | 2+N | 0 | クアッドSPIデバイスにデータを書き込みます。最大転送サイズは4キロバイト (KB) または1024ワードです。
3つの引数を取ります。
書き込み用のメモリーを準備するには、このコマンドを発行する前に QSPI_ERASE コマンドを使用してください。
注: デバイス・コンフィグレーションの進行中は、QSPI_WRITE コマンドを実行することはできません。
重要: クアッドSPIをリセットするときは、クアッドSPIフラッシュのリセット で指定されている指示に従う必要があります。
|
|||
QSPI_ERASE | 38 | 2 | 0 | クアッドSPIデバイスの4/32/64 KBセクターを消去します。2つの引数を取ります。
重要: クアッドSPIをリセットするときは、クアッドSPIフラッシュのリセット で指定された指示に従う必要があります。
|
|||
QSPI_READ_DEVICE_REG | 35 | 2 | N | クアッドSPIデバイスからレジスターを読み出します。最大読み出しは8バイトです。2つの引数を取ります。
読み出しが成功すると、OK応答コードが返され、それに続いてデバイスから読み出されたデータが返されます。読み出されたデータの戻り値は4バイトの倍数です。読み出すバイトが正確に4バイトの倍数でない場合は、次のワード境界まで4バイトの倍数でパディングされ、パディングされたビット値はゼロになります。
重要: クアッドSPIをリセットするときは、クアッドSPIフラッシュのリセット で指定された指示に従う必要があります。
|
|||
QSPI_WRITE_DEVICE_REG | 36 | 2+N | 0 | クアッドSPIのレジスターに書き込みます。最大書き込みは8バイトです。3つの引数を取ります。
セクター消去またはサブセクター消去を実行するには、次の例に示すように、シリアル・フラッシュ・アドレスを最上位バイト (MSB) から最下位バイト (LSB) の順序で指定する必要があります。 QSPI_WRITE_DEVICE_REG コマンドを使用してアドレス0x04FF0000のMicron 2ギガビット (Gb) フラッシュのセクターを消去するには、次に示すように、フラッシュアドレスをMSBからLSBの順序で書き込みます。 ヘッダー: 0x00003036 オペコード: 0x000000DC 書き込むバイトの数: 0x00000004 フラッシュアドレス: 0x0000FF04 書き込みが成功すると、OK応答コードが返されます。このコマンドは、4バイトの倍数ではないデータを次のワード境界にパディングします。このコマンドは、データにゼロを埋め込みます。
重要: クアッドSPIをリセットするときは、クアッドSPIフラッシュのリセット で指定された指示に従う必要があります。
|
|||
QSPI_SEND_DEVICE_OP | 37 | 1 | 0 | コマンドオペコードをクアッドSPIに送信します。1つの引数を取ります。
コマンドが成功すると、OK応答コードが返されます。
重要: クアッドSPIをリセットするときは、クアッドSPIフラッシュのリセット で指定された指示に従う必要があります。
|
For CONFIG_STATUS and RSU_STATUS major and minor error code descriptions, refer to Appendix: CONFIG_STATUS and RSU_STATUS Error Code Descriptions in the Mailbox Client Intel® FPGA IP User Guide .