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

ダウンロード PDF
ID 683184
日付 11/10/2021
Public

このドキュメントの新しいバージョンが利用できます。お客様は次のことを行ってください。 こちらをクリック 最新バージョンに移行する。

インテルのみ表示可能 — GUID: ack1606327036542

Ixiasoft

詳細を見る

ドキュメント目次
ドキュメント目次 x
1. 概要 2. ユースケース 3. クアッドSPIフラッシュのレイアウト 4. インテル® Quartus® Prime開発ソフトウェアとツールのサポート 5. ソフトウェアのサポート 6. フラッシュの破損 - 検出と回復 7. リモート・システム・アップデートの例 8. バージョンの互換性に関する考慮事項 9. HPS先行でのRSUの使用 A. コンフィグレーション・フローの図 B. RSUステータスコードとエラーコード C. U-Boot RSUリファレンス情報 D. LIBRSUリファレンス情報 E. 組み合わせたアプリケーション・イメージ 15. SoCのリモート・システム・アップデート・ユーザーガイドの改訂履歴
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. 決定ファームウェア・データのMax Retry情報 3.4. ファームウェアのバージョン情報
3.1. フラッシュレイアウトの概略 x
3.1.1. フラッシュの標準 (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. アプリケーション・イメージのレイアウト
4. インテル® Quartus® Prime開発ソフトウェアとツールのサポート x
4.1. インテルQuartus Prime開発ソフトウェア・プロ・エディション 4.2. Programming File Generator 4.3. インテル® Quartus® Prime Programmer 4.4. サポートされているQSPIフラッシュデバイス
4.1. インテルQuartus Prime開発ソフトウェア・プロ・エディション x
4.1.1. ファクトリー・ロード・ピンの選択 4.1.2. RSUをトリガーするためのHPSウォッチドッグのイネーブル 4.1.3. Max Retry パラメーターの設定
4.2. Programming File Generator x
4.2.1. Programming File Generatorのファイルの種類 4.2.2. Bitswap オプション
5. ソフトウェアのサポート x
5.1. SDM RSUのサポート 5.2. Arm Trusted Firmwareのサポート 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. インテル® Service Driver 5.4.2. インテル® RSUドライバー 5.4.3. LIBRSUライブラリー 5.4.4. RSU Client
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. 前提条件 7.2. RSUバイナリー構築の例 7.3. バイナリーのフラッシュ 7.4. U-Boot RSUコマンドの実行 7.5. RSUクライアントの実行
7.2. RSUバイナリー構築の例 x
7.2.1. 環境の設定 7.2.2. ハードウェア・プロジェクトの構築 7.2.3. ARM* Trusted Firmwareの構築 7.2.4. U-Bootの構築 7.2.5. 初期フラッシュイメージの作成 7.2.6. アプリケーション・イメージの作成 7.2.7. ファクトリー・アップデート・イメージの作成 7.2.8. 決定ファームウェア・アップデート・イメージの作成 7.2.9. Linux*の構築 7.2.10. ZLIBの構築 7.2.11. LIBRSUおよびRSUクライアントの構築 7.2.12. ルート・ファイル・システムの構築 7.2.13. SDカードの構築
7.3. バイナリーのフラッシュ x
7.3.1. 初期RSUイメージのQSPIへのフラッシュ 7.3.2. SDカードイメージの書き込み
7.4. U-Boot RSUコマンドの実行 x
7.4.1. U-Bootを使用した基本動作の実行 7.4.2. ウォッチドッグおよびMax Retry動作 7.4.3. U-Bootを使用したファクトリー・イメージの更新 7.4.4. アプリケーション・イメージのフラッシュ破損のフォールバック 7.4.5. 追加フラッシュの破損における検出と回復
7.4.5. 追加フラッシュの破損における検出と回復 x
7.4.5.1. 破損した決定ファームウェア 7.4.5.2. 破損した決定ファームウェアのデータ 7.4.5.3. 破損したコンフィグレーション・ポインター・ブロック 7.4.5.4. 破損したサブ・パーティション表
7.5. RSUクライアントの実行 x
7.5.1. RSUクライアントを使用した基本動作の実行 7.5.2. ウォッチドッグ・タイムアウトと max retry 動作 7.5.3. RSUクライアントを使用したファクトリー・イメージの更新 7.5.4. アプリケーション・イメージのフラッシュ破損のフォールバック 7.5.5. 追加フラッシュの破損における検出と回復
7.5.5. 追加フラッシュの破損における検出と回復 x
7.5.5.1. 破損した決定ファームウェア 7.5.5.2. 破損した決定ファームウェアのデータ 7.5.5.3. 破損したコンフィグレーション・ポインター・ブロック 7.5.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ソースコードの詳細
9. HPS先行でのRSUの使用 x
9.1. HPS先行を使用するためのハードウェア・デザインの更新 9.2. HPS先行用の初期フラッシュイメージの作成 9.3. HPS先行用のアプリケーション・イメージとアップデート・イメージの作成
A. コンフィグレーション・フローの図 x
10.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. U-Boot RSUコマンド
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. U-Boot RSUコマンド 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. update 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. priority D.7.5. enable D.7.6. disable D.7.7. request D.7.8. request-factory D.7.9. erase D.7.10. add D.7.11. add-factory-update D.7.12. add-raw D.7.13. verify D.7.14. verify-raw D.7.15. copy D.7.16. log 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
E. 組み合わせたアプリケーション・イメージ x
E.1. 組み合わせたアプリケーション・イメージの作成 E.2. 組み合わせたアプリケーション・イメージの使用
1. 概要
2. ユースケース
3. クアッドSPIフラッシュのレイアウト
4. インテル® Quartus® Prime開発ソフトウェアとツールのサポート
5. ソフトウェアのサポート
6. フラッシュの破損 - 検出と回復
7. リモート・システム・アップデートの例
8. バージョンの互換性に関する考慮事項
9. HPS先行でのRSUの使用
A. コンフィグレーション・フローの図
B. RSUステータスコードとエラーコード
C. U-Boot RSUリファレンス情報
D. LIBRSUリファレンス情報
E. 組み合わせたアプリケーション・イメージ
15. SoCのリモート・システム・アップデート・ユーザーガイドの改訂履歴

7.5.5.3. 破損したコンフィグレーション・ポインター・ブロック

この項では、RSUクライアントを使用して、コンフィグレーション・ポインター・ブロックの破損を検出および回復する方法を示します。また、U-Bootを使用してCPBを破損します。これは、CPBでより便利に実行されるためです。
注: この例に一覧表示されているコマンドは、初期フラッシュイメージ (JIC) が他の変更なしでフラッシュに書き込まれたことを前提としています。
  1. ボードの電源を入れ直し、Linuxで起動して、RSUステータスを照会します。 
    root@linux:~# ./rsu_client --log
      VERSION: 0x00000202
        STATE: 0x00000000
CURRENT IMAGE: 0x0000000001000000
   FAIL IMAGE: 0x0000000000000000
    ERROR LOC: 0x00000000
ERROR DETAILS: 0x00000000
RETRY COUNTER: 0x00000000
Operation completed

    エラーはありません。

  2. ボードを再起動または電源を入れ直し、U-Bootプロンプトで停止して、対応するフラッシュ領域を消去することによりCPB0を破損します。 
    SOCFPGA # sf probe
SF: Detected mt25qu02g with page size 256 Bytes, erase size 4 KiB, total 256 MiB
SOCFPGA # sf erase 0x0920000 0x1000
SF: 4096 bytes @ 0x920000 Erased: OK
  3. ボードの電源を入れ直します。U-Bootが実行され、Linuxを起動する前に、いくつかのRSUコマンドが実行されます。これにより、rsu_init が呼び出され、CPB1コピーからCPB0を復元します。 
    FW detects corrupted CPB0 but CPB1 is fine
Restoring CPB0
  4. Linuxが起動したら、RSUのステータスを照会します。 
    root@linux:~# ./rsu_client --log
librsu: load_cpb(): FW detects corrupted CPB0, fine CPB1
 [LOW]
librsu: load_cpb(): warning: Restoring CPB0 [LOW]
      VERSION: 0x0DCF0202
        STATE: 0xF004D010
CURRENT IMAGE: 0x0000000001000000
   FAIL IMAGE: 0x0000000000100000
    ERROR LOC: 0x00000000
ERROR DETAILS: 0x00000000
RETRY COUNTER: 0x00000000
Operation completed

    State フィールドには、特別なエラーコード 0xF004D010 があります。これは、CPB0が破損していることを示します。Last Fail Image には、この場合に使用される特別な値 0x00100000 があります。Version フィールドは、エラーが決定ファームウェア (0xDCF) によって報告されたことを示します。U-BootはすでにCPB1からCPB0を回復しましたが、ファームウェアはまだCPB0が破損していると報告し、LibRSUはそれを再び回復します。

  5. エラーステータスをクリアして、ファームウェアがCPB0の破損の報告を停止し、RSUステータスを再度照会して、エラーがないことを確認します。 
    root@linux:~# ./rsu_client --clear-error-status
librsu: load_cpb(): FW detects corrupted CPB0, fine CPB1
 [LOW]
librsu: load_cpb(): warning: Restoring CPB0 [LOW]
Operation completed
root@linux:~# ./rsu_client --log
      VERSION: 0x00000202
        STATE: 0x00000000
CURRENT IMAGE: 0x0000000001000000
   FAIL IMAGE: 0x0000000000000000
    ERROR LOC: 0x00000000
ERROR DETAILS: 0x00000000
RETRY COUNTER: 0x00000000
Operation completed
  6. ボードの電源を入れ直し、Linuxを起動して、RSUステータスを照会します。エラーがないことを確認します。 
    root@linux:~# ./rsu_client --log
      VERSION: 0x00000202
        STATE: 0x00000000
CURRENT IMAGE: 0x0000000001000000
   FAIL IMAGE: 0x0000000000000000
    ERROR LOC: 0x00000000
ERROR DETAILS: 0x00000000
RETRY COUNTER: 0x00000000
Operation completed
  7. CPBの内容をファイルに保存して、後でリカバリー用に使用できるようにします。また、sync コマンドを呼び出して、ファイルがストレージに保存されていることを確認します。 
    root@linux:~# ./rsu_client --save-cpb cpb-backup.bin
Operation completed
root@linux:~# sync
  8. 再起動または電源を入れ直し、U-Bootで停止して、その位置のフラッシュを消去することにより両方のCPBを破損します。 
    SOCFPGA # sf probe
SF: Detected mt25qu02g with page size 256 Bytes, erase size 4 KiB, total 256 MiB
SOCFPGA # sf erase 0x0920000 0x1000
SF: 4096 bytes @ 0x920000 Erased: OK
SOCFPGA # sf erase 0x0928000 0x1000
SF: 4096 bytes @ 0x928000 Erased: OK
  9. ボードの電源を入れ直し、Linuxで起動して、RSUステータスを照会します。 
    root@linux:~# ./rsu_client --log
librsu: load_cpb(): FW detects both CPBs corrupted
 [LOW]
      VERSION: 0x0DCF0202
        STATE: 0xF004D011
CURRENT IMAGE: 0x0000000000110000
   FAIL IMAGE: 0x0000000000100000
    ERROR LOC: 0x00000000
ERROR DETAILS: 0x00000000
RETRY COUNTER: 0x00000000
Operation completed

    予想どおり、Current Image はファクトリー・イメージとして報告されます。State フィールドには、特別なエラーコード 0xF004D011 があります。これは、両方のCPBが破損していることを示します。Last Fail Image には、この場合に使用される特別な値 0x00100000 があります。Version フィールドは、エラーが決定ファームウェア (0xDCF) によって報告されたことを示します。LibRSUは、両方のCPBの破損を報告しました。

  10. 有効なCPBを必要とするコマンドの実行を試し、それが拒否されることを確認します。 
    root@linux:~# ./rsu_client --list 1
librsu: load_cpb(): FW detects both CPBs corrupted
 [LOW]
librsu: rsu_cpb_corrupted_info(): corrupted CPB -- [LOW]
librsu: rsu_cpb_corrupted_info(): run rsu_client create-empty-cpb or  [LOW]
librsu: rsu_cpb_corrupted_info(): rsu_client restore_cpb <file_name> first
 [LOW]
ERROR: Failed to get slot attributes
  11. エラーをクリアして、CPBがファームウェアによって破損していると報告されないようにします。 
    root@linux:~# ./rsu_client --clear-error-status
librsu: load_cpb(): FW detects both CPBs corrupted
 [LOW]
Operation completed
root@linux:~# ./rsu_client --log
librsu: load_cpb(): Bad CPB1 is bad [MED]
librsu: load_cpb(): Bad CPB0 is bad [MED]
librsu: load_cpb(): error: found both corrupted CPBs [LOW]
      VERSION: 0x00000202
        STATE: 0x00000000
CURRENT IMAGE: 0x0000000000110000
   FAIL IMAGE: 0x0000000000000000
    ERROR LOC: 0x00000000
ERROR DETAILS: 0x00000000
RETRY COUNTER: 0x00000000
Operation completed
  12. 作成したバックアップ・ファイルから保存したCPBを復元します。 
    root@linux:~# ./rsu_client --restore-cpb cpb-backup.bin
librsu: load_cpb(): Bad CPB1 is bad [MED]
librsu: load_cpb(): Bad CPB0 is bad [MED]
librsu: load_cpb(): error: found both corrupted CPBs [LOW]
Operation completed
  13. RSUステータスを再度照会し、エラーがないことを確認します。 
    root@linux:~# ./rsu_client --log
      VERSION: 0x00000202
        STATE: 0x00000000
CURRENT IMAGE: 0x0000000000110000
   FAIL IMAGE: 0x0000000000000000
    ERROR LOC: 0x00000000
ERROR DETAILS: 0x00000000
RETRY COUNTER: 0x00000000
Operation completed
  14. 有効なCPBを必要とするコマンドの実行を試し、それが拒否されることを確認します。 
    root@linux:~# ./rsu_client --list 1
      NAME: P2
    OFFSET: 0x0000000002000000
      SIZE: 0x01000000
  PRIORITY: [disabled]
Operation completed
レベル 2 の表題