Intel Agilex® 7 ハード・プロセッサー・システム (HPS) のリモート・システム・アップデート・ユーザーガイド

ダウンロード PDF
ID 683184
日付 6/09/2023
Public
ドキュメント目次
ドキュメント目次 x
1. 概要 2. 使用例 3. クワッドSPIフラッシュレイアウト 4. インテル® Quartus® Prime ソフトウェアとツールのサポート 5. ソフトウェア・サポート 6. フラッシュの破損 - 検出と回復 7. リモート・システム・アップデートの例 8. 9. Intel Agilex® 7ハード・プロセッサー・システム・リモート・システム・アップデート・ユーザーガイド 10. Intel Agilex® 7 プロセッサ システム・リモート・システム・アップデートのユーザーガイドのドキュメント改訂履歴 A. 構成フロー図 B. RSU のステータスコードとエラーコード C. U-Boot RSU リファレンス情報 D. LIBRSU参考情報 E. 結合されたアプリケーション・イメージ
1. 概要 x
1.1. 高度な機能 1.2. 操作コマンド 1.3. 用語集
2. 使用例 x
2.1. アプリケーション 2.2. アプリケーション・イメージ・ブート 2.3. ファクトリー・イメージ・ブート 2.4. アプリケーション・イメージのリストの変更 2.5. RSU ステータスのクエリ 2.6. 特定の画像をロードする 2.7. フラッシュへの保護されたアクセス 2.8. リモート・システム・アップデート ウォッチドッグ 2.9. RSU Notify 2.10. ファクトリーイメージの更新 2.11. 判定ファームウェアのアップデート 2.12. 構成失敗時の再試行 2.13. 決定ファームウェアのバージョンの問い合わせ
3. クワッドSPIフラッシュレイアウト x
3.1. 高レベルのフラッシュレイアウト 3.2. 詳細なクワッド SPI フラッシュレイアウト 3.3. 判定ファームウェア・データ最大リトライ情報 3.4. ファームウェアのバージョン情報
3.1. 高レベルのフラッシュレイアウト x
3.1.1. Flash の標準 (非 RSU) 画像レイアウト 3.1.2. フラッシュ内の RSU イメージレイアウト – SDM の観点 3.1.3. RSU 画像レイアウト –視点
3.2. 詳細なクワッド SPI フラッシュレイアウト x
3.2.1. RSU イメージのサブパーティションのレイアウト 3.2.2. サブパーティション・テーブルのレイアウト 3.2.3. コンフィギュレーション・ポインター・ブロックのレイアウト 3.2.4. 出力イメージのレイアウト
3.2.4. 出力イメージのレイアウト x
3.2.4.1. 絶対的なアプリケーション・イメージのレイアウト
4. インテル® Quartus® Prime ソフトウェアとツールのサポート x
4.1. インテル® Quartus® Primeプロ・エディション ソフトウェア 4.2. プログラミングファイルジェネレーター 4.3. インテル® Quartus® Primeプログラマー 4.4. サポートされている QSPI フラッシュ・デバイス
4.1. インテル® Quartus® Primeプロ・エディション ソフトウェア x
4.1.1. 工場出荷時のロードピンの選択 4.1.2. HPS ウォッチドッグを有効にして RSU をトリガーする 4.1.3. Max Retryパラメーター の設定
4.2. プログラミングファイルジェネレーター x
4.2.1. Programming File Generatorのファイルタイプ 4.2.2. ビットスワップ オプション 4.2.3. 画像の作成
4.2.3. 画像の作成 x
4.2.3.1. 初期フラッシュイメージの作成 4.2.3.2. アプリケーション・フレームワークの作成 4.2.3.3. ファクトリーアップデートイメージの作成 4.2.3.4. 決定ファームウェア更新イメージの作成 4.2.3.5. 結合されたアプリケーション・イメージの作成
4.2.3.1. 初期フラッシュイメージの作成 x
4.2.3.1.1. 最初に FPGA の初期フラッシュイメージを作成する 4.2.3.1.2. 最初に HPS の初期フラッシュイメージを作成する
5. ソフトウェア・サポート x
5.1. SDM RSUサポート 5.2. Arm の信頼できるファームウェア・サポート 5.3. U-Boot RSU のサポート 5.4. Linux* RSUのサポート
5.3. U-Boot RSU のサポート x
5.3.1. U-Boot RSU API 5.3.2. U-Boot RSU コマンド
5.4. Linux* RSUのサポート x
5.4.1. 操作コマンド 5.4.2. 操作コマンド 5.4.3. リブレス図書館 5.4.4. RSUクライアント
6. フラッシュの破損 - 検出と回復 x
6.1. 決定ファームウェア 6.2. 決定ファームウェア・データ 6.3. コンフィグレーション・ポインター ブロック 6.4. サブパーティション・テーブル 6.5. アプリケーション・イメージ 6.6. ファクトリー・イメージ 6.7. メンテナンス手順の例
6.7. メンテナンス手順の例 x
6.7.1. メンテナンスの手順
6.7.1. メンテナンスの手順 x
6.7.1.1. 決定ファームウェアのリカバリー手順
7. リモート・システム・アップデートの例 x
7.1. RSU サンプル バイナリの構築 7.2. バイナリをフラッシュする 7.3. U-Boot RSU コマンドの実行
7.1. RSU サンプル バイナリの構築 x
7.1.1. 環境のセットアップ 7.1.2. ハードウェアプロジェクトの構築 7.1.3. 建物 Arm* 信頼できるファームウェア 7.1.4. 操作コマンド 7.1.5. U-Boot の構築 7.1.6. U-Boot スクリプトの構築 7.1.7. 初期フラッシュイメージの作成 7.1.8. アプリケーション・イメージの作成 7.1.9. 工場出荷時のアップデートイメージの作成 7.1.10. デシジョンファームウェアアップデートイメージの作成 7.1.11. 操作コマンド 7.1.12. LIBRSU および RSU クライアントの構築 7.1.13. ルート・ファイル・システムの構築 7.1.14. SDルートキーを作成する
7.2. バイナリをフラッシュする x
7.2.1. 初期 RSU イメージを QSPI にフラッシュする 7.2.2. SDルートキーを作成する
7.3. U-Boot RSU コマンドの実行 x
7.3.1. U-Boot を使用して基本操作を実行する 7.3.2. ウォッチドッグと最大再試行操作 7.3.3. U-Boot を使用した工場出荷時のイメージの更新 7.3.4. アプリケーションイメージのフラッシュ破損に対するフォールバック 7.3.5. 追加のフラッシュ破損の検出と回復
7.3.5. 追加のフラッシュ破損の検出と回復 x
7.3.5.1. 破損した判定ファームウェア 7.3.5.2. 破損した判定ファームウェアデータ 7.3.5.3. 破損した構成ポインタ ブロック 7.3.5.4. 破損したサブパーティションテーブル
8. x
8.1. 操作コマンド 8.2. コンポーネントインターフェイス 8.3. コンポーネントのバージョンの互換性 8.4. 複数の使用 インテル® Quartus® Prime ビットストリームのソフトウェア バージョン 8.5. ビットストリームごとに異なる SSBL をサポートするための U-Boot の更新
8.5. ビットストリームごとに異なる SSBL をサポートするための U-Boot の更新 x
8.5.1. SD/MMC での複数の SSBL の使用 8.5.2. QSPI での複数の SSBL の使用 8.5.3. U-Boot Source Code Details
A. 構成フロー図 x
A.1. 電源投入時またはnConfigフローでイメージをロードする A.2. 画像処理をロードしてみる A.3. リクエスト固有の画像フロー A.4. イメージ障害後の構成プロセス A.5. ウォッチドッグタイムアウトフロー
C. U-Boot RSU リファレンス情報 x
C.1. 設定パラメータ C.2. エラーコード C.3. 有効な SPT または CPB なしで U-Boot RSU を使用する C.4. アプリケーション C.5. データ型 C.6. アプリケーション C.7. RSU U-Boot コマンド
C.1. 設定パラメータ x
C.1.1. rsu_protected_slot C.1.2. rsu_log_level C.1.3. rsu_spt_checksum
C.5. データ型 x
C.5.1. rsu_slot_info C.5.2. rsu_status_info
C.6. アプリケーション x
C.6.1. rsu_init C.6.2. rsu_exit C.6.3. rsu_slot_count C.6.4. rsu_slot_by_name C.6.5. rsu_slot_get_info C.6.6. rsu_slot_size C.6.7. rsu_slot_priority C.6.8. rsu_slot_erase C.6.9. rsu_slot_program_buf C.6.10. rsu_slot_program_factory_update_buf C.6.11. rsu_slot_program_buf_raw C.6.12. rsu_slot_verify_buf C.6.13. rsu_slot_verify_buf_raw C.6.14. rsu_slot_enable C.6.15. rsu_slot_disable C.6.16. rsu_slot_load C.6.17. rsu_slot_load_factory C.6.18. rsu_slot_rename C.6.19. rsu_slot_delete C.6.20. rsu_slot_create C.6.21. rsu_status_log C.6.22. RSU_NOTIFY C.6.23. rsu_clear_error_status C.6.24. rsu_reset_retry_counter C.6.25. rsu_dcmf_version C.6.26. rsu_max_retry C.6.27. rsu_dcmf_status C.6.28. rsu_create_empty_cpb C.6.29. rsu_restore_cpb C.6.30. rsu_save_cpb C.6.31. rsu_restore_spt C.6.32. rsu_save_spt C.6.33. rsu_running_factory
C.7. RSU U-Boot コマンド x
C.7.1. dtb C.7.2. list C.7.3. slot_by_name C.7.4. slot_count C.7.5. slot_disable C.7.6. slot_enable C.7.7. slot_erase C.7.8. slot_get_info C.7.9. slot_load C.7.10. slot_load_factory C.7.11. slot_priority C.7.12. slot_program_buf C.7.13. slot_program_buf_raw C.7.14. slot_program_factory_update_buf C.7.15. slot_rename C.7.16. slot_delete C.7.17. slot_create C.7.18. slot_size C.7.19. slot_verify_buf C.7.20. slot_verify_buf_raw C.7.21. status_log C.7.22. アップデート C.7.23. notify C.7.24. clear_error_status C.7.25. reset_retry_counter C.7.26. display_dcmf_version C.7.27. display_dcmf_status C.7.28. display_max_retry C.7.29. restore_spt C.7.30. save_spt C.7.31. create_empty_cpb C.7.32. restore_cpb C.7.33. save_cpb C.7.34. check_running_factory
D. LIBRSU参考情報 x
D.1. 設定ファイル D.2. エラーコード D.3. 有効な SPT または CPB なしで LIBRSU を使用する D.4. アプリケーション D.5. データ型 D.6. アプリケーション D.7. RSUクライアントコマンド
D.5. データ型 x
D.5.1. rsu_slot_info D.5.2. rsu_status_info D.5.3. rsu_data_callback
D.6. アプリケーション x
D.6.1. librsu_init D.6.2. librsu_exit D.6.3. rsu_slot_count D.6.4. rsu_slot_by_name D.6.5. rsu_slot_get_info D.6.6. rsu_slot_size D.6.7. rsu_slot_priority D.6.8. rsu_slot_erase D.6.9. rsu_slot_program_buf D.6.10. rsu_slot_program_factory_update_buf D.6.11. rsu_slot_program_file D.6.12. rsu_slot_program_factory_update_file D.6.13. rsu_slot_program_buf_raw D.6.14. rsu_slot_program_file_raw D.6.15. rsu_slot_verify_buf D.6.16. rsu_slot_verify_file D.6.17. rsu_slot_verify_buf_raw D.6.18. rsu_slot_verify_file_raw D.6.19. rsu_slot_program_callback D.6.20. rsu_slot_program_callback_raw D.6.21. rsu_slot_verify_callback D.6.22. rsu_slot_verify_callback_raw D.6.23. rsu_slot_copy_to_file D.6.24. rsu_slot_enable D.6.25. rsu_slot_disable D.6.26. rsu_slot_load_after_reboot D.6.27. rsu_slot_load_factory_after_reboot D.6.28. rsu_slot_rename D.6.29. rsu_slot_delete D.6.30. rsu_slot_create D.6.31. rsu_status_log D.6.32. RSU_NOTIFY D.6.33. rsu_clear_error_status D.6.34. rsu_reset_retry_counter D.6.35. rsu_dcmf_version D.6.36. rsu_max_retry D.6.37. rsu_dcmf_status D.6.38. rsu_save_spt D.6.39. rsu_restore_spt D.6.40. rsu_save_cpb D.6.41. rsu_create_empty_cpb D.6.42. rsu_restore_cpb D.6.43. rsu_running_factory
D.7. RSUクライアントコマンド x
D.7.1. count D.7.2. list D.7.3. <size> D.7.4. 優先順位 D.7.5. enable D.7.6. disable D.7.7. 要求 D.7.8. request-factory D.7.9. 消去可能 D.7.10. 追加 D.7.11. add-factory-update D.7.12. add-raw D.7.13. verify D.7.14. verify-raw D.7.15. コピー D.7.16. 対数 D.7.17. notify D.7.18. Clear error status D.7.19. reset-retry-counter D.7.20. display-dcmf-version D.7.21. display-dcmf-status D.7.22. display-max-retry D.7.23. create-slot D.7.24. delete-slot D.7.25. restore-spt D.7.26. save-spt D.7.27. create-empty-cpb D.7.28. restore-cpb D.7.29. save-cpb D.7.30. check-running-factory D.7.31. help
1. 概要
2. 使用例
3. クワッドSPIフラッシュレイアウト
4. インテル® Quartus® Prime ソフトウェアとツールのサポート
5. ソフトウェア・サポート
6. フラッシュの破損 - 検出と回復
7. リモート・システム・アップデートの例
8.
9. Intel Agilex® 7ハード・プロセッサー・システム・リモート・システム・アップデート・ユーザーガイド
10. Intel Agilex® 7 プロセッサ システム・リモート・システム・アップデートのユーザーガイドのドキュメント改訂履歴
A. 構成フロー図
B. RSU のステータスコードとエラーコード
C. U-Boot RSU リファレンス情報
D. LIBRSU参考情報
E. 結合されたアプリケーション・イメージ

7.3.2. ウォッチドッグと最大再試行操作

このセクションでは、U-Boot を使用して次のことを説明します。
  • RSU によるウォッチドッグ タイムアウトの処理。
  • 最大再試行回数 この機能により、各画像のロードを最大 3 回試行できます。
  • RSU 通知により、ウォッチドッグ タイムアウトの前に HPS ソフトウェアの状態を報告し、その後に HPS ソフトウェアの状態を取得できるようになります。
  • RSU ステータス エラー フィールドをクリアします。
  • 現在の再試行カウンタ値をリセットします。
注: このセクションにリストされているコマンドは、 基本操作 セクションが最初に実行され、具体的にはアプリケーション イメージを P2 フラッシュ パーティションに追加します。
  1. ボードの電源を入れ直し、U-Boot を停止して、RSU ステータス ログを確認します。 
    SOCFPGA # rsu status_log
Current Image   : 0x02000000
Last Fail Image : 0x00000000
State           : 0x00000000
Version         : 0x00000202
Error location  : 0x00000000
Error details   : 0x00000000
Retry counter   : 0x00000000

    スロット 1 (パーティション P2) のアプリケーション イメージは、CPB で最高の優先順位としてマークされているため、ロードされました。

    フィールドの意味は次のとおりです。
    • リトライ カウンターは 0x00000000 —最初にこの画像のロードを試みます。
    • 州 は 0x00000000 —報告すべきエラーはありません
  2. をクエリして表示します。 max_retry 価値： 
    SOCFPGA # rsu display_max_retry 
max_retry = 3
  3. Cause a watchdog timeout by setting the timeout value to lowest possible. This prevents U-Boot from being able to service it in time: 
    SOCFPGA # mw.l 0xffd00204 0
  4. ウォッチドッグはすぐにタイムアウトになり、SDM は同じアプリケーション イメージを再ロードします。 最大再試行回数 パラメータは 3 に設定されます。 U-Boot コンソールを見て、ステータス ログを確認します。 
    SOCFPGA # rsu status_log
Current Image   : 0x02000000
Last Fail Image : 0x02000000
State           : 0xf0060001
Version         : 0x0acf0202
Error location  : 0x00000000
Error details   : 0x00000000
Retry counter   : 0x00000001

    同じ P2 イメージが読み込まれますが、 リトライ カウンタ値は現在 1 です。これは、このイメージのロードが 2 回目の再試行であることを意味します。の バージョン フィールドは、最後の失敗がアプリケーション イメージによるものであることを示します (0xACF）。の 州 フィールドには、最後のエラーがウォッチドッグ タイムアウトであったことが示されています (0xF006)、HPS ソフトウェアからの最新の通知値は、U-Boot をロードしている SPL からのものでした (0x0001）。

  5. Clear the error status so we can see the next errors. Query the status to show the errors were cleared: 
    SOCFPGA # rsu clear_error_status
SOCFPGA # rsu status_log 
Current Image   : 0x02000000
Last Fail Image : 0x00000000
State           : 0x00000000
Version         : 0x00000202
Error location  : 0x00000000
Error details   : 0x00000000
Retry counter   : 0x00000001
  6. 別のウォッチドッグ タイムアウトを引き起こします。 U-Boot プロンプトで RSU ログをクエリし、 リトライ カウンタは 2 になりました。 
    SOCFPGA # rsu status_log
Current Image   : 0x02000000
Last Fail Image : 0x02000000
State           : 0xf0060001
Version         : 0x0acf0202
Error location  : 0x00000000
Error details   : 0x00000000
Retry counter   : 0x00000002
  7. 次のエラーを確認できるように、エラー ステータスをクリアします。
  8. Notice コマンドを使用して、SDM に HPS ソフトウェアの状態を 16 ビット値として知らせます。 
    SOCFPGA0 # rsu notify 0x1234
  9. もう一度ウォッチドッグ タイムアウトを発生させ、再起動後に RSU ステータス ログを表示します。 
    SOCFPGA # rsu status_log
Current Image   : 0x01000000
Last Fail Image : 0x02000000
State           : 0xf0061234
Version         : 0x0acf0202
Error location  : 0x00000000
Error details   : 0x00000000
Retry counter   : 0x00000000

    SDM は次のアプリケーション イメージを CPB (P1) にロードしましたが、イメージ P2 が失敗したことを報告します。この状態は、ウォッチドッグ タイムアウトが発生したことを示します (上位 16 ビット = 0xF006)、HPS ソフトウェアによって報告された通知値が 0x1234。バージョンの上位 16 ビットは次のように設定されます。 0x0ACF これは、以前のエラーがアプリケーション イメージ ファームウェアによって報告されたことを意味します。詳細については、以下を参照してください。 RSU のステータスコードとエラーコード 。

  10. エラーをクリアしてステータスを表示します。エラーは表示されません。 
    SOCFPGA # rsu clear_error_status
SOCFPGA # rsu status_log
Current Image   : 0x01000000
Last Fail Image : 0x00000000
State           : 0x00000000
Version         : 0x00000202
Error location  : 0x00000000
Error details   : 0x00000000
Retry counter   : 0x00000000
  11. ウォッチドッグ タイムアウトを発生させ、U-Boot で起動してステータスを表示します。 リトライ カウンタは 1 つです: 
    SOCFPGA # rsu status_log
Current Image   : 0x01000000
Last Fail Image : 0x01000000
State           : 0xf0060001
Version         : 0x0acf0202
Error location  : 0x00000000
Error details   : 0x00000000
Retry counter   : 0x00000001
  12. 電流をリセットする リトライ カウンタ値をゼロに設定し、ステータスを再度クエリして確認します。 
    SOCFPGA # rsu reset_retry_counter
SOCFPGA # rsu status_log         
Current Image   : 0x01000000
Last Fail Image : 0x01000000
State           : 0xf0060001
Version         : 0x0acf0202
Error location  : 0x00000000
Error details   : 0x00000000
Retry counter   : 0x00000000
レベル 2 の表題