Débogage de la phase status d'un transfert de contrôle USB

Les transferts de contrôle USB semblent simples jusqu'à ce qu'un périphérique échoue en phase status. Les utilisateurs cherchent « USB control transfer status stage », « zero length packet USB », « endpoint zero stall », « SETUP DATA STATUS USB », « control transfer timeout » ou « vendor request fails » quand les descripteurs marchent mais qu'une commande stall ou timeout.

Bus Scope est utile car les échecs de transfert de contrôle exigent de voir toutes les phases ensemble. Le setup packet seul ne suffit pas. La data stage et la status stage prouvent si l'hôte et le périphérique ont terminé la transaction.

Les phases d'un transfert de contrôle

Un transfert de contrôle comporte généralement :

• SETUP stage
• DATA stage (optionnelle)
• STATUS stage

La status stage utilise souvent un paquet de longueur zéro dans la direction opposée à la data stage. Elle confirme la complétion.

Si la status stage échoue, l'hôte peut signaler un timeout même si le périphérique a déjà échangé des données.

Confusion autour du paquet de longueur zéro

Un paquet de longueur zéro n'est pas automatiquement « pas de données » au sens applicatif. Dans les transferts de contrôle, il peut s'agir du handshake status requis.

Erreurs fréquentes :

• le firmware n'ACK pas la status stage
• l'hôte attend un paquet status de longueur zéro et reçoit STALL
• le périphérique envoie des données là où le status devrait être vide
• la commande vendor termine la data stage mais échoue sur le handshake final
• la machine à états du firmware oublie d'armer l'endpoint zéro

Ces bugs sont fréquents dans les commandes vendor et les bootloaders personnalisés.

L'endpoint zéro est particulier

L'endpoint zéro gère l'énumération et les requêtes de contrôle. Si son état est corrompu, le périphérique entier peut devenir instable.

Symptômes :

• l'énumération démarre mais échoue sur un descripteur ultérieur
• la requête vendor marche une fois puis stall
• le périphérique nécessite un débranchement/rebranchement après un transfert de contrôle
• SET_ADDRESS ou SET_CONFIGURATION est peu fiable
• HID Feature Report sur le chemin de contrôle échoue
• la requête DFU detach revient mais le périphérique ne change jamais de mode

Bus Scope doit montrer si l'endpoint zéro s'est récupéré après un stall ou est resté cassé.

Transferts de contrôle IN vs OUT

La direction du contrôle change la direction de la status stage.

Pour une requête IN :

• l'hôte envoie SETUP
• le périphérique envoie DATA
• l'hôte envoie un paquet OUT status de longueur zéro

Pour une requête OUT :

• l'hôte envoie SETUP
• l'hôte envoie DATA s'il y en a
• le périphérique envoie un paquet IN status de longueur zéro

Les bugs firmware surviennent souvent quand une direction est plus testée que l'autre.

Échecs de descripteurs vs commandes vendor

Les requêtes de descripteurs standard peuvent marcher parce qu'elles utilisent des chemins firmware bien testés. Les requêtes vendor peuvent échouer parce qu'un handler personnalisé gère mal la longueur, la direction ou la status stage.

Preuves :

• bmRequestType
• bRequest
• wValue
• wIndex
• wLength
• longueur de données réelle
• résultat de la status stage
• STALL, NAK, timeout ou reset

Les champs du setup packet doivent être interprétés avec le comportement observé des phases.

Checklist de débogage

Suivez ce flux :

1. Capturez le transfert de contrôle complet.
2. Décodez les champs SETUP.
3. Identifiez la direction du transfert.
4. Vérifiez la longueur de données attendue.
5. Vérifiez les octets de la data stage.
6. Vérifiez la direction de la status stage.
7. Cherchez un paquet de longueur zéro.
8. Vérifiez STALL ou timeout.
9. Comparez requêtes standard et vendor.
10. Conservez le comportement de récupération de l'endpoint zéro.

Diagnostic final

Les échecs de transfert de contrôle USB sont souvent des échecs de status stage, pas seulement des problèmes de setup packet. Les paquets de longueur zéro, l'état de l'endpoint zéro, la direction et le handshake final comptent.

Bus Scope aide les ingénieurs à prouver si un périphérique a échoué pendant SETUP, DATA, STATUS, la gestion ZLP, la récupération de l'endpoint zéro ou le traitement d'une commande vendor.