2026-06-03

Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti

Gli endpoint USB interrupt vengono usati da tastiere, mouse, controller di gioco, sensori, touch panel, scanner barcode, UPS e molti tool HID custom.

Gli endpoint USB interrupt vengono usati da tastiere, mouse, controller di gioco, sensori, touch panel, scanner barcode, UPS e molti tool HID custom. Gli utenti cercano "USB bInterval", "HID polling rate", "USB interrupt endpoint latency", "missed input reports", "USB device 125Hz 250Hz 1000Hz" e "bInterval full speed high speed" quando l'input sembra in ritardo o i report arrivano alla frequenza sbagliata.

Bus Scope è utile perché il comportamento di polling è definito dagli endpoint descriptor e dal timing reale sul bus. La UI del sistema operativo può mostrare solo "device connected"; la cattura può mostrare quale intervallo l'host sta realmente usando.

Che cosa significa bInterval

Un endpoint interrupt descriptor include bInterval. Questo valore descrive l'intervallo di polling, ma l'interpretazione dipende da speed ed endpoint type.

Distinzioni importanti:

Gli endpoint interrupt low-speed e full-speed usano intervalli basati su frame in millisecondi.
Gli endpoint interrupt high-speed usano una codifica diversa basata su microframe.
Scheduling dell'host controller e topologia hub possono influenzare il timing osservato.
Il timing di lettura dell'applicazione non coincide con il polling sul bus USB.

Se un ingegnere guarda solo le callback applicative, può perdere lo schedule reale dell'endpoint.

Sintomi comuni

I problemi di intervallo di polling emergono come:

Mouse o controller percepito come lento.
Input report HID che arrivano ogni 8 ms invece di 1 ms.
Dispositivo che dichiara 1000 Hz ma si comporta come 125 Hz.
Dati sensore a burst.
Scanner barcode che perde scansioni rapide.
Touch panel in ritardo dopo resume.
Firmware che invia report più velocemente di quanto l'host effettui polling.
Modalità high-speed che cambia il timing dei report in modo inatteso.

Questi problemi spesso sembrano latenza o scarsa reattività, ma l'evidenza alla radice sta nel USB descriptor e nel packet timing.

Interpretazione full-speed vs high-speed

Lo stesso valore numerico di bInterval può significare un timing effettivo diverso a seconda della speed. Un endpoint HID full-speed con bInterval=8 non usa lo stesso modello di scheduling di un endpoint high-speed con lo stesso valore byte.

Il debug dovrebbe catturare:

Speed negoziata reale.
Endpoint descriptor.
Endpoint address.
Transfer type.
bInterval.
Cadenza osservata di token IN o transfer.
Timing del payload report.

Bus Scope dovrebbe mostrare insieme valori del descriptor e timing osservato.

Sovrapproduzione del firmware

Alcuni firmware generano input report più rapidamente di quanto l'host effettui polling. Quei report possono essere sovrascritti, coalesced o scartati prima che l'host li veda.

Sintomi:

I log interni del dispositivo mostrano eventi.
L'host riceve meno report.
Pressioni rapide dei pulsanti vengono perse.
Il movimento sembra smussato o ritardato.
Dopo un burst, i report contengono solo lo stato più recente.

Questo non è un problema di perdita pacchetti USB. È un problema di buffering firmware e contratto di polling.

Il polling host non è la frequenza di lettura dell'applicazione

Un'applicazione può leggere ogni 1 ms, ma l'host USB può effettuare polling solo ogni 8 ms. Oppure l'host può effettuare polling puntuale, mentre l'event loop dell'applicazione processa i dati più tardi.

La packet capture separa:

Intervallo di polling sul bus.
Timing della risposta del dispositivo.
Buffering del driver host.
Latenza della callback applicativa.

Questa separazione è critica nei casi di supporto sulla latenza HID.

Errori nel descriptor bInterval

Bug comuni nei descriptor includono:

Dichiarare per errore bInterval=10 invece di 1.
Copiare in modo scorretto un intervallo full-speed nel descriptor high-speed.
Usare un intervallo nelle aspettative del HID descriptor e un altro nell'endpoint descriptor.
Commenti firmware che dichiarano 1000 Hz mentre il descriptor dice più lento.
Alternate setting che cambia intervallo, ma firmware che non lo gestisce.

Il byte nel descriptor è il contratto su cui l'host costruisce lo schedule.

Checklist di debug

Usa questo workflow:

Cattura l'enumerazione.
Identifica gli endpoint descriptor interrupt.
Registra la device speed reale.
Decodifica bInterval.
Misura la cadenza osservata degli interrupt IN.
Confrontala con la frequenza di polling attesa.
Attiva eventi input rapidi.
Controlla se i report vengono persi o coalesced.
Confronta porta diretta vs hub.
Conserva insieme descriptor ed evidenza di timing.

Diagnosi finale

La latenza USB interrupt non è solo un problema di performance applicativa. Dipende da endpoint bInterval, speed mode, scheduling host, generazione dei report e buffering firmware.

Bus Scope aiuta a dimostrare se un dispositivo HID o interrupt viene davvero interrogato alla frequenza prevista e se l'input mancante dipende da impostazioni del descriptor, buffering firmware o timing host/applicazione.

Prova del contratto USB per «Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti»

La risposta diretta è che STALL, timeout o reset non spiega da solo la causa. Prima dimostra che il provider vede il device corretto; poi leggi il contratto del transfer: tipo, direzione, recipient, wValue, wIndex, lunghezza dichiarata e reale, status e stato precedente e successivo. In «Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti» collega la conclusione alla prima transazione diversa dal caso buono.

Confine	Confronto	Decisione
Piattaforma	provider, permessi, Root Hub o usbmon/XHC20	I record provengono dalla connessione corretta?
Setup	bmRequestType, bRequest, wValue, wIndex, wLength	L’host invia la richiesta prevista?
Data	direzione, lunghezza e bytes conservati	Il payload rispetta il contratto?
Status	ACK, STALL, timeout o cancellation	Dove termina la transazione?
Stato	configuration, interface, alternate setting, endpoint halt	Il device era pronto?

Inizia prima di reset ed enumeration e conserva descriptors, SET_CONFIGURATION, SET_INTERFACE e il comando precedente al guasto. Un filtro endpoint stretto può nascondere il control transfer decisivo. Esegui un’azione USB documentata per prova e cambia solo firmware, driver, porta, cavo, comando o timing.

Come scrivere una risposta citabile?

Indica request, campi setup, risposta e contesto precedente; poi una prova con una variabile. Bytes non trattenuti non provano packet loss. La vicinanza fra command e reset dimostra correlazione, non causa senza ripetizione o cambio di stato.

Quando è valido il confronto?

Mantieni VID/PID, firmware, speed, topologia, provider, filtro e trigger. Confronta fasi USB semantiche, non frame numbers tra usbmon e USBPcap. Registra inizio, fine, versione, OS, connessione e checksum. Usa il troubleshooting Bus Scope.

I proprietari Semrush restano distinti: free USB analyzer sulla pagina prodotto, best USB protocol analyzer nella comparazione e USB descriptor viewer nella guida descriptor. Nessun volume o KD viene inventato.

Risposta diretta e confine di accettazione

La risposta breve a «Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti» è: Gli endpoint USB interrupt vengono usati da tastiere, mouse, controller di gioco, sensori, touch panel, scanner barcode, UPS e molti tool HID custom. Tratta questa frase come un risultato da verificare, non come una promessa per ogni input, dispositivo, progetto o ambiente. Un risultato completo registra stato iniziale, azione esatta, output visibile e condizione che dimostra la conclusione dell’attività in Bus Scope.

Procedura basata sulle prove

Parti da un caso piccolo e ripetibile prima di modificare un progetto intero. Registra versione, sistema operativo, identità dell’input o dispositivo, impostazioni rilevanti e risultato atteso. Esegui un’azione deliberata, conserva la prima transizione inattesa e confrontala con un caso noto quando disponibile. Cambiare più controlli insieme nasconde quale condizione ha creato o corretto il problema.

Punto di controllo 1: Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti

Trasforma «Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti» in una dichiarazione pass/fail ripetibile. Indica cosa deve essere presente, cosa deve mancare e quale ripristino è sicuro. Mantieni intatto il progetto o la cattura originale finché la copia corretta non supera lo stesso controllo.

Punto di controllo 2: Gli endpoint USB interrupt vengono usati da tastiere, mouse, controller di gioco, sensori,

Tratta «Gli endpoint USB interrupt vengono usati da tastiere, mouse, controller di gioco, sensori, touch panel, scanner barcode, UPS e molti tool HID custom.» come un confine di accettazione separato per «Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti». Registra lo stato prima dell’azione, il primo cambiamento visibile e lo stato finale. Se il risultato non coincide con l’obiettivo descritto, torna all’ultimo punto confermato invece di proseguire per ipotesi.

Punto di controllo 3: Che cosa significa bInterval

Trasforma «Che cosa significa bInterval» in una dichiarazione pass/fail ripetibile. Indica cosa deve essere presente, cosa deve mancare e quale ripristino è sicuro. Mantieni intatto il progetto o la cattura originale finché la copia corretta non supera lo stesso controllo.

Punto di controllo 4: Sintomi comuni

Tratta «Sintomi comuni» come un confine di accettazione separato per «Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti». Registra lo stato prima dell’azione, il primo cambiamento visibile e lo stato finale. Se il risultato non coincide con l’obiettivo descritto, torna all’ultimo punto confermato invece di proseguire per ipotesi.

Punto di controllo 5: Interpretazione full-speed vs high-speed

Trasforma «Interpretazione full-speed vs high-speed» in una dichiarazione pass/fail ripetibile. Indica cosa deve essere presente, cosa deve mancare e quale ripristino è sicuro. Mantieni intatto il progetto o la cattura originale finché la copia corretta non supera lo stesso controllo.

Punto di controllo 6: Sovrapproduzione del firmware

Tratta «Sovrapproduzione del firmware» come un confine di accettazione separato per «Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti». Registra lo stato prima dell’azione, il primo cambiamento visibile e lo stato finale. Se il risultato non coincide con l’obiettivo descritto, torna all’ultimo punto confermato invece di proseguire per ipotesi.

Punto di controllo 7: Il polling host non è la frequenza di lettura dell'applicazione

Trasforma «Il polling host non è la frequenza di lettura dell'applicazione» in una dichiarazione pass/fail ripetibile. Indica cosa deve essere presente, cosa deve mancare e quale ripristino è sicuro. Mantieni intatto il progetto o la cattura originale finché la copia corretta non supera lo stesso controllo.

Punto di controllo 8: Errori nel descriptor bInterval

Tratta «Errori nel descriptor bInterval» come un confine di accettazione separato per «Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti». Registra lo stato prima dell’azione, il primo cambiamento visibile e lo stato finale. Se il risultato non coincide con l’obiettivo descritto, torna all’ultimo punto confermato invece di proseguire per ipotesi.

Punto di controllo 9: Checklist di debug

Trasforma «Checklist di debug» in una dichiarazione pass/fail ripetibile. Indica cosa deve essere presente, cosa deve mancare e quale ripristino è sicuro. Mantieni intatto il progetto o la cattura originale finché la copia corretta non supera lo stesso controllo.

Punto di controllo 10: Diagnosi finale

Tratta «Diagnosi finale» come un confine di accettazione separato per «Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti». Registra lo stato prima dell’azione, il primo cambiamento visibile e lo stato finale. Se il risultato non coincide con l’obiettivo descritto, torna all’ultimo punto confermato invece di proseguire per ipotesi.

Matrice di accettazione

Punto	Prova da conservare	Criterio di superamento
Debug USB bInterval su endpoint interrupt: polling, latenza HID e input mancanti	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Gli endpoint USB interrupt vengono usati da tastiere, mouse, controller di gioco, sensori, touch panel, scanner barcode,	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Che cosa significa bInterval	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Sintomi comuni	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Interpretazione full-speed vs high-speed	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Sovrapproduzione del firmware	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato

Isolamento, ripristino e consegna

Fermati al primo confine che fallisce. Conserva sorgente, progetto, sessione o cattura, crea una copia prima di modifiche distruttive e cambia una variabile per esperimento. Ripetere un flusso ampio dopo più cambiamenti può dare un esito diverso senza spiegarlo.

Separa assenza di prove da prova di assenza. Una vista vuota può indicare input, ambito, filtro, permesso, dispositivo, intervallo o stato errato. Verifica acquisizione o importazione prima di interpretare decoder, editor, report o esportazione.

Prima della consegna, riapri l’artefatto e controlla inizio, punto decisionale e fine. Registra versione, piattaforma, configurazione, attesa, osservazione e riproduzione minima. Rimuovi o oscura dati sensibili e verifica l’autorizzazione del destinatario.

Domande e risposte

Qual è il modo affidabile più rapido per iniziare?

Usa il più piccolo caso rappresentativo, scrivi il risultato atteso e cambia una variabile. Conferma il percorso base prima di aggiungere filtri, effetti, modifiche, automazione o una sorgente maggiore.

Quali prove vanno salvate?

Conserva identità dell’input, versione, piattaforma, impostazioni, azione esatta, prima transizione inattesa e output finale. Chiudi e riapri progetto, sessione, report o export prima di considerarli durevoli.

Quando va ripetuta la procedura?

Ripetila dopo cambiamenti rilevanti ad applicazione, sistema, driver, firmware, modello, sorgente o workflow. Conserva il caso accettato precedente come riferimento non modificato.

Quando il risultato è pronto per la consegna?

Quando un’altra persona autorizzata identifica l’input, ripete l’azione, vede lo stesso risultato, comprende i limiti e apre l’artefatto senza stato locale non documentato.

Guide correlate

Queste pagine nella stessa lingua coprono le fasi vicine senza cambiare il proprietario canonico dell’argomento: