7.5.1. RSUクライアントを使用した基本動作の実行

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

ダウンロード PDF

ID 683184

日付 11/10/2021

バージョン

Public

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

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

Ixiasoft

詳細を見る

7.5.1. RSUクライアントを使用した基本動作の実行

この項では、RSUクライアントを使用して、次の基本動作を実行する方法を示します。

RSUステータスの照会
スロットの数とそれに関する情報の照会
新しいアプリケーション・イメージの追加
アプリケーション・イメージが正しく書き込まれたかの確認
特定のアプリケーション・イメージのロードの要求

注: この項では、フラッシュに初期RSUイメージが含まれていることを前提としています。それが当てはまらない場合は、初期RSUイメージのQSPIへのフラッシュに示すように、初期イメージを再フラッシュする必要があります。

ボードの電源を入れ直し、Linux*を起動します。
ユーザー名に「root」を使用してログインします。パスワードは不要です。

パラメーターを指定せずに rsu_client を実行して、ヘルプメッセージを表示します。

root@linux:~# ./rsu_client 
--- RSU app usage ---
-c|--count                        get the number of slots
-l|--list slot_num                list the attribute info from the selected slot
-z|--size slot_num                get the slot size in bytes
-p|--priority slot_num            get the priority of the selected slot
-E|--enable slot_num              set the selected slot as the highest priority
-D|--disable slot_num             disable selected slot but to not erase it
-r|--request slot_num             request the selected slot to be loaded after the next reboot
-R|--request-factory              request the factory image to be loaded after the next reboot
-e|--erase slot_num               erase app image from the selected slot
-a|--add file_name -s|--slot slot_num  add a new app image to the selected slot
-u|--add-factory-update file_name -s|--slot slot_num  add a new factory update image to the selected slot
-A|--add-raw file_name -s|--slot slot_num  add a new raw image to the selected slot
-v|--verify file_name -s|--slot slot_num  verify app image on the selected slot
-V|--verify-raw file_name -s|--slot slot_num  verify raw image on the selected slot
-f|--copy file_name -s|--slot slot_num  read the data in a selected slot then write to a file
-g|--log                          print the status log
-n|--notify value                 report software state
-C|--clear-error-status           clear errors from the log
-Z|--reset-retry-counter          reset current retry counter
-m|--display-dcmf-version         print DCMF version
-y|--display-dcmf-status          print DCMF status
-x|--display-max-retry            print max_retry parameter
-t|--create-slot slot_name -S|--address slot_address -L|--length slot_size  create a new slot using unallocated space
-d|--delete-slot slot_num         delete selected slot, freeing up allocated space
-W|--restore-spt file_name        restore spt from a file
-X|--save-spt file_name           save spt to a file
-b|--create-empty-cpb             create a empty cpb
-B|--restore-cpb file_name        restore cpb from a file
-P|--save-cpb file_name           save cpb to a file
-k|--check-running-factory        check if currently running the factory image
-h|--help                         show usage message

現在のステータスを表示する rsu_client コマンドを実行すると、スロット0 (パーティションP1) からのアプリケーション・イメージがエラーなしでロードされていることが示されます。

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

スロットに関する情報を表示するRSUクライアント・コマンドを実行します。

root@linux:~# ./rsu_client --count
number of slots is 3
Operation completed
root@linux:~# ./rsu_client --list 0
      NAME: P1
    OFFSET: 0x0000000001000000
      SIZE: 0x01000000
  PRIORITY: 1
Operation completed
root@linux:~# ./rsu_client --list 1
      NAME: P2
    OFFSET: 0x0000000002000000
      SIZE: 0x01000000
  PRIORITY: [disabled]
Operation completed
root@linux:~# ./rsu_client --list 2
      NAME: P3
    OFFSET: 0x0000000003000000
      SIZE: 0x01000000
  PRIORITY: [disabled]
Operation completed

決定ファームウェアのバージョン情報を表示します。

root@linux:~# ./rsu_client --display-dcmf-version
DCMF0 version = 21.2.0
DCMF1 version = 21.2.0
DCMF2 version = 21.2.0
DCMF3 version = 21.2.0
Operation completed

スロット1を消去し、application2.rpd アプリケーション・イメージをスロット1 (パーティションP2) に追加します。
```
root@linux:~# ./rsu_client --erase 1
Operation completed
root@linux:~# ./rsu_client --add application2.rpd --slot 1
Operation completed
```
アプリケーション・イメージがフラッシュに正しく書き込まれたことを確認します。
```
root@linux:~# ./rsu_client --verify application2.rpd --slot 1
Operation completed
```

スロットを再度リストします。これは、最も高い優先度 (つまり、最も低い優先度番号) を持つ最後に書き込まれたパーティションP2イメージを示しています。

root@linux:~# ./rsu_client --list 0
      NAME: P1
    OFFSET: 0x0000000001000000
      SIZE: 0x01000000
  PRIORITY: 2
Operation completed
root@linux:~# ./rsu_client --list 1
      NAME: P2
    OFFSET: 0x0000000002000000
      SIZE: 0x01000000
  PRIORITY: 1
Operation completed
root@linux:~# ./rsu_client --list 2
      NAME: P3
    OFFSET: 0x0000000003000000
      SIZE: 0x01000000
  PRIORITY: [disabled]
Operation completed

ボードの電源を入れ直し、Linux*を起動して、ステータスを表示します。実行中のパーティションP2からのイメージが表示されます。

root@linux:~# ./rsu_client --log
      VERSION: 0x00000202
        STATE: 0x00000000
CURRENT IMAGE: 0x0000000002000000
   FAIL IMAGE: 0x0000000000000000
    ERROR LOC: 0x00000000
ERROR DETAILS: 0x00000000
RETRY COUNTER: 0x00000000
Operation completed

次の reboot コマンドでSDMからスロット0 (パーティションP1) を要求するようにRSUクライアントに指示します。
```
root@linux:~# ./rsu_client --request 0
Operation completed
```
reboot コマンドを実行して、Linux*を再起動します。
```
root@linux:~# reboot
```

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

ステータスは、要求に応じて、パーティションP1からのイメージがロードされたことを示します。

言語の選択

Intel.com サーチを使用

クイックリンク

最近の検索

高度検索

検索のみ

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

7.5.1. RSUクライアントを使用した基本動作の実行