2026-06-02

Debug USB Mass Storage BOT: CBW, CSW, sense data e transfer falliti

Dal lato utente i dispositivi USB Mass Storage sembrano semplici: \"colleghi una chiavetta, un data logger, un dispositivo di aggiornamento firmware o uno storage gadget embedded, e compare un disco.

Dal lato utente i dispositivi USB Mass Storage sembrano semplici: "colleghi una chiavetta, un data logger, un dispositivo di aggiornamento firmware o uno storage gadget embedded, e compare un disco. Quando falliscono, l'errore può essere vago: dispositivo non pronto, errore I/O, richiesta di formattazione, mount fallito o disco che scompare." Sotto, molti dispositivi usano Bulk-Only Transport. BOT ha un flusso di comando riconoscibile: "Command Block Wrapper, data phase, Command Status Wrapper. Se quel pattern si rompe, la cattura di solito mostra dove."

Capire il flusso BOT

Il pattern normale è:

l'host invia CBW su bulk OUT
data phase opzionale su bulk IN o OUT
il dispositivo invia CSW su bulk IN

Il CBW porta un comando SCSI. Il CSW riporta lo stato del comando. Se il comando fallisce, l'host può emettere REQUEST SENSE per capire il motivo.

Evidenza utile:

CBW signature
command tag
data transfer length
direction flag
byte del comando SCSI
lunghezza della data phase
CSW signature
CSW status
residue
sense data dopo il fallimento

Se i tag non corrispondono, l'host non può fidarsi dello stato. Se la lunghezza dati non corrisponde al comportamento, possono seguire timeout o stall.

I sense data spiegano molti fallimenti

Un comando SCSI fallito non è la fine della diagnosi. I sense data spesso danno la vera ragione:

not ready
medium error
illegal request
write protected
logical block address out of range
unit attention after reset

I team firmware dovrebbero catturare il comando fallito e la risposta sense successiva. Un mount fallito sull'host può essere una risposta valida a una condizione storage riportata dal firmware.

Endpoint STALL e reset recovery

BOT definisce un comportamento di recovery. Se un endpoint va in stall o un comando fallisce gravemente, l'host può fare clear endpoint halt o emettere mass storage reset. Un dispositivo che non recupera correttamente può sembrare scomparire o richiedere scollegamento.

Ispeziona:

quale endpoint è andato in stall
se l'host ha inviato clear feature
se è avvenuto BOT reset
se il flusso CBW/CSW successivo è ripreso
se i tag sono rimasti coerenti

Questa evidenza è migliore di un'ipotesi sulle state machine firmware.

Dove entra Bus Scope

Bus Scope è un workbench di ispezione USB. Nei casi mass storage, i byte raw non bastano; struttura BOT decodificata e transfer status aiutano gli ingegneri a trovare il guasto più rapidamente.

Un report Bus Scope utile per il debug BOT dovrebbe rispondere:

quale comando SCSI è fallito?
la data phase corrispondeva a direzione e lunghezza del CBW?
il CSW è arrivato?
il tag CSW corrispondeva al tag CBW?
quali sense data sono seguiti?
la reset recovery ha funzionato?

Per query come "USB mass storage BOT failed", "CBW CSW mismatch" o "USB flash drive I/O error firmware", questo è il percorso dal sintomo utente all'evidenza sul bus.

Prova del contratto USB per «Debug USB Mass Storage BOT: CBW, CSW, sense data e transfer falliti»

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 Mass Storage BOT: CBW, CSW, sense data e transfer falliti» 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 Mass Storage BOT: CBW, CSW, sense data e transfer falliti» è: Dal lato utente i dispositivi USB Mass Storage sembrano semplici: "colleghi una chiavetta, un data logger, un dispositivo di aggiornamento firmware o uno storage gadget embedded, e compare un disco. 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 Mass Storage BOT: CBW, CSW, sense data e transfer falliti

Per «Debug USB Mass Storage BOT: CBW, CSW, sense data e transfer falliti», separa una decisione del prodotto da un limite del sistema, hardware, file sorgente, permesso o processo. Conferma quale livello ha prodotto la prova prima di assegnare una causa. Così un sintomo vicino non diventa una causa radice data per certa.

Punto di controllo 2: Dal lato utente i dispositivi USB Mass Storage sembrano semplici: "colleghi una chiavetta

Chiudi «Dal lato utente i dispositivi USB Mass Storage sembrano semplici: "colleghi una chiavetta, un data logger, un dispositivo di aggiornamento firmware o» solo quando il risultato salvato, esportato o riaperto conserva lo stato osservato. Il feedback temporaneo dell’interfaccia è utile, ma la prova durevole è più forte. Registra ogni limite residuo per chi prosegue.

Punto di controllo 3: Capire il flusso BOT

Per «Capire il flusso BOT», separa una decisione del prodotto da un limite del sistema, hardware, file sorgente, permesso o processo. Conferma quale livello ha prodotto la prova prima di assegnare una causa. Così un sintomo vicino non diventa una causa radice data per certa.

Punto di controllo 4: I sense data spiegano molti fallimenti

Chiudi «I sense data spiegano molti fallimenti» solo quando il risultato salvato, esportato o riaperto conserva lo stato osservato. Il feedback temporaneo dell’interfaccia è utile, ma la prova durevole è più forte. Registra ogni limite residuo per chi prosegue.

Punto di controllo 5: Endpoint STALL e reset recovery

Per «Endpoint STALL e reset recovery», separa una decisione del prodotto da un limite del sistema, hardware, file sorgente, permesso o processo. Conferma quale livello ha prodotto la prova prima di assegnare una causa. Così un sintomo vicino non diventa una causa radice data per certa.

Punto di controllo 6: Dove entra Bus Scope

Chiudi «Dove entra Bus Scope» solo quando il risultato salvato, esportato o riaperto conserva lo stato osservato. Il feedback temporaneo dell’interfaccia è utile, ma la prova durevole è più forte. Registra ogni limite residuo per chi prosegue.

Punto di controllo 7: Prova del contratto USB per «Debug USB Mass Storage BOT: CBW, CSW, sense data e transfer f

Per «Prova del contratto USB per «Debug USB Mass Storage BOT: CBW, CSW, sense data e transfer falliti»», separa una decisione del prodotto da un limite del sistema, hardware, file sorgente, permesso o processo. Conferma quale livello ha prodotto la prova prima di assegnare una causa. Così un sintomo vicino non diventa una causa radice data per certa.

Punto di controllo 8: Come scrivere una risposta citabile?

Chiudi «Come scrivere una risposta citabile?» solo quando il risultato salvato, esportato o riaperto conserva lo stato osservato. Il feedback temporaneo dell’interfaccia è utile, ma la prova durevole è più forte. Registra ogni limite residuo per chi prosegue.

Punto di controllo 9: Quando è valido il confronto?

Per «Quando è valido il confronto?», separa una decisione del prodotto da un limite del sistema, hardware, file sorgente, permesso o processo. Conferma quale livello ha prodotto la prova prima di assegnare una causa. Così un sintomo vicino non diventa una causa radice data per certa.

Punto di controllo 10: l'host invia CBW su bulk OUT

Chiudi «l'host invia CBW su bulk OUT» solo quando il risultato salvato, esportato o riaperto conserva lo stato osservato. Il feedback temporaneo dell’interfaccia è utile, ma la prova durevole è più forte. Registra ogni limite residuo per chi prosegue.

Matrice di accettazione

Punto	Prova da conservare	Criterio di superamento
Debug USB Mass Storage BOT: CBW, CSW, sense data e transfer falliti	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Dal lato utente i dispositivi USB Mass Storage sembrano semplici: "colleghi una chiavetta, un data logger, un dispositi	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Capire il flusso BOT	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
I sense data spiegano molti fallimenti	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Endpoint STALL e reset recovery	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Dove entra Bus Scope	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: