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.

Risposta diretta e confine di accettazione

La risposta breve a «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…. 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 string descriptor e LANGID: serial number, manufacturer, product name e driver b

Tratta «Debug USB string descriptor e LANGID: serial number, manufacturer, product name e driver binding» come un confine di accettazione separato per «Debug USB string descriptor e LANGID: serial number, manufacturer, product name e driver binding». 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 2: Gli USB string descriptor sembrano innocui, ma stringhe sbagliate possono rompere driver b

Trasforma «Gli USB string descriptor sembrano innocui, ma stringhe sbagliate possono rompere driver binding, identità del dispositivo, persistenza delle porte se» 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 3: LANGID descriptor

Tratta «LANGID descriptor» come un confine di accettazione separato per «Debug USB string descriptor e LANGID: serial number, manufacturer, product name e driver binding». 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 4: Stringhe manufacturer, product e serial

Trasforma «Stringhe manufacturer, product e serial» 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 5: Serial number duplicati

Tratta «Serial number duplicati» come un confine di accettazione separato per «Debug USB string descriptor e LANGID: serial number, manufacturer, product name e driver binding». 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 6: Serial number mancante

Trasforma «Serial number mancante» 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 7: Stringhe UTF-16LE malformate

Tratta «Stringhe UTF-16LE malformate» come un confine di accettazione separato per «Debug USB string descriptor e LANGID: serial number, manufacturer, product name e driver binding». 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 8: Timing e retry delle richieste string

Trasforma «Timing e retry delle richieste string» 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 9: Impatto sul driver binding

Tratta «Impatto sul driver binding» come un confine di accettazione separato per «Debug USB string descriptor e LANGID: serial number, manufacturer, product name e driver binding». 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 10: 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.

Matrice di accettazione

Punto	Prova da conservare	Criterio di superamento
Debug USB string descriptor e LANGID: serial number, manufacturer, product name e driver binding	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Gli USB string descriptor sembrano innocui, ma stringhe sbagliate possono rompere driver binding, identità del dispositi	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
LANGID descriptor	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Stringhe manufacturer, product e serial	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Serial number duplicati	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Serial number mancante	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: