Interface _DSM para a classe de função endereçável energy backed de bytes jedec (interface de função 1)
Esta seção descreve a interface método específico do dispositivo (_DSM) que foi projetada para mapear para o padrão de interface com suporte de energia endereçável de bytes JEDEC, a fim de minimizar a complexidade do BIOS. Ele fornece uma base comum de relatórios de funções de dispositivo & recursos, de modo que o software do sistema operacional possa interagir com várias implementações por meio dos mesmos mecanismos. Além disso, ele permite suporte para funcionalidade específica do fornecedor por meio do acesso a registros I2C.
As plataformas que estão em conformidade com a Interface de _DSM para a Classe de Função Com Suporte à Energia Endereçável de Bytes (Interface de Função 1) podem dar suporte a um NVDIMM-N que implementa a especificação interface de suporte de energia endereçável de bytes jedec (classe de função 0x01 e interface de função 0x01). Para obter mais informações, consulte a Especificação da interface com suporte à energia endereçável de bytes JEDEC (JESD245 de documento).
Definição de GUID
O GUID para a interface _DSM classe de função endereçável de energia endereçável de bytes jedec é 1EE68B36-D4BD-4a1a-9A16-4F8E53D46E05.
Funções e campos obrigatórios
As funções _DSM definidas nesta seção devem ser implementadas em objetos de dispositivo namespace ACPI NVDIMM. O termo Obrigatório refere-se a se a função deve retornar dados válidos ou não.
A tabela a seguir especifica as funções e os campos obrigatórios, em que "ESP" significa "Política de Fonte de Energia".
Entrada do método _DSM
Arg3 para todas as funções é um valor de Pacote. Se a função não aceitar um argumento de entrada, o valor do pacote não conterá dados. Se a função usar um argumento de entrada, o valor do pacote conterá um buffer.
Se a função não aceitar um argumento de entrada e Arg3 não for um Pacote vazio, a função deverá retornar o Código de Status Geral de Parâmetros de Entrada Inválidos.
Saída do método _DSM
Todos os métodos retornarão um buffer de comprimento maior ou igual a 4 bytes. Os primeiros 4 bytes do buffer de retorno são estruturados da seguinte maneira:
| Campo | Comprimento do byte | Deslocamento de bytes | Descrição |
|---|---|---|---|
| Código de status geral | 2 | 0 | O código de status geral. Verifique abaixo quanto a possíveis valores. |
| código de erro Function-Specific | 1 | 2 | Um código de erro específico para a função que foi chamada. Esse campo conterá apenas informações válidas se o Código de Status Geral for igual ao Código de Erro Específico da Função. |
| Código de erro específico do fornecedor | 1 | 3 | Códigos de status específicos do fornecedor. Esse campo só conterá informações válidas se o Código de Status Geral for igual ao Código de Erro Específico do Fornecedor. |
Veja a seguir os valores possíveis para o Código de Status Geral.
| Valor | Significado |
|---|---|
| 0 | Êxito |
| 1 | Sem suporte |
| 2 | Parâmetros de entrada inválidos |
| 3 | Erro de comunicação I2C |
| 4 | código de erro Function-Specific |
| 5 | Código de erro específico do fornecedor |
| 6 | 0xFFFF – Reservado |
Qualquer Código de Status Geral diferente de zero indica que a função falhou. Nenhuma função definida nesta versão da especificação deve retornar o Código de Status Geral sem Suporte. Todas as funções obrigatórias devem retornar dados válidos ou um código de erro que indica um erro de runtime. Funções não obrigatórias podem retornar um código de erro Function-Specific para sinalizar que não há dados válidos a serem retornados.
Todos os bits e bytes reservados devem ter um valor de 0. A menos que indicado de outra forma, todos os campos de vários bytes deverão ser representados de maneira little-endian.
Observação
Uma referência a um registro de Interface de Energy-Backed Endereçável de Bytes descreve muitos campos de retorno para funções especificadas nessa interface. Esses campos devem ser idênticos ao registro definido na revisão "Interface de Suporte à Energia Endereçável de Bytes, versão 1.0, JEDEC Standard No. 2233-22" da especificação interface Byte-Addressable Energy-Backed. A versão de especificação é relatada no campo Revisão de Especificação retornado pela função Get NVDIMM-N Identification (Function Index 1).
Alguns campos de retorno referem-se a informações sobre a Fonte de Energia (ES). Quando a política do ES é gerenciada pelo dispositivo, a plataforma deve ler o registro de hardware especificado na descrição do campo para recuperar todas as informações relacionadas ao ES. Quando a política do ES é gerenciada pelo host, a plataforma deve obter as informações relacionadas ao ES por meio de mecanismos específicos da plataforma. Nesse caso, todas as informações relacionadas ao ES devem ser apresentadas no mesmo layout binário que o registro de hardware especificado na descrição do campo.