Создание пакета драйвера обновления

Необходимо, чтобы полезные данные обновления для каждого ресурса встроенного ПО, описанного в ESRT, были упакованы и распределены в собственном пакете драйверов, чтобы позволить ему поддерживать собственную систему версионирования без привязки к другим обновлениям ресурсов встроенного ПО, которые могут не обновляться с той же частотой.

В следующем примере показано примерное определение INF-файла пакета драйвера для обновления ресурса микропрограммы, направленного на ресурс {SYSTEM_FIRMWARE} из примера ESRT в таблице 2, обновляемого с версии 1 до версии 2. В справочных целях предположим, что GUID, назначенный для ресурса SYSTEM_FIRMWARE, равен 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. Установите последнюю версию пакета SDK для Windows и комплект драйверов Windows (WDK).

   • Пакет SDK для Windows устанавливает такие средства, как makecert, pvk2pfxи signtool.
   • Пакет драйверов Windows (WDK) устанавливает средства для конкретного драйвера, такие как Inf2Cat.

   Обычно эти средства можно найти в каталоге установки комплектов Windows, например:

   %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 в зависимости от ОС, для которой предназначен пакет драйвера встроенного ПО. Дополнительные сведения см. в разделе 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. Включите тестовую подпись в параметрах BCD, чтобы загрузчик ОС мог загрузить файл образа встроенного ПО (firmware.bin) во время загрузки, даже если каталог не подписан в соответствии с производственными стандартами. Выполните следующую команду с правами администратора:

   bcdedit /set testsigning on
   

После подписания пакета драйвера его можно установить с помощью одного из следующих механизмов:

• Диспетчер устройств. Для ручного тестирования Диспетчер устройств предоставляет удобный интерфейс для поиска устройства ресурса встроенного ПО и обновления драйвера для запуска обновления ресурсов встроенного ПО.

  1. Найдите требуемое устройство ресурса встроенного ПО в классе "Встроенное ПО" при просмотре устройств по типу или на устройстве Microsoft UEFI-Compliant System при просмотре устройств по подключению.

  2. Щелкните правой кнопкой мыши устройство с прошивкой и выберите пункт "Обновить драйвер...".

  3. Используйте вариант "Просмотр моего компьютера для поиска драйверов", чтобы найти и установить более новый пакет обновления драйверов для устройства встроенного ПО. Эта операция гарантирует, что указанный пакет драйвера обновления ресурсов встроенного ПО на самом деле является более новым, чем любой существующий пакет драйвера обновления ресурсов встроенного ПО, который уже может находиться на устройстве ресурса встроенного ПО, прежде чем добавлять его в Магазин драйверов Windows и инициировать установку.

• pnputil. Для автоматического тестирования командная служебная программа PnpUtil может использоваться с правами администратора для импорта пакета драйвера обновления ресурсов встроенного ПО в Магазин драйверов Windows и инициировать установку на всех соответствующих устройствах ресурсов встроенного ПО, которые в настоящее время используют более старую версию ресурса встроенного ПО, как указано в DriverVer INF-файла их установленного пакета драйвера, или при отсутствии пакета INF-файла драйвера от стороннего поставщика. Например, используйте следующую командную строку для добавления и установки X:\firmware.inf:

  pnputil -i -a X:\firmware.inf
  

Если обновление ресурса встроенного ПО было успешно установлено на устройстве ресурсов встроенного ПО и предоставляет обновление ресурсов встроенного ПО, которое является более высокой версией текущей версии встроенного ПО, устройство ожидает перезагрузки системы, чтобы завершить операцию обновления. Устройство в этом состоянии указывает на необходимость перезагрузки системы путем поддержания проблемы с устройством, что предотвращает запуск и восстановление устройства в устойчивом состоянии до завершения перезагрузки.

Проверка состояния обновления встроенного ПО

При успешном установке пакета драйвера встроенного ПО PnP запрашивает перезагрузку системы для применения обновлений. После перезагрузки можно проверить состояние обновления. Состояние обновления сохраняется в следующем разделе реестра: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FirmwareResources\{RESOURCE_GUID}

RESOURCE_GUID — это GUID ресурса (из ESRT), который был обновлен.

Значение реестра LastAttemptStatus указывает состояние обновления встроенного ПО, где значение 0 указывает на успешность и любое ненулевое значение представляет сбой. Значение этого ключа реестра — коды NTSTATUS, которые заполняет загрузчик ОС, исходя из значения LastAttemptStatus из ESRT. В следующей таблице код LastAttemptStatus сопоставляется с соответствующим кодом NTSTATUS.

Свойство "Идентификатор оборудования" узла устройства ресурса, связанного со встроенным ПО, также должно отражать изменение в версии, где XXX обозначает новую версию встроенного ПО.

• UEFI\RES_{RESOURCE_GUID}&REV_XXX

Если обновление встроенного ПО завершилось сбоем, можно повторить обновление встроенного ПО:

• В диспетчере устройств разверните узел встроенного ПО, щелкните правой кнопкой мыши устройство ресурса встроенного ПО и щелкните "Обновить программное обеспечение драйвера".

• Нажмите Просмотр моего компьютера для поиска программного обеспечения драйвера, и на следующей странице нажмите Выбрать из списка драйверов устройств на моем компьютере.

• Выберите тот же драйвер, который вы установили ранее, и нажмите кнопку "ОК".

После следующей перезагрузки загрузчик ОС вызовет функцию UpdateCapsule() с содержимым пакета драйвера прошивки.

Связанные темы

определение таблицы ESRT

устройство типа "Подключи и используй"

Обработка обновлений

I/O устройства из среды UEFI

Бесшовное предотвращение и восстановление кризисов

состояние обновления прошивки