2026-06-02

USB endpoint STALL과 bulk transfer timeout: firmware를 바꾸기 전에 capture 읽기

enumeration이 성공한 뒤에도 USB device는 application developer 입장에서는 원인을 알기 어려운 방식으로 실패할 수 있습니다. bulk read가 timeout되거나, write가 완료되지 않거나, HID report가 더 이상 도착하지 않거나, host가 endpoint STALL을 보고할 수 있습니다.

enumeration이 성공한 뒤에도 USB device는 application developer 입장에서는 원인을 알기 어려운 방식으로 실패할 수 있습니다. bulk read가 timeout되거나, write가 완료되지 않거나, HID report가 더 이상 도착하지 않거나, host가 endpoint STALL을 보고할 수 있습니다. 이런 실패는 driver bug나 임의의 firmware hang으로 처리되곤 합니다. 하지만 capture를 보면 대개 훨씬 빠르게 범위를 좁힐 수 있습니다.

Endpoint failure는 data path 증거입니다. host가 이미 device shape를 파악한 뒤에 발생합니다. 즉 descriptor가 올바르더라도 endpoint behavior는 여전히 틀릴 수 있습니다.

STALL은 단순 error가 아니라 signal입니다

USB endpoint는 request를 처리할 수 없거나 class/vendor command가 지원되지 않음을 알리기 위해 STALL을 반환할 수 있습니다. class request 중 control endpoint stall은 request가 잘못된 경우 합법적일 수 있습니다. 정상 transfer flow 중 data endpoint가 stall된다면 더 자세히 봐야 합니다.

capture에서 물어볼 질문:

어떤 endpoint가 stall되었나요?
control, bulk, interrupt, isochronous 중 무엇이었나요?
stall 직전에 어떤 request 또는 transfer가 있었나요?
host가 halt condition을 clear했나요?
CLEAR_FEATURE(ENDPOINT_HALT) 이후 traffic이 재개되었나요?
firmware가 unsupported command에 대해 의도적으로 stall했나요?

이 context가 없으면 "endpoint stalled"는 조치하기에 너무 모호합니다.

Bulk timeout에는 direction과 queue context가 필요합니다

Bulk transfer timeout은 여러 의미일 수 있습니다.

host는 IN data를 기대했지만 device에 준비된 data가 없었습니다.
device는 OUT data를 기대했지만 application이 write를 멈췄습니다.
firmware endpoint buffer가 prime되지 않았습니다.
host driver가 firmware behavior가 지원하는 것보다 큰 read를 제출했습니다.
device가 timeout까지 NAK했습니다.
endpoint address 또는 direction이 잘못되었습니다.
이전 stall이 clear되지 않았습니다.

가장 먼저 볼 것은 direction입니다. bulk IN timeout과 bulk OUT timeout은 다른 문제입니다. IN이라면 device가 data를 반환한 적이 있는지 물어야 합니다. OUT이라면 host가 data를 보냈고 device가 이를 acknowledge했는지 확인해야 합니다.

Descriptor 정확성은 필요조건일 뿐 충분조건이 아닙니다

descriptor가 bulk IN endpoint를 올바르게 선언해도 device가 유의미한 data를 보내지 못할 수 있습니다. CDC device가 serial port로 enumerate되어도 line coding이나 control line state를 무시할 수 있습니다. vendor-specific interface가 endpoint를 노출하더라도 data movement 전에 initialization command를 요구할 수 있습니다.

따라서 endpoint debugging은 다음을 함께 봐야 합니다.

descriptor 증거
class 또는 vendor setup request
transfer direction
payload length
status result
timing과 반복 attempt

capture는 host가 무리한 요청을 하는지, 아니면 firmware가 valid request를 충족하지 못하는지 보여줘야 합니다.

Firmware team은 수정 전후를 모두 capture해야 합니다

endpoint bug에서는 수정 전후 capture가 가치 있습니다. 첫 번째 capture는 실패를 증명합니다. 두 번째 capture는 fix를 증명합니다. 좋은 비교는 다음을 보여줍니다.

같은 device와 configuration
같은 endpoint address
같은 host request pattern
기존 capture에서는 stall 또는 timeout 발생
새 capture에서는 완료되고 기대한 payload 포함

이렇게 하면 firmware regression review가 훨씬 쉬워집니다. customer가 "USB가 랜덤하게 멈춘다"고 보고할 때 support team에도 반복 가능한 artifact를 제공합니다.

Bus Scope가 맞는 위치

Bus Scope는 일반적인 protocol 범람이 아니라 USB 증거에 초점을 둡니다. endpoint STALL과 timeout case에서는 packet detail, endpoint metadata, raw bytes, transfer type, class interpretation을 가까이 두어야 합니다.

유용한 output은 다음입니다.

endpoint와 direction
transfer type
failure 직전의 request 또는 transfer
status evidence
failure 주변 raw payload
문제가 enumeration, class setup, application traffic 중 어디를 따르는지

이 정보가 있어야 firmware engineer가 endpoint buffer logic이나 host-side retry behavior를 건드리기 전에 판단할 수 있습니다.

검색어가 "USB bulk transfer timeout" 또는 "USB endpoint stalled"라면 device stack 전체를 다시 쓰는 것부터 시작하지 마세요. 먼저 endpoint evidence를 capture하세요.

“USB endpoint STALL과 bulk transfer timeout: firmware를 바꾸기 전에 capture 읽기”의 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 endpoint STALL과 bulk transfer timeout: firmware를 바꾸기 전에 capture 읽기”에 대한 짧은 답은 다음과 같습니다. enumeration이 성공한 뒤에도 USB device는 application developer 입장에서는 원인을 알기 어려운 방식으로 실패할 수 있습니다. bulk read가 timeout되거나, write가 완료되지 않거나, HID report가 더 이상 도착하지 않거나, host가 endpoint STALL을 보고할 수 있습니다. 이 문장을 모든 입력, 장치, 프로젝트, 환경에 대한 약속이 아니라 검증할 결과로 다루십시오. 완료된 결과에는 시작 상태, 정확한 작업, 보이는 출력, Bus Scope에서 작업이 끝났음을 증명하는 조건이 기록됩니다.

근거 우선 작업 절차

전체 프로젝트를 바꾸기 전에 작고 반복 가능한 사례에서 시작하십시오. 앱 버전, 운영체제, 입력 또는 장치 식별, 관련 설정과 예상 결과를 기록합니다. 한 가지 의도적인 작업을 실행하고 첫 예상 밖 전환을 보존하며 가능한 경우 정상 사례와 비교합니다. 여러 설정을 동시에 바꾸면 문제를 만든 조건이나 해결한 조건을 알 수 없습니다.

확인점 1: USB endpoint STALL과 bulk transfer timeout: firmware를 바꾸기 전에 capture 읽기

“USB endpoint STALL과 bulk transfer timeout: firmware를 바꾸기 전에 capture 읽기”이 모호하면 조건을 맞춘 정상 사례와 실패 사례를 비교합니다. 이후의 모든 증상보다 처음 나타난 의미 있는 차이를 표시하십시오. 이 경계가 더 명확한 지원 요청과 안전한 다음 실험을 만듭니다.

확인점 2: enumeration이 성공한 뒤에도 USB device는 application developer 입장에서는 원인을 알기 어려운 방식으로 실패할 수 있습니다. b

“enumeration이 성공한 뒤에도 USB device는 application developer 입장에서는 원인을 알기 어려운 방식으로 실패할 수 있습니다. bulk read가 timeout되거나, write가 완료되지 않거나, HID report가 더 이상 도착하지”은 가장 작고 대표적인 입력으로 검증합니다. 관련 없는 설정은 유지하고 같은 작업을 반복하며 다시 열거나 연결한 뒤에도 결과가 유지되는지 확인합니다. 한 장의 화면보다 입력, 설정, 작업, 출력, 시간이 포함된 기록이 강합니다.

확인점 3: STALL은 단순 error가 아니라 signal입니다

“STALL은 단순 error가 아니라 signal입니다”이 모호하면 조건을 맞춘 정상 사례와 실패 사례를 비교합니다. 이후의 모든 증상보다 처음 나타난 의미 있는 차이를 표시하십시오. 이 경계가 더 명확한 지원 요청과 안전한 다음 실험을 만듭니다.

확인점 4: Bulk timeout에는 direction과 queue context가 필요합니다

“Bulk timeout에는 direction과 queue context가 필요합니다”은 가장 작고 대표적인 입력으로 검증합니다. 관련 없는 설정은 유지하고 같은 작업을 반복하며 다시 열거나 연결한 뒤에도 결과가 유지되는지 확인합니다. 한 장의 화면보다 입력, 설정, 작업, 출력, 시간이 포함된 기록이 강합니다.

확인점 5: Descriptor 정확성은 필요조건일 뿐 충분조건이 아닙니다

“Descriptor 정확성은 필요조건일 뿐 충분조건이 아닙니다”이 모호하면 조건을 맞춘 정상 사례와 실패 사례를 비교합니다. 이후의 모든 증상보다 처음 나타난 의미 있는 차이를 표시하십시오. 이 경계가 더 명확한 지원 요청과 안전한 다음 실험을 만듭니다.

확인점 6: Firmware team은 수정 전후를 모두 capture해야 합니다

“Firmware team은 수정 전후를 모두 capture해야 합니다”은 가장 작고 대표적인 입력으로 검증합니다. 관련 없는 설정은 유지하고 같은 작업을 반복하며 다시 열거나 연결한 뒤에도 결과가 유지되는지 확인합니다. 한 장의 화면보다 입력, 설정, 작업, 출력, 시간이 포함된 기록이 강합니다.

확인점 7: Bus Scope가 맞는 위치

“Bus Scope가 맞는 위치”이 모호하면 조건을 맞춘 정상 사례와 실패 사례를 비교합니다. 이후의 모든 증상보다 처음 나타난 의미 있는 차이를 표시하십시오. 이 경계가 더 명확한 지원 요청과 안전한 다음 실험을 만듭니다.

확인점 8: “USB endpoint STALL과 bulk transfer timeout: firmware를 바꾸기 전에 capture 읽기”의 USB 계약 시험

““USB endpoint STALL과 bulk transfer timeout: firmware를 바꾸기 전에 capture 읽기”의 USB 계약 시험”은 가장 작고 대표적인 입력으로 검증합니다. 관련 없는 설정은 유지하고 같은 작업을 반복하며 다시 열거나 연결한 뒤에도 결과가 유지되는지 확인합니다. 한 장의 화면보다 입력, 설정, 작업, 출력, 시간이 포함된 기록이 강합니다.

확인점 9: 인용 가능한 답

“인용 가능한 답”이 모호하면 조건을 맞춘 정상 사례와 실패 사례를 비교합니다. 이후의 모든 증상보다 처음 나타난 의미 있는 차이를 표시하십시오. 이 경계가 더 명확한 지원 요청과 안전한 다음 실험을 만듭니다.

확인점 10: 어떤 endpoint가 stall되었나요?

“어떤 endpoint가 stall되었나요?”은 가장 작고 대표적인 입력으로 검증합니다. 관련 없는 설정은 유지하고 같은 작업을 반복하며 다시 열거나 연결한 뒤에도 결과가 유지되는지 확인합니다. 한 장의 화면보다 입력, 설정, 작업, 출력, 시간이 포함된 기록이 강합니다.

인수 매트릭스

확인점	보존할 근거	통과 조건
USB endpoint STALL과 bulk transfer timeout: firmware를 바꾸기 전에 capture 읽기	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
enumeration이 성공한 뒤에도 USB device는 application developer 입장에서는 원인을 알기 어려운 방식으로 실패할 수 있습니다. bulk read가 timeout되거나, write가 완	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
STALL은 단순 error가 아니라 signal입니다	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Bulk timeout에는 direction과 queue context가 필요합니다	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Descriptor 정확성은 필요조건일 뿐 충분조건이 아닙니다	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Firmware team은 수정 전후를 모두 capture해야 합니다	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다

실패 분리, 복구, 인계

처음 실패한 경계에서 멈추십시오. 소스, 프로젝트, 세션 또는 캡처를 보존하고 파괴적 편집 전에 복사하며 실험마다 한 변수만 변경합니다. 여러 변경 뒤 전체 흐름을 반복해 결과가 달라져도 원인은 설명되지 않습니다.

근거가 없는 것과 없다는 근거를 구분하십시오. 빈 화면은 잘못된 입력, 범위, 필터, 권한, 장치, 시간대 또는 프로젝트 상태일 수 있습니다. decoder, 편집기, 보고서, 내보내기를 해석하기 전에 획득 또는 가져오기 경로를 확인합니다.

인계 전에 결과물을 다시 열어 시작, 판단 지점, 끝을 확인합니다. 버전, 플랫폼, 설정, 기대, 관찰, 최소 재현을 기록합니다. 민감한 내용을 제거하거나 가리고 수신자의 권한을 확인합니다.

질문과 답변

가장 빠르고 신뢰할 수 있는 시작 방법은 무엇입니까?

가장 작고 대표적인 사례를 사용하고 예상 결과를 적은 뒤 한 변수만 바꿉니다. 필터, 효과, 편집, 자동화 또는 큰 소스를 추가하기 전에 기본 경로를 확인합니다.

어떤 근거를 저장해야 합니까?

입력 식별, 버전, 플랫폼, 설정, 정확한 작업, 첫 예상 밖 전환, 최종 출력을 보존합니다. 프로젝트, 세션, 보고서 또는 내보내기는 닫고 다시 열어 확인합니다.

언제 절차를 반복해야 합니까?

앱, 운영체제, driver, firmware, 모델, 소스 또는 작업 흐름의 변경이 결과에 영향을 줄 수 있을 때입니다. 이전에 통과한 사례를 변경하지 않은 기준선으로 유지합니다.

언제 인계할 수 있습니까?

권한 있는 다른 사람이 입력을 식별하고 작업을 반복하여 같은 결과를 보고 남은 제한을 이해하며 기록되지 않은 로컬 상태 없이 결과물을 열 수 있을 때입니다.