USB-Endpoint-Max-Packet-Size-Mismatch: \"wMaxPacketSize, Short-Pakete, Bulk-Transfers und Firmware-Buffer-Bugs debuggen – Vergleich und Praxisleitfaden

USB-Endpoint-wMaxPacketSize sieht nach einem kleinen Deskriptor-Feld aus, aber ein falscher Wert kann Bulk-Transfers, Interrupt-Reports, High-Speed-Betrieb, Firmware-Buffering und Host-Treiber-Annahmen zerbrechen. Nutzer suchen nach "USB wMaxPacketSize mismatch", "USB short packet problem", "bulk transfer stops at 64 bytes", "USB endpoint packet size high speed full speed" und "USB descriptor max packet size bug", wenn Transfers nur bei bestimmten Größen oder Speeds fehlschlagen.

Bus Scope hilft, weil der Fehler erst sichtbar wird, wenn Deskriptoren und Transfer-Pakete zusammen verglichen werden. Der Deskriptor kann eine Paketgröße behaupten, während Firmware, Host-Code oder Endpoint-Hardware sich wie eine andere verhalten.

Was wMaxPacketSize steuert

Jeder Endpoint-Deskriptor enthält wMaxPacketSize. Er sagt dem Host die maximale Paket-Payload für diesen Endpoint. Typische Werte hängen von Speed und Endpoint-Typ ab.

Beispiele:

• Full-Speed-Bulk-Endpoint nutzt oft 64 Bytes.
• High-Speed-Bulk-Endpoint nutzt oft 512 Bytes.
• Interrupt-Endpoints variieren je nach Speed und Intervall.
• Isochronous-Endpoints nutzen bandbreiten-spezifische Paketgrößen.

Konfiguriert die Firmware Endpoint-Buffer für 64 Bytes, wirbt aber mit 512 Bytes, sendet der Host möglicherweise Transfers, die das Gerät nicht korrekt verarbeiten kann.

Häufige Symptome

Endpoint-Max-Packet-Size-Bugs können auftreten als:

• Bulk-Transfer läuft für kleine Messages, scheitert aber für große.
• Gerät läuft bei Full-Speed, scheitert aber bei High-Speed.
• Transfer stoppt nach genau 64 Bytes.
• Host wartet ewig auf ein Short-Paket.
• Firmware empfängt Split-Daten unerwartet.
• Gerät stalled OUT-Transfers.
• IN-Transfers geben truncated Daten zurück.
• Treiber meldet Timeout trotz existierendem Traffic.
• Composite-Device läuft auf einem Interface, aber nicht auf einem anderen.

Die exakte Byte-Anzahl ist oft der Hinweis.

Short-Paket-Verhalten

USB-Bulk-Transfers nutzen oft Short-Pakete, um das Ende eines Transfers zu signalisieren, wenn die angefragte Länge größer als die tatsächlichen Daten ist. Gibt das Gerät genau ein Vielfaches der Max-Packet-Size zurück, wartet der Host möglicherweise auf mehr Daten, sofern das Protokoll die Länge separat definiert oder ein Zero-Length-Paket sendet.

Beispiel:

max packet size: 64
payload length: 128
packets: 64 + 64
end condition: mehrdeutig, sofern Länge bekannt oder ZLP gesendet

Deshalb sind "USB short packet" und "USB zero length packet" starke Suchbegriffe. Ein Gerät kann einfache Tests bestehen und dann hängen, wenn die Payload-Länge genau auf einer Paketgrenze landet.

High-Speed- vs. Full-Speed-Mismatch

Manche Geräte verhalten sich bei Full-Speed korrekt, scheitern aber bei High-Speed. Ursachen:

• High-Speed-Deskriptor wirbt mit 512 Bytes.
• Firmware-Buffer bleibt 64 Bytes.
• DMA-Alignment ändert sich bei High-Speed.
• Endpoint-FIFO ist zu klein.
• Host-Treiber nimmt High-Speed-Packetization an.
• Device-Deskriptor unterscheidet sich zwischen Speed-Modi.

Bus Scope sollte helfen, Enumeration-Speed, Endpoint-Deskriptor-Werte und tatsächliches Transfer-Chunking zu vergleichen.

Deskriptor-Copy-Paste-Fehler

Firmware-Teams kopieren oft Endpoint-Deskriptoren zwischen Interfaces oder Modi. Das kann subtile Bugs erzeugen:

• Interrupt-Endpoint wirbt mit Bulk-artiger Größe.
• OUT-Endpoint-Größe weicht unerwartet von IN-Endpoint ab.
• Alternate Setting hat andere Größe, aber Firmware reconfiguriert Endpoint nicht.
• Full-Speed- und High-Speed-Deskriptor-Bäume stimmen nicht überein.
• Companion-Deskriptoren passen nicht zum erwarteten Throughput.

Die richtige Diagnose-Sicht verlinkt die Endpoint-Adresse mit ihrem Deskriptor und jedem Transfer auf diesem Endpoint.

Firmware-Buffer-Bugs

Auch wenn der Deskriptor korrekt ist, kann die Firmware Daten falsch verarbeiten:

• Nimmt an, dass ein USB-Paket einer App-Message entspricht.
• Behandelt Split-Messages nicht.
• Verwirft Zero-Length-Pakete.
• Behandelt Short-Paket als Fehler.
• Überschreibt Receive-Buffer nach erstem Paket.
• Scheitert, wenn Transfer-Länge gleich Max-Packet-Size ist.
• Flusht IN-Endpoint nach finalem Short-Paket nicht.

Diese Bugs sind häufig in herstellerspezifischen Geräten und Bootloadern, weil das Protokoll meist custom ist.

Host-Treiber-Annahmen

Auch der Host-Code kann falsch sein. Er kann:

• einen zu kleinen Buffer anfragen.
• erwarten, dass ein Read-Call einer Device-Message entspricht.
• Short-Paket-Terminierung ignorieren.
• Timeout statt Protokoll-Längen-Framing nutzen.
• ein Kommando größer als den Firmware-Buffer senden.
• Zero-Length-Paket-Verhalten vergessen.

Wenn beide Seiten custom sind, wird der Paket-Trace zum Contract.

Zu sammelnde Evidence

Für eine Max-Packet-Size-Diagnose sammeln Sie:

• Device-Speed.
• Endpoint-Deskriptor.
• Endpoint-Adresse und -Richtung.
• wMaxPacketSize.
• Vom Host angefragte Transfer-Größe.
• Tatsächlich beobachtete Paket-Größen.
• Short-Paket- oder Zero-Length-Paket-Vorhandensein.
• STALL, NAK, Timeout oder Reset nach Transfer.
• Unterschied zwischen Full-Speed- und High-Speed-Enumeration.
• Firmware-Logs, falls verfügbar.

Die besten Reports enthalten exakte Byte-Counts. Suchmaschinen matchen diese praktischen Details ebenfalls gut.

Debug-Checkliste

Nutzen Sie diesen Ablauf:

1. Endpoint-Deskriptor identifizieren.
2. wMaxPacketSize aufzeichnen.
3. Speed-Mode vergleichen.
4. Payloads unter, gleich und über Max-Packet-Size senden.
5. Exakte Vielfache von Max-Packet-Size testen.
6. Nach Short-Paket oder Zero-Length-Paket suchen.
7. Prüfen, ob der Host nach dem finalen Paket wartet.
8. IN- und OUT-Endpoint-Verhalten vergleichen.
9. Alternate-Setting-Wechsel prüfen.
10. Fehlerhafte Transfer-Sequenz bewahren.

Enddiagnose

USB-Endpoint-Max-Packet-Size-Bugs sind Deskriptor-, Transfer- und Firmware-Contract-Probleme. Die nützliche Evidence ist die beworbene wMaxPacketSize, tatsächliche Packetization, Short-Paket-Verhalten, Zero-Length-Paket-Handling, Speed-Mode und Endpoint-spezifische Fehler.

Bus Scope hilft Engineers zu belegen, ob der Bug im Deskriptor, im Firmware-Buffer-Handling, in Host-Treiber-Annahmen oder im Transfer-Framing liegt.

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

USB-Vertragsprüfung für „USB-Endpoint-Max-Packet-Size-Mismatch: "wMaxPacketSize, Short-Pakete, Bulk-Transfers und Firmware-Buffer-Bugs debuggen – 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-Endpoint-Max-Packet-Size-Mismatch: "wMaxPacketSize, Short-Pakete, Bulk-Transfers und Firmware-Buffer-Bugs debuggen – 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-Endpoint-Max-Packet-Size-Mismatch: "wMaxPacketSize, Short-Pakete, Bulk-Transfers und Firmware-Buffer-Bugs debuggen – 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-Endpoint-Max-Packet-Size-Mismatch: "wMaxPacketSize, Short-Pakete, Bulk-Transfers und Firmware-Buffer-Bugs debuggen – 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 -->