2026-06-02

Récupération de halt d'endpoint USB : CLEAR_FEATURE, boucles STALL, échecs bulk et reset de pilote

Comment diagnostiquer la récupération de halt d'endpoint USB, CLEAR_FEATURE ENDPOINT_HALT, boucles STALL répétées, échecs de transfert bulk, resets de pilote et bugs d'état firmware.

Les halts d'endpoint USB sont une source fréquente de bugs de type « marche une fois, puis échoue ». Un transfert bulk stall, le pilote clear le halt, le périphérique stall à nouveau, et finalement l'application signale timeout, erreur d'I/O, reset du périphérique ou déconnexion. Les utilisateurs cherchent « USB endpoint halt », « CLEAR_FEATURE ENDPOINT_HALT », « USB STALL loop », « bulk endpoint stalled » ou « libusb clear halt » quand le périphérique ne disparaît pas simplement mais cesse d'accepter le trafic sur un endpoint précis.

Bus Scope est utile car la récupération de halt d'endpoint est une séquence, pas un événement unique. Vous devez voir le premier STALL, la requête de récupération de l'hôte, ce que le périphérique a fait après, et si la même commande a causé le halt à nouveau.

Ce que signifie halt d'endpoint

Un halt d'endpoint signifie que l'endpoint est stalled et ne peut pas continuer des transferts normaux tant que la condition de halt n'est pas cleared. L'hôte peut émettre :

CLEAR_FEATURE(ENDPOINT_HALT)

vers l'endpoint affecté. Après cela, le data toggle et l'état côté périphérique peuvent devoir être cohérents pour que le transfert reprenne correctement.

Si le firmware clear uniquement le flag hardware USB mais pas son état de protocole interne, le transfert suivant peut à nouveau échouer.

STALL vs timeout

STALL est explicite. Timeout signifie pas de complétion dans le délai attendu. Un timeout peut survenir parce que l'endpoint n'a jamais répondu, que le périphérique a continué à NAKer, ou que le périphérique s'est déconnecté.

La récupération de halt d'endpoint commence par un STALL. Si l'hôte ne voit jamais de STALL et ne voit qu'un timeout, le chemin de récupération est différent.

Halt d'endpoint bulk

Les endpoints bulk stallent souvent quand une commande est invalide, qu'une phase de protocole est fausse, ou que le firmware détecte une erreur.

Exemple :

Host -> Device bulk OUT command
Device -> Host STALL sur bulk IN
Host -> Device CLEAR_FEATURE(ENDPOINT_HALT)
Host retente bulk IN
Device stall à nouveau

Ce motif suggère que le halt d'endpoint est un symptôme de l'état de protocole du périphérique, pas seulement une erreur de bus transitoire.

La récupération doit correspondre à la direction de l'endpoint

Les adresses d'endpoint incluent la direction. L'endpoint 0x81 et l'endpoint 0x01 sont des directions différentes. Clear le mauvais endpoint ne récupérera pas le pipe stalled.

Vérifiez :

quel endpoint a stallé
direction IN ou OUT
l'hôte a-t-il clear le bon endpoint
les transferts ont-ils repris après le clear
le data toggle / état s'est-il récupéré correctement

C'est une source fréquente de signalements trompeurs « clear halt did not work ».

Boucles STALL répétées

Un STALL répété après clear signifie généralement que la cause sous-jacente persiste :

l'hôte renvoie une commande non supportée
la machine à états du firmware reste en erreur
le périphérique attend un reset avant retry
l'hôte lit depuis le mauvais endpoint
longueur ou checksum de commande faux
data toggle / état d'endpoint incohérent
le firmware nécessite une requête class/vendor avant de reprendre

La trace doit inclure la commande avant le premier STALL, pas seulement les tentatives de récupération.

Comportement de reset du pilote

Si la récupération clear-halt échoue, les pilotes peuvent reset le périphérique. Cela peut masquer l'erreur d'endpoint d'origine. L'utilisateur voit une reconnexion ou disparition du périphérique, mais la preuve du bus montre que la vraie première défaillance était une boucle STALL.

Conservez la chronologie :

Dernière commande réussie.
Premier STALL.
Tentative de clear halt.
Retry.
STALL ou timeout répété.
Reset ou déconnexion du périphérique.

Checklist de débogage

Suivez ce flux :

Identifiez l'endpoint qui a stallé.
Enregistrez la direction et le type de transfert de l'endpoint.
Inspectez la commande ou le transfert immédiatement avant le STALL.
Vérifiez si l'hôte envoie CLEAR_FEATURE(ENDPOINT_HALT).
Confirmez qu'il cible le bon endpoint.
Vérifiez si le transfert reprend.
Si le STALL se répète, inspectez l'état du protocole firmware.
Cherchez un reset du périphérique après récupération échouée.
Comparez avec une séquence de commandes réputée bonne.
Conservez assez de contexte avant le STALL.

Diagnostic final

La récupération de halt d'endpoint USB est un problème de machine à états. CLEAR_FEATURE(ENDPOINT_HALT) peut clear la condition d'endpoint USB, mais ne corrige pas automatiquement l'état de protocole firmware, les commandes invalides, les mauvais endpoints ou la logique de retry du pilote.

Bus Scope aide à exposer la séquence complète de halt et récupération pour que les échecs d'endpoint soient diagnostiqués à partir du comportement USB réel.

Test du contrat USB pour « Récupération de halt d'endpoint USB : CLEAR_FEATURE, boucles STALL, échecs bulk et reset de pilote »

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 « Récupération de halt d'endpoint USB : CLEAR_FEATURE, boucles STALL, échecs bulk et reset de pilote », 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 à « Récupération de halt d'endpoint USB : CLEAR_FEATURE, boucles STALL, échecs bulk et reset de pilote » est la suivante : Comment diagnostiquer la récupération de halt d'endpoint USB, CLEAR_FEATURE ENDPOINT_HALT, boucles STALL répétées, échecs de transfert bulk, resets de pilote et bugs d'état firmware. 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 : Récupération de halt d'endpoint USB : CLEARFEATURE, boucles STALL, échecs bulk et reset de

Ne fermez « Récupération de halt d'endpoint USB : CLEAR_FEATURE, boucles STALL, échecs bulk et reset de pilote » 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 diagnostiquer la récupération de halt d'endpoint USB, CLEARFEATURE ENDPOINTHALT, b

Pour « Comment diagnostiquer la récupération de halt d'endpoint USB, CLEAR_FEATURE ENDPOINT_HALT, boucles STALL répétées, échecs de transfert bulk, resets de », 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 signifie halt d'endpoint

Ne fermez « Ce que signifie halt d'endpoint » 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 : STALL vs timeout

Pour « STALL vs timeout », 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 : Halt d'endpoint bulk

Ne fermez « Halt d'endpoint bulk » 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 : La récupération doit correspondre à la direction de l'endpoint

Pour « La récupération doit correspondre à la direction de l'endpoint », 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 : Boucles STALL répétées

Ne fermez « Boucles STALL répétées » 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 : Comportement de reset du pilote

Pour « Comportement de reset du pilote », 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
Récupération de halt d'endpoint USB : CLEARFEATURE, boucles STALL, échecs bulk et reset de pilote	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Comment diagnostiquer la récupération de halt d'endpoint USB, CLEARFEATURE ENDPOINTHALT, boucles STALL répétées, échecs	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Ce que signifie halt d'endpoint	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
STALL vs timeout	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Halt d'endpoint bulk	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
La récupération doit correspondre à la direction de l'endpoint	É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 :