2026-06-02

USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite

I USB control transfer sono la base dell'enumerazione e della gestione del dispositivo.

I USB control transfer sono la base dell'enumerazione e della gestione del dispositivo. Leggono descrittori, impostano indirizzi, selezionano configurazioni, cambiano interfacce, emettono class request e inviano comandi vendor-specific. Quando un control transfer va in STALL, gli utenti possono vedere "USB device not recognized", "control transfer failed", "libusb control transfer error", "endpoint zero stalled" o un firmware updater che si ferma all'inizializzazione.

Ricerche come "USB control transfer STALL", "USB setup packet debugging", "endpoint zero stall", "GET_DESCRIPTOR failed" e "vendor request stalled" di solito significano che il fallimento è avvenuto prima che il normale traffico bulk, interrupt o isochronous potesse procedere.

Bus Scope è utile perché il setup packet spiega la richiesta. Senza quello, uno STALL è solo un errore generico.

Cosa contiene un control transfer

Un USB control transfer ha fasi:

Setup stage
Optional data stage
Status stage

Il setup packet contiene:

bmRequestType
bRequest
wValue
wIndex
wLength

Questi campi definiscono direzione, request type, recipient, request code, descriptor type, interfaccia, endpoint e lunghezza dati attesa.

Se il dispositivo va in STALL, ispeziona prima il setup packet.

Endpoint zero è speciale

Endpoint zero esiste per ogni dispositivo USB. Viene usato durante l'enumerazione e le operazioni di controllo. Se endpoint zero si comporta in modo errato, l'host potrebbe non associare mai il driver normale.

I fallimenti di endpoint zero possono apparire come:

richiesta device descriptor fallita
lettura configuration descriptor fallita
richiesta string descriptor in STALL
SET_CONFIGURATION fallita
richiesta class-specific fallita
comando vendor fallito

Nel firmware custom, la correttezza di endpoint zero non è negoziabile.

STALL può essere valido

Non ogni STALL è un bug. Un dispositivo può legittimamente mandare in STALL una richiesta non supportata. La domanda è se l'host si aspettava il supporto e se lo stato del dispositivo permette la richiesta.

Esempi:

Unsupported vendor request: STALL può essere corretto.
Invalid descriptor index: STALL può essere corretto.
Required class request durante l'enumerazione: STALL può rompere il driver binding.
DFU request nello stato sbagliato: STALL può indicare mismatch della state machine.

Il significato dipende da request type e timing.

Fallimenti delle richieste descriptor

Gli STALL sui descriptor sono comuni negli stack USB custom. Controlla:

Descriptor type sbagliato in wValue.
String index non supportato.
Mismatch della lunghezza totale della configurazione.
Il dispositivo restituisce in modo errato meno dati di quelli richiesti.
Il dispositivo non gestisce le letture iniziali brevi dei descriptor.
Il firmware assume un solo pattern di richiesta dell'host.

Sistemi operativi diversi chiedono i descrittori in ordini diversi. Un dispositivo che funziona su Linux può andare in STALL su una richiesta che Windows invia durante l'enumerazione.

Richieste class e vendor

Le class request sono interpretate dalla classe USB. HID, CDC, DFU, Audio, Video, Mass Storage e dispositivi vendor-specific hanno tutti aspettative sulle request.

Esempi comuni:

HID GET_REPORT
HID SET_REPORT
CDC SET_LINE_CODING
CDC SET_CONTROL_LINE_STATE
DFU GETSTATUS
controlli UVC probe/commit
comandi bootloader vendor-specific

Se una class request va in STALL, controlla se il numero di interfaccia in wIndex corrisponde all'interfaccia prevista. I dispositivi composite falliscono spesso perché l'host invia una request a un'interfaccia e il firmware ne gestisce un'altra.

Checklist di debug

Usa questo workflow:

Acquisisci dal momento del plug-in.
Trova il primo control transfer STALL.
Decodifica i campi del setup packet.
Determina se la request è standard, class o vendor-specific.
Determina il recipient: device, interface, endpoint o other.
Controlla wValue, wIndex e wLength.
Confronta con i descrittori e lo stato attuale del dispositivo.
Controlla se lo STALL è atteso o fatale.
Cerca una richiesta di recupero come clear feature o reset.
Confronta l'ordine delle request dell'host OS se il comportamento cross-platform è diverso.

Diagnosi finale

USB control transfer STALL da solo non è abbastanza informazione. Il setup packet è l'ancora della diagnosi. Dice quale request è fallita, quale recipient è stato indirizzato, quanti dati erano attesi e se lo stato del dispositivo rendeva valida la request.

Bus Scope aiuta a esporre evidenze su endpoint zero e setup packet, così team firmware, driver e QA possono fare debug preciso dei fallimenti nel control path.

Prova del contratto USB per «USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite»

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 «USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite» 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 «USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite» è: I USB control transfer sono la base dell'enumerazione e della gestione del dispositivo. 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: USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite

Trasforma «USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite» 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: I USB control transfer sono la base dell'enumerazione e della gestione del dispositivo.

Tratta «I USB control transfer sono la base dell'enumerazione e della gestione del dispositivo.» come un confine di accettazione separato per «USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite». 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: Cosa contiene un control transfer

Trasforma «Cosa contiene un control transfer» 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: Endpoint zero è speciale

Tratta «Endpoint zero è speciale» come un confine di accettazione separato per «USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite». 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: STALL può essere valido

Trasforma «STALL può essere valido» 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: Fallimenti delle richieste descriptor

Tratta «Fallimenti delle richieste descriptor» come un confine di accettazione separato per «USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite». 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: Richieste class e vendor

Trasforma «Richieste class e vendor» 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: Checklist di debug

Tratta «Checklist di debug» come un confine di accettazione separato per «USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite». 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: Diagnosi finale

Trasforma «Diagnosi finale» 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: Prova del contratto USB per «USB control transfer STALL: debug di setup packet, endpoint z

Tratta «Prova del contratto USB per «USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite»» come un confine di accettazione separato per «USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite». 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
USB control transfer STALL: debug di setup packet, endpoint zero e richieste fallite	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
I USB control transfer sono la base dell'enumerazione e della gestione del dispositivo.	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Cosa contiene un control transfer	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Endpoint zero è speciale	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
STALL può essere valido	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Fallimenti delle richieste descriptor	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: