USB-Interrupt-Endpoint-bInterval-Debugging
So debuggen Sie USB-Interrupt-Endpoint-bInterval, Polling-Rate, HID-Latency, verpasste Input-Reports, Full-Speed- vs. High-Speed-Intervall-Regeln und Endpoint-Deskriptor-Fehler.
USB-Interrupt-Endpoints werden von Tastaturen, Mäusen, Game-Controllern, Sensoren, Touch-Panels, Barcode-Scannern, USV-Geräten und vielen Custom-HID-Tools genutzt. Nutzer suchen nach "USB bInterval", "HID polling rate", "USB interrupt endpoint latency", "missed input reports", "USB device 125Hz 250Hz 1000Hz" und "bInterval full speed high speed", wenn Input sich verzögert anfühlt oder Reports in der falschen Rate ankommen.
Bus Scope hilft, weil Polling-Verhalten durch Endpoint-Deskriptoren und tatsächliches Bus-Timing definiert wird. Das OS-UI zeigt oft nur "device connected"; der Capture kann zeigen, welches Intervall der Host tatsächlich nutzt.
Was bInterval bedeutet
Ein Interrupt-Endpoint-Deskriptor enthält bInterval. Dieser Wert beschreibt das Polling-Intervall, aber die Interpretation hängt von Speed und Endpoint-Typ ab.
Wichtige Unterscheidungen:
- Low-Speed- und Full-Speed-Interrupt-Endpoints nutzen Millisekunden-Frame-basierte Intervalle.
- High-Speed-Interrupt-Endpoints nutzen eine andere Kodierung basierend auf Microframes.
- Host-Controller-Scheduling und Hub-Topologie können das beobachtete Timing beeinflussen.
- App-Read-Timing ist nicht dasselbe wie USB-Bus-Polling.
Schaut ein Engineer nur auf App-Callbacks, verpasst er möglicherweise den tatsächlichen Endpoint-Schedule.
Häufige Symptome
Polling-Intervall-Probleme zeigen sich als:
- Maus oder Controller fühlen sich laggy an.
- HID-Input-Reports kommen alle 8 ms statt 1 ms.
- Gerät wirbt mit 1000 Hz, verhält sich aber wie 125 Hz.
- Sensor-Daten sind bursty.
- Barcode-Scanner verwirft schnelle Scans.
- Touch-Panel fühlt sich nach Resume verzögert an.
- Firmware sendet Reports schneller als der Host pollt.
- High-Speed-Mode ändert Report-Timing unerwartet.
Diese Issues wirken oft wie Latency- oder Responsiveness-Probleme, aber die Root-Evidence liegt im USB-Deskriptor und Paket-Timing.
Full-Speed- vs. High-Speed-Interpretation
Derselbe numerische bInterval kann je nach Speed unterschiedliches effektives Timing bedeuten. Ein Full-Speed-HID-Endpoint mit bInterval=8 ist nicht dasselbe Scheduling-Modell wie ein High-Speed-Endpoint mit demselben Byte-Wert.
Debugging sollte capturen:
- Tatsächliche verhandelte Speed.
- Endpoint-Deskriptor.
- Endpoint-Adresse.
- Transfer-Typ.
bInterval.- Beobachtete IN-Token- oder Transfer-Cadence.
- Report-Payload-Timing.
Bus Scope sollte Deskriptor-Werte und beobachtetes Timing zusammen zeigen.
Firmware-Überproduktion
Manche Firmware erzeugt Input-Reports schneller, als der Host pollt. Diese Reports können überschrieben, koalesziert oder verworfen werden, bevor der Host sie je sieht.
Symptome:
- Device-interne Logs zeigen Events.
- Host erhält weniger Reports.
- Schnelle Tastendrücke werden verpasst.
- Bewegung wirkt smoothed oder verzögert.
- Reports nach einem Burst enthalten nur den letzten State.
Das ist kein USB-Paketverlust-Problem. Es ist ein Firmware-Buffering- und Polling-Contract-Problem.
Host-Polling ist nicht App-Read-Rate
Eine App mag jede 1 ms lesen, aber der USB-Host pollt vielleicht nur alle 8 ms. Oder der Host pollt pünktlich, aber der App-Event-Loop verarbeitet Daten später.
Paket-Capture trennt:
- Bus-Polling-Intervall.
- Device-Response-Timing.
- Host-Treiber-Buffering.
- App-Callback-Latency.
Diese Trennung ist kritisch für HID-Latency-Support-Cases.
bInterval-Deskriptor-Fehler
Häufige Deskriptor-Bugs:
- Versehentliches Werben mit
bInterval=10statt1. - Falsches Kopieren des Full-Speed-Intervalls in High-Speed-Deskriptor.
- Verwendung eines Intervalls in HID-Deskriptor-Erwartungen und eines anderen im Endpoint-Deskriptor.
- Firmware-Kommentare behaupten 1000 Hz, aber Deskriptor sagt langsamer.
- Alternate-Setting ändert Intervall, aber Firmware behandelt es nicht.
Das Byte im Deskriptor ist der Contract, gegen den der Host schedult.
Debug-Checkliste
Nutzen Sie diesen Workflow:
- Enumeration capturen.
- Interrupt-Endpoint-Deskriptoren identifizieren.
- Tatsächliche Device-Speed aufzeichnen.
bIntervaldekodieren.- Beobachtete Interrupt-IN-Cadence messen.
- Mit erwarteter Polling-Rate vergleichen.
- Schnelle Input-Events triggern.
- Prüfen, ob Reports verpasst oder koalesziert werden.
- Direkter Port vs. Hub vergleichen.
- Deskriptor- und Timing-Evidence zusammen bewahren.
Enddiagnose
USB-Interrupt-Latency ist nicht nur ein App-Performance-Problem. Sie hängt von Endpoint-bInterval, Speed-Mode, Host-Scheduling, Report-Erzeugung und Firmware-Buffering ab.
Bus Scope belegt, ob ein HID- oder Interrupt-Gerät wirklich mit der gedachten Rate gepollt wird und ob verpasster Input durch Deskriptor-Settings, Firmware-Buffering oder Host/App-Timing verursacht wird.
<!-- bus-scope-localized-transaction-foundation-v1:start -->USB-Vertragsprüfung für „USB-Interrupt-Endpoint-bInterval-Debugging“
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-Interrupt-Endpoint-bInterval-Debugging“ 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-Interrupt-Endpoint-bInterval-Debugging“ 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-Interrupt-Endpoint-bInterval-Debugging“ 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 -->