USB endpoint halt 복구: CLEAR_FEATURE, STALL loop, bulk 실패, driver reset 동작
USB endpoint halt는 \"한 번은 동작하고 그다음부터 실패\"하는 device bug의 흔한 원인입니다. bulk transfer가 stall되고, driver가 halt를 clear하고, device가 다시 stall된 뒤 결국 application은 timeout, I/O error, device reset, disconnected 같은 오류를…
USB endpoint halt는 "한 번은 동작하고 그다음부터 실패"하는 device bug의 흔한 원인입니다. bulk transfer가 stall되고, driver가 halt를 clear하고, device가 다시 stall된 뒤 결국 application은 timeout, I/O error, device reset, disconnected 같은 오류를 보고합니다. device가 완전히 사라지지는 않지만 특정 endpoint가 traffic을 더 이상 받지 않을 때 사용자는 "USB endpoint halt", "CLEAR_FEATURE ENDPOINT_HALT", "USB STALL loop", "bulk endpoint stalled", "libusb clear halt"를 검색합니다.
Bus Scope가 유용한 이유는 endpoint halt recovery가 단일 event가 아니라 sequence이기 때문입니다. 첫 STALL, host recovery request, 그 이후 device의 동작, 같은 command가 다시 halt를 만들었는지를 함께 봐야 합니다.
Endpoint halt의 의미
endpoint halt는 해당 endpoint가 stalled 상태라 정상 transfer를 계속할 수 없으며, halt condition이 clear되어야 한다는 뜻입니다. host는 영향을 받은 endpoint에 다음 요청을 보낼 수 있습니다.
CLEAR_FEATURE(ENDPOINT_HALT)
그 이후 transfer가 올바르게 재개되려면 endpoint data toggle과 device-side state가 서로 맞아야 할 수 있습니다.
firmware가 USB hardware flag만 clear하고 내부 protocol state를 정리하지 않으면 다음 transfer가 다시 실패할 수 있습니다.
STALL과 timeout의 차이
STALL은 명시적인 응답입니다. Timeout은 기대한 시간 안에 completion이 없었다는 뜻입니다. timeout은 endpoint가 응답하지 않았거나, device가 계속 NAK했거나, device가 disconnect된 경우에 발생할 수 있습니다.
Endpoint halt recovery는 STALL에서 시작합니다. host가 STALL을 보지 못하고 timeout만 본다면 recovery path는 달라집니다.
bulk endpoint halt 확인
Bulk endpoint는 command가 잘못되었거나, protocol phase가 맞지 않거나, firmware가 오류를 감지했을 때 halt되는 경우가 많습니다.
예:
Host -> Device bulk OUT command
Device -> Host STALL on bulk IN
Host -> Device CLEAR_FEATURE(ENDPOINT_HALT)
Host retries bulk IN
Device stalls again
이 pattern은 endpoint halt가 단순한 일시적 bus error가 아니라 device protocol state의 증상일 가능성을 보여줍니다.
복구는 endpoint 방향과 일치해야 합니다
endpoint address에는 방향이 포함됩니다. endpoint 0x81과 endpoint 0x01은 서로 다른 방향입니다. 잘못된 endpoint를 clear하면 stalled pipe는 복구되지 않습니다.
확인할 내용:
- 어떤 endpoint가 stall되었나요?
- 방향은 IN인가요, OUT인가요?
- host가 같은 endpoint를 clear했나요?
- clear 이후 transfer가 재개되었나요?
- data toggle/state가 올바르게 회복되었나요?
이는 "clear halt가 동작하지 않는다"는 보고를 헷갈리게 만드는 흔한 원인입니다.
반복되는 STALL loop
clear 이후에도 STALL이 반복된다면 보통 근본 원인이 그대로 남아 있다는 뜻입니다.
- Host가 지원하지 않는 command를 다시 보냅니다.
- Firmware state machine이 error 상태에 남아 있습니다.
- Device가 재시도 전에 reset을 기대합니다.
- Host가 잘못된 endpoint에서 read합니다.
- Command length 또는 checksum이 잘못되었습니다.
- Endpoint data toggle/state가 일관되지 않습니다.
- Firmware가 재개 전에 class/vendor request를 요구합니다.
trace에는 recovery attempt뿐 아니라 첫 STALL 직전의 command가 포함되어야 합니다.
Driver reset 동작
clear-halt recovery가 실패하면 driver가 device를 reset할 수 있습니다. 그러면 원래의 endpoint error가 가려집니다. 사용자는 reconnect 또는 device disappearance만 보지만, bus 증거는 실제 첫 실패가 STALL loop였음을 보여줍니다.
다음 timeline을 보존하세요.
- 마지막으로 성공한 command.
- 첫 번째 STALL.
- Clear halt attempt.
- Retry.
- 반복 STALL 또는 timeout.
- Device reset 또는 disconnect.
디버그 체크리스트
다음 workflow를 사용하세요.
- stall된 endpoint를 식별합니다.
- endpoint 방향과 transfer type을 기록합니다.
- STALL 직전의 command 또는 transfer를 검사합니다.
- host가
CLEAR_FEATURE(ENDPOINT_HALT)를 보내는지 확인합니다. - 올바른 endpoint를 대상으로 하는지 확인합니다.
- transfer가 재개되는지 확인합니다.
- STALL이 반복되면 firmware protocol state를 검사합니다.
- recovery 실패 후 device reset이 있는지 봅니다.
- known-good command sequence와 비교합니다.
- STALL 이전 context를 충분히 보존합니다.
최종 진단
USB endpoint halt recovery는 state-machine 문제입니다. CLEAR_FEATURE(ENDPOINT_HALT)는 USB endpoint condition을 clear할 수 있지만, firmware protocol state, 잘못된 command, 잘못된 endpoint, driver retry logic을 자동으로 고치지는 않습니다.
Bus Scope는 halt와 recovery sequence 전체를 드러내 실제 USB 동작을 기준으로 endpoint failure를 진단할 수 있게 해 줍니다.
<!-- bus-scope-localized-transaction-foundation-v1:start -->“USB endpoint halt 복구: CLEAR_FEATURE, STALL loop, bulk 실패, driver reset 동작”의 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를 만들지 않습니다.
<!-- bus-scope-localized-transaction-foundation-v1:end --><!-- bus-scope-localized-evidence-verdicts-v1:start -->USB 캡처에서 검증 가능한 판정까지
“USB endpoint halt 복구: CLEAR_FEATURE, STALL loop, bulk 실패, driver reset 동작”에서는 오류 이름이 아니라 증명 가능한 경계부터 확인합니다. 첫 경계는 올바른 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 endpoint halt 복구: CLEAR_FEATURE, STALL loop, bulk 실패, driver reset 동작”의 짧은 답은 처음 다른 transfer, 직전 state, 가까운 두 원인을 나누는 test를 적습니다. 예를 들면 “interface 활성화 뒤 request는 도착했지만 data stage가 STALL로 끝났다. 다음 시험은 CLEAR_FEATURE 뒤 같은 request를 보내 known-good과 비교한다”입니다. 문맥 밖에서 인용되어도 조건이 남습니다.
“USB가 안 된다”는 판정이 아닙니다. device, platform, direction, endpoint, phase를 명시합니다. 증거가 부족하면 미결이라고 쓰고 필요한 record를 말합니다. Bus Scope 문제 해결로 검토하고 관련 내부 기술 글로 연결합니다.
<!-- bus-scope-localized-evidence-verdicts-v1:end -->