ESRT テーブルの定義

[アーティクル]
03/22/2024

ESRT テーブルへのポインタは、EFI_CONFIGURATION_TABLE の該当する GUID から識別できます。

#define EFI_SYSTEM_RESOURCE_TABLE_GUID   \
{ 0xb122a263, 0x3661, 0x4f68,  0x99, 0x29, 0x78, 0xf8, 0xb0, 0xd6, 0x21, 0x80  }

次のテーブルは、ESRT テーブルの形式およびテーブルに含まれるファームウェアリソースエントリを表しています。

フィールド	配列の値	バイト長さ	バイトオフセット	説明
ファームウェアリソースの数		4	0	ESRT 内のファームウェアリソースエントリの数。ゼロにはできません。
ファームウェアリソースの最大値		4	4	テーブルを再割り当てせずに追加できるリソース配列エントリの最大数。ファームウェアリソースの数を上回る必要があります。
ファームウェアリソースのバージョン		8	8	ファームウェアリソースエントリのバージョン。この値は 1 に設定します
ファームウェアリソースエントリ配列				ファームウェアリソースエントリ 0
	ファームウェアのクラス	16	16	更新カプセルを介して更新できるファームウェアコンポーネントを識別する GUID。この GUID は、更新中に更新カプセルヘッダーの CapsuleGuid パラメーターとして UEFI 更新カプセルランタイムサービスに渡されます。
	ファームウェアの種類	4	32	ファームウェアリソースの種類を識別する次のいずれかの値。 0: 不明 1: システムのファームウェア 2: デバイスのファームウェア 3: UEFI ドライバー
	Firmware Version	4	36	現在のファームウェアバージョン。新しいリリースほど数字が大きくなります。この値の形式は定義されていませんが、バージョンのメジャー番号やマイナー番号を組み込みます。推奨としては、最初の単語がメジャーバージョン番号、2 番目の単語がマイナーバージョン番号の形式にします。
	サポートされている最小バージョンのファームウェア	4	40	特定のシステム / デバイスに対してファームウェアリソースをロールバックできる最小のファームウェアリソースのバージョン。このファームウェアバージョンでセキュリティ関連の修正プログラムを使用できる場合、互換性の低いバージョンは現在のファームウェアバージョンと同じです。
	カプセルフラグ	4	44	更新カプセルヘッダーのフラグフィールドのビット 0 ~ 15 で UEFI 更新カプセルランタイムサービスに渡されるフラグ (OS は、UEFI 仕様のセクション 7.5.3 で定義されているフラグのビット 16 ~ 31 を構成します)。
	前回の試行バージョン	4	48	更新が試行された最新のファームウェアバージョン。この値はファームウェアバージョンと同じ形式を使用します。
	最新の試行の状態	4	52	最新のファームウェア更新の試行の状態を示す次のいずれかの値。 0: 成功 1: 失敗 2: リソース不足 3: 正しくないバージョン 4: 無効なイメージ形式 5: 認証エラー 6: 電源イベント - AC が接続されていません 7: 電源イベント - バッテリー不足
...				ファームウェアリソースエントリ 1

コア UEFI ファームウェアは、それ自体に 1 つのシステムリソースエントリ (システムファームウェア) を含む ESRT 構成テーブルを割り当てて設定します。説明の目的で、このガイドのコアファームウェアでは、ファームウェア更新パッケージメカニズムを使用してデバイスファームウェアの更新をサポートするデバイスを表す 1 つの追加エントリも作成します。

システムファームウェアを記述するエントリは常に 1 つのみ必要です。このエントリは、システムファームウェアの更新を対象とするために使用します。実装でシステムとデバイスのファームウェアの更新を単一のモノリシック操作として実行する場合は、システムファームウェアエントリを使用して更新プログラムをターゲットにする必要があります。それ以外の場合、デバイスファームウェアの更新プログラムは、デバイスファームウェアを記述する ESRT エントリの対象となります。

最初の手順では、これら 2 つのファームウェアリソース ({SYSTEM_FIRMWARE} と {DEVICE_FIRMWARE}) を表す GUID を生成します。表 2 はテーブル定義の例を示しています。この例では、両方のファームウェアバージョンが現在のバージョン 1 (ファームウェアバージョン == 1) であることを前提としています。

フィールド	配列の値	Value	コメント
ファームウェアリソースの数		2	この表には、2 つのファームウェアリソースエントリが含まれています。
ファームウェアリソースの最大値		2	このテーブルの割り当てには、最大 2 つのリソースを記述するために十分な領域が含まれています。
ファームウェアリソースのバージョン		1	この表で使用するファームウェアリソースエントリ形式のバージョンは 1 です。
ファームウェアリソースエントリ配列		ファームウェアリソースエントリ 0
	ファームウェアのクラス	(SYSTEM_FIRMWARE)	この GUID は、PnP を介して更新するシステムファームウェアを識別します。
	ファームウェアの種類	1	システムファームウェアの種類は 1 です。
	Firmware Version	1	現在のファームウェアバージョンは 1 です。
	サポートされている最小バージョンのファームウェア	1	サポートされているファームウェアの最小バージョンは 1 であるため、ファームウェアをバージョン 1 より以前のバージョンにロールバックすることはできません。
	カプセルフラグ	0	システムファームウェアは、プライベートカプセル更新フラグを定義しません。
	前回の試行バージョン	1	更新が試行された最新のシステムファームウェアバージョンはバージョン 1 です。
	最新の試行の状態	0	最新のシステムファームウェアの更新が成功しました。
		ファームウェアリソースエントリ 1
	ファームウェアのクラス	(DEVICE_FIRMWARE)	この GUID は、PnP を介して更新するデバイスファームウェアを識別します。
	ファームウェアの種類	2	デバイスのファームウェアの種類は 2 です。
	Firmware Version	1	現在のデバイスファームウェアバージョンは 1 です。
	サポートされている最小バージョンのファームウェア	1	サポートされているファームウェアの最小バージョンは 1 であるため、ファームウェアをバージョン 1 より以前のバージョンにロールバックすることはできません。
	カプセルフラグ	0x8010	デバイスファームウェアは、プライベートカプセル更新フラグ (0x8010) を定義します。
	前回の試行バージョン	1	更新が試行された最新のデバイスファームウェアバージョンはバージョン 1 です
	最新の試行の状態	0	最新のデバイスファームウェアの更新に成功しました。