Debug USB selective suspend: disconnessioni casuali, errori sleep/resume e transfer mancanti
USB selective suspend dovrebbe risparmiare energia. Quando funziona, i dispositivi inattivi entrano in uno stato a basso consumo e riprendono quando serve.
USB selective suspend dovrebbe risparmiare energia. Quando funziona, i dispositivi inattivi entrano in uno stato a basso consumo e riprendono quando serve. Quando fallisce, gli utenti vedono disconnessioni casuali, dati mancanti, camere bloccate, porte seriali che smettono di rispondere, dispositivi HID che perdono input o dispositivi che spariscono dopo sleep. Ricerche come "USB selective suspend random disconnect", "USB device stops working after idle", "USB resume failure" e "disable USB selective suspend" arrivano di solito da persone che hanno già provato cavi e driver.
Disabilitare selective suspend può essere un workaround, ma non è una diagnosi. La vera domanda è se il dispositivo, il driver, l'hub, l'host controller o l'applicazione fallisce durante suspend/resume o durante il recovery dopo idle.
Bus Scope aiuta perché il fallimento ha una timeline. Devi sapere quale traffico c'è stato prima di idle, se l'host ha sospeso il percorso, quale richiesta ha fatto resume del dispositivo e quale transfer è fallito dopo resume.
Che cosa fa selective suspend
Selective suspend consente al sistema operativo di sospendere un singolo dispositivo o una singola interfaccia USB mentre il resto del sistema rimane attivo. È diverso dal full system sleep. Un dispositivo USB può essere sospeso perché sembra inattivo anche mentre il computer è acceso.
Questo conta per:
- Adattatori seriali USB
- Dispositivi HID
- Camere USB
- Interfacce audio
- Debug probe
- Security token
- Dispositivi vendor custom
- Sensori bus-powered
Se il firmware del dispositivo non gestisce correttamente suspend/resume, il primo transfer dopo idle può fallire.
Sintomi tipici
I problemi di selective suspend spesso appaiono come:
- Il dispositivo funziona dopo il plug-in ma fallisce dopo alcuni minuti.
- Il primo comando dopo idle va in timeout.
- Una serial read resta bloccata per sempre dopo inattività.
- L'anteprima camera si blocca dopo screen lock.
- I report HID si fermano fino a unplug/replug.
- Il dispositivo si riconnette con un nuovo address.
- L'applicazione dice che il dispositivo è disconnesso anche se è ancora fisicamente collegato.
- I log Windows o Linux mostrano messaggi legati a reset o resume.
Il pattern chiave è il tempo. Se il fallimento segue periodi idle, sleep/resume, display off o cambi dello stato di alimentazione del laptop, il power management va incluso nell'indagine.
Fallimento di suspend vs fallimento di resume
Ci sono due problemi diversi:
- Fallimento di suspend: il dispositivo o il driver non riesce a entrare correttamente in low power.
- Fallimento di resume: il dispositivo entra in low power ma non torna correttamente.
Dal punto di vista dell'utente entrambi possono sembrare "device disconnected". La traccia USB può separarli mostrando se il traffico si è fermato in modo pulito e se la richiesta successiva dopo idle è fallita.
Se il dispositivo sparisce solo dopo che l'applicazione invia un comando dopo idle, sospetta resume o ripristino dello stato firmware. Se il dispositivo si resetta mentre è idle senza richieste applicative, sospetta power management host, comportamento hub o watchdog firmware del dispositivo.
Primo transfer dopo idle
Il primo transfer dopo idle è spesso l'evidenza più importante. Può essere:
- Una control request.
- Una bulk read o write.
- Un polling interrupt IN.
- Una class-specific request.
- Un vendor command.
- Una richiesta di restart stream.
Se il primo transfer va in timeout, stall o innesca reset, probabilmente il dispositivo non ha fatto resume nello stato atteso. La correzione può riguardare gestione firmware del resume, driver power policy, retry applicativi o disabilitazione di selective suspend per quel dispositivo.
Runtime power management su Linux
Linux ha anche USB runtime power management. I dispositivi possono fare autosuspend dopo un idle delay. Un dispositivo può comportarsi in modo diverso a seconda di driver, versione kernel, impostazioni autosuspend e se un'applicazione mantiene il dispositivo aperto.
Per indagini Linux, cattura il traffico e correlalo con i log di sistema. Se il dispositivo fa resume e subito si resetta, la traccia bus è più utile di un generico "I/O error" dell'applicazione.
Windows selective suspend
Su Windows, il comportamento di selective suspend dipende da power plan, supporto driver, impostazioni USB hub e device class. Gli utenti spesso disabilitano "USB selective suspend setting" nelle opzioni risparmio energia. Può essere un workaround pratico, ma una diagnosi professionale dovrebbe comunque spiegare se il dispositivo è fallito durante il recovery da idle.
I problemi USB su Windows possono essere influenzati anche da Modern Standby, comportamento dei dock laptop, hub e driver host controller. Un dispositivo può funzionare su un desktop ma fallire su un dock laptop perché suspend e resume si comportano in modo diverso.
Strategia di capture
Per catturare un bug di selective suspend:
- Avvia la capture mentre il dispositivo funziona.
- Esegui un'operazione nota e riuscita.
- Lascia il dispositivo idle abbastanza a lungo da attivare il problema.
- Esegui l'operazione che di solito fallisce.
- Continua la capture fino a timeout, reset o reconnect.
- Salva l'intera finestra temporale.
Non avviare la capture solo dopo che il dispositivo è già fallito. Serve la transizione da attivo a idle a fallimento.
Che cosa cercare
Nella traccia, ispeziona:
- Ultimo transfer prima di idle.
- Gap temporale prima del fallimento.
- Primo transfer dopo idle.
- Timeout, stall, reset o disconnessione.
- Re-enumeration dopo il fallimento.
- Cambio di device address.
- Class-specific request dopo resume.
- Endpoint halt recovery.
- Cambi di alternate setting per dispositivi di streaming.
Il timing qui non è rumore. Il timing è l'evidenza.
Checklist di debug
Usa questo ordine:
- Conferma se i fallimenti correlano con il tempo idle.
- Prova con alimentazione AC e batteria.
- Prova porta diretta vs hub o dock.
- Cattura prima di idle e fino al fallimento.
- Identifica il primo transfer fallito dopo idle.
- Controlla se il dispositivo si resetta o se fallisce solo un transfer.
- Confronta con selective suspend disabilitato.
- Confronta un altro OS o host controller.
- Controlla la gestione firmware del resume.
- Controlla driver power policy e retry applicativi.
Diagnosi finale
I problemi USB selective suspend non si risolvono bene tirando a indovinare. Disabilitare il power management può ridurre i sintomi, ma la vera risposta ingegneristica arriva dalla timeline USB: traffico attivo, gap idle, tentativo di resume, transfer fallito, reset o recovery.
Bus Scope aiuta a conservare e ispezionare questa evidenza, così una "random USB disconnect" può essere diagnosticata come uno specifico fallimento di suspend/resume, driver, firmware, hub o power management.
<!-- bus-scope-localized-transaction-foundation-v1:start -->Prova del contratto USB per «Debug USB selective suspend: disconnessioni casuali, errori sleep/resume e transfer 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 selective suspend: disconnessioni casuali, errori sleep/resume e transfer 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.
<!-- bus-scope-localized-transaction-foundation-v1:end --><!-- bus-scope-localized-evidence-verdicts-v1:start -->Dalla cattura USB a un verdetto verificabile
Per «Debug USB selective suspend: disconnessioni casuali, errori sleep/resume e transfer mancanti» 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 selective suspend: disconnessioni casuali, errori sleep/resume e transfer mancanti» 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.
<!-- bus-scope-localized-evidence-verdicts-v1:end -->