2026-06-02

Debug dispositivi USB composite: numeri di interfaccia, IAD, endpoint e driver binding

I dispositivi USB composite sono comodi e rischiosi.

I dispositivi USB composite sono comodi e rischiosi. Un singolo dispositivo può esporre controlli HID, seriale CDC, mass storage, endpoint vendor-specific, audio, video o interfacce di diagnostica. Quando tutto è descritto correttamente, l'host associa i driver giusti e ogni funzione lavora. Quando un solo campo del descrittore è sbagliato, l'intero dispositivo può sembrare inaffidabile.

Ricerche come "USB composite device not recognized", "CDC interface not showing", "HID works but serial does not" o "wrong driver binding USB interface" di solito puntano a struttura dei descrittori, numerazione delle interfacce, assegnazione degli endpoint o comportamento degli Interface Association Descriptor.

I dispositivi composite hanno bisogno di una configurazione coerente

Il configuration descriptor è la mappa di livello più alto. Deve descrivere lunghezza totale, numero di interfacce, attributi di alimentazione e tutti i descrittori annidati di interfaccia ed endpoint. Se wTotalLength è sbagliato, l'host potrebbe non leggere tutte le funzioni. Se il conteggio delle interfacce è sbagliato, l'host potrebbe ignorare le interfacce successive. Se gli indirizzi degli endpoint collidono, i transfer diventano ambigui o non validi.

Ispeziona:

lunghezza totale della configurazione
numero di interfacce
numeri di interfaccia
alternate settings
indirizzi degli endpoint
direzioni degli endpoint
valori class, subclass, protocol
ordine dei descrittori

Una capture dovrebbe mostrare se l'host ha richiesto l'intera configurazione e quali byte ha restituito il dispositivo.

IAD aiuta a raggruppare interfacce correlate

Gli Interface Association Descriptors vengono spesso usati per raggruppare più interfacce che appartengono a una stessa funzione, per esempio CDC communication più CDC data. Senza un raggruppamento corretto, l'host può associare i driver in modo errato o esporre solo una parte della funzione.

Evidenze IAD da ispezionare:

primo numero di interfaccia
numero di interfacce
function class, subclass, protocol
posizione prima delle interfacce raggruppate
coerenza con gli interface descriptor effettivi

Se CDC seriale non appare ma HID funziona, l'interfaccia HID può essere corretta mentre il raggruppamento CDC è sbagliato.

Le collisioni di indirizzi endpoint sono facili da perdere

Gli indirizzi degli endpoint includono la direzione. Gli endpoint 0x81 e 0x01 hanno direzioni diverse, ma due endpoint IN con lo stesso indirizzo non sono validi nella stessa configurazione del dispositivo. A volte i team firmware copiano descrittori endpoint tra interfacce e dimenticano di aggiornare gli indirizzi.

I sintomi includono:

un'interfaccia funziona, un'altra resta muta
l'host invia transfer a un endpoint inatteso
il class driver si carica ma l'applicazione non riceve dati
endpoint STALL o timeout dopo la configurazione
funziona una sola funzione alla volta

La capture dovrebbe mostrare fianco a fianco descrittori degli endpoint e traffico di transfer successivo.

Anche il driver binding è evidenza

L'host sceglie i driver in base ai descrittori. Un dispositivo associato in modo errato può avere evidenze nei descrittori che spiegano il perché. Class, subclass, protocol, associazione delle interfacce, compatible IDs e descrittori specifici del sistema operativo possono influenzare il binding.

Non diagnosticare il driver binding solo da Gestione dispositivi o dai log applicativi. Confronta le richieste class-specific dell'host con l'albero dei descrittori. Se le class request attese non arrivano mai, probabilmente l'host non ha associato il driver previsto.

Dove si inserisce Bus Scope

Bus Scope dovrebbe aiutare i team firmware a ispezionare i dispositivi composite su entrambi i livelli:

mappa dei descrittori
evidenze di transfer dopo il driver binding

Una buona sessione .bscope per il debug composite mostra:

tutte le interfacce
raggruppamento IAD
assegnazioni degli endpoint
richieste class-specific per interfaccia
byte grezzi dei descrittori
stato dei transfer dopo la configurazione

Questo rende specifica la conversazione di supporto. Invece di "Windows non gradisce il nostro dispositivo composite", il report può dire "l'interfaccia 2 non riceve mai richieste CDC class perché il grouping descriptor non corrisponde al layout di interfacce dichiarato".

Questo è il livello di evidenza di cui hanno bisogno i team firmware.

Prova del contratto USB per «Debug dispositivi USB composite: numeri di interfaccia, IAD, endpoint e driver binding»

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 dispositivi USB composite: numeri di interfaccia, IAD, endpoint e driver binding» 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 dispositivi USB composite: numeri di interfaccia, IAD, endpoint e driver binding» è: I dispositivi USB composite sono comodi e rischiosi. 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 dispositivi USB composite: numeri di interfaccia, IAD, endpoint e driver binding

Verifica «Debug dispositivi USB composite: numeri di interfaccia, IAD, endpoint e driver binding» con il più piccolo input rappresentativo. Mantieni invariate le impostazioni non correlate, ripeti la stessa azione e controlla il risultato dopo riapertura o riconnessione. Un’immagine isolata è più debole di un record con input, impostazione, azione, output e ora.

Punto di controllo 2: I dispositivi USB composite sono comodi e rischiosi.

Se «I dispositivi USB composite sono comodi e rischiosi.» è ambiguo, confronta un caso valido e uno fallito nelle stesse condizioni. Segna la prima differenza significativa invece di elencare tutti i sintomi successivi. Quel confine produce una richiesta di supporto più chiara e un esperimento più sicuro.

Punto di controllo 3: I dispositivi composite hanno bisogno di una configurazione coerente

Verifica «I dispositivi composite hanno bisogno di una configurazione coerente» con il più piccolo input rappresentativo. Mantieni invariate le impostazioni non correlate, ripeti la stessa azione e controlla il risultato dopo riapertura o riconnessione. Un’immagine isolata è più debole di un record con input, impostazione, azione, output e ora.

Punto di controllo 4: IAD aiuta a raggruppare interfacce correlate

Se «IAD aiuta a raggruppare interfacce correlate» è ambiguo, confronta un caso valido e uno fallito nelle stesse condizioni. Segna la prima differenza significativa invece di elencare tutti i sintomi successivi. Quel confine produce una richiesta di supporto più chiara e un esperimento più sicuro.

Punto di controllo 5: Le collisioni di indirizzi endpoint sono facili da perdere

Verifica «Le collisioni di indirizzi endpoint sono facili da perdere» con il più piccolo input rappresentativo. Mantieni invariate le impostazioni non correlate, ripeti la stessa azione e controlla il risultato dopo riapertura o riconnessione. Un’immagine isolata è più debole di un record con input, impostazione, azione, output e ora.

Punto di controllo 6: Anche il driver binding è evidenza

Se «Anche il driver binding è evidenza» è ambiguo, confronta un caso valido e uno fallito nelle stesse condizioni. Segna la prima differenza significativa invece di elencare tutti i sintomi successivi. Quel confine produce una richiesta di supporto più chiara e un esperimento più sicuro.

Punto di controllo 7: Dove si inserisce Bus Scope

Verifica «Dove si inserisce Bus Scope» con il più piccolo input rappresentativo. Mantieni invariate le impostazioni non correlate, ripeti la stessa azione e controlla il risultato dopo riapertura o riconnessione. Un’immagine isolata è più debole di un record con input, impostazione, azione, output e ora.

Punto di controllo 8: Prova del contratto USB per «Debug dispositivi USB composite: numeri di interfaccia, IAD,

Se «Prova del contratto USB per «Debug dispositivi USB composite: numeri di interfaccia, IAD, endpoint e driver binding»» è ambiguo, confronta un caso valido e uno fallito nelle stesse condizioni. Segna la prima differenza significativa invece di elencare tutti i sintomi successivi. Quel confine produce una richiesta di supporto più chiara e un esperimento più sicuro.

Punto di controllo 9: Come scrivere una risposta citabile?

Verifica «Come scrivere una risposta citabile?» con il più piccolo input rappresentativo. Mantieni invariate le impostazioni non correlate, ripeti la stessa azione e controlla il risultato dopo riapertura o riconnessione. Un’immagine isolata è più debole di un record con input, impostazione, azione, output e ora.

Punto di controllo 10: Quando è valido il confronto?

Se «Quando è valido il confronto?» è ambiguo, confronta un caso valido e uno fallito nelle stesse condizioni. Segna la prima differenza significativa invece di elencare tutti i sintomi successivi. Quel confine produce una richiesta di supporto più chiara e un esperimento più sicuro.

Matrice di accettazione

Punto	Prova da conservare	Criterio di superamento
Debug dispositivi USB composite: numeri di interfaccia, IAD, endpoint e driver binding	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
I dispositivi USB composite sono comodi e rischiosi.	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
I dispositivi composite hanno bisogno di una configurazione coerente	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
IAD aiuta a raggruppare interfacce correlate	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Le collisioni di indirizzi endpoint sono facili da perdere	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Anche il driver binding è evidenza	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: