2026-06-03

Debug USB string descriptor e LANGID: serial number, manufacturer, product name e driver binding

Gli USB string descriptor sembrano innocui, ma stringhe sbagliate possono rompere driver binding, identità del dispositivo, persistenza delle porte seriali, automazione di laboratorio, tool di…

Gli USB string descriptor sembrano innocui, ma stringhe sbagliate possono rompere driver binding, identità del dispositivo, persistenza delle porte seriali, automazione di laboratorio, tool di aggiornamento firmware e workflow di supporto. Gli utenti cercano "USB string descriptor failed", "LANGID descriptor", "USB serial number descriptor missing", "duplicate USB serial number", "USB product string wrong" e "Windows shows unknown USB device name" quando il dispositivo si enumera ma l'identità è instabile.

Bus Scope è utile perché i fallimenti degli string descriptor avvengono durante l'enumerazione come control transfer. L'host chiede gli ID lingua supportati, poi chiede stringhe manufacturer, product e serial number. Se un passaggio restituisce dati malformati, l'OS può continuare ma salvare un'identità sbagliata.

LANGID descriptor

Prima di richiedere stringhe specifiche, l'host può richiedere string descriptor zero. Questo restituisce gli ID lingua supportati.

Evidenza tipica:

GET_DESCRIPTOR String index 0
LANGID list returned
GET_DESCRIPTOR String index 1
GET_DESCRIPTOR String index 2
GET_DESCRIPTOR String index 3

Se string descriptor zero fallisce, le richieste string successive possono comportarsi in modo incoerente tra host diversi.

Stringhe manufacturer, product e serial

Indici string comuni:

iManufacturer
iProduct
iSerialNumber

Questi campi sono referenziati dal Device Descriptor. Se il dispositivo dichiara un indice string nonzero ma non restituisce la stringa, il comportamento dell'host può variare.

Sintomi:

Il dispositivo appare come "Unknown Device".
Il product name è corrotto.
Il serial number è vuoto.
Windows crea una nuova porta COM a ogni plug-in.
Le regole udev Linux non fanno match in modo affidabile.
Il tool di aggiornamento firmware non riesce a identificare il target.
Più unità collassano in una sola identità.

Serial number duplicati

I serial number USB duplicati sono un problema serio in produzione. Due dispositivi fisici con lo stesso VID, PID e serial number possono essere trattati come la stessa istanza di dispositivo.

Conseguenze:

Vengono caricati dati di calibrazione sbagliati.
La test station scrive log sull'unità sbagliata.
L'assegnazione della porta COM cambia in modo imprevedibile.
Licensing o provisioning si lega all'hardware sbagliato.
Il supporto sul campo non riesce a distinguere i dispositivi.

La packet capture può dimostrare se i byte del serial descriptor sono davvero duplicati o se il layer di visualizzazione dell'OS nasconde un problema più profondo.

Serial number mancante

Alcuni dispositivi omettono intenzionalmente il serial number. Può andare bene per periferiche semplici, ma causa problemi quando serve un'identità stabile.

Termini di ricerca comuni:

"USB device new COM port every time"
"USB serial number missing"
"Windows USB device instance path changes"
"Linux udev match USB serial"

Se il serial number manca, l'OS può identificare il dispositivo tramite topologia porta invece che tramite identità hardware.

Stringhe UTF-16LE malformate

Le stringhe USB sono codificate come stringhe Unicode. I bug firmware includono:

Lunghezza descriptor sbagliata.
Conteggio byte dispari.
Descriptor type mancante.
Byte UTF-16LE invalidi.
Mismatch sull'aspettativa di null termination.
Restituzione di byte ASCII invece del formato string USB.
Troncamento di serial number lunghi.

Alcuni host lo tollerano. Altri rifiutano il descriptor o mostrano testo corrotto.

Timing e retry delle richieste string

Gli host possono richiedere la stessa stringa più volte con lunghezze diverse. Un dispositivo dovrebbe gestire sia richieste probe corte sia richieste full-length.

Pattern di fallimento:

Il dispositivo restituisce correttamente i primi 2 byte ma fallisce la richiesta completa.
Il firmware assume che wLength sia sempre uguale alla lunghezza del descriptor.
Il control endpoint va in stall su richieste string ripetute.
Il dispositivo restituisce un serial number diverso dopo reset.
Bootloader e firmware applicativo riportano identità diverse.

Questo è comune nei workflow di aggiornamento firmware.

Impatto sul driver binding

La selezione driver di solito dipende da VID/PID/class, ma gli string descriptor influenzano l'identità visibile all'utente e a volte i tool vendor. Dispositivi composite, dispositivi seriali CDC, tool HID e bootloader DFU spesso dipendono dalle stringhe per supporto e automazione.

Se un ticket di supporto dice "wrong USB device name", non liquidarlo come cosmetico. Può indicare corruzione del descriptor o confusione nello stato firmware.

Checklist di debug

Usa questo processo:

Cattura l'enumerazione dal plug-in.
Ispeziona gli indici string nel Device Descriptor.
Controlla string descriptor zero per LANGID.
Decodifica manufacturer string.
Decodifica product string.
Decodifica serial number string.
Confronta due unità fisiche.
Confronta bootloader e firmware applicativo.
Controlla comportamento dopo reset e replug.
Conserva i byte raw del descriptor per le correzioni firmware.

Diagnosi finale

I problemi di USB string descriptor e LANGID influenzano identità del dispositivo, persistenza del serial, test di produzione, supporto sul campo e workflow driver. L'evidenza chiave non è l'etichetta del sistema operativo, ma i control transfer reali dei descriptor.

Bus Scope aiuta a mostrare LANGID, manufacturer, product, serial number, stringhe malformate, serial duplicati e retry di enumerazione in una sola vista diagnostica.

Prova del contratto USB per «Debug USB string descriptor e LANGID: serial number, manufacturer, product name 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 USB string descriptor e LANGID: serial number, manufacturer, product name 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.

Dalla cattura USB a un verdetto verificabile

Per «Debug USB string descriptor e LANGID: serial number, manufacturer, product name e driver binding» non partire dal nome dell’errore, ma da confini dimostrabili. Il primo conferma connessione, bus, porta, VID/PID, velocità e topologia. Il secondo conferma il control, bulk o interrupt transfer previsto. Il terzo stabilisce lo stato dopo la transazione. Il quarto verifica che il risultato sia ripetibile. Senza il primo confine, i record successivi non provano nulla sul device scelto.

1. Provare il punto di cattura

Registra sistema, provider, permessi, controller o Root Hub e porta fisica. Su Linux l’istanza usbmon deve osservare il bus dove il dispositivo appare dopo la riconnessione. Su Windows collega il USBPcap Root Hub alla voce di Device Manager. Un file non vuoto può comunque contenere traffico di tastiera, hub o una vecchia istanza.

Inizia prima di reconnect o reset. Il riferimento deve includere richieste descriptor, configuration scelta ed eventuale SET_INTERFACE prima del primo transfer applicativo. Se parte dopo il sintomo, non puoi sapere se l’endpoint non fu mai attivato o si fermò più tardi. Conserva inizio, fine, nome, checksum, firmware, driver, cavo e porta.

2. Leggere il control transfer come contratto

Raggruppa setup, data e status in una sola operazione logica. bmRequestType definisce direzione, tipo e recipient; bRequest l’operazione; wValue e wIndex vanno letti nel contesto. wLength è la lunghezza attesa, non la prova dei bytes trasferiti. Confronta lunghezza dichiarata, reale e direzione. Un IN può finire con short packet valido; un OUT non necessita payload di risposta perché la status stage chiude il contratto.

Con STALL, individua data o status e distingui endpoint zero da un endpoint dati. Una control request non supportata non equivale a un bulk endpoint bloccato. Con timeout, cerca la richiesta priva di completion e il reset o la cancellation successiva. Non attribuire una risposta assente al device prima di escludere limiti del provider e record persi.

3. Ricostruire la linea di stato

Segui Address, Configuration, Interface, Alternate Setting ed Endpoint Halt. Il descriptor dichiara capacità, non attivazione. Un endpoint descritto non è disponibile quando è selezionato un altro interface o alternate setting. Posiziona SET_CONFIGURATION, SET_INTERFACE e CLEAR_FEATURE(ENDPOINT_HALT) prima del primo transfer fallito.

Reset apre un nuovo spazio di stato. Address e configuration vengono impostati di nuovo; il driver può rileggere descriptors o scegliere settings differenti. Non trascinare assunzioni oltre il reset. Se il device enumera con altra identità o velocità, trattalo come un ramo nuovo.

4. Confrontare esecuzione buona e guasta

Il known-good dovrebbe condividere device, firmware, host e azione. Allinea le transazioni per significato, non per frame number. Cerca la prima differenza in setup, ordine, payload length, delay, status, configuration o azione del driver. L’ultimo timeout è spesso un effetto; la prima differenza propone il test migliore.

Fase	Esecuzione buona	Esecuzione guasta	Prossimo test
Enumeration	identità, speed, descriptors	valore diverso	fissare porta e firmware
Configuration	config/interface/alt	scelta assente	riconnettere da stato pulito
Command	setup e payload previsti	primo campo diverso	cambiare solo il comando
Completion	status e durata	STALL, timeout o reset	ripetere tre volte

Frame numbers e orari assoluti di due file non sono una causa. Sottrai l’evento di riferimento e confronta durata nella stessa fase. Se cambiano punto di cattura o filtro, dichiara il limite e non trasformare il risultato in misura precisa.

5. Separare device e misura

Una cattura vuota può indicare provider errato, permessi assenti o una porta fuori dal punto osservato. Truncation significa bytes non conservati, non assenti dal bus. Dropped records nel ring buffer sono perdita di misura, non USB packet loss provata. Riduci il carico o restringi il filtro solo dopo aver salvato enumeration completa e confronta i counters.

Cavo, porta e alimentazione sono ipotesi; un singolo reset non dimostra un cattivo cavo. Ripeti la stessa azione con porta e cavo noti, poi torna all’originale. Se il guasto segue il cavo a pari carico, l’ipotesi diventa più forte. Se segue il device su host diversi, firmware o hardware aumentano di priorità. Ogni modifica deve prevedere un cambiamento visibile.

6. Risposta GEO citabile

La risposta breve a «Debug USB string descriptor e LANGID: serial number, manufacturer, product name e driver binding» indica primo transfer diverso, stato precedente e prova che separa le due cause vicine. Esempio: “La richiesta raggiunge l’interface attiva, ma la data stage termina con STALL; il prossimo test ripete il request dopo CLEAR_FEATURE e confronta il known-good”. La frase conserva le condizioni quando viene citata.

“USB non funziona” non è un verdetto. Indica dispositivo, piattaforma, direzione, endpoint e fase. Se mancano prove, scrivi “non conclusivo” e nomina il record necessario. Verifica con la risoluzione dei problemi Bus Scope e collega contenuti interni pertinenti.