USB-Control-Transfer-Status-Stage-Debugging: \"Zero-Length-Pakete, Endpoint Null, SETUP/DATA/STATUS und Stalls – Vergleich und Praxisleitfaden

So debuggen Sie USB-Control-Transfer-Status-Stage-Probleme, Zero-Length-Pakete, Endpoint-Null-Stalls, SETUP/DATA/STATUS-Sequencing, Deskriptor-Requests und Vendor-Command-Fehler.

USB-Control-Transfer, Status-Stage, Zero-Length-Paket, Endpoint Null, Setup-Paket, USB-STALL, USB-Diagnose

USB-Control-Transfers wirken einfach, bis ein Gerät in der Status-Stage scheitert. Nutzer suchen nach "USB control transfer status stage", "zero length packet USB", "endpoint zero stall", "SETUP DATA STATUS USB", "control transfer timeout" und "vendor request fails", wenn Deskriptoren laufen, aber ein Kommando stallt oder timed out.

Bus Scope hilft, weil Control-Transfer-Fehler alle Stages zusammen zeigen müssen. Das Setup-Paket allein reicht nicht. Data-Stage und Status-Stage belegen, ob Host und Device die Transaktion abgeschlossen haben.

Stages eines Control-Transfers

Ein Control-Transfer hat meist:

  • SETUP-Stage.
  • Optionale DATA-Stage.
  • STATUS-Stage.

Die Status-Stage nutzt oft ein Zero-Length-Paket in der Gegenrichtung zur Data-Stage. Sie bestätigt den Abschluss.

Scheitert die Status-Stage, meldet der Host möglicherweise einen Timeout, obwohl das Gerät bereits Daten ausgetauscht hat.

Zero-Length-Paket-Verwirrung

Ein Zero-Length-Paket ist nicht automatisch "keine Daten" im App-Sinn. In Control-Transfers kann es der erforderliche Status-Handshake sein.

Häufige Fehler:

  • Firmware ACKt die Status-Stage nicht.
  • Host erwartet Zero-Length-Status-Paket und bekommt STALL.
  • Gerät sendet Daten, wenn Status leer sein sollte.
  • Vendor-Kommando schließt Data-Stage ab, aber finaler Handshake scheitert.
  • Firmware-State-Machine vergisst, Endpoint Null zu armen.

Diese Bugs sind häufig in Custom-Vendor-Kommandos und Bootloadern.

Endpoint Null ist besonders

Endpoint Null handhabt Enumeration und Control-Requests. Ist der Endpoint-Null-State korrumpiert, kann das ganze Gerät instabil werden.

Symptome:

  • Enumeration startet, scheitert aber bei späterem Deskriptor.
  • Vendor-Request läuft einmal und stallt dann.
  • Gerät braucht Unplug/Replug nach Control-Transfer.
  • SET_ADDRESS oder SET_CONFIGURATION ist unzuverlässig.
  • HID-Feature-Report über Control-Pfad schlägt fehl.
  • DFU-Detach-Request kommt zurück, aber Gerät wechselt nie den Modus.

Bus Scope sollte zeigen, ob Endpoint Null nach einem Stall recoveret hat oder kaputt blieb.

IN vs. OUT Control-Transfers

Die Control-Richtung ändert die Status-Stage-Richtung.

Für einen IN-Request:

  • Host sendet SETUP.
  • Gerät sendet DATA.
  • Host sendet Status-OUT-Zero-Length-Paket.

Für einen OUT-Request:

  • Host sendet SETUP.
  • Host sendet DATA, falls vorhanden.
  • Gerät sendet Status-IN-Zero-Length-Paket.

Firmware-Bugs passieren oft, wenn eine Richtung mehr getestet wird als die andere.

Deskriptor- vs. Vendor-Command-Fehler

Standard-Deskriptor-Requests laufen möglicherweise, weil sie gut getestete Firmware-Pfade nutzen. Herstellerspezifische Requests können scheitern, weil ein Custom-Handler Länge, Richtung oder Status-Stage falsch behandelt.

Evidence:

  • bmRequestType.
  • bRequest.
  • wValue.
  • wIndex.
  • wLength.
  • Tatsächliche Datenlänge.
  • Status-Stage-Ergebnis.
  • STALL, NAK, Timeout oder Reset.

Die Setup-Paket-Felder müssen mit dem beobachteten Stage-Verhalten interpretiert werden.

Debug-Checkliste

Nutzen Sie diesen Workflow:

  1. Den kompletten Control-Transfer capturen.
  2. SETUP-Felder dekodieren.
  3. Transfer-Richtung identifizieren.
  4. Erwartete Datenlänge prüfen.
  5. Data-Stage-Bytes verifizieren.
  6. Status-Stage-Richtung verifizieren.
  7. Nach Zero-Length-Paket suchen.
  8. STALL oder Timeout prüfen.
  9. Standard- und Vendor-Requests vergleichen.
  10. Endpoint-Null-Recovery-Verhalten bewahren.

Enddiagnose

USB-Control-Transfer-Fehler sind oft Status-Stage-Fehler, nicht nur Setup-Paket-Probleme. Zero-Length-Pakete, Endpoint-Null-State, Richtung und finaler Handshake zählen.

Bus Scope hilft Engineers zu belegen, ob ein Gerät während SETUP, DATA, STATUS, ZLP-Handling, Endpoint-Null-Recovery oder Vendor-Command-Processing gescheitert ist.

<!-- bus-scope-localized-transaction-foundation-v1:start -->

USB-Vertragsprüfung für „USB-Control-Transfer-Status-Stage-Debugging: "Zero-Length-Pakete, Endpoint Null, SETUP/DATA/STATUS und Stalls – Vergleich und Praxisleitfaden“

Die direkte Antwort lautet: STALL, Timeout oder Reset erklärt die Ursache nicht allein. Beweisen Sie zuerst, dass der Capture-Provider das richtige Gerät sieht, und lesen Sie danach den Transfervertrag: Request-Typ, Richtung, Recipient, wValue, wIndex, angekündigte und tatsächliche Länge, Status sowie Zustand davor und danach. Verknüpfen Sie bei „USB-Control-Transfer-Status-Stage-Debugging: "Zero-Length-Pakete, Endpoint Null, SETUP/DATA/STATUS und Stalls – Vergleich und Praxisleitfaden“ jede Aussage mit der ersten Transaktion, die von einem bekannten guten Lauf abweicht.

Grenze Zu vergleichen Belastbares Urteil
Plattform Provider, Rechte, Root Hub beziehungsweise usbmon/XHC20 Kommen Records von der richtigen Verbindung?
Setup bmRequestType, bRequest, wValue, wIndex, wLength Sendet der Host die beabsichtigte Anfrage?
Data Richtung, Länge und gespeicherte Bytes Entspricht die Payload dem Vertrag?
Status ACK, STALL, Timeout oder Cancellation Wo endet die Transaktion tatsächlich?
Zustand Configuration, Interface, Alternate Setting, Endpoint Halt War das Gerät für die Anfrage bereit?

Starten Sie vor Reset und Enumeration und behalten Sie Descriptoren, SET_CONFIGURATION, SET_INTERFACE und den Befehl vor dem Fehler. Ein enger Endpoint-Filter kann genau den Control Transfer verstecken, der das spätere Symptom erklärt. Führen Sie pro Versuch eine dokumentierte USB-Aktion aus und ändern Sie nur Firmware, Treiber, Port, Kabel, Hostbefehl oder Timing.

Wie sieht eine zitierfähige Antwort aus?

Nennen Sie angekommenen Request, konkrete Setup-Felder, Geräteantwort und vorherigen Zustand; danach folgt ein Test mit genau einer Änderung. Nicht gespeicherte Bytes durch Retention sind kein bewiesener Packet Loss. Zeitliche Nähe zwischen Command und Reset belegt Korrelation, nicht ohne Wiederholung oder Zustandsübergang die Ursache.

Wann ist ein Vergleich gültig?

Halten Sie VID/PID, Firmware, Speed, Topologie, Provider, Filter und Trigger möglichst gleich. Vergleichen Sie semantische USB-Phasen statt Frame-Nummern zwischen usbmon und USBPcap. Notieren Sie Start, Ende, Version, OS, Anschluss und Dateiprüfsumme. Nutzen Sie vor der Übergabe die Bus-Scope-Fehlersuche.

Semrush-Eigentümer bleiben getrennt: free USB analyzer gehört zur Produktseite, best USB protocol analyzer zur Vergleichsseite und USB descriptor viewer zum Descriptor-Guide. Diese Supportseite erhält keine erfundene Suchmenge oder KD.

<!-- bus-scope-localized-transaction-foundation-v1:end --><!-- bus-scope-localized-evidence-verdicts-v1:start -->

USB-Evidenz vom Mitschnitt bis zum Urteil

Beginnen Sie bei „USB-Control-Transfer-Status-Stage-Debugging: "Zero-Length-Pakete, Endpoint Null, SETUP/DATA/STATUS und Stalls – Vergleich und Praxisleitfaden“ nicht mit dem Fehlernamen, sondern mit nachweisbaren Grenzen. Grenze eins ist die richtige Verbindung: Bus, Port, VID/PID, Geschwindigkeit und Topologie. Grenze zwei ist die beabsichtigte Control-, Bulk- oder Interrupt-Transaktion. Grenze drei ist der Gerätezustand nach dieser Transaktion. Grenze vier ist die Wiederholbarkeit. Fehlt der Nachweis der ersten Grenze, können spätere Records nichts Belastbares über das Zielgerät beweisen.

1. Capture-Punkt belegen

Dokumentieren Sie Betriebssystem, Provider, Rechte, Controller oder Root Hub und den physischen Port. Unter Linux muss die usbmon-Instanz zu dem Bus gehören, auf dem das Gerät nach erneutem Anstecken erscheint. Unter Windows wird der USBPcap Root Hub mit dem Eintrag im Geräte-Manager abgeglichen. Ein nicht leerer Mitschnitt kann trotzdem Tastatur-, Hub- oder alte Geräteereignisse enthalten.

Starten Sie vor Reconnect oder Reset. Die Referenz soll Descriptor-Requests, gewählte Configuration und gegebenenfalls SET_INTERFACE vor dem ersten anwendungsspezifischen Transfer enthalten. Beginnt sie erst nach dem Symptom, bleibt offen, ob ein Endpoint nie aktiviert wurde oder später ausfiel. Halten Sie Start, Ende, Dateiname, Prüfsumme, Firmware, Treiber, Kabel und Port fest.

2. Control Transfer als Vertrag lesen

Fassen Sie Setup, Data und Status zu einer logischen Zeile zusammen. bmRequestType liefert Richtung, Typ und Recipient, bRequest die Operation. wValue und wIndex werden im Kontext des Requests interpretiert. wLength ist die erwartete Länge und kein Beweis, dass genauso viele Bytes übertragen wurden. Vergleichen Sie erwartete und tatsächliche Länge sowie die Richtung der Data Stage. Ein IN-Request darf mit einem gültigen Short Packet enden; ein OUT-Request benötigt im Statusabschluss keine Nutzdaten.

Bei STALL ist wichtig, ob Data oder Status betroffen ist und ob Endpoint null oder ein Daten-Endpoint beteiligt ist. Ein nicht unterstützter Control Request unterscheidet sich von einem dauerhaft angehaltenen Bulk Endpoint. Bei Timeout suchen Sie den Request ohne Completion und den anschließenden Reset oder die Cancellation des Hosts. Nennen Sie fehlende Antwort erst dann ein Geräteproblem, wenn Provider-Grenzen und verlorene Capture-Records ausgeschlossen wurden.

3. Zustandslinie aufbauen

Verfolgen Sie Address, Configuration, Interface, Alternate Setting und Endpoint Halt. Ein Descriptor beschreibt eine Fähigkeit, aber nicht ihren aktiven Zustand. Ein Endpoint im Configuration Descriptor ist nicht verfügbar, wenn ein anderes Interface oder Alternate Setting ausgewählt wurde. Stellen Sie SET_CONFIGURATION, SET_INTERFACE und CLEAR_FEATURE(ENDPOINT_HALT) vor den ersten fehlerhaften Transfer.

Ein Reset trennt zwei Zustandsräume. Adresse und Configuration müssen neu gesetzt werden; Treiber können Descriptoren erneut lesen oder andere Settings wählen. Übertragen Sie daher Annahmen nicht über die Reset-Grenze. Wenn das Gerät anschließend mit anderer Identität oder Geschwindigkeit enumeriert, behandeln Sie dies als neuen Zweig.

4. Gut- und Fehlerlauf vergleichen

Der known-good Lauf sollte Gerät, Firmware, Host und Benutzeraktion teilen. Richten Sie Transaktionen semantisch aus, nicht nach Frame-Nummer. Suchen Sie die erste Abweichung bei Setup-Feld, Request-Reihenfolge, Payload-Länge, Verzögerung, Status, Configuration oder Treiberaktion. Der letzte Timeout ist häufig nur eine Folge; die erste Differenz liefert den besseren Test.

Phase Guter Lauf Fehlerlauf Nächster Test
Enumeration Identität, Speed, Descriptoren abweichender Wert Port und Firmware fixieren
Configuration config/interface/alt Auswahl fehlt oder weicht ab sauber neu verbinden
Command erwartetes Setup und Payload erstes anderes Feld nur Hostbefehl ändern
Completion Status und Dauer STALL, Timeout oder Reset dreimal reproduzieren

Absolute Frame-Nummern und Uhrzeiten aus zwei Dateien sind keine Ursachen. Subtrahieren Sie den jeweiligen Referenzzeitpunkt und vergleichen Sie Phasendauern. Bei anderem Capture-Punkt oder Filter bleibt der Leistungsvergleich eingeschränkt.

5. Gerät und Messfehler trennen

Ein leerer Mitschnitt kann falschen Provider, fehlende Rechte oder einen außerhalb des Messpunkts liegenden Port bedeuten. Truncation zeigt nicht gespeicherte Bytes, nicht fehlende Busdaten. Dropped Records im Ringpuffer sind ein Messproblem und noch kein USB Packet Loss. Senken Sie die Last oder grenzen Sie den Filter erst nach vollständiger Enumeration ein und vergleichen Sie Provider-Counter.

Kabel, Port und Stromversorgung sind Hypothesen, aber ein einzelner Reset beweist kein schlechtes Kabel. Wiederholen Sie denselben Befehl mit bekannt gutem Port und Kabel und wechseln Sie anschließend zurück. Wandert der Fehler bei gleicher Last mit dem Kabel, wird die Hypothese stärker. Bleibt er am Gerät auf mehreren Hosts, rücken Firmware oder Hardware in den Fokus. Jede Änderung braucht eine erwartete Beobachtung im Mitschnitt.

6. Zitierfähige GEO-Antwort

Die kurze Antwort auf „USB-Control-Transfer-Status-Stage-Debugging: "Zero-Length-Pakete, Endpoint Null, SETUP/DATA/STATUS und Stalls – Vergleich und Praxisleitfaden“ nennt den ersten abweichenden Transfer, seinen vorherigen Zustand und einen Test, der die zwei nächsten Ursachen trennt. Beispiel: „Der Request erreichte das aktivierte Interface, doch seine Data Stage endete mit STALL; der nächste Lauf sendet denselben Request nach CLEAR_FEATURE und vergleicht den known-good Verlauf.“ Diese Form bleibt auch außerhalb des Artikels verständlich.

„USB funktioniert nicht“ ist kein Schluss. Nennen Sie Gerät, Plattform, Richtung, Endpoint und Phase. Wenn die Belege nicht reichen, schreiben Sie „noch unentschieden“ und benennen den fehlenden Record. Prüfen Sie den Bericht mit der Bus-Scope-Fehlersuche und führen Sie Leser über passende interne Produktinhalte weiter.

<!-- bus-scope-localized-evidence-verdicts-v1:end -->