応答には、ビットマスクで設定されたビットに対する1ワードの引数が含まれます。返される電圧は、2進小数点以下の16ビットの符号なし固定小数点数です。例えば、0.75Vの電圧では0x0000C000が返されます。^{13 14 15}

GET_TEMPERATURE コマンドは、指定した1つまたは複数のコア・ファブリックもしくはトランシーバー・チャネルの位置の温度を返します。

返される温度は、2進小数点以下の8ビットの符号付き固定値です。例えば、温度が10°C の場合は0x00000A00が返され、温度がマイナス1.5°Cの場合は0xFFFFFE80が返されます。

ビットマスクが無効な Location を指定している場合、コマンドはエラーコードを返します。これは、0x80000000-0x800000FFの範囲のいずれかの値になります。

Stratix® 10デバイス: センサーの位置に関しては、 Stratix® 10アナログ-デジタル・コンバーター・ユーザーガイドで、温度センサーのチャネルと位置を参照してください。

Agilex™ 7デバイス: ローカル内蔵温度センサーに関しては、 Agilex™ 7パワー・マネジメント・ユーザーガイドを参照してください。

Agilex™ 5デバイス: ローカル内蔵温度センサーに関しては、 Agilex™ 5 Power Management User Guideを参照してください。

データソース (ファクトリー・イメージまたはアプリケーション・イメージのいずれか) からリコンフィグレーションをトリガーします。

このコマンドは、オプションの64ビットの引数を取ります。これは、フラッシュ内のリコンフィグレーション・データ・アドレスを指定するものです。この引数をIPに送信する際は、最初にビット [31:0] を送信し、次にビット [63:32] を送信します。この引数を指定しない場合、その値は0とみなされます。

• ビット [31:0]: アプリケーション・イメージの開始アドレス
• ビット [63:32]: 予約済み (0として書き込み)

デバイスでこのコマンドが処理されると、デバイスのリコンフィグレーションに進む前に、応答ヘッダーが応答FIFOに返されます。ホストPCまたはホスト・コントローラーでは他の割り込みサービスを停止し、応答ヘッダーのデータの読み出しに焦点を当て、コマンドが正常に完了していることが示されていることを確認します。これを行わないと、リコンフィグレーション・プロセスが開始した際に、ホストPCまたはホスト・コントローラーで応答を受信できない場合があります。

デバイスがリコンフィグレーションを開始すると、外部ホストとFPGA間のリンクが喪失します。デザインで PCIe* を使用している場合は、 PCIe* リンクを再列挙する必要があります。

RSU_GET_SPT では、RSUで使用する2つのサブ・パーティション・テーブル (SPT0とSPT1) のクアッドSPIフラッシュの位置を取得します。

4ワードの応答には、次の情報が含まれます。

最後のリコンフィグレーションの状態を報告します。このコマンドを使用して、コンフィグレーション中および終了後にコンフィグレーションの状態を確認することができます。応答には次の情報が含まれます。

詳細については、Mailbox Client Intel® FPGA IPユーザーガイドの付録: CONFIG_STATUS および RSU_STATUS エラーコードの詳細を参照してください。

• ビット [31]: 現在の nSTATUS 出力値 (アクティブLow)
• ビット [30]: 検出されたnCONFIG入力値 (アクティブLow)
• ビット [29:8]: 予約済み
• ビット [7:6]: コンフィグレーション・クロックソース
  • 01 = 内部オシレーター
  • 10 = OSC_CLK_1
  注: ビット [7:6] は、 Agilex™ 7および Agilex™ 5デバイスにのみ適用されます。
• ビット [5:3]: 予約済み
• ビット [2:0]: 電源投入時の MSEL 値

• ビット [31:6]: 予約済み
• ビット [5]: HPS_WARMRESET
• ビット [4]: HPS_COLDRESET
• ビット [3]: SEU_ERROR
• ビット [2]: CVP_DONE
• ビット [1]: INIT_DONE
• ビット [0]: CONF_DONE

最も優先度の高い失敗アプリケーション・イメージのフラッシュオフセットです。フラッシュメモリーに複数のイメージがある場合は、最初に失敗したイメージの値を格納します。値がすべて0であれば、失敗したイメージがないことを示します。失敗したイメージがない場合、ステータス情報の残りのワードに有効なデータは含まれません。

失敗がない場合は0を返します。詳細は、Mailbox Client Intel® FPGA IPユーザーガイドの付録: CONFIG_STATUS および RSU_STATUS エラーコードの詳細を参照してください。

RSUインターフェイスのバージョンとエラーソースです。

詳細は、ハード・プロセッサー・システム (HPS) のリモート・システム・アップデート・ユーザーガイドで、RSUステータスおよびエラーコードのセクションを参照してください。

現在のイメージで行われた再試行の数です。カウンターは最初は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 です。

このフィールドは、 Quartus® Primeプロ・エディション・ソフトウェアのバージョン19.3で追加されました。

このコマンドは、 Quartus® Primeプロ・エディションの19.3より前のバージョンでは使用できません。

クアッド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を含むデザインで、Mailbox Client IPを介したクアッドSPIフラッシュメモリー・デバイスへのアクセスは利用することができません。ただし、HPSのソフトウェア・コンフィグレーションでQSPIを無効にしている場合は当てはまりません。

• ビット [31:28]: 選択するフラッシュデバイス。nCSO[0:3] ピンに対応する値については、次の情報を参照してください。
  • 値 4'h0000 では、nCSO[0] に対応するフラッシュを選択します。
  • 値 4'h0001 では、nCSO[1] に対応するフラッシュを選択します。
  • 値 4'h0002 では、nCSO[2] に対応するフラッシュを選択します。
  • 値 4'h0003 では、nCSO[3] に対応するフラッシュを選択します。
• ビット [27:0]: 予約済み (0として書き込み)。

Stratix® 10デバイス: AS x4コンフィグレーション・スキームでは、このコマンドはオプションです。AS x4コンフィグレーション後、チップセレクト・ラインは最後に実行された QSPI_SET_CS コマンドに従う、またはデフォルトの nCSO[0] になります。

Agilex™ 7および Agilex™ 5デバイス: AS x4コンフィグレーション・スキームでは、このコマンドは各 QSPI_OPEN コマンドの後に必要です。

JTAGコンフィグレーション・スキームではすべてのデバイスにおいて、このコマンドは各 QSPI_OPEN コマンドの後に必要です。

接続しているクアッドSPIデバイスを読み出します。最大転送サイズは4キロバイト (KB) または1024ワードです。

部分的に読み出しが成功している場合に、QSPI_READ では誤った OK ステータスが返されることがあります。

クアッドSPIデバイスにデータを書き込みます。最大転送サイズは4キロバイト (KB) または1024ワードです。

メモリーを書き込みの準備ができている状態にするには、このコマンドを発行する前に QSPI_ERASE コマンドを使用します。

• 消去を開始するフラッシュ・アドレス・オフセット (1ワード)。消去するワード数に応じて、開始アドレスは次のようになります。
  • 消去するワード数が0x400の場合、4KBのアライメント
  • 消去するワード数が0x2000の場合、32KBのアライメント
  • 消去するワード数が0x4000の場合、64KBのアライメント
  4/32/64KB以外にアライメントされたアドレスにはエラーを返します。
• 消去するワード数は、次の倍数で指定されます。
  • 0x400では、4KB (1024ワード) のデータを消去。このオプションは、最小消去サイズです。
  • 0x2000では、32KB (8192ワード) のデータを消去
  • 0x4000では、64KB (16384ワード) のデータを消去

• 読み出しコマンドのオペコード。
• 読み出すバイトの数。

読み出しが成功すると、OK応答コードが返され、それに続いてデバイスから読み出されたデータが返されます。返される読み出しデータは4バイトの倍数です。読み出すバイトが正確に4バイトの倍数でない場合は、4バイトの倍数で次のワード境界までパディングされます。パディングされるビット値は0です。

• 書き込みコマンドのオペコード。
• 書き込むバイトの数。
• 書き込むデータ。

セクター消去またはサブセクター消去を実行するには、次の例に示すように、シリアル・フラッシュ・アドレスを最上位バイト (MSB) から最下位バイト (LSB) の順序で指定する必要があります。

QSPI_WRITE_DEVICE_REG コマンドを使用してアドレス0x04FF0000のMicron 2ギガビット (Gb) フラッシュのセクターを消去するには、次に示すように、フラッシュアドレスをMSBからLSBの順序で書き込みます。

ヘッダー: 0x00003036

オペコード: 0x000000DC

書き込むバイトの数: 0x00000004

フラッシュアドレス: 0x0000FF04

書き込みが成功すると、OK応答コードが返されます。このコマンドでは、4バイトの倍数ではないデータを次のワード境界までパディングします。このコマンドでは、データを0でパディングします。

• クアッドSPIデバイスに送信するオペコード。

コマンドが成功すると、OK応答コードが返されます。

このコマンドは、2つの32ビット・ワードを引数として取ります。

ワード0

• ビット [1:0]: SHAバリアント。このパラメーターは、使用するSHAアルゴリズムのタイプを決定します。次の値を取ることができます。
  • 00: SHA512
  • 01: SHA384
  • 10: SHA256
• ビット [31:2]: 開始アドレス。フラッシュ内のこのアドレスから検証を開始します。アドレスは4バイトでアライメントされている必要があります。

ワード1

• ビット [31:0]: NumBytes。これは、SHA読み出しで使用されるバイト数を表します。64の倍数にする必要があります。

通常、コンフィグレーション・サイクルカウントは下位32ビットでキャプチャーされます。ファームウェアが64ビットのサイクルカウントを返すことはほとんどありませんが、64ビットが返される場合は、2つの32ビット・ワードを連結して総サイクルカウント値を取得する必要があります。

次に例を示します。

返される応答: 0x007C27EE = 8136686サイクル

コンフィグレーション・コントロール・クロック周波数: 200MHz

コンフィグレーション時間: (8136686/200000000) × 1000 = 40.68ミリ秒

• エラー・メッセージ・キューが空の場合は1、それ以外の場合は、
• 長さ +2、FIFOサイズ [17] まで

SEUエラーが検出されると、エラー情報はエラー・メッセージ・キューに格納されます。このコマンドは、キューを検査し、そこからエントリーを削除する方法を提供します。

Device and Pin OptionsウィンドウでSEU_ERRORピンを設定すると、エラー・メッセージ・キューに1つ以上のエラーがある場合に、SEU_ERROR信号がHighの状態で維持されるようになります。エラー・メッセージ・キューが空の場合、信号はLowになります。

エラー・メッセージ・キューにエラーがない場合、応答長は1ワードになります。

キューに1つ以上のエラーがある場合、キューから最初のエラーが取り出され、後続のワードで返されます。このコマンドは、一度に1つの要素をキューから返します。

このコマンドは、指定されているセクターのSEU統計を報告します。

このコマンドは、1つの32ビット・ワードを引数として取ります。

ワード0

• ビット [31:24]: 予約済み (0として書き込み)
• ビット [23:16]: セクターアドレス
• ビット [15:0]: 予約済み (0として書き込み)

応答長は次のとおりです。

• ワード0

  • ビット [31:0]: T_seu_cycle

• ワード1
  • ビット [31:0]: T_seu_detect
• ワード2
  • ビット [31:0]: T_seu_correct
• ワード3
  • ビット [31:0]: T_seu_inject_detect
• ワード4
  • ビット [31:0]: T_sdm_seu_poll_interval
• ワード5
  • ビット [31:0]: T_sdm_seu_pin_toggle_overhead

時間 (秒) = サイクル/内部クロック周波数

詳細は、該当するSEU緩和ユーザーガイドを参照してください。

検出が機能している場合、デバイスは可能な場合はこのエラーを訂正し、標準のSEUレポートメカニズムによってユーザーに報告します。

挿入は、あらかじめ定義されている、未使用のCRAMが提供されている位置のリストのみを対象にすることができます (CRAM_SEL 0から7で識別されます)。

次に例を示します。

詳細は、該当するSEU緩和ユーザーガイドを参照してください。

このコマンドでは、CNT/SDMの選択されているRAMにECCエラーを挿入し、リードバックを実行してECCエラーをトリガーします。ユーザーはシングルビットのECCのみを挿入することができます。

このコマンドは、2つの32ビット・ワードを引数として取ります。

ワード0

• ビット [1:0]: SHAバリアント。SHA512アルゴリズムの場合は00を入力します。
• ビット [31:2]: 開始アドレス。このフラッシュ内のアドレスから検証を開始します。アドレスは4バイトでアライメントする必要があります。

ワード1

• ビット [31:0]: NumBytes。これは、SHA読み出しで使用されるバイト数を表します。64の倍数にする必要があります。

返される応答長は16ワードです。

電源管理ファームウェア (PMF) および電圧レギュレーター (VR) のデータのインターフェイスを提供します。このコマンドは、VID対応デバイスで、VRポーリングとPMFの両方が有効になっている場合に使用します。

このコマンドは、 Quartus® Primeプロ・エディションのバージョン23.3以降で利用することができます。