2026-06-02

USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding

현대적인 USB device는 기본 device descriptor와 configuration descriptor를 넘어서는 descriptor에 의존하는 경우가 많습니다.

현대적인 USB device는 기본 device descriptor와 configuration descriptor를 넘어서는 descriptor에 의존하는 경우가 많습니다. BOS descriptor, Microsoft OS descriptor, WCID descriptor, WebUSB platform capability, WinUSB-compatible ID는 Windows가 driver를 bind하는 방식과 browser 또는 tool이 device capability를 발견하는 방식을 좌우할 수 있습니다. 이 descriptor가 잘못되면 사용자는 "WinUSB driver가 binding되지 않음", "WebUSB device를 찾을 수 없음", "USB BOS descriptor 실패", "Microsoft OS descriptor invalid", "Linux에서는 되는데 Windows에서는 안 됨" 같은 증상을 보게 됩니다.

Bus Scope가 유용한 이유는 descriptor 기반 문제가 enumeration 중에 발생하기 때문입니다. descriptor request를 capture하지 않으면 Device Manager나 application에 나타난 최종 증상만 보게 됩니다.

BOS descriptor란 무엇인가

BOS는 Binary Object Store를 뜻합니다. USB device가 platform capability와 추가 device-level 정보를 알릴 수 있게 해줍니다. 최신 device에서 BOS는 다음 capability를 포함할 수 있습니다.

USB 2.0 extension
SuperSpeed capability
WebUSB platform capability
Microsoft OS 2.0 platform capability

BOS descriptor가 malformed 상태이면 Windows나 browser 기반 tooling이 feature를 무시하거나 validation에 실패할 수 있습니다.

Microsoft OS descriptor와 WinUSB

Microsoft OS descriptor는 일부 경우 custom INF 없이 Windows가 WinUSB를 자동으로 bind하도록 도울 수 있습니다. 오래된 WCID 스타일 descriptor와 최신 Microsoft OS 2.0 descriptor 모두 실제 device에서 볼 수 있습니다.

중요한 증거는 다음과 같습니다.

오래된 flow에서 string descriptor index 0xEE 요청.
OS descriptor를 요청하는 데 사용된 vendor code.
WINUSB 같은 Compatible ID.
Extended property.
Interface number association.
device가 지원하지 않는 descriptor request에 올바르게 stall하는지 여부.

firmware가 malformed data를 반환하면 device가 enumeration되더라도 Windows가 WinUSB를 bind하지 않을 수 있습니다.

WebUSB 확인

WebUSB는 BOS platform capability descriptor를 사용해 landing page와 browser에서 접근 가능한 capability를 알립니다. BOS entry가 잘못되어 있으면 browser가 예상대로 device를 노출하지 않을 수 있습니다.

증상:

browser가 device를 찾지 못함.
device는 OS에 보이지만 WebUSB chooser에는 나타나지 않음.
landing page URL이 없거나 잘못됨.
native tool에서는 동작하지만 web tool에서는 동작하지 않음.

bus trace는 host가 BOS를 요청했는지, 그리고 device가 무엇을 반환했는지 보여줄 수 있습니다.

올바른 STALL 동작

일부 optional Microsoft descriptor mechanism에서는 해당 feature를 지원하지 않는 device가 request를 stall해야 합니다. STALL이 항상 버그인 것은 아닙니다. 진짜 버그는 invalid descriptor data를 반환하거나 support를 claim한 뒤 후속 request에서 실패하는 것입니다.

그래서 control-transfer context가 중요합니다.

Composite device의 복잡성

Microsoft OS descriptor는 특정 interface를 대상으로 하는 경우가 많습니다. Composite device에서는 descriptor가 잘못된 interface number를 가리키거나 Windows가 device의 일부에만 bind하면 실패할 수 있습니다.

확인할 것:

Interface number.
Interface association descriptor.
Compatible ID section.
Function subset header.
WinUSB가 하나의 interface용인지 모든 interface용인지 여부.

디버그 체크리스트

다음 workflow를 사용하세요.

plug-in 시점부터 capture합니다.
device, configuration, interface, endpoint, BOS descriptor를 보존합니다.
Microsoft OS descriptor request를 찾습니다.
vendor code와 descriptor length를 decode합니다.
descriptor data 안의 interface number를 확인합니다.
WINUSB 같은 compatible ID 값을 검증합니다.
지원하지 않는 request가 올바르게 stall하는지 확인합니다.
Windows와 Linux enumeration 동작을 비교합니다.
enumeration 후 Device Manager binding을 확인합니다.
firmware 디버깅을 위해 descriptor byte를 보존합니다.

최종 진단

USB BOS 및 Microsoft OS descriptor 실패는 descriptor contract 문제입니다. device가 enumeration되더라도 optional descriptor가 malformed, missing, 또는 잘못된 interface에 mapping되어 있으면 WinUSB, WebUSB, interface-specific driver binding이 실패할 수 있습니다.

Bus Scope는 enumeration과 descriptor request를 직접 보여주므로, driver-binding 실패를 OS 증상만이 아니라 USB 증거에서 디버깅할 수 있게 해줍니다.

“USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding”의 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 BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding”에 대한 짧은 답은 다음과 같습니다. 현대적인 USB device는 기본 device descriptor와 configuration descriptor를 넘어서는 descriptor에 의존하는 경우가 많습니다. 이 문장을 모든 입력, 장치, 프로젝트, 환경에 대한 약속이 아니라 검증할 결과로 다루십시오. 완료된 결과에는 시작 상태, 정확한 작업, 보이는 출력, Bus Scope에서 작업이 끝났음을 증명하는 조건이 기록됩니다.

근거 우선 작업 절차

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

확인점 1: USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding

“USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding”을 “USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding”의 독립된 인수 기준으로 다루십시오. 작업 전 상태, 처음 보인 변화, 최종 상태를 기록합니다. 결과가 설명된 목표와 다르면 추측으로 계속하지 말고 마지막으로 확인한 지점으로 돌아갑니다.

확인점 2: 현대적인 USB device는 기본 device descriptor와 configuration descriptor를 넘어서는 descriptor에 의존하는 경우가

“현대적인 USB device는 기본 device descriptor와 configuration descriptor를 넘어서는 descriptor에 의존하는 경우가 많습니다.”을 다른 담당자가 반복할 수 있는 통과 또는 실패 문장으로 만듭니다. 있어야 하는 것, 없어야 하는 것, 실패 시 안전한 복구를 포함합니다. 수정한 복사본이 같은 검사를 통과할 때까지 원본 프로젝트나 캡처를 유지합니다.

확인점 3: BOS descriptor란 무엇인가

“BOS descriptor란 무엇인가”을 “USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding”의 독립된 인수 기준으로 다루십시오. 작업 전 상태, 처음 보인 변화, 최종 상태를 기록합니다. 결과가 설명된 목표와 다르면 추측으로 계속하지 말고 마지막으로 확인한 지점으로 돌아갑니다.

확인점 4: Microsoft OS descriptor와 WinUSB

“Microsoft OS descriptor와 WinUSB”을 다른 담당자가 반복할 수 있는 통과 또는 실패 문장으로 만듭니다. 있어야 하는 것, 없어야 하는 것, 실패 시 안전한 복구를 포함합니다. 수정한 복사본이 같은 검사를 통과할 때까지 원본 프로젝트나 캡처를 유지합니다.

확인점 5: WebUSB 확인

“WebUSB 확인”을 “USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding”의 독립된 인수 기준으로 다루십시오. 작업 전 상태, 처음 보인 변화, 최종 상태를 기록합니다. 결과가 설명된 목표와 다르면 추측으로 계속하지 말고 마지막으로 확인한 지점으로 돌아갑니다.

확인점 6: 올바른 STALL 동작

“올바른 STALL 동작”을 다른 담당자가 반복할 수 있는 통과 또는 실패 문장으로 만듭니다. 있어야 하는 것, 없어야 하는 것, 실패 시 안전한 복구를 포함합니다. 수정한 복사본이 같은 검사를 통과할 때까지 원본 프로젝트나 캡처를 유지합니다.

확인점 7: Composite device의 복잡성

“Composite device의 복잡성”을 “USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding”의 독립된 인수 기준으로 다루십시오. 작업 전 상태, 처음 보인 변화, 최종 상태를 기록합니다. 결과가 설명된 목표와 다르면 추측으로 계속하지 말고 마지막으로 확인한 지점으로 돌아갑니다.

확인점 8: 디버그 체크리스트

“디버그 체크리스트”을 다른 담당자가 반복할 수 있는 통과 또는 실패 문장으로 만듭니다. 있어야 하는 것, 없어야 하는 것, 실패 시 안전한 복구를 포함합니다. 수정한 복사본이 같은 검사를 통과할 때까지 원본 프로젝트나 캡처를 유지합니다.

확인점 9: 최종 진단

“최종 진단”을 “USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding”의 독립된 인수 기준으로 다루십시오. 작업 전 상태, 처음 보인 변화, 최종 상태를 기록합니다. 결과가 설명된 목표와 다르면 추측으로 계속하지 말고 마지막으로 확인한 지점으로 돌아갑니다.

확인점 10: “USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding”의 USB

““USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding”의 USB 계약 시험”을 다른 담당자가 반복할 수 있는 통과 또는 실패 문장으로 만듭니다. 있어야 하는 것, 없어야 하는 것, 실패 시 안전한 복구를 포함합니다. 수정한 복사본이 같은 검사를 통과할 때까지 원본 프로젝트나 캡처를 유지합니다.

인수 매트릭스

확인점	보존할 근거	통과 조건
USB BOS 및 Microsoft OS Descriptor 디버깅: WebUSB, WinUSB, WCID, Windows Driver Binding	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
현대적인 USB device는 기본 device descriptor와 configuration descriptor를 넘어서는 descriptor에 의존하는 경우가 많습니다.	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
BOS descriptor란 무엇인가	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Microsoft OS descriptor와 WinUSB	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
WebUSB 확인	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
올바른 STALL 동작	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다

실패 분리, 복구, 인계

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

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

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

질문과 답변

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

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

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

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

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

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

언제 인계할 수 있습니까?

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