2026-06-03

Débogage des descripteurs string USB et LANGID

Comment déboguer les descripteurs string USB, échecs de requêtes LANGID, bugs de descripteur de numéro de série, noms manufacturer/product, numéros de série dupliqués et problèmes de liaison de pilote.

Les descripteurs string USB semblent inoffensifs, mais de mauvais strings peuvent casser la liaison de pilote, l'identité du périphérique, la persistance du port série, l'automatisation de laboratoire, les outils de mise à jour firmware et les flux de support. Les utilisateurs cherchent « USB string descriptor failed », « LANGID descriptor », « USB serial number descriptor missing », « duplicate USB serial number », « USB product string wrong » ou « Windows shows unknown USB device name » quand le périphérique s'énumère mais que l'identité est instable.

Bus Scope est utile car les échecs de descripteurs string surviennent pendant l'énumération comme transferts de contrôle. L'hôte demande les language IDs supportés, puis les strings manufacturer, product et numéro de série. Si une étape renvoie des données mal formées, l'OS peut continuer mais stocker une mauvaise identité.

Descripteur LANGID

Avant de demander des strings spécifiques, l'hôte peut demander le descripteur string zéro. Celui-ci renvoie les language IDs supportés.

Preuve typique :

GET_DESCRIPTOR String index 0
LANGID list retournée
GET_DESCRIPTOR String index 1
GET_DESCRIPTOR String index 2
GET_DESCRIPTOR String index 3

Si le descripteur string zéro échoue, les requêtes de string ultérieures peuvent se comporter de façon incohérente entre hôtes.

Strings manufacturer, product et série

Index de string courants :

iManufacturer
iProduct
iSerialNumber

Ces champs sont référencés depuis le Device Descriptor. Si le périphérique annonce un index de string non nul mais échoue à renvoyer le string, le comportement de l'hôte peut varier.

Symptômes :

Le périphérique apparaît comme « Unknown Device ».
Le nom produit est brouillé.
Le numéro de série est vide.
Windows crée un nouveau port COM à chaque branchement.
Les règles udev Linux ne matchent pas de façon fiable.
L'outil de mise à jour firmware ne peut pas identifier la cible.
Plusieurs unités se collapsent en une seule identité.

Numéros de série dupliqués

Les numéros de série USB dupliqués sont un sérieux problème de production. Deux périphériques physiques avec le même VID, PID et numéro de série peuvent être traités comme la même instance de périphérique.

Conséquences :

Mauvaises données de calibration chargées.
La station de test écrit des logs vers la mauvaise unité.
L'attribution de port COM change de façon imprévisible.
Le licensing ou provisioning se lie au mauvais hardware.
Le support terrain ne peut pas distinguer les périphériques.

La capture de paquets peut prouver si les octets du descripteur série sont réellement dupliqués ou si la couche d'affichage OS cache un problème plus profond.

Numéro de série manquant

Certains périphériques omettent volontairement un numéro de série. C'est acceptable pour des périphériques simples, mais cela pose problème quand une identité stable compte.

Termes de recherche fréquents :

« USB device new COM port every time »
« USB serial number missing »
« Windows USB device instance path changes »
« Linux udev match USB serial »

Si le numéro de série est manquant, l'OS peut identifier le périphérique par la topologie de port plutôt que par l'identité hardware.

Strings UTF-16LE mal formés

Les strings USB sont encodés en Unicode. Bugs firmware :

Mauvaise longueur de descripteur.
Compte d'octets impair.
Type de descripteur manquant.
Octets UTF-16LE invalides.
Attente de terminaison null non satisfaite.
Renvoi d'octets ASCII au lieu du format string USB.
Troncature de longs numéros de série.

Certains hôtes le tolèrent. D'autres rejettent le descripteur ou affichent du texte corrompu.

Timing de requête string et retries

Les hôtes peuvent demander le même string plusieurs fois avec des longueurs différentes. Un périphérique doit gérer à la fois les requêtes courtes de probe et les requêtes en pleine longueur.

Motifs de défaillance :

Le périphérique renvoie les 2 premiers octets corrects mais échoue la requête complète.
Le firmware suppose que wLength égale toujours la longueur du descripteur.
L'endpoint de contrôle stall sur les requêtes string répétées.
Le périphérique renvoie un numéro de série différent après reset.
Le bootloader et le firmware applicatif rapportent des identités différentes.

C'est fréquent dans les flux de mise à jour firmware.

Impact sur la liaison de pilote

La sélection du pilote dépend généralement de VID/PID/class, mais les descripteurs string affectent l'identité visible par l'utilisateur et parfois les outils vendor. Les périphériques composites, CDC série, HID et DFU bootloaders s'appuient souvent sur les strings pour le support et l'automatisation.

Si un ticket de support dit « wrong USB device name », ne le balayez pas comme cosmétique. Il peut indiquer une corruption de descripteur ou une confusion d'état firmware.

Checklist de débogage

Suivez ce processus :

Capturez l'énumération depuis le branchement.
Inspectez les index de string du Device Descriptor.
Vérifiez le descripteur string zéro pour le LANGID.
Décodez le string manufacturer.
Décodez le string product.
Décodez le string numéro de série.
Comparez deux unités physiques.
Comparez le bootloader et le firmware applicatif.
Vérifiez le comportement après reset et rebranchement.
Conservez les octets de descripteurs bruts pour les correctifs firmware.

Diagnostic final

Les problèmes de descripteurs string USB et LANGID affectent l'identité du périphérique, la persistance série, les tests de fabrication, le support terrain et les flux de pilote. La preuve clé n'est pas le label de l'OS mais les transferts de contrôle de descripteurs réels.

Bus Scope aide à montrer LANGID, manufacturer, product, numéro de série, strings mal formés, séries dupliquées et retries d'énumération dans une vue diagnostique unique.

Test du contrat USB pour « Débogage des descripteurs string USB et LANGID »

La réponse directe est qu’un STALL, timeout ou reset n’explique pas seul la cause. Prouvez d’abord que le fournisseur voit le bon périphérique, puis lisez le contrat du transfer : type, direction, recipient, wValue, wIndex, longueur annoncée et réelle, status et état avant/après. Pour « Débogage des descripteurs string USB et LANGID », reliez la conclusion à la première transaction différente d’un cas nominal.

Limite	Comparaison	Décision
Plateforme	fournisseur, droits, Root Hub ou usbmon/XHC20	Les records viennent-ils de la bonne connexion ?
Setup	bmRequestType, bRequest, wValue, wIndex, wLength	L’hôte envoie-t-il la requête prévue ?
Data	direction, longueur et bytes conservés	Le payload respecte-t-il le contrat ?
Status	ACK, STALL, timeout ou cancellation	Où finit réellement la transaction ?
État	configuration, interface, alternate setting, endpoint halt	Le périphérique était-il prêt ?

Commencez avant reset et énumération et gardez descriptors, SET_CONFIGURATION, SET_INTERFACE et la commande avant défaut. Un filtre endpoint étroit peut masquer le control transfer décisif. Exécutez une seule action USB documentée par essai et ne changez que firmware, driver, port, câble, commande ou timing.

Comment rédiger une réponse réutilisable ?

Nommez requête, champs setup, réponse et contexte précédent, puis un test à variable unique. Des bytes non retenus ne prouvent pas packet loss. La proximité entre command et reset établit une corrélation, pas la cause sans répétition ou transition d’état.

Quand la comparaison est-elle valide ?

Gardez VID/PID, firmware, speed, topologie, fournisseur, filtre et trigger. Comparez les phases USB sémantiques, pas les frame numbers entre usbmon et USBPcap. Notez début, fin, version, OS, connexion et checksum. Consultez le dépannage Bus Scope.

Les propriétaires Semrush restent distincts : free USB analyzer sur la page produit, best USB protocol analyzer dans la comparaison et USB descriptor viewer dans le guide descriptor. Aucun volume ou KD n’est inventé pour cette page de support.

Réponse directe et limite d’acceptation

La réponse courte à « Débogage des descripteurs string USB et LANGID » est la suivante : Comment déboguer les descripteurs string USB, échecs de requêtes LANGID, bugs de descripteur de numéro de série, noms manufacturer/product, numéros de série dupliqués et problèmes de liaison de pilote. Considérez cette phrase comme un résultat à vérifier, et non comme une promesse valable pour toute entrée, tout appareil, tout projet ou tout environnement. Un résultat complet consigne l’état initial, l’action exacte, la sortie visible et la condition qui prouve la fin de la tâche dans Bus Scope.

Procédure fondée sur les preuves

Commencez par un cas petit et répétable avant de modifier un projet complet. Notez version de l’application, système, identité de l’entrée ou de l’appareil, réglages pertinents et résultat attendu. Exécutez une action volontaire, conservez la première transition inattendue et comparez-la à un cas nominal si possible. Plusieurs changements simultanés masquent la condition qui a créé ou corrigé le problème.

Point de contrôle 1 : Débogage des descripteurs string USB et LANGID

Traitez « Débogage des descripteurs string USB et LANGID » comme une porte d’acceptation distincte pour « Débogage des descripteurs string USB et LANGID ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 2 : Comment déboguer les descripteurs string USB, échecs de requêtes LANGID, bugs de descripte

Transformez « Comment déboguer les descripteurs string USB, échecs de requêtes LANGID, bugs de descripteur de numéro de série, noms manufacturer/product, numéros de » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 3 : Descripteur LANGID

Traitez « Descripteur LANGID » comme une porte d’acceptation distincte pour « Débogage des descripteurs string USB et LANGID ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 4 : Strings manufacturer, product et série

Transformez « Strings manufacturer, product et série » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 5 : Numéros de série dupliqués

Traitez « Numéros de série dupliqués » comme une porte d’acceptation distincte pour « Débogage des descripteurs string USB et LANGID ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 6 : Numéro de série manquant

Transformez « Numéro de série manquant » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 7 : Strings UTF-16LE mal formés

Traitez « Strings UTF-16LE mal formés » comme une porte d’acceptation distincte pour « Débogage des descripteurs string USB et LANGID ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 8 : Timing de requête string et retries

Transformez « Timing de requête string et retries » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 9 : Impact sur la liaison de pilote

Traitez « Impact sur la liaison de pilote » comme une porte d’acceptation distincte pour « Débogage des descripteurs string USB et LANGID ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 10 : Checklist de débogage

Transformez « Checklist de débogage » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Matrice d’acceptation

Point	Preuve à conserver	Critère de réussite
Débogage des descripteurs string USB et LANGID	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Comment déboguer les descripteurs string USB, échecs de requêtes LANGID, bugs de descripteur de numéro de série, noms ma	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Descripteur LANGID	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Strings manufacturer, product et série	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Numéros de série dupliqués	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Numéro de série manquant	État initial, une action et état obtenu	Une seconde personne reproduit le résultat

Isolation, reprise et transmission

Arrêtez-vous à la première limite en échec. Conservez source, projet, session ou capture, dupliquez avant toute modification destructive et changez une variable par essai. Rejouer un flux entier après plusieurs changements peut modifier le résultat sans expliquer pourquoi.

Distinguez absence de preuve et preuve d’absence. Une vue vide peut signaler mauvaise entrée, portée, filtre, permission, appareil, période ou état du projet. Vérifiez acquisition ou import avant d’interpréter décodeur, éditeur, rapport ou export.

Avant transmission, rouvrez l’artefact durable et inspectez début, point de décision et fin. Notez version, plateforme, configuration, attente, observation et reproduction minimale. Retirez ou masquez les données sensibles et confirmez l’autorisation du destinataire.

Questions et réponses

Quelle est la manière fiable la plus rapide de commencer ?

Utilisez le plus petit cas représentatif, écrivez le résultat attendu et ne changez qu’une variable. Validez le parcours de base avant d’ajouter filtres, effets, modifications, automatisation ou grande source.

Quelles preuves faut-il conserver ?

Gardez identité de l’entrée, version, plateforme, réglages, action exacte, première transition inattendue et sortie finale. Fermez puis rouvrez projet, session, rapport ou export avant de le considérer durable.

Quand faut-il répéter la procédure ?

Répétez-la après un changement pertinent d’application, système, pilote, firmware, modèle, source ou processus. Conservez le cas accepté précédent comme référence non modifiée.

Quand le résultat est-il transmissible ?

Lorsqu’une seconde personne autorisée identifie l’entrée, répète l’action, obtient le même résultat, comprend les limites et ouvre l’artefact sans état local non documenté.

Guides associés

Ces pages dans la même langue couvrent les étapes voisines sans changer le propriétaire canonique du sujet :