Partilhar via


Definição da tabela ESRT

O ponteiro para a tabela ESRT é identificado através do GUID correspondente no EFI_CONFIGURATION_TABLE.

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

A tabela a seguir descreve o formato da tabela ESRT e as entradas de recursos de firmware contidas na tabela.

Campo Valor da matriz Comprimento do byte Deslocamento de byte Descrição
Contagem de recursos de firmware 4 0 O número de entradas de recursos de firmware no ESRT. Não deve ser zero.
Máximo de recursos de firmware 4 4 O número máximo de entradas da matriz de recursos que podem ser adicionadas sem realocar a tabela. Deve ser maior ou igual à Contagem de Recursos de Firmware.
Versão do recurso de firmware 8 8 A versão de entrada de recursos do firmware. Este valor deve ser definido como 1
Matriz de entrada de recursos de firmware Entrada de recursos de firmware 0
Classe de firmware 16 16 Um GUID que identifica um componente de firmware que pode ser atualizado usando uma cápsula de atualização. Esse GUID será passado para o serviço de tempo de execução da cápsula de atualização UEFI como o parâmetro CapsuleGuid do cabeçalho da cápsula de atualização durante a atualização.
Tipo de firmware 4 32 Um dos seguintes valores que identifica o tipo de recurso de firmware:

0: Desconhecido

1: Firmware do sistema

2: Firmware do dispositivo

3: Driver UEFI
Versão do firmware 4 36 A versão atual do firmware, onde um número maior representa uma versão mais recente. O formato deste valor não está definido, mas deve incorporar números principais e secundários da versão. O formato recomendado é que o primeiro número corresponde à versão principal e o segundo ao número da versão secundária.
Versão de firmware suportada mais baixa 4 40 A versão mínima do recurso de firmware para a qual se pode reverter um recurso de firmware num determinado sistema/dispositivo. Se estiver disponível uma correção relacionada com a segurança nesta versão de firmware, então a versão menos compatível deve ser igual à versão atual do firmware.
Bandeiras Cápsula 4 44 Sinalizadores que serão passados para o serviço de tempo de execução da cápsula de atualização UEFI nos bits 0 – 15 do campo Sinalizadores do cabeçalho da cápsula de atualização (o SO é responsável por configurar os bits 16 – 31 dos Sinalizadores, conforme definido pela seção 7.5.3 da especificação UEFI).
Última versão de tentativa 4 48 A última versão de firmware para a qual foi tentada uma atualização. Este valor utiliza o mesmo formato que a Versão de Firmware.
Estado da Última Tentativa 4 52 Um dos seguintes valores que descreve o status da última tentativa de atualização de firmware:

0: Sucesso

1: Sem sucesso

2: Recursos insuficientes

3: Versão incorreta

4: Formato de imagem inválido

5: Erro de autenticação

6: Evento de alimentação - CA não conectado

7: Evento de energia - bateria insuficiente
... Entrada de recursos de firmware 1

O núcleo do firmware UEFI deve alocar e preencher uma tabela de configuração ESRT que contenha uma entrada de recurso do sistema para ele próprio (firmware do sistema). Para fins ilustrativos, neste guia o firmware principal também criará uma entrada adicional representando um dispositivo que suporta a atualização de firmware do dispositivo usando o mecanismo do pacote de atualização de firmware.

Sempre deve haver exatamente uma entrada descrevendo o firmware do sistema. Esta entrada é usada para direcionar uma atualização de firmware do sistema. Se uma implementação executar atualizações de firmware do sistema e do dispositivo como uma única operação monolítica, a entrada de firmware do sistema deverá ser usada para direcionar a atualização. Em todos os outros casos, as atualizações de firmware do dispositivo são direcionadas por uma entrada ESRT que descreve o firmware do dispositivo.

O primeiro passo, então, é gerar GUIDs para representar esses dois recursos de firmware, ou seja, {SYSTEM_FIRMWARE} e {DEVICE_FIRMWARE}. A Tabela 2 mostra um exemplo de uma definição de tabela. Este exemplo pressupõe que ambas as versões de firmware são atualmente a versão 1 (Versão de firmware == 1).

Campo Valor da matriz Valor Comentário
Contagem de recursos de firmware 2 Esta tabela contém duas entradas de recursos de firmware.
Máximo de recursos de firmware 2 Esta alocação de tabela contém espaço suficiente para descrever um máximo de dois recursos.
Versão do recurso de firmware 1 A versão do formato de entrada de recursos de firmware que esta tabela usa é 1.
Matriz de entrada de recursos de firmware Entrada de recurso de firmware 0
Classe de firmware (Firmware do sistema) Este GUID identifica o firmware do sistema para atualização via PnP.
Tipo de firmware 1 O tipo de firmware do sistema é 1.
Versão do firmware 1 A versão atual do firmware do sistema é 1.
Versão de firmware suportada mais baixa 1 A versão de firmware suportada mais baixa é 1, portanto, o firmware não pode ser revertido para uma versão anterior à versão 1.
Bandeiras Cápsula 0 O firmware do sistema não define nenhum sinalizador de atualização de cápsula privada.
Última versão de tentativa 1 A última versão de firmware do sistema para a qual foi tentada uma atualização foi a versão 1.
Estado da Última Tentativa 0 A última tentativa de atualização de firmware do sistema foi bem-sucedida.
Entrada de recurso de firmware 1
Classe de firmware FIRMWARE_DO_DISPOSITIVO Este GUID identifica o firmware do dispositivo para atualização via PnP.
Tipo de firmware 2 O tipo de firmware do dispositivo é 2.
Versão do firmware 1 A versão atual do firmware do dispositivo é 1.
Versão de firmware suportada mais baixa 1 A versão de firmware suportada mais baixa é a 1, pelo que o firmware não pode ser revertido para uma versão anterior à versão 1.
Bandeiras Cápsula 0x8010 O firmware do dispositivo define bandeiras de atualização privada da cápsula (0x8010).
Última versão de tentativa 1 A última versão de firmware do dispositivo para a qual foi tentada uma atualização é a versão 1
Estado da Última Tentativa 0 A última tentativa de atualização de firmware do dispositivo foi bem-sucedida.

O exemplo de ESRT acima é usado em outro lugar nesta documentação para percorrer o processo de atualização de firmware e descrever o suporte do Windows para o processo de atualização, bem como a implementação de um firmware de suporte.

Dispositivo Plug-and-Play

Criação de um pacote de driver de atualização

Processamento de atualizações

E/S de dispositivo a partir do ambiente UEFI

Prevenção e recuperação de crises sem descontinuidades

Estado da atualização de firmware