2026-06-03

Débogage USB CDC ACM DTR et RTS : SetControlLineState, ouvertures de port série, reset bootloader et données manquantes

Comment déboguer l'état des lignes de contrôle DTR et RTS en USB CDC ACM, les requêtes SetControlLineState, le comportement d'ouverture du port série, les déclencheurs de reset bootloader et les données série manquantes.

Les périphériques USB CDC ACM ressemblent à des ports série, mais beaucoup de bugs « port série » sont en réalité des bugs de contrôle de classe USB. Les utilisateurs cherchent « CDC ACM DTR RTS », « SetControlLineState USB », « USB serial no data until DTR », « Arduino resets when serial port opens », « USB CDC bootloader reset » ou « COM port opens but device does not respond » quand le port existe mais que le comportement est faux.

Bus Scope est utile car DTR et RTS ne sont pas de simples flags applicatifs magiques. L'hôte envoie des requêtes de contrôle spécifiques à la classe, et le firmware réagit à ces requêtes.

Ce que fait SetControlLineState

CDC ACM utilise une requête de classe communément appelée SetControlLineState. Elle communique l'état des lignes de contrôle telles que :

DTR : Data Terminal Ready
RTS : Request To Send

Beaucoup de périphériques utilisent ces bits au-delà du simple comportement modem traditionnel. Le firmware peut commencer à streamer uniquement après l'assertion de DTR, entrer en bootloader quand DTR bascule, ou utiliser RTS pour la sémantique de contrôle de flux.

Symptômes courants

Les problèmes de lignes de contrôle se manifestent par :

le port COM s'ouvre mais aucune donnée n'arrive
le périphérique commence à émettre seulement après la connexion du programme terminal
le firmware reset à l'ouverture d'un moniteur série
le bootloader apparaît après ouverture/fermeture du port
les données s'arrêtent quand DTR retombe
l'option de contrôle de flux RTS/CTS change le comportement
outil Linux marche mais outil Windows non
script Python qui se comporte différemment d'un émulateur de terminal

Ces formulations correspondent aux symptômes que les ingénieurs décrivent quand ils essaient de reproduire la défaillance.

Comportement d'ouverture du port série

Différentes applications hôtes positionnent DTR et RTS différemment à l'ouverture du port.

Exemples :

un émulateur de terminal assert DTR immédiatement
un script ouvre le port mais laisse DTR à false
un outil de mise à jour firmware toggle DTR comme signal de reset
le pilote positionne RTS selon les réglages de contrôle de flux
l'application ferme le port et lâche DTR de façon inattendue

La trace de paquets peut montrer la séquence réelle des requêtes de contrôle au lieu de s'appuyer sur les hypothèses applicatives.

Motifs de reset bootloader

Beaucoup de cartes de développement utilisent les transitions DTR ou RTS pour reset en mode bootloader. C'est pratique pour l'upload du firmware, mais surprenant dans les outils de production.

Motifs de défaillance :

le périphérique reset à chaque ouverture d'un viewer de logs
l'upload du firmware marche mais la connexion série normale échoue
le périphérique apparaît sous une identité USB, reset, puis se ré-énumère en bootloader
le numéro de série ou la chaîne produit change après reset
l'application perd le handle du port

Bus Scope doit conserver la requête de contrôle et la séquence de ré-énumération.

Pas de données tant que DTR n'est pas asserté

Certains firmwares attendent volontairement DTR avant d'envoyer des données. Cela peut faire apparaître un outil comme cassé alors qu'un autre fonctionne.

Preuves :

l'hôte ouvre les endpoints bulk ou interrupt
aucune donnée IN n'est envoyée
l'hôte envoie SetControlLineState avec DTR à true
le périphérique commence à transmettre

Ce n'est pas un problème de câble et pas nécessairement un bug de pilote. C'est une politique firmware.

Confusion RTS et contrôle de flux

RTS peut servir au contrôle de flux matériel, mais beaucoup de périphériques USB CDC n'ont pas de vraies lignes modem. Le firmware peut quand même exposer l'état RTS à la logique applicative.

Questions :

l'hôte positionne-t-il RTS ?
le périphérique requiert-il RTS avant d'émettre ?
activer le contrôle de flux matériel dans le terminal change-t-il les bits de la requête ?
le firmware ignore-t-il RTS alors que la documentation prétend le contraire ?
RTS est-il utilisé comme signal bootloader ou sélecteur de mode ?

Les preuves de paquets évitent de deviner.

Checklist de débogage

Suivez ce processus :

Capturez l'énumération.
Ouvrez le port série avec l'application défaillante.
Enregistrez les requêtes spécifiques à la classe CDC.
Trouvez SetControlLineState.
Décodez les bits DTR et RTS.
Comparez avec un programme terminal fonctionnel.
Vérifiez si les données démarrent après DTR.
Vérifiez si un reset ou une ré-énumération suit un toggle.
Comparez les outils Windows et Linux.
Conservez ensemble les requêtes de contrôle et les premiers paquets de données.

Diagnostic final

Les problèmes USB CDC ACM DTR et RTS sont des problèmes d'ordonnancement de contrôle de classe. Le port peut exister et les pilotes peuvent se lier correctement alors que le firmware attend un état de ligne de contrôle que l'application n'envoie jamais.

Bus Scope aide à montrer SetControlLineState, DTR, RTS, le comportement d'ouverture série, les resets bootloader et les causes de données manquantes au niveau du protocole USB.

Test du contrat USB pour « Débogage USB CDC ACM DTR et RTS : SetControlLineState, ouvertures de port série, reset bootloader et données manquantes »

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 USB CDC ACM DTR et RTS : SetControlLineState, ouvertures de port série, reset bootloader et données manquantes », 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 USB CDC ACM DTR et RTS : SetControlLineState, ouvertures de port série, reset bootloader et données manquantes » est la suivante : Comment déboguer l'état des lignes de contrôle DTR et RTS en USB CDC ACM, les requêtes SetControlLineState, le comportement d'ouverture du port série, les déclencheurs de reset bootloader et les données série manquantes. 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 USB CDC ACM DTR et RTS : SetControlLineState, ouvertures de port série, reset boo

Ne fermez « Débogage USB CDC ACM DTR et RTS : SetControlLineState, ouvertures de port série, reset bootloader et données manquantes » que lorsque le résultat enregistré, exporté ou rouvert correspond encore à l’état observé. Le retour temporaire de l’interface aide, mais une preuve durable est plus forte. Consignez toute limite restante pour la suite.

Point de contrôle 2 : Comment déboguer l'état des lignes de contrôle DTR et RTS en USB CDC ACM, les requêtes Set

Pour « Comment déboguer l'état des lignes de contrôle DTR et RTS en USB CDC ACM, les requêtes SetControlLineState, le comportement d'ouverture du port série, », séparez une décision du produit d’une limite du système, du matériel, du fichier source, des droits ou du processus. Confirmez la couche qui fournit la preuve avant d’attribuer une cause. Un symptôme voisin ne devient ainsi pas une cause racine prétendument prouvée.

Point de contrôle 3 : Ce que fait SetControlLineState

Ne fermez « Ce que fait SetControlLineState » que lorsque le résultat enregistré, exporté ou rouvert correspond encore à l’état observé. Le retour temporaire de l’interface aide, mais une preuve durable est plus forte. Consignez toute limite restante pour la suite.

Point de contrôle 4 : Symptômes courants

Pour « Symptômes courants », séparez une décision du produit d’une limite du système, du matériel, du fichier source, des droits ou du processus. Confirmez la couche qui fournit la preuve avant d’attribuer une cause. Un symptôme voisin ne devient ainsi pas une cause racine prétendument prouvée.

Point de contrôle 5 : Comportement d'ouverture du port série

Ne fermez « Comportement d'ouverture du port série » que lorsque le résultat enregistré, exporté ou rouvert correspond encore à l’état observé. Le retour temporaire de l’interface aide, mais une preuve durable est plus forte. Consignez toute limite restante pour la suite.

Point de contrôle 6 : Motifs de reset bootloader

Pour « Motifs de reset bootloader », séparez une décision du produit d’une limite du système, du matériel, du fichier source, des droits ou du processus. Confirmez la couche qui fournit la preuve avant d’attribuer une cause. Un symptôme voisin ne devient ainsi pas une cause racine prétendument prouvée.

Point de contrôle 7 : Pas de données tant que DTR n'est pas asserté

Ne fermez « Pas de données tant que DTR n'est pas asserté » que lorsque le résultat enregistré, exporté ou rouvert correspond encore à l’état observé. Le retour temporaire de l’interface aide, mais une preuve durable est plus forte. Consignez toute limite restante pour la suite.

Point de contrôle 8 : Confusion RTS et contrôle de flux

Pour « Confusion RTS et contrôle de flux », séparez une décision du produit d’une limite du système, du matériel, du fichier source, des droits ou du processus. Confirmez la couche qui fournit la preuve avant d’attribuer une cause. Un symptôme voisin ne devient ainsi pas une cause racine prétendument prouvée.

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

Ne fermez « Checklist de débogage » que lorsque le résultat enregistré, exporté ou rouvert correspond encore à l’état observé. Le retour temporaire de l’interface aide, mais une preuve durable est plus forte. Consignez toute limite restante pour la suite.

Point de contrôle 10 : Diagnostic final

Pour « Diagnostic final », séparez une décision du produit d’une limite du système, du matériel, du fichier source, des droits ou du processus. Confirmez la couche qui fournit la preuve avant d’attribuer une cause. Un symptôme voisin ne devient ainsi pas une cause racine prétendument prouvée.

Matrice d’acceptation

Point	Preuve à conserver	Critère de réussite
Débogage USB CDC ACM DTR et RTS : SetControlLineState, ouvertures de port série, reset bootloader et données manquantes	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Comment déboguer l'état des lignes de contrôle DTR et RTS en USB CDC ACM, les requêtes SetControlLineState, le comportem	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Ce que fait SetControlLineState	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Symptômes courants	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Comportement d'ouverture du port série	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Motifs de reset bootloader	É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 :