Microsoft Debug Port Table 2 (DBG2)

Article
04/14/2023

Cette spécification définit le format de la table de port de débogage 2 (DBG2), utilisée 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 plus récents.

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

Avis de brevet : Microsoft rend certains droits de brevet disponibles pour les implémentations de cette spécification selon deux options :

Promesse de la communauté microsoft, disponible à l’adresse https://www.microsoft.com/openspecifications/en/us/programs/community-promise/default.aspx

Le contrat de spécification final d’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.

Historique des documents

Date	Modifier
29 novembre 2011	Première publication.
22 mai 2012	Mises à jour au tableau 3 par plateforme finale prise en charge pour Windows 8.
10 août 2015	Mise à jour de l’avis de brevet.
6 octobre 2015	Ajout de nouveaux sous-types de débogage en série (Arm SBSA UART, Arm DCC)
10 décembre 2015	Ajout d’un nouveau sous-type de débogage série (BCM2835)
31 mai 2017	Ajout d’un nouveau sous-type de débogage série (i.MX6, compatible avec la structure d’adresse générique 16550)
11 juin 2020	Ajout d’un nouveau sous-type de débogage série (SDM845v2)
1 septembre 2020	Modification de la syntaxe et de la mise en forme du document converti en Markdown.
21 septembre 2020	Ajout d’un nouveau sous-type de débogage série (IALPSS)
17 février 2021	Documenter tous les sous-types de débogage série connus
10 avril 2023	Ajout d’un nouveau sous-type de débogage série (RISC-V) et ajout d’informations de clarification sur les sous-types compatibles 16550

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 port 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 de débogage (DBGP) ACPI sur les plateformes dont les implémentations de port de débogage ne peuvent pas être décrites à l’aide de DBGP.

Debug Port Table 2 (DBG2)

Tableau 1. Format Debug Port Table 2

Le tableau 1 définit les champs dans DBG2.

Champ	Longueur d’octets	Décalage d’octets	Description
En-tête
Signature	4	0	'DBG2'. Signature pour la table de port de débogage 2.
Longueur	4	4	Longueur, en octets, de l’intégralité du tableau de port de débogage 2.
Révision	1	8	Pour cette version de la spécification, cette valeur est 0.
Somme de contrôle	1	9	La table entière doit être égale à zéro.
OEM ID	6	10	ID du fabricant d’équipement d’origine (OEM).
OEM Table ID	8	16	Pour la table de port de débogage 2, l’ID de table est l’ID de modèle du fabricant.
Révision OEM	4	24	Révision OEM de la table de port de débogage 2 pour l’ID de table OEM fourni.
ID du créateur	4	28	ID de fournisseur de l’utilitaire qui a créé la table.
Révision du créateur	4	32	Révision de l’utilitaire qui a créé la table.
OffsetDbgDeviceInfo	4	36	Décalage, en octets, du début de cette table vers la première entrée de structure Informations sur l’appareil de débogage.
NumberDbgDeviceInfo	4	40	Indique le nombre d’entrées de structure Informations sur l’appareil de débogage.
Structure d’informations de périphérique de débogage[NumberDbgDeviceInfo]	Variable	OffsetDbgDeviceInfo	Liste des structures Debug Device Information pour cette plateforme. Le format de structure est défini dans la section Structure d’informations sur le périphérique de débogage, plus loin dans ce document.

Structure d’informations sur les appareils de débogage

Tableau 2. Format de structure Debug Device Information

Champ	Longueur d’octets	Décalage d’octets	Description
Révision	1	0	Révision de la structure Informations sur l’appareil de débogage. Pour cette version de la spécification, il doit s’agir de 0.
Longueur	2	1	Longueur, en octets, de cette structure, y compris NamespaceString et OEMData.
NumberofGenericAddressRegisters	1	3	Nombre de registres d’adresses génériques en cours d’utilisation.
NamespaceStringLength	2	4	Longueur, en octets, de NamespaceString, y compris les caractères NUL.
NamespaceStringOffset	2	6	Décalage, en octets, du début de cette structure vers le champ NamespaceString[]. Cette valeur doit être valide, car cette chaîne doit être présente.
OemDataLength	2	8	Longueur, en octets, du bloc de données OEM.
OemDataOffset	2	10	Décalage, en octets, vers le champ OemData[] à partir du début de cette structure. Cette valeur sera 0 si aucune donnée OEM n’est présente.
Type de port	2	12	Type de port de débogage pour cet appareil de débogage. Chacune de ces valeurs aura une valeur de sous-type correspondante, comme indiqué dans le tableau 3.
Sous-type de port	2	14	Sous-type de port de débogage pour cet appareil de débogage. Voir le tableau 3.
Réservé	2	16	Réservé, doit être 0.
BaseAddressRegisterOffset	2	18	Décalage, en octets, du début de cette structure vers le champ BaseaddressRegister[].
AddressSizeOffset	2	20	Décalage, en octets, du début de cette structure vers le champ AddressSize[].
BaseAddressRegister[]	(NumberofGenericAddressRegisters) * 12	BaseAddressRegisterOffset	Tableau d’adresses génériques.
AddressSize[]	(NumberofGenericAddressRegisters) * 4	AddressSizeOffset	Tableau de tailles d’adresses correspondant à chaque adresse générique ci-dessus.
NamespaceString[]	NamespaceStringLength	NamespaceStringOffset	Chaîne ASCII terminée par nul pour identifier de manière unique cet appareil. Cette chaîne se compose d’une référence complète à l’objet qui représente cet appareil dans l’espace de noms ACPI. S’il n’existe aucun périphérique d’espace de noms, NamespaceString[] ne doit contenir qu’un seul ' . Caractère (période ASCII).
OemData[]	OemDataLength	OemDataOffset	Données oem de longueur variable facultatives.

Tableau 3. Types et sous-types de ports de débogage

Port	Type	Subtype	Description
Réservé	0x0000 – 0x7FFF et 0xFFFF	Tous	Réservé (ne pas utiliser)
Série	0x8000	0x0000	Entièrement compatible 16550
		0x0001	Sous-ensemble 16550 compatible avec DBGP Revision 1
		0x0002	MAX311xE SPI UART
		0x0003	Arm PL011 UART
		0x0004	MSM8x60 (par exemple, 8960)
		0x0005	Nvidia 16550
		0x0006	TI OMAP
		0x0007	Réservé (ne pas utiliser)
		0x0008	APM88xxxx
		0x0009	MSM8974
		0x000A	SAM5250
		0x000B	Intel USIF
		0x000C	i.MX 6
		0x000D	(déconseillé) Arm SBSA (2.x uniquement) UART générique prenant en charge uniquement les accès 32 bits
		0x000E	UART générique SBSA Arm
		0x000F	Arm DCC
		0x0010	BCM2835
		0x0011	SDM845 avec une fréquence d’horloge de 1,8432 MHz
		0x0012	Compatible 16550 avec les paramètres définis dans la structure d’adresse générique
		0x0013	SDM845 avec une fréquence d’horloge de 7,372 MHz
		0x0014	Intel LPSS
		0x0015	Console SBI RISC-V (tout mécanisme SBI pris en charge)
		0x0016 – 0xFFFF	Réservé (pour une utilisation ultérieure)
1394	0x8001	0x0000	Interface du contrôleur d’hôte standard IEEE1394
		0x0001 – 0xFFFF	Réservé (pour une utilisation ultérieure)
USB	0x8002	0x0000	Contrôleur compatible XHCI avec interface de débogage
		0x0001	Contrôleur conforme à EHCI avec interface de débogage
		0x0002 – 0x0006	Réservé (ne pas utiliser)
		0x0007 – 0xFFFF	Réservé (pour une utilisation ultérieure)
Net	0x8003	NNNN	NNNN doit être un ID de fournisseur affecté par pci valide
	0x8004	Tous	Réservé (ne pas utiliser)
Réservé	0x8005 – 0xFFFE	Tous	Réservé (pour une utilisation ultérieure)

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

La structure d’adresse générique dans BaseAddressRegister[0] est utilisée pour spécifier la largeur de bits du registre et la taille d’accès utilisées par certains sous-types série.
Les champs ID de l’espace d’adressage et Décalage du bit d’enregistrement doivent être 0.
Le champ Register Bit Width contient la foulée de registre et doit avoir 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 permet de déterminer si les accès byte, WORD, DWORD ou QWORD doivent être utilisés. Les accès QWORD ne sont valides que 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 les 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 qu’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éscribables dans la table DBGP ACPI. Les implémentations de système d’exploitation peuvent traiter cela comme équivalent à un port de débogage fourni par DBGP et respecter uniquement le champ Adresse de base de la structure d’adresse 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 0x1, ainsi que par les nouveaux ports, tels que ceux nécessitant des tailles d’accès non traditionnelles et des largeurs de bits dans la structure d’adresse générique.

Ressources

Spécification ACPI

Share via