2026-06-03

Debug USB HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti

Come diagnosticare cambio tra USB HID Boot Protocol e Report Protocol, richieste SetProtocol, modalità BIOS della tastiera, report ID, tasti mancanti e compatibilità firmware HID.

Tastiere e mouse USB HID possono usare Boot Protocol o Report Protocol. Gli utenti cercano "HID Boot Protocol", "HID Report Protocol", "USB keyboard BIOS mode", "SetProtocol HID", "keyboard works in BIOS but not OS" e "HID report ID missing keys" quando l'input funziona in un ambiente ma fallisce in un altro.

Bus Scope è utile perché l'host può inviare richieste di classe HID che cambiano il formato dei report del dispositivo. Se il firmware ignora SetProtocol o invia il formato report sbagliato, alcuni tasti possono sparire anche se il dispositivo enumera correttamente.

Boot Protocol

Boot Protocol è un formato HID semplificato usato da BIOS, UEFI, ambienti pre-boot e stack host semplici. Permette a tastiere e mouse di base di funzionare prima che sia disponibile un parser HID completo.

Sintomi che coinvolgono Boot Protocol:

La tastiera funziona nel BIOS ma fallisce nel sistema operativo.
La tastiera funziona nel sistema operativo ma non nel menu di boot.
I tasti speciali spariscono in modalità pre-boot.
Il mouse funziona solo dopo il caricamento del sistema operativo.
Il firmware invia report ID quando il boot report non ne prevede.

La domanda diagnostica è quale protocollo ha selezionato l'host.

Report Protocol

Report Protocol usa il descrittore di report HID. Supporta layout più ricchi, report ID, report vendor-defined, tasti multimediali, sensori e comportamento composito.

Se l'host passa a Report Protocol ma il dispositivo continua a inviare report Boot, il sistema operativo può interpretare male l'input. Se l'host richiede Boot Protocol ma il dispositivo invia Report Protocol, il BIOS può ignorare i report.

Richiesta SetProtocol

La richiesta di classe HID SetProtocol può passare tra Boot Protocol e Report Protocol per i dispositivi che li supportano.

Evidenze da raccogliere:

Descrittore interfaccia HID.
Valori di sottoclasse e protocollo Boot.
Descrittore di report.
Richiesta SetProtocol.
Valore di protocollo selezionato dall'host.
Byte dei report interrupt IN prima e dopo il cambio.

Bus Scope può rendere visibile questa sequenza.

Report ID e tasti mancanti

Report Protocol può usare report ID. Boot Protocol spesso si aspetta report di dimensione fissa senza prefisso report ID.

Bug firmware comuni:

Il dispositivo include il report ID in Boot Protocol.
Il dispositivo omette il report ID in Report Protocol.
Il dispositivo cambia dimensione del report ma il descrittore non corrisponde.
I tasti multimediali sono solo in un report secondario.
Il report NKRO viene inviato prima che l'host lo abiliti.
La tastiera invia un report vendor sull'endpoint tastiera.

Questi bug generano ricerche come "USB keyboard missing keys" e "HID report ID wrong."

BIOS vs comportamento del sistema operativo

Gli ambienti BIOS e UEFI sono di solito più rigidi e semplici rispetto ai sistemi operativi completi. Una tastiera può sembrare corretta su Windows o Linux ma fallire prima del boot.

Confronto utile:

Acquisisci durante il pre-boot, se possibile con un analizzatore esterno.
Acquisisci dopo il caricamento del sistema operativo.
Confronta il comportamento SetProtocol.
Confronta il formato del payload dei report.
Controlla se il dispositivo si resetta tra gli ambienti.

Anche se l'acquisizione pre-boot è difficile, le evidenze SetProtocol lato sistema operativo possono rivelare assunzioni del firmware.

Checklist di debug

Usa questo processo:

Acquisisci l'enumerazione.
Ispeziona sottoclasse e protocollo dell'interfaccia HID.
Ispeziona il descrittore di report HID.
Trova le richieste SetProtocol.
Decodifica il protocollo selezionato.
Confronta i report interrupt IN prima e dopo.
Controlla l'uso dei report ID.
Testa tasti normali e tasti multimediali.
Confronta comportamento in BIOS, bootloader, Windows e Linux.
Conserva insieme descrittori e byte dei report.

Diagnosi finale

I fallimenti HID Boot Protocol e Report Protocol sono problemi di negoziazione del formato report. Il dispositivo può enumerare correttamente e allo stesso tempo inviare report nel formato di protocollo sbagliato.

Bus Scope aiuta a provare se tasti mancanti, fallimenti di input nel BIOS o problemi di compatibilità HID derivano da gestione di SetProtocol, report ID, mismatch dei descrittori o formattazione dei report firmware.

Prova del contratto USB per «Debug USB HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti»

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 HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti» 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 HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti» è: Come diagnosticare cambio tra USB HID Boot Protocol e Report Protocol, richieste SetProtocol, modalità BIOS della tastiera, report ID, tasti mancanti e compatibilità firmware HID. 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 HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti

Trasforma «Debug USB HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti» 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: Come diagnosticare cambio tra USB HID Boot Protocol e Report Protocol, richieste SetProtoc

Tratta «Come diagnosticare cambio tra USB HID Boot Protocol e Report Protocol, richieste SetProtocol, modalità BIOS della tastiera, report ID, tasti mancanti » come un confine di accettazione separato per «Debug USB HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti». 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: Boot Protocol

Trasforma «Boot Protocol» 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: Report Protocol

Tratta «Report Protocol» come un confine di accettazione separato per «Debug USB HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti». 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: Richiesta SetProtocol

Trasforma «Richiesta SetProtocol» 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: Report ID e tasti mancanti

Tratta «Report ID e tasti mancanti» come un confine di accettazione separato per «Debug USB HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti». 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: BIOS vs comportamento del sistema operativo

Trasforma «BIOS vs comportamento del sistema operativo» 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 «Debug USB HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti». 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 «Debug USB HID Boot Protocol e Report Protocol: SetProtocol e

Tratta «Prova del contratto USB per «Debug USB HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti»» come un confine di accettazione separato per «Debug USB HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti». 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
Debug USB HID Boot Protocol e Report Protocol: SetProtocol e tasti mancanti	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Come diagnosticare cambio tra USB HID Boot Protocol e Report Protocol, richieste SetProtocol, modalità BIOS della tastie	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Boot Protocol	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Report Protocol	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Richiesta SetProtocol	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Report ID e tasti mancanti	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: