Partager via


Configuration du débogage en mode noyau USB 3.0 xHCI (KDUSB xHCI-DBC USB 3.0)

Les outils de débogage pour Windows prennent en charge le débogage en mode noyau sur un câble USB 3.0. Cet article explique comment configurer manuellement le débogage USB 3.0.

L’ordinateur qui exécute le débogueur est appelé l’ordinateur hôte, et l’ordinateur en cours de débogage est appelé l’ordinateur cible.

Le débogage sur un câble USB 3.0 nécessite le matériel suivant :

  • Sur l’ordinateur hôte, un contrôleur hôte xHCI (USB 3.0)
  • Sur l’ordinateur cible, un contrôleur hôte xHCI (USB 3.0) qui prend en charge le débogage
  • Le contrôleur hôte USB de l’ordinateur cible doit prendre en charge l’interface de capacité Intel xHCI-Debug (DBC). Pour plus d’informations, reportez-vous à la spécification xHCI disponible sur le site Web Intel.

Configuration requise pour les câbles

  • Un câble de débogage USB Microsoft orange, qui est un câble croisé A-A qui a deux plugs de type A mâle et aucune connexion Vbus. Ce câble est disponible auprès des fournisseurs tels que DataPro - USB 3.0 Super-Speed A/A Debugging Cable.

Pour simplifier la résolution des problèmes, connectez le câble directement entre l’ordinateur cible et l’ordinateur hôte, ce qui évite les hubs ou les stations d’ancrage.

Fichiers de transport binaires

Le kdstub.dll est utilisé pour prendre en charge le transport du débogueur USB 3.0 de KDUSB xHCI-DBC.

Configurez l’ordinateur cible

  1. Sur l’ordinateur cible, lancez l’outil UsbView . L’outil UsbView est inclus dans les outils de débogage pour Windows. Pour un système x64, UsbView se trouve dans C :\Program Files (x86)\Windows Kits\10\Tools\kitversion\x64\usbview.exe.

  2. Dans UsbView, recherchez tous les contrôleurs hôtes xHCI.

  3. Dans UsbView, développez les nœuds des contrôleurs hôtes xHCI. Recherchez une indication qu’un port sur le contrôleur hôte prend en charge le débogage.

    [Port1]
    
    Is Port User Connectable:         yes
    Is Port Debug Capable:            yes
    Companion Port Number:            3
    Companion Hub Symbolic Link Name: USB#ROOT_HUB30#5&32bab638&0&0#{...}
    Protocols Supported:
     USB 1.1:                         no
     USB 2.0:                         no
     USB 3.0:                         yes
    
  4. Notez les numéros de bus, d’appareil et de fonction du contrôleur xHCI que vous envisagez d’utiliser pour le débogage. UsbView affiche ces numéros. Dans l’exemple suivant, le numéro de bus est 48, le numéro d’appareil est 0 et le numéro de fonction est 0.

    USB xHCI Compliant Host Controller
    ...
    DriverKey: {36fc9e60-c465-11cf-8056-444553540000}\0020
    ...
    Bus.Device.Function (in decimal): 48.0.0
    
  5. Après avoir identifié un contrôleur xHCI qui prend en charge le débogage, l’étape suivante consiste à localiser le connecteur USB physique associé à un port sur le contrôleur xHCI. Pour trouver le connecteur physique, branchez n’importe quel périphérique USB 3.0 dans n’importe quel connecteur USB sur l’ordinateur cible. Actualisez UsbView pour voir où se trouve votre appareil. Si UsbView affiche votre appareil connecté à votre contrôleur hôte xHCI choisi, vous avez trouvé un connecteur USB physique que vous pouvez utiliser pour le débogage USB 3.0.

Important

bcdedit Avant de modifier les informations de démarrage, vous devrez peut-être suspendre temporairement les fonctionnalités de sécurité Windows telles que BitLocker et Démarrage sécurisé sur le PC de test. Réactivez ces fonctionnalités de sécurité lorsque les tests sont terminés et gérez de manière appropriée le PC de test lorsque les fonctionnalités de sécurité sont désactivées.

  1. Sur l’ordinateur cible, ouvrez une fenêtre d’invite de commandes en tant qu’administrateur et entrez les commandes suivantes :

    bcdedit /debug on
    bcdedit /dbgsettings usb targetname:<TargetName>
    

    TargetName est un nom que vous créez pour l’ordinateur cible. Notez que TargetName n’a pas besoin d’être le nom officiel de l’ordinateur cible ; il peut s’agir de n’importe quelle chaîne que vous créez tant qu’elle répond à ces restrictions :

    • La chaîne ne doit pas contenir de « débogage » n’importe où dans targetName dans une combinaison de majuscules ou minuscules. Par exemple, si vous utilisez « Déboguer » ou « DEBUG » n’importe où dans votre nom cible, le débogage ne fonctionne pas correctement.
    • Les seuls caractères de la chaîne sont le trait d’union (-), le trait de soulignement(_), les chiffres 0 à 9 et les lettres A à Z (majuscule ou minuscule).
    • La longueur maximale de la chaîne est de 24 caractères.
  2. Dans Gestionnaire de périphériques, recherchez le contrôleur USB que vous envisagez d’utiliser pour le débogage. Sous Emplacement sous l’onglet Général , les numéros de bus, d’appareil et de fonction sont affichés. Entrez cette commande :

    bcdedit /set "{dbgsettings}" busparams <b.d.f>
    

    B, d et f sont les numéros de bus, d et de fonction du contrôleur hôte USB. Les numéros de bus, d’appareilet de fonction doivent être au format décimal.

    Exemple :

    bcdedit /set "{dbgsettings}" busparams 48.0.0
    
  3. Redémarrez l'ordinateur cible.

Désactiver la gestion de l’alimentation

Dans certains cas, les transitions d’alimentation peuvent interférer avec le débogage via USB 3.0. Pour éviter ces problèmes, désactivez l’interruption sélective pour le contrôleur hôte xHCI et son hub racine que vous utilisez pour le débogage.

  1. Dans Gestionnaire de périphériques, accédez au nœud du contrôleur hôte xHCI. Cliquez avec le bouton droit sur le nœud, puis choisissez Propriétés. S’il existe un onglet Gestion de l’alimentation, ouvrez l’onglet et désactivez la case Autoriser l’ordinateur à désactiver cet appareil pour enregistrer l’alimentation .

  2. Dans Gestionnaire de périphériques, accédez au nœud du hub racine du contrôleur hôte xHCI. Cliquez avec le bouton droit sur le nœud, puis choisissez Propriétés. S’il existe un onglet Gestion de l’alimentation, ouvrez l’onglet et désactivez l’option Autoriser l’ordinateur à désactiver cet appareil pour enregistrer l’alimentation .

Lorsque vous avez terminé d’utiliser le contrôleur hôte xHCI pour le débogage, réactivez la suspension sélective pour le contrôleur hôte xHCI.

Démarrer une session de débogage pour la première fois

  1. Connectez un câble de débogage USB 3.0 aux ports USB 3.0 que vous avez choisis pour le débogage sur les ordinateurs hôtes et cibles.
  2. Déterminez la bits (32 bits ou 64 bits) de Windows s’exécutant sur l’ordinateur hôte.
  3. Sur l’ordinateur hôte, ouvrez une version de WinDbg (en tant qu’administrateur) qui correspond au bit de Windows en cours d’exécution sur l’ordinateur hôte. Par exemple, si l’ordinateur hôte exécute une version 64 bits de Windows, ouvrez la version 64 bits de WinDbg en tant qu’administrateur.
  4. Dans le menu Fichier, choisissez Débogage du noyau. Dans la boîte de dialogue Débogage du noyau, ouvrez l’onglet USB . Entrez le nom cible que vous avez créé lors de la configuration de l’ordinateur cible. Cliquez sur OK.

À ce stade, le pilote de débogage USB est installé sur l’ordinateur hôte, c’est pourquoi il est important de faire correspondre le bit de WinDbg au bitness de Windows. Une fois le pilote de débogage USB installé, vous pouvez utiliser la version 32 bits ou 64 bits de WinDbg pour les sessions de débogage suivantes.

Démarrer une session de débogage

Utilisation de WinDbg

Sur l’ordinateur hôte, ouvrez WinDbg. Dans le menu Fichier, choisissez Débogage du noyau. Dans la boîte de dialogue Débogage du noyau, ouvrez l’onglet USB . Entrez le nom cible que vous avez créé lors de la configuration de l’ordinateur cible. Cliquez sur OK.

Vous pouvez également démarrer une session avec WinDbg en entrant la commande suivante dans une fenêtre d’invite de commandes, où TargetName est le nom cible que vous avez créé lors de la configuration de l’ordinateur cible :

windbg /k usb:targetname=<TargetName>

Utilisation de KD

Sur l’ordinateur hôte, ouvrez une fenêtre d’invite de commandes et entrez la commande suivante, où TargetName est le nom cible que vous avez créé lorsque vous avez configuré l’ordinateur cible :

kd /k usb:targetname=<TargetName>

Redémarrez l’ordinateur cible

Une fois le débogueur connecté, redémarrez l’ordinateur cible. Une façon de redémarrer le PC consiste à utiliser la shutdown -r -t 0 commande à partir de l’invite de commandes d’un administrateur.

Après le redémarrage de l’ordinateur cible, le débogueur devrait se connecter automatiquement.

Dépannage

Périphérique USB non reconnu

Si une notification Windows s’affiche sur l’hôte avec le périphérique USB texte non reconnu lorsque vous insérez le câble de débogage, il est possible qu’un problème de compatibilité USB 3.1 à 3.1 connu soit atteint. Ce problème affecte les configurations de débogage lorsque le câble de débogage est connecté à un contrôleur USB 3.1 sur l’hôte et à un contrôleur USB Intel (Ice Lake ou Tiger Lake) 3.1 USB sur la cible.

Pour plus d’informations et des descriptions de modèles de processeur, consultez Ice Lake (microprocesseur) et Tiger Lake (microprocesseur). Pour rechercher le modèle de processeur de l’ordinateur cible, ouvrez l’application Paramètres, puis accédez au système, puis à propos. Le processeur est répertorié dans les spécifications de l’appareil.

Pour vérifier ce problème, ouvrez Gestionnaire de périphériques et recherchez l’appareil de connexion de débogage USB sous contrôleurs de bus série universel. Si cet appareil est introuvable, recherchez un appareil inconnu sous Autres appareils. Cliquez avec le bouton droit sur l’appareil pour ouvrir sa page de propriétés. La zone de texte d’état de l’appareil aura le texte que Windows a arrêté cet appareil, car il a signalé des problèmes (code 43) et le périphérique USB a retourné un descripteur USB BOS non valide.

Pour contourner ce problème, exécutez ces commandes à partir d’une invite de commandes d’administrateur pour apporter des modifications au Registre :

reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\usbflags\349500E00000 /v SkipBOSDescriptorQuery /t REG_DWORD /d 1 /f
reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\usbflags\045E06560000 /v SkipBOSDescriptorQuery /t REG_DWORD /d 1 /f

Ensuite, supprimez et réinsérez le câble de débogage.

La connexion retente les messages sur les fenêtres de la console du débogueur et ne peut pas entrer dans la cible - SkipPciProbeDebugDevice

Si vous rencontrez le message suivant dans la console du débogueur KDNET, ne peut pas lancer d’arrêt dans la cible ou rencontrer des problèmes avec certaines commandes (par exemple, kdfiles), il peut être dû à KDNET recevant un paquet ping hors séquence.

... Retry sending the same data packet for 128 times.

The transport connection between host kernel debugger and target Windows seems lost.
please try resync with target, recycle the host debugger, or reboot the target Windows.

Ce problème peut se produire, car le pilote pci.sys est incorrectement en cours de détection de l’appareil de débogage. Pour éliminer les erreurs, créez l’entrée de Registre suivante sur l’appareil TARGET à l’invite de commandes administrateur.

reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\SERVICES\kdnet /v SkipPciProbeDebugDevice /t REG_DWORD /d 1 /f

Redémarrez ensuite l’ordinateur cible.

shutdown /r /t 0

Une fois l’appareil redémarré, les erreurs doivent disparaître, et les commandes doivent fonctionner comme prévu.

Voir aussi

Configurer manuellement le débogage en mode noyau

Configuration automatique du débogage du noyau réseau KDNET

Configuration manuelle du débogage du noyau réseau KDNET

Configuration du débogage en mode noyau EEM DE KDNET USB (KDNET-EEM-USB)

Configuration du débogage en mode noyau DE KDNET USB (KDNET-USB)