更新プログラム ドライバー パッケージの作成

ESRT で説明されている各ファームウェア リソースの更新ペイロードをバンドルし、独自のドライバー パッケージで配布し、同じ周期で更新できない可能性がある他のファームウェア リソースの更新プログラムに関連付けることなく、独自のバージョン管理スキームを維持できるようにする必要があります。

次の例では、表 2 の ESRT の例から {SYSTEM_FIRMWARE} リソースを対象とするファームウェア リソース更新プログラムのドライバー パッケージ INF ファイル定義のサンプルを提供し、バージョン 1 からバージョン 2 に更新します。 参考のため、SYSTEM_FIRMWARE リソースに割り当てられた GUID が 6bd4efb9-23cc-4b4a-ac37-016517413e9a であると仮定します。

[Version]
Signature   = "$WINDOWS NT$"
Provider    = %Provider%
Class       = Firmware
ClassGuid   = {f2e7dd72-6468-4e36-b6f1-6488f42c1b52}
DriverVer   = 01/01/2012,2.0.0.0
CatalogFile = catalog.cat
PnpLockdown = 1

[Manufacturer]
%MfgName% = Firmware,NTarm64.10.0...17134
; Prior to Windows 10, version 1803, the above should instead be:
; %MfgName% = Firmware,NTarm64

[Firmware.NTarm64.10.0...17134]
; Prior to Windows 10, version 1803, the above should instead be:
; [Firmware.NTarm64]
%FirmwareDesc% = Firmware_Install,UEFI\RES_{6bd4efb9-23cc-4b4a-ac37-016517413e9a}

[Firmware_Install.NT]
CopyFiles = Firmware_CopyFiles

[Firmware_CopyFiles]
firmware.bin

[Firmware_Install.NT.Hw]
AddReg = Firmware_AddReg

[Firmware_AddReg]
HKR,,FirmwareId,,{6bd4efb9-23cc-4b4a-ac37-016517413e9a}
HKR,,FirmwareVersion,%REG_DWORD%,0x00000002
HKR,,FirmwareFilename,,%13%\firmware.bin
; Prior to Windows 10, version 1803, the above should instead be:
; HKR,,FirmwareFilename,,{6bd4efb9-23cc-4b4a-ac37-016517413e9a}\firmware.bin

[SourceDisksNames]
1 = %DiskName%

[SourceDisksFiles]
firmware.bin = 1

[DestinationDirs]
DefaultDestDir = 13
; Prior to Windows 10, version 1803, the above should be:
; DefaultDestDir = 10,Firmware\{6bd4efb9-23cc-4b4a-ac37-016517413e9a}

[Strings]
; localizable
Provider     = "Contoso Ltd."
MfgName      = "Fabrikam Inc."
FirmwareDesc = "Fabrikam System Firmware 2.0"
DiskName     = "Firmware Update"

; non-localizable
REG_DWORD     = 0x00010001

次のセクションを変更して、セットアップ用にカスタマイズします。

[Version]
DriverVer --> The date on which this driver package was authored and the driver version of this driver package. Driver version in this driver package must be greater than the current driver version
CatalogFile --> Name of the catalog file

firmware.bin --> Change all instances of firmware.bin with the name of the firmware image name

[Manufacturer]
%MfgName% = Firmware,NTarm64.10.0...17134
[Firmware.NTarm64.10.0...17134] --> Change the architecture.
For x86, it should be NTx86
For AMD64, it should be NTamd64

[Firmware.NTarm64.10.0...17134]
%FirmwareDesc% = Firmware_Install,UEFI\RES_{6bd4efb9-23cc-4b4a-ac37-016517413e9a} --> The GUID of the firmware resource

[Firmware_AddReg]
HKR,,FirmwareId,,{6bd4efb9-23cc-4b4a-ac37-016517413e9a} --> The GUID of the firmware resource
HKR,,FirmwareVersion,%REG_DWORD%,0x00000002 --> Version of the firmware for the update
HKR,,FirmwareFilename,,%13%\firmware.bin --> firmware.bin should be replaced with the firmware image name
; Prior to Windows 10, version 1803, the above should instead be:
HKR,,FirmwareFilename,,{6bd4efb9-23cc-4b4a-ac37-016517413e9a}\firmware.bin --> The subdirectory named after the GUID of the firmware resource and the firmware image name

[DestinationDirs]
DefaultDestDir = 13 --> The full destination path as a 'run from Driver Store' binary
; Prior to Windows 10, version 1803, the above should be:
; DefaultDestDir = 10,Firmware\{6bd4efb9-23cc-4b4a-ac37-016517413e9a} --> The full destination path for the firmware image file based under a subdirectory named after the GUID of the firmware resource within the %SystemRoot%\Firmware directory

[Strings]
; localizable
Modify any strings here [optional]

次の表では、上記のサンプル ドライバー パッケージ INF ファイル定義を参照するさまざまなドライバー パッケージ INF セクションとフィールドについて説明します。

他のファームウェア イメージ ファイル (独自のファイルと他のファームウェア ベンダーのファイルの両方) との潜在的な競合を回避するために、ファームウェア リソースの更新イメージ ファイルのバージョンごとに一意の名前を使用することが重要です。 たとえば、ベンダー名とバージョンの制約の両方を満たすために、上記の firmware.bin に次の名前を割り当てる必要があります: Fabrikam-System-Firmware-2.0.bin。

OEM/IHV カスタマイズの目的で使用される可能性のある特定のファームウェア リソース更新イメージのバリアントが、同じ Windows システム イメージに展開されるときに競合しないようにするために、個別のファームウェア リソース更新イメージはそれぞれ 、"ドライバー ストアから実行" ファイル (Windows 10 バージョン 1803 以降) であるか、%SystemRoot%\Firmware ディレクトリ内のサブディレクトリの下に保持されることをお勧めします。 このサブディレクトリには、ターゲット ファームウェア リソース GUID の後に名前を付ける必要があります。 たとえば、次のファームウェア リソース更新イメージ パスは、デプロイの制約を満たしている: %SystemRoot%\\Firmware\\{6bd4efb9-23cc-4b4a-ac37-016517413e9a}\\Fabrikam-System-Firmware-2.0.bin。

ファームウェア ドライバー パッケージの署名をテストする

ドライバー パッケージ INF ファイルとファームウェア ペイロード バイナリの準備ができたら、カタログ ファイルを生成するためにドライバー パッケージ全体に署名する必要があります。 Windows がファームウェア リソースの更新を安全に開始できるようにするには、ドライバー パッケージに含まれる INF ファイルとファームウェア ペイロード バイナリの有効性と信頼性を保証することが、このカタログ ファイルで重要です。

テスト目的でドライバー パッケージに自己署名する手順を次に示します。 これらの手順はテスト目的でのみ使用されることに注意してください。 運用環境では、署名のために、ファームウェア更新ドライバー パッケージをパートナー センターに提出する必要があります。 運用環境用のファームウェア ドライバー パッケージに署名する手順については、「 更新プログラム パッケージの認定と署名」を参照してください。

1. 最新の Windows SDK および Windows Driver Kit (WDK) をインストールします。

   • Windows SDK には、 makecert、 pvk2pfx、 signtoolなどのツールがインストールされます。
   • Windows Driver Kit (WDK) は、 Inf2Catなどのドライバー固有のツールをインストールします。

   通常、これらのツールは Windows Kits のインストール ディレクトリにあります。次に例を示します。

   %WindowsSdkDir%\bin\<version>\x86 (または x64)

   注

   正確な SDK バージョン フォルダーと使用可能なツールのセットは、インストールされている Windows SDK/WDK コンポーネントによって異なります。

2. 次のコマンドを実行して、テスト証明書を作成します。

   makecert.exe -r -pe -a sha256 -eku 1.3.6.1.5.5.7.3.3 -n CN=Foo -sv fwu.pvk fwu.cer
   pvk2pfx.exe -pvk fwu.pvk -spc fwu.cer -pi <Password entered during makecert prompt> -spc fwu.cer -pfx fwu.pfx
   

   詳細については、「 MakeCert」を参照してください。

3. 次のコマンドを実行して、カタログ ファイルを作成します。

   Inf2Cat.exe /driver:"." /os:8_x64
   

   /driver 引数は、INF が配置されている場所を指します。 ファームウェア ドライバー パッケージの対象となる OS に応じて 、/os 引数の値を変更します。 詳細については、「 Inf2Cat」を参照してください。

   セキュリティ カタログとドライバーの詳細については、「 カタログ ファイルとデジタル署名 」および 「PnP ドライバー パッケージのカタログ ファイルの作成」を参照してください。

4. 次のコマンドを実行してカタログ ファイルに署名します。

   signtool sign /fd sha256 /f fwu.pfx /p <Password entered during makecert prompt> delta.cat
   

   詳細については、「 SignTool」を参照してください。

5. テストシステムにテスト証明書をインストールします。

   1. fwu.cer ファイルをダブルクリックし、[ 証明書のインストール ] オプションを選択します。

   2. 証明書のインストール中に、次のオプションを選択します。

      • [ストアの場所] で、[ローカルコンピューター] を選択します。

      • 証明書ストアの場合は、 信頼されたルート証明機関を参照して選択します。

6. ファームウェア/BIOS オプションでセキュア ブートを無効にします。

7. カタログが実稼働署名されていない場合でも OS ローダーが起動時にファームウェア イメージ ファイル (firmware.bin) を読み込むことができるように、BCD オプションでテスト署名を有効にします。 管理者特権で次のコマンドを実行します。

   bcdedit /set testsigning on
   

ドライバー パッケージに署名した後は、次のいずれかのメカニズムを使用してインストールできます。

• デバイス マネージャー。 手動テストの場合、デバイス マネージャーには、ファームウェア リソース デバイスを検索し、そのドライバーを更新してファームウェア リソースの更新を開始するためのわかりやすいインターフェイスが用意されています。

  1. デバイスを種類別に表示しているときに "Firmware" クラスの下にある目的のファームウェア リソース デバイスを見つけるか、デバイスを接続別に表示しているときに "Microsoft UEFI-Compliant System" デバイスの下を見つけます。

  2. ファームウェア リソース デバイスを右クリックし、[ドライバー ソフトウェアの更新...] を選択します。オプション。

  3. [Browse my computer for driver software]\(ドライバー ソフトウェアのコンピューターを参照する\) オプションを使用して、新しいファームウェア リソース更新プログラム ドライバー パッケージを見つけて、ファームウェア リソース デバイスにインストールします。 この操作により、指定されたファームウェア リソース更新ドライバー パッケージが、Windows ドライバー ストアに追加してインストールを開始する前に、既にファームウェア リソース デバイス上にある可能性がある既存のファームウェア リソース更新ドライバー パッケージよりも実際に新しいものになります。

• pnputil。 自動テストの場合、管理者権限でのコマンド プロンプトから PnpUtil コマンド ライン ユーティリティを使用して、ファームウェア リソース更新ドライバーパッケージを Windows ドライバーストアにインポートし、現在古いファームウェア リソースバージョンを使用しているすべての適用可能なファームウェア リソース デバイスにデバイスインストールを開始できます。これは、インストール済みのドライバーパッケージの INF ファイルの DriverVer によって決定されるか、サードパーティが提供したドライバーパッケージの INF ファイルが全くない場合に適用されます。 たとえば、次のコマンド ラインを使用して X:\firmware.inf を追加してインストールします。

  pnputil -i -a X:\firmware.inf
  

ファームウェア リソースの更新プログラムがファームウェア リソース デバイスに正常にインストールされ、現在のファームウェア バージョンよりも高いバージョンのファームウェア リソース更新プログラムが提供されている場合、デバイスは更新操作を完了するためにシステムの再起動を待機します。 この状態のデバイスは、デバイスの問題を維持することによってシステムを再起動する必要があることを示します。これにより、再起動が実行されるまで、デバイスが起動され、安定した状態に復元されなくなります。

ファームウェア更新プログラムの状態の検証

ファームウェア ドライバー パッケージが正常にインストールされると、PnP はシステムの再起動を要求して更新プログラムを適用します。 再起動後、更新プログラムの状態を検証できます。 更新プログラムの状態は、次のレジストリ キーの下に保持されます: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FirmwareResources\{RESOURCE_GUID}。

RESOURCE_GUIDは、更新された (ESRT からの) リソースの GUID です。

"LastAttemptStatus" レジストリ値はファームウェアの更新の状態を示します。値 0 は成功を示し、ゼロ以外の値は失敗を表します。 このレジストリ キーの値は、ESRT の LastAttemptStatus の値に基づいて OS ローダーによって設定される NTSTATUS コードです。 次の表は、LastAttemptStatus コードを対応する NTSTATUS コードにマップします。

ファームウェア リソース デバイス ノードのハードウェア ID プロパティには、ファームウェア バージョンの変更も反映されている必要があります。XXX は新しいファームウェア バージョンです。

• UEFI\RES_{RESOURCE_GUID}&REV_XXX

ファームウェアの更新に失敗した場合は、失敗したファームウェアの更新を再試行できます。

• デバイス マネージャーで、[ファームウェア] ノードを展開し、ファームウェア リソース デバイスを右クリックし、[ ドライバー ソフトウェアの更新] をクリックします。

• [ コンピューターでドライバー ソフトウェアを参照] をクリックし、次のページで [コンピューター 上のデバイス ドライバーの一覧から選択できるようにする] をクリックします。

• 以前にインストールしたのと同じドライバーを選択し、[OK] をクリックします。

次回の再起動後、OS ローダーはファームウェア ドライバー パッケージのペイロードを使用して UpdateCapsule() を呼び出します。

関連トピック

ESRT テーブル定義

プラグ アンド プレイ デバイス

更新プログラムの処理

UEFI 環境からのデバイス I/O

シームレスな危機防止と復旧

ファームウェアの更新の状態