2026-06-02

Debug USB remote wakeup e suspend/resume: selective suspend, segnali di resume e wake mancati

I bug di power management USB sono difficili da diagnosticare perché il dispositivo può funzionare perfettamente mentre il sistema è attivo e fallire solo dopo idle, sleep, selective suspend, sleep del dock, chiusura del coperchio del laptop o spegnimento del monitor. Gli utenti cercano "USB remote wakeup not working", "USB selective suspend disconnect", "USB device does not wake computer", "USB resume failure", "USB suspend resume bug" e "HID keyboard wake from sleep not working".

Bus Scope è utile perché suspend e resume sono eventi a livello bus, non solo errori applicativi. Devi vedere se l'host ha sospeso il dispositivo, se il remote wakeup era abilitato, se il dispositivo ha segnalato resume, se l'host ha ripreso il traffico e se il dispositivo ha fatto re-enumeration invece di fare resume.

Che cosa significa remote wakeup

Remote wakeup consente a un dispositivo USB sospeso di chiedere all'host di riprendere la comunicazione. Esempi comuni includono:

Tastiera che sveglia un desktop in sleep.
Mouse che sveglia un laptop da idle.
Pulsante del dock che sveglia una workstation.
Scanner barcode che sveglia un kiosk.
Controller industriale che sveglia un panel PC.
Sensore HID che sveglia l'host dopo un evento esterno.

Remote wakeup non significa semplicemente "il dispositivo ha alimentazione". L'host deve consentirlo, il dispositivo deve dichiarare il supporto, la feature deve essere abilitata e il resume signaling deve avvenire al momento giusto.

Sintomi comuni

I problemi di remote wakeup e suspend si presentano come:

Il dispositivo funziona finché il PC non va in sleep.
Il dispositivo non sveglia il computer.
Il dispositivo sveglia il sistema subito dopo suspend.
Il dispositivo scompare dopo resume.
Il dispositivo fa re-enumeration con un nuovo address.
Input HID perso dopo idle.
Dispositivo seriale che smette di inviare dopo selective suspend.
Dispositivo audio o camera che torna da sleep senza dati.
Firmware che recupera solo dopo unplug/replug.

Questi sintomi vengono spesso attribuiti ai driver, ma la cattura può mostrare un problema di power-state nel firmware.

Evidenza da descriptor e feature

Il configuration descriptor può dichiarare la capacità remote wakeup. L'host può quindi abilitare o disabilitare la feature remote wakeup. Una traccia diagnostica USB utile dovrebbe rispondere:

Il dispositivo dichiara remote wakeup?
L'host ha inviato SET_FEATURE(DEVICE_REMOTE_WAKEUP)?
L'host ha poi fatto clear della feature?
Il suspend è avvenuto dopo idle?
Il dispositivo ha tentato resume signaling?
L'host ha ripreso i transfer normali?

Senza questi fatti, la diagnosi è congettura.

Selective suspend

Selective suspend consente al sistema operativo di sospendere un dispositivo USB inattivo senza mettere in sleep l'intero sistema. Questo risparmia energia, ma espone bug firmware.

Pattern di fallimento:

Il dispositivo entra in low-power state ma non ripristina lo stato degli endpoint.
Il firmware perde lo stato pending interrupt IN.
Il dispositivo risponde NAK all'infinito dopo resume.
L'host resetta il dispositivo dopo timeout.
L'applicazione vede timeout o rimozione del dispositivo.
Un dispositivo composite riprende una interfaccia ma non un'altra.

Chi cerca spesso scrive "USB selective suspend random disconnect" perché il dispositivo sembra disconnettersi anche se l'evento reale è un fallimento suspend/resume.

Resume vs re-enumeration

Dopo sleep ci sono due esiti molto diversi:

Resume: lo stesso dispositivo continua con la configurazione esistente.
Re-enumeration: l'host resetta ed enumera di nuovo il dispositivo.

La re-enumeration può essere accettabile dopo una disconnessione fisica, ma è sospetta dopo un suspend normale. Può rompere applicazioni che mantengono handle aperti, nomi di porte seriali, path HID o sessioni di capture camera.

Bus Scope dovrebbe aiutare a capire se la traccia contiene traffico di resume normale o una nuova sequenza di enumerazione con GET_DESCRIPTOR, SET_ADDRESS e SET_CONFIGURATION.

Wake event mancati

A volte il dispositivo vede l'evento esterno ma l'host non si sveglia. Le cause includono:

Remote wakeup non dichiarato.
Remote wakeup non abilitato dall'host.
Il dispositivo invia resume troppo presto.
Il dispositivo invia resume troppo tardi.
L'hub blocca o gestisce male il wake signaling.
Policy wake di BIOS o OS che disabilita la porta.
Firmware del dispositivo che entra in sleep più profondo del previsto.
Evento che avviene prima che il suspend sia completo.

L'evidenza a livello pacchetto non sostituisce la power policy dell'OS, ma restringe la domanda. Il dispositivo aveva il permesso di svegliare l'host e ha tentato di farlo?

Wake immediato dopo suspend

Anche il problema opposto è comune: il sistema va in suspend e si sveglia subito. I dispositivi USB possono causarlo quando segnalano wake per input residuo, stato interrupt rumoroso, bug di debounce o firmware che tratta suspend come un nuovo evento.

Evidenza da raccogliere:

Ultimo interrupt report prima del suspend.
Se l'host ha abilitato wake.
Timing tra suspend e resume.
Device class e interfaccia.
Se lo stesso endpoint aveva dati pending.
Se l'evento si ripete a ogni tentativo di suspend.

È particolarmente comune con tastiere, mouse, touch panel, game controller e dispositivi HID custom.

Checklist di debug

Usa questo processo:

Cattura l'enumerazione dal plug-in.
Conferma la capacità remote wakeup nei descriptor.
Controlla se l'host abilita remote wakeup.
Registra il periodo idle prima del suspend.
Identifica il timing del suspend.
Cerca resume signaling o traffico di resume dell'host.
Separa resume da re-enumeration completa.
Controlla il comportamento degli endpoint dopo resume.
Confronta lo stesso dispositivo su porta diretta e attraverso hub.
Conserva pacchetti sia pre-suspend sia post-resume.

Diagnosi finale

I bug USB remote wakeup e suspend/resume sono problemi di protocollo nello stato di alimentazione. L'evidenza utile è capacità nel descriptor, selezione feature da parte dell'host, timing del suspend, resume signaling, recovery degli endpoint e se l'host ha fatto resume o re-enumeration del dispositivo.

Bus Scope rende visibile questa evidenza, così "USB wake not working" diventa una diagnosi concreta invece di un ciclo di colpe attribuite al driver.

Prova del contratto USB per «Debug USB remote wakeup e suspend/resume: selective suspend, segnali di resume e wake mancati»

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 remote wakeup e suspend/resume: selective suspend, segnali di resume e wake mancati» 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 remote wakeup e suspend/resume: selective suspend, segnali di resume e wake mancati» è: I bug di power management USB sono difficili da diagnosticare perché il dispositivo può funzionare perfettamente mentre il sistema è attivo e fallire solo dopo idle, sleep, selective suspend, sleep del…. 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 remote wakeup e suspend/resume: selective suspend, segnali di resume e wake manc

Chiudi «Debug USB remote wakeup e suspend/resume: selective suspend, segnali di resume e wake mancati» 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 2: I bug di power management USB sono difficili da diagnosticare perché il dispositivo può fu

Per «I bug di power management USB sono difficili da diagnosticare perché il dispositivo può funzionare perfettamente mentre il sistema è attivo e fallire », 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 3: Che cosa significa remote wakeup

Chiudi «Che cosa significa remote wakeup» 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 4: Sintomi comuni

Per «Sintomi comuni», 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 5: Evidenza da descriptor e feature

Chiudi «Evidenza da descriptor e feature» 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 6: Selective suspend

Per «Selective suspend», 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 7: Resume vs re-enumeration

Chiudi «Resume vs re-enumeration» 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 8: Wake event mancati

Per «Wake event mancati», 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 9: Wake immediato dopo suspend

Chiudi «Wake immediato dopo suspend» 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 10: Checklist di debug

Per «Checklist di debug», 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.

Matrice di accettazione

Punto	Prova da conservare	Criterio di superamento
Debug USB remote wakeup e suspend/resume: selective suspend, segnali di resume e wake mancati	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
I bug di power management USB sono difficili da diagnosticare perché il dispositivo può funzionare perfettamente mentre	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Che cosa significa remote wakeup	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Sintomi comuni	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Evidenza da descriptor e feature	Stato iniziale, un’azione e stato risultante	Una seconda persona riproduce il risultato
Selective suspend	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: