Creación de un paquete de controladores para la actualización

Es necesario que la carga de actualización de cada recurso de firmware descrito en ESRT se incluya y distribuya en su propio paquete de controladores para permitir que mantenga su propio esquema de control de versiones sin estar vinculado a otras actualizaciones de recursos de firmware que pueden no actualizarse a la misma cadencia.

En el ejemplo siguiente se proporciona una definición de archivo INF del paquete de controladores de ejemplo para una actualización de recursos de firmware destinada al recurso {SYSTEM_FIRMWARE} del ejemplo de ESRT de la tabla 2, actualizándolo de la versión 1 a la versión 2. Para fines de referencia, supongamos que el GUID asignado para el recurso SYSTEM_FIRMWARE es 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

Cambie las secciones siguientes para personalizar la configuración.

[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]

En la tabla siguiente se describen las distintas secciones y campos INF del paquete de controladores en referencia a la definición anterior del archivo INF del paquete de controladores de ejemplo.

Es importante usar un nombre único para cada versión de archivo de imagen de actualización de recursos de firmware para evitar posibles colisiones con otros archivos de imagen de firmware, tanto suyos como los de otros proveedores de firmware. Por ejemplo, firmware.bin de los anteriores deben asignarse el siguiente nombre para satisfacer las restricciones de nombre del proveedor y versión: Fabrikam-System-Firmware-2.0.bin.

Para asegurarse de que las variantes de una imagen de actualización de recursos de firmware determinada, que se pueden usar con fines de personalización oem/IHV, no entren en conflicto cuando se implementan en la misma imagen del sistema de Windows, se recomienda que cada imagen de actualización de recursos de firmware distinta sea un archivo "ejecutar desde el Almacén de controladores" (Windows 10, versión 1803 y posteriores) o que se mantenga bajo un subdirectorio dentro del directorio %SystemRoot%\Firmware. Este subdirectorio debe tener el nombre del GUID del recurso de firmware de destino. Por ejemplo, las siguientes rutas de actualización de firmware satisfacen las restricciones de implementación: %SystemRoot%\\Firmware\\{6bd4efb9-23cc-4b4a-ac37-016517413e9a}\\Fabrikam-System-Firmware-2.0.bin.

Prueba de la firma del paquete de controladores de firmware

Una vez que el archivo INF del paquete de controladores y el archivo binario de carga de firmware estén listos, todo el paquete de controladores debe estar firmado para generar un archivo de catálogo. Es crucial que este archivo de catálogo garantice la validez y autenticidad del archivo INF y del binario de la carga de firmware contenidos en el paquete de controladores para que Windows pueda iniciar de manera segura una actualización de recursos de firmware.

A continuación se enumeran los pasos para firmar el paquete de controladores automáticamente con fines de prueba. Tenga en cuenta que estos pasos son solo con fines de prueba. En producción, los paquetes de drivers para la actualización de firmware deben enviarse al Centro de Partners para su firma. Para conocer los pasos para firmar un paquete de controladores de firmware para producción, consulte Certificación y firma del paquete de actualización.

1. Instale la versión más reciente de Windows SDK y Windows Driver Kit (WDK).

   • Windows SDK instala herramientas como makecert, pvk2pfxy signtool.
   • El Kit de controladores de Windows (WDK) instala herramientas específicas del controlador, como Inf2Cat.

   Normalmente, puedes encontrar estas herramientas en el directorio de instalación de Windows Kits, por ejemplo:

   %WindowsSdkDir%\bin\<version>\x86 (o x64)

   Nota:

   La carpeta exacta de la versión del SDK y el conjunto de herramientas disponibles dependen de los componentes instalados de Windows SDK/WDK.

2. Ejecute el siguiente comando para crear un certificado de prueba.

   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
   

   Para obtener más información, consulte MakeCert.

3. Ejecute el comando siguiente para crear un archivo de catálogo.

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

   El argumento /driver apunta a la ubicación donde se encuentra el INF. Cambie el valor del argumento /os en función del sistema operativo para el que está destinado el paquete de controladores de firmware. Para obtener más información, vea Inf2Cat.

   Para obtener más información sobre los catálogos de seguridad y los controladores, vea Archivos de catálogo y firmas digitales y Creación de un archivo de catálogo para un paquete de controladores PnP.

4. Ejecute el siguiente comando para firmar el archivo de catálogo.

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

   Para obtener más información, vea SignTool.

5. Instale el certificado de prueba en el sistema de prueba:

   1. Haga doble clic en el archivo fwu.cer y elija la opción Instalar certificado .

   2. Elija las siguientes opciones durante la instalación del certificado:

      • En Ubicación de la tienda, elija Equipo local.

      • En Almacén de certificados, busque y seleccione Entidades de certificación raíz de confianza.

6. Deshabilite el arranque seguro en las opciones de firmware/BIOS.

7. Habilite el inicio de sesión de prueba en las opciones de BCD para que el cargador del sistema operativo pueda cargar el archivo de imagen de firmware (firmware.bin) durante el arranque incluso si el catálogo no está firmado por producción. Ejecute el comando siguiente con privilegios de administrador:

   bcdedit /set testsigning on
   

Una vez firmado el paquete de controladores, se puede instalar mediante uno de los siguientes mecanismos:

• Administrador de dispositivos. Para las pruebas manuales, Device Manager proporciona una interfaz fácil de localizar un dispositivo de recursos de firmware y actualizar su controlador para iniciar una actualización de recursos de firmware.

  1. Busque el dispositivo de recursos de firmware deseado en la clase "Firmware" mientras ve los dispositivos por tipo o en el dispositivo "Microsoft UEFI-Compliant System" mientras ve los dispositivos por conexión.

  2. Haga clic con el botón derecho en el dispositivo de recursos de firmware y seleccione la opción "Actualizar software del controlador..." opción.

  3. Use la opción "Examinar mi equipo para el software del controlador" para buscar e instalar un paquete de controladores de actualización de recursos de firmware más reciente en el dispositivo de recursos de firmware. Esta operación garantizará que el paquete de controladores de actualización de recursos de firmware especificado sea más reciente que cualquier paquete de controladores de actualización de recursos de firmware existente que ya esté en el dispositivo de recursos de firmware antes de agregarlo a la Tienda de controladores de Windows e iniciar una instalación.

• pnputil. Para las pruebas automatizadas, la utilidad de línea de comandos PnpUtil se puede usar desde un símbolo del sistema elevado a administrador para importar un paquete de controladores de actualización de recursos de firmware en el Almacén de controladores de Windows e iniciar una instalación de dispositivo en todos los dispositivos de recursos de firmware aplicables que actualmente usan una versión anterior del recurso de firmware, tal como lo establece DriverVer en su archivo INF del paquete de controladores instalado actualmente o la falta absoluta de un archivo INF en el paquete de controladores proporcionado por terceros. Por ejemplo, use la siguiente línea de comandos para agregar e instalar X:\firmware.inf:

  pnputil -i -a X:\firmware.inf
  

Si la actualización del recurso de firmware se instaló correctamente en un dispositivo de recursos de firmware y proporciona una actualización de recursos de firmware que es una versión superior a la versión de firmware actual, el dispositivo esperará un reinicio del sistema para completar la operación de actualización. Un dispositivo en este estado indicará su necesidad de reiniciar el sistema manteniendo un problema de dispositivo, lo que impide que el dispositivo se inicie y restaure a un estado estable hasta que se realice el reinicio.

Validación del estado de la actualización de firmware

Cuando se instala correctamente un paquete de controladores de firmware, PnP solicitará un reinicio del sistema para aplicar las actualizaciones. Después del reinicio, se puede validar el estado de la actualización. El estado de la actualización se mantiene en la siguiente clave del Registro: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FirmwareResources\{RESOURCE_GUID}.

RESOURCE_GUID es el GUID del recurso (de ESRT) que se actualizó.

El valor del Registro "LastAttemptStatus" indica el estado de la actualización de firmware, donde un valor de 0 indica que se ha realizado correctamente y cualquier valor distinto de cero representa un error. El valor de esta clave de registro del sistema son códigos NTSTATUS proporcionados por el Cargador del SO según el valor de LastAttemptStatus desde el ESRT. En la tabla siguiente se asigna el código LastAttemptStatus a su código NTSTATUS correspondiente.

La propiedad Id. de hardware del nodo del dispositivo de recurso de firmware también debe reflejar el cambio en la versión de firmware, donde XXX es la nueva versión de firmware.

• UEFI\RES_{RESOURCE_GUID}&REV_XXX

Si se produjo un error en la actualización del firmware, puede volver a intentar la actualización fallida del firmware.

• En el Administrador de dispositivos, expanda el nodo Firmware, haga clic con el botón derecho en el dispositivo de recursos de firmware y haga clic en Actualizar software de controlador.

• Haga clic en Examinar mi equipo para el software del controlador y, en la página siguiente, haga clic en Permitirme elegir de una lista de controladores de dispositivos en mi equipo.

• Seleccione el mismo controlador que instaló anteriormente y haga clic en Aceptar.

Después del siguiente reinicio, el cargador del sistema operativo llamará a UpdateCapsule() con la carga del paquete de controladores de firmware.

Temas relacionados

Definición de tabla DE ESRT

Dispositivo de conexión y uso inmediato (plug and play)

Procesamiento de actualizaciones

E/S del dispositivo desde el entorno UEFI

Prevención y recuperación de crisis sin problemas

Estado de actualización de firmware