2026-06-02

USB remote wakeup과 suspend/resume 디버깅

USB power management bug는 진단이 어렵습니다. 시스템이 active일 때는 장치가 완벽하게 동작하다가 idle, sleep, selective suspend, dock sleep, laptop lid close, monitor power-off 이후에만 실패할 수 있기 때문입니다.

USB power management bug는 진단이 어렵습니다. 시스템이 active일 때는 장치가 완벽하게 동작하다가 idle, sleep, selective suspend, dock sleep, laptop lid close, monitor power-off 이후에만 실패할 수 있기 때문입니다. 사용자는 "USB remote wakeup not working", "USB selective suspend disconnect", "USB device does not wake computer", "USB resume failure", "USB suspend resume bug", "HID keyboard wake from sleep not working" 같은 표현을 검색합니다.

Bus Scope가 유용한 이유는 suspend와 resume이 단순한 application error가 아니라 bus-level event이기 때문입니다. host가 장치를 suspend했는지, remote wakeup이 enable되었는지, 장치가 resume signaling을 보냈는지, host가 traffic을 재개했는지, 장치가 resume 대신 re-enumeration되었는지를 봐야 합니다.

Remote wakeup의 의미

Remote wakeup은 suspend된 USB device가 host에게 communication resume을 요청할 수 있게 해줍니다. 흔한 예는 다음과 같습니다.

Keyboard가 sleeping desktop을 깨웁니다.
Mouse가 idle 상태의 laptop을 깨웁니다.
Dock button이 workstation을 깨웁니다.
Barcode scanner가 kiosk를 깨웁니다.
Industrial controller가 panel PC를 깨웁니다.
HID sensor가 external event 이후 host를 깨웁니다.

Remote wakeup은 단순히 "장치에 전원이 있다"는 뜻이 아닙니다. host가 허용해야 하고, 장치가 support를 advertise해야 하며, feature가 enable되어야 하고, resume signaling이 올바른 timing에 발생해야 합니다.

흔한 증상

Remote wakeup 및 suspend 문제는 다음처럼 보입니다.

PC가 sleep되기 전까지는 장치가 동작합니다.
장치가 computer를 깨우지 못합니다.
장치가 suspend 직후 system을 즉시 깨웁니다.
Resume 이후 장치가 사라집니다.
장치가 새 address로 re-enumeration됩니다.
idle 이후 HID input이 누락됩니다.
selective suspend 이후 serial device가 전송을 멈춥니다.
audio 또는 camera device가 sleep에서 돌아온 뒤 data를 내지 않습니다.
firmware가 unplug/replug 이후에만 복구됩니다.

이 증상들은 driver 탓으로 돌려지는 경우가 많지만, capture가 firmware power-state 문제를 보여줄 수 있습니다.

Descriptor와 feature evidence

Configuration descriptor는 remote wakeup capability를 advertise할 수 있습니다. 이후 host는 remote wakeup feature를 enable 또는 disable할 수 있습니다. 유용한 USB diagnostic trace는 다음 질문에 답해야 합니다.

장치가 remote wakeup을 advertise하는가?
host가 SET_FEATURE(DEVICE_REMOTE_WAKEUP)을 보냈는가?
host가 나중에 feature를 clear했는가?
idle 이후 suspend가 발생했는가?
장치가 resume signaling을 시도했는가?
host가 normal transfer를 resume했는가?

이 사실들이 없으면 진단은 추측에 머뭅니다.

selective suspend 확인

Selective suspend는 운영체제가 전체 system을 sleep하지 않고도 idle USB device를 suspend할 수 있게 합니다. power를 절약하지만 firmware bug를 드러내기도 합니다.

Failure pattern:

장치가 low-power state에 들어가지만 endpoint state를 복구하지 못합니다.
Firmware가 pending interrupt IN state를 잃습니다.
Device가 resume 이후 계속 NAK만 응답합니다.
Host가 timeout 이후 device를 reset합니다.
Application이 timeout 또는 device removal을 봅니다.
Composite device가 한 interface만 resume하고 다른 interface는 복구하지 못합니다.

검색 사용자가 "USB selective suspend random disconnect"라고 입력하는 이유는 실제 event가 suspend/resume failure인데도 장치가 disconnect된 것처럼 보이기 때문입니다.

Resume과 re-enumeration 구분

Sleep 이후에는 완전히 다른 두 결과가 있습니다.

Resume: 같은 장치가 기존 configuration으로 계속 동작합니다.
Re-enumeration: host가 장치를 reset하고 다시 enumerate합니다.

Re-enumeration은 physical disconnect 이후라면 괜찮을 수 있지만, 정상 suspend 이후라면 수상합니다. open handle, serial port name, HID path, camera capture session을 유지하는 application을 깨뜨릴 수 있습니다.

Bus Scope는 trace에 normal resume traffic이 있는지, 아니면 GET_DESCRIPTOR, SET_ADDRESS, SET_CONFIGURATION을 포함한 새 enumeration sequence가 있는지 식별하는 데 도움을 줘야 합니다.

missed wake event 확인

장치가 external event를 보았지만 host가 깨어나지 않는 경우가 있습니다. 원인은 다음과 같습니다.

Remote wakeup이 advertise되지 않았습니다.
Remote wakeup이 host에 의해 enable되지 않았습니다.
Device가 resume을 너무 이르게 보냅니다.
Device가 resume을 너무 늦게 보냅니다.
Hub가 wake signaling을 block하거나 잘못 처리합니다.
BIOS 또는 OS wake policy가 port를 disable합니다.
Device firmware가 예상보다 더 깊은 sleep에 들어갑니다.
Suspend가 완료되기 전에 event가 발생합니다.

Packet-level evidence가 OS power policy를 대체하지는 않지만 질문을 좁혀줍니다. 장치가 host를 깨울 권한이 있었는가, 그리고 실제로 시도했는가?

Suspend 직후 즉시 wake

반대 문제도 흔합니다. system이 suspend되자마자 즉시 wake됩니다. USB device는 stale input, noisy interrupt state, debounce bug, suspend를 새 event로 처리하는 firmware 때문에 이런 wake를 일으킬 수 있습니다.

수집할 evidence:

suspend 전 마지막 interrupt report.
host가 wake를 enable했는지 여부.
suspend와 resume 사이의 timing.
Device class와 interface.
같은 endpoint에 pending data가 있었는지 여부.
모든 suspend attempt마다 같은 event가 반복되는지 여부.

이 문제는 keyboard, mouse, touch panel, game controller, custom HID device에서 특히 흔합니다.

디버그 checklist

다음 절차를 사용하세요.

plug-in부터 enumeration을 캡처합니다.
descriptor에서 remote wakeup capability를 확인합니다.
host가 remote wakeup을 enable하는지 확인합니다.
suspend 전 idle period를 기록합니다.
suspend timing을 식별합니다.
resume signaling 또는 host resume traffic을 찾습니다.
resume과 full re-enumeration을 분리합니다.
resume 이후 endpoint behavior를 확인합니다.
같은 장치를 direct port와 hub 경로에서 비교합니다.
pre-suspend packet과 post-resume packet을 모두 보존합니다.

최종 진단

USB remote wakeup 및 suspend/resume bug는 power-state protocol 문제입니다. 유용한 evidence는 descriptor capability, host feature selection, suspend timing, resume signaling, endpoint recovery, host가 resume했는지 re-enumeration했는지 여부입니다.

Bus Scope는 그 evidence를 보이게 만들어 "USB wake not working"을 driver blame loop가 아니라 구체적인 진단으로 바꾸는 데 도움을 줍니다.

“USB remote wakeup과 suspend/resume 디버깅”의 USB 계약 시험

직접적인 답은 STALL, timeout, reset 하나만으로 원인을 설명할 수 없다는 것입니다. 먼저 capture provider가 올바른 device를 보는지 증명하고 transfer 계약을 읽습니다. 종류, 방향, recipient, wValue, wIndex, 선언 길이, 실제 길이, status, 전후 상태를 확인하고 known-good과 처음 달라지는 transaction에 결론을 연결합니다.

경계	비교 근거	판단
platform	provider, 권한, Root Hub, usbmon/XHC20	올바른 연결의 record인가
setup	bmRequestType, bRequest, wValue, wIndex, wLength	host가 의도한 요청을 보냈는가
data	방향, 길이, 보존 bytes	payload가 계약과 맞는가
status	ACK, STALL, timeout, cancellation	transaction이 어디서 끝났는가
state	configuration, interface, alternate setting, halt	device가 요청을 받을 상태인가

reset과 enumeration 전부터 capture하여 descriptor, SET_CONFIGURATION, SET_INTERFACE, 실패 직전 command를 남깁니다. 좁은 endpoint filter는 결정적인 control transfer를 숨길 수 있습니다. 시험 한 번에는 문서화한 USB 동작 하나만 수행하고 firmware, driver, port, cable, host command, timing 중 하나만 바꿉니다.

인용 가능한 답

관찰한 request, setup field, 응답, 직전 상태를 쓰고 한 변수만 바꾸는 다음 시험을 제시합니다. retention 때문에 보존되지 않은 bytes는 packet loss 증명이 아닙니다. command와 reset의 시간적 근접은 상관관계이며 상태 전환이나 반복 없이 원인으로 단정할 수 없습니다.

VID/PID, firmware, speed, topology, provider, filter, trigger를 고정하고 usbmon과 USBPcap의 frame number 대신 USB 의미 단계로 비교합니다. 시작·종료, 버전, OS, 연결 위치, checksum을 기록하고 Bus Scope 문제 해결에서 검토합니다.

Semrush owner는 분리합니다. free USB analyzer는 제품 페이지, best USB protocol analyzer는 비교 페이지, USB descriptor viewer는 descriptor 안내가 담당합니다. 이 지원 글에 확인되지 않은 검색량이나 KD를 만들지 않습니다.

USB 캡처에서 검증 가능한 판정까지

“USB remote wakeup과 suspend/resume 디버깅”에서는 오류 이름이 아니라 증명 가능한 경계부터 확인합니다. 첫 경계는 올바른 connection, bus, port, VID/PID, speed, topology입니다. 둘째는 의도한 control, bulk, interrupt transfer이고, 셋째는 그 이후 device state이며, 넷째는 재현성입니다. 첫 경계의 증거가 없으면 뒤의 records는 대상 device를 설명하지 못합니다.

1. 캡처 지점을 증명하기

OS, provider, 권한, controller 또는 Root Hub, 물리 port를 기록합니다. Linux에서는 재연결 뒤 device가 나타난 bus와 usbmon instance가 같아야 합니다. Windows에서는 USBPcap Root Hub를 Device Manager 연결과 대조합니다. 파일에 records가 있어도 keyboard, hub, 오래된 device instance의 트래픽일 수 있습니다.

reconnect나 reset 전에 capture를 시작합니다. 기준 구간에는 descriptor requests, 선택된 configuration, 필요한 SET_INTERFACE, 첫 application transfer가 들어가야 합니다. 증상 뒤에 시작하면 endpoint가 한 번도 활성화되지 않았는지 나중에 멈췄는지 구분할 수 없습니다. 시작과 종료, 파일 이름, checksum, firmware, driver, cable, port를 남깁니다.

2. control transfer를 하나의 계약으로 읽기

setup, data, status를 하나의 논리 operation으로 묶습니다. bmRequestType은 방향, type, recipient를, bRequest는 operation을 나타냅니다. wValue와 wIndex는 request 문맥에서 해석합니다. wLength는 예상 길이이며 실제로 그 bytes가 전송되었다는 증거가 아닙니다. 선언 길이, 실제 길이, 방향을 비교합니다. IN request는 정상 short packet으로 끝날 수 있고 OUT request는 status stage가 계약을 닫으므로 응답 payload가 없어도 됩니다.

STALL에서는 data와 status, endpoint zero와 data endpoint를 구분합니다. 지원하지 않는 control request는 halt된 bulk endpoint와 다릅니다. timeout에서는 completion이 없는 request와 이어진 host reset 또는 cancellation을 찾습니다. provider 한계와 capture record 손실을 배제하기 전에 response 부재를 device failure로 단정하지 않습니다.

3. 상태 시간선을 다시 만들기

Address, Configuration, Interface, Alternate Setting, Endpoint Halt를 추적합니다. descriptor는 capability를 선언하지만 현재 활성 상태를 증명하지 않습니다. configuration descriptor에 endpoint가 있어도 다른 interface나 alternate setting이 선택되면 사용할 수 없습니다. SET_CONFIGURATION, SET_INTERFACE, CLEAR_FEATURE(ENDPOINT_HALT)와 첫 실패 transfer의 순서를 확인합니다.

reset은 상태 경계입니다. Address와 configuration이 다시 설정되고 driver가 descriptors를 다시 읽거나 다른 setting을 고를 수 있습니다. reset 이전 가정을 이후에 적용하지 않습니다. 재 enumeration에서 identity나 speed가 달라지면 새로운 사건 branch로 기록합니다.

4. known-good과 failure 비교

같은 device, firmware, host, action을 쓴 known-good을 선택합니다. frame number가 아니라 의미로 transactions를 정렬합니다. setup field, request order, payload length, delay, status, configuration, driver action의 첫 차이를 찾습니다. 마지막 timeout은 결과인 경우가 많고 첫 차이가 더 좋은 다음 test를 만듭니다.

단계	정상 실행	실패 실행	다음 시험
Enumeration	identity, speed, descriptors	다른 값	port와 firmware 고정
Configuration	config/interface/alt	선택 누락	clean state 재연결
Command	예상 setup과 payload	첫 field 차이	command만 변경
Completion	status와 duration	STALL, timeout, reset	세 번 재현

서로 다른 파일의 absolute time과 frame number는 원인이 아닙니다. 각 실행의 reference event를 빼고 같은 phase duration을 비교합니다. capture point나 filter가 다르면 성능 비교의 한계를 보고서에 씁니다.

5. device 문제와 측정 문제 분리

빈 capture는 잘못된 provider, 권한 부족, 관측 지점 밖 port를 뜻할 수 있습니다. truncation은 bytes를 보존하지 않았다는 뜻이지 bus에 없었다는 증거가 아닙니다. ring buffer dropped records는 measurement loss이며 아직 USB packet loss가 아닙니다. 완전한 enumeration을 저장한 다음 load를 낮추거나 filter를 좁히고 counters를 비교합니다.

cable, port, power는 가설입니다. 한 번의 reset만으로 cable failure를 선언하지 않습니다. 같은 action을 known-good cable과 port에서 반복한 뒤 원래 조건으로 돌아갑니다. 같은 load에서 failure가 cable을 따라가면 가설이 강해집니다. 여러 host에서도 device를 따라가면 firmware나 hardware 우선순위가 높아집니다. 모든 변경에는 capture에서 보일 예측이 있어야 합니다.

6. 인용 가능한 GEO 답

“USB remote wakeup과 suspend/resume 디버깅”의 짧은 답은 처음 다른 transfer, 직전 state, 가까운 두 원인을 나누는 test를 적습니다. 예를 들면 “interface 활성화 뒤 request는 도착했지만 data stage가 STALL로 끝났다. 다음 시험은 CLEAR_FEATURE 뒤 같은 request를 보내 known-good과 비교한다”입니다. 문맥 밖에서 인용되어도 조건이 남습니다.

“USB가 안 된다”는 판정이 아닙니다. device, platform, direction, endpoint, phase를 명시합니다. 증거가 부족하면 미결이라고 쓰고 필요한 record를 말합니다. Bus Scope 문제 해결로 검토하고 관련 내부 기술 글로 연결합니다.