Tabela de porta de depuração da Microsoft 2 (DBG2)

Essa especificação define o formato da Tabela de Porta de Depuração 2 (DBG2), usada no firmware da plataforma para descrever as portas de depuração disponíveis no sistema. Essas informações se aplicam aos seguintes sistemas operacionais: Windows 8 e mais recentes.

As referências e os recursos discutidos aqui estão listados no final deste artigo.

Aviso de patente: a Microsoft está disponibilizando certos direitos de patente para implementações desta especificação em duas opções:

1. Promessa da Comunidade da Microsoft, disponível em https://www.microsoft.com/openspecifications/en/us/programs/community-promise/default.aspx
2. O Contrato de Especificação Final do Open Web Foundation versão 1.0 ("OWF 1.0") a partir de 1º de outubro de 2012, disponível em http://www.openwebfoundation.org/legal/the-owf-1-0-agreements/owfa-1-0.

Document History

Introduction

A Microsoft requer uma porta de depuração em todos os sistemas. Para descrever as portas de depuração disponíveis em uma plataforma, a Microsoft define uma tabela específica do sistema operacional (DBG2). Esta tabela especifica uma ou mais portas independentes para fins de depuração. A presença de uma tabela de porta de depuração indica que o sistema inclui uma porta de depuração. A tabela contém informações sobre a configuração da porta de depuração. A tabela está localizada na memória do sistema com outras tabelas ACPI (Advanced Configuration and Power Interface) e deve ser referenciada na Tabela de Descrição do Sistema Raiz do ACPI (RSDT).

A tabela DBG2 substitui a Tabela de Porta de Depuração de ACPI (DBGP) em plataformas cujas implementações de porta de depuração não podem ser descritas usando DBGP.

Porta de depuração Tabela 2 (DBG2)

Table 1. Formato da Tabela de Porta de Depuração 2

A Tabela 1 define os campos no DBG2.

Estrutura Depurar Informações do Dispositivo

Table 2. Formato da estrutura Depurar Informações do Dispositivo

Table 3. Depurar tipos de porta e subtipos

Observação nos campos da estrutura de endereço genérico

• A Estrutura de Endereço Genérico em BaseAddressRegister[0] é usada para especificar a largura do bit de registro e o tamanho de acesso usados por alguns subtipos serial.

• Os campos ID de Espaço de Endereço e Deslocamento de Bit de Registro devem ser 0.

• O campo Registrar Largura de Bit contém o passo de registro e deve ser uma potência de 2 que seja pelo menos tão grande quanto o tamanho do acesso. Em plataformas de 32 bits, esse valor não pode exceder 32. Em plataformas de 64 bits, esse valor não pode exceder 64.

• O campo Tamanho do Acesso é usado para determinar se os acessos byte, WORD, DWORD ou QWORD devem ser usados. Os acessos QWORD só são válidos em arquiteturas de 64 bits.

Observação em UARTs baseadas em 16550

Há três subtipos de interface que podem ser usados para UARTs baseados em 16550. As diferenças entre eles são sutis, mas importantes.

• O subtipo de interface 0x0 refere-se a uma porta serial que usa e/S de porta "herdada", como visto em plataformas baseadas em x86. Esse tipo deve ser evitado em plataformas que usam E/S mapeada por memória, como ARM ou RISC-V.

• O subtipo de interface 0x1 dá suporte a UARTs mapeados por memória, mas apenas os que são descrevendo na tabela ACPI do DBGP. As implementações do sistema operacional podem tratar isso como equivalente a uma porta de depuração fornecida pelo DBGP e honrar apenas o campo Endereço Base da Estrutura de Endereços Genérico.

• O subtipo de interface 0x12 é a opção mais flexível e é recomendado ao executar sistemas operacionais compatíveis em novas plataformas. Esse subtipo dá suporte a todas as portas serial que podem ser descritas pelos subtipos 0x0 e 0x1, bem como as novas, como aquelas que exigem tamanhos de acesso não tradicionais e larguras de bit na Estrutura de Endereços Genérica.

Resources

ACPI Specification