Microsoft Debug Port Table 2 (DBG2)

Cette spécification définit le format du tableau de ports de débogage 2 (DBG2), utilisé dans le microprogramme de plateforme pour décrire les ports de débogage disponibles sur le système. Ces informations s’appliquent aux systèmes d’exploitation suivants : Windows 8 et versions ultérieures.

Les références et les ressources présentées ici sont répertoriées à la fin de ce document.

Avis de brevet : Microsoft met certains droits de brevet à la disposition des implémentations de cette spécification sous deux options :

1. Microsoft Community Promise, disponible à l’adresse https://www.microsoft.com/openspecifications/en/us/programs/community-promise/default.aspx
2. Le Contrat de spécification final Open Web Foundation version 1.0 (« OWF 1.0 ») à compter du 1er octobre 2012, disponible à l’adresse http://www.openwebfoundation.org/legal/the-owf-1-0-agreements/owfa-1-0.

Document History

Introduction

Microsoft nécessite un port de débogage sur tous les systèmes. Pour décrire le ou les ports de débogage disponibles sur une plateforme, Microsoft définit une table spécifique au système d’exploitation (DBG2). Ce tableau spécifie un ou plusieurs ports indépendants à des fins de débogage. La présence d’une table de ports de débogage indique que le système inclut un port de débogage. La table contient des informations sur la configuration du port de débogage. La table se trouve dans la mémoire système avec d’autres tables ACPI (Advanced Configuration and Power Interface), et doit être référencée dans la table de description du système racine ACPI (RSDT).

La table DBG2 remplace la table de ports DEbug ACPI (DBGP) sur les plateformes dont les implémentations de port de débogage ne peuvent pas être décrites à l’aide de DBGP.

Port de débogage Tableau 2 (DBG2)

Table 1. Format Debug Port Table 2

Le tableau 1 définit les champs dans DBG2.

Déboguer la structure d’informations sur l’appareil

Table 2. Format de structure Debug Device Information

Table 3. Déboguer les types de ports et les sous-types

Remarque sur les champs de la structure d’adresses générique

• La structure d’adresse générique dans BaseAddressRegister[0] est utilisée pour spécifier la largeur du bit d’enregistrement et la taille d’accès utilisée par certains sous-types série.

• L’ID d’espace d’adressage et les champs Inscrire le décalage de bits doivent être 0.

• Le champ Largeur du bit d’enregistrement contient le pas de registre et doit être une puissance de 2 qui est au moins aussi grande que la taille d’accès. Sur les plateformes 32 bits, cette valeur ne peut pas dépasser 32. Sur les plateformes 64 bits, cette valeur ne peut pas dépasser 64.

• Le champ Taille d’accès est utilisé pour déterminer si les accès byte, WORD, DWORD ou QWORD doivent être utilisés. Les accès QWORD sont valides uniquement sur les architectures 64 bits.

Remarque sur les UART basés sur 16550

Il existe trois sous-types d’interface qui peuvent être utilisés pour les UART basés sur 16550. Les différences entre elles sont subtiles mais importantes.

• Le sous-type d’interface 0x0 fait référence à un port série qui utilise des E/S de port « hérités », comme indiqué sur les plateformes x86. Ce type doit être évité sur les plateformes qui utilisent des E/S mappées en mémoire, telles que ARM ou RISC-V.

• Le sous-type d’interface 0x1 prend en charge les UART mappés en mémoire, mais uniquement ceux qui sont décribables dans la table ACPI DBGP. Les implémentations du système d’exploitation peuvent les traiter comme équivalentes à un port de débogage fourni par DBGP et respecter uniquement le champ Adresse de base de la structure d’adresses générique.

• Le sous-type d’interface 0x12 est le choix le plus flexible et est recommandé lors de l’exécution de systèmes d’exploitation compatibles sur de nouvelles plateformes. Ce sous-type prend en charge tous les ports série qui peuvent être décrits par les sous-types 0x0 et les 0x1, ainsi que les nouveaux ports, tels que ceux nécessitant des tailles d’accès et des largeurs de bits non traditionnelles dans la structure d’adresses générique.

Resources

ACPI Specification