2026-06-02

USB Composite Device 디버깅: Interface Number, IAD, Endpoint, Driver Binding

USB composite device는 편리하지만 위험합니다. 하나의 device가 HID control, CDC serial, mass storage, vendor-specific endpoint, audio, video, diagnostics interface를 노출할 수 있습니다.

USB composite device는 편리하지만 위험합니다. 하나의 device가 HID control, CDC serial, mass storage, vendor-specific endpoint, audio, video, diagnostics interface를 노출할 수 있습니다. 모든 것이 올바르게 설명되어 있으면 host가 올바른 driver를 bind하고 각 function이 동작합니다. descriptor field 하나가 틀리면 전체 device가 불안정해 보일 수 있습니다.

"USB composite device not recognized", "CDC interface not showing", "HID works but serial does not", "wrong driver binding USB interface" 같은 검색은 보통 descriptor structure, interface numbering, endpoint assignment, Interface Association Descriptor 동작을 가리킵니다.

Composite Device에는 일관된 Configuration이 필요합니다

configuration descriptor는 top-level map입니다. total length, interface 수, power attribute, 그리고 nested interface 및 endpoint descriptor 전체를 설명해야 합니다. wTotalLength가 틀리면 host가 모든 function을 읽지 못할 수 있습니다. interface count가 틀리면 host가 뒤쪽 interface를 무시할 수 있습니다. endpoint address가 충돌하면 transfer가 모호하거나 invalid해집니다.

inspect할 것:

capture는 host가 전체 configuration을 요청했는지, 그리고 device가 어떤 byte를 반환했는지 보여줘야 합니다.

IAD는 관련 Interface를 묶는 데 도움이 됩니다

Interface Association Descriptor는 CDC communication과 CDC data처럼 하나의 function에 속하는 여러 interface를 묶는 데 자주 사용됩니다. grouping이 올바르지 않으면 host가 driver를 잘못 bind하거나 function의 일부만 노출할 수 있습니다.

inspect할 IAD 증거:

first interface number
interface count
function class, subclass, protocol
grouped interface 앞에 위치하는지 여부
실제 interface descriptor와의 consistency

CDC serial은 보이지 않지만 HID는 동작한다면, HID interface는 정상이고 CDC grouping이 틀렸을 수 있습니다.

Endpoint Address 충돌은 놓치기 쉽습니다

endpoint address에는 direction이 포함됩니다. endpoint 0x81과 0x01은 서로 다른 direction이지만, 같은 device configuration 안에서 같은 address를 가진 두 IN endpoint는 valid하지 않습니다. firmware 팀은 interface 사이에서 endpoint descriptor를 복사한 뒤 address update를 잊는 경우가 있습니다.

증상:

하나의 interface는 동작하지만 다른 interface는 silent 상태
host가 예상 밖의 endpoint로 transfer를 보냄
class driver는 load되지만 application에 data가 없음
configuration 이후 endpoint STALL 또는 timeout
한 번에 하나의 function만 동작

capture는 endpoint descriptor와 이후 transfer traffic을 나란히 보여줘야 합니다.

Driver Binding도 증거입니다

host는 descriptor를 기준으로 driver를 선택합니다. device가 잘못 bind되었다면 그 이유를 설명하는 descriptor 증거가 있을 수 있습니다. class, subclass, protocol, interface association, compatible ID, OS-specific descriptor 모두 binding에 영향을 줄 수 있습니다.

Device Manager나 application log만 보고 driver binding을 진단하지 마세요. host의 class-specific request를 descriptor tree와 비교하세요. 기대한 class request가 전혀 도착하지 않는다면 host가 예상한 driver를 bind하지 않았을 가능성이 큽니다.

Bus Scope가 들어맞는 위치

Bus Scope는 firmware team이 composite device를 두 수준에서 inspect하도록 도와야 합니다.

descriptor map
driver binding 이후 transfer evidence

composite 디버깅에 좋은 .bscope session은 다음을 보여줍니다.

이렇게 하면 support 대화가 구체적이 됩니다. "Windows가 우리 composite device를 싫어합니다" 대신, report는 "grouping descriptor가 선언된 interface layout과 맞지 않아 interface 2가 CDC class request를 전혀 받지 않습니다"라고 말할 수 있습니다.

이 정도가 firmware 팀에 필요한 증거 수준입니다.

“USB Composite Device 디버깅: Interface Number, IAD, Endpoint, 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 Composite Device 디버깅: Interface Number, IAD, Endpoint, Driver Binding”에 대한 짧은 답은 다음과 같습니다. USB composite device는 편리하지만 위험합니다. 하나의 device가 HID control, CDC serial, mass storage, vendor-specific endpoint, audio, video, diagnostics interface를 노출할 수 있습니다. 이 문장을 모든 입력, 장치, 프로젝트, 환경에 대한 약속이 아니라 검증할 결과로 다루십시오. 완료된 결과에는 시작 상태, 정확한 작업, 보이는 출력, Bus Scope에서 작업이 끝났음을 증명하는 조건이 기록됩니다.

근거 우선 작업 절차

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

확인점 1: USB Composite Device 디버깅: Interface Number, IAD, Endpoint, Driver Binding

“USB Composite Device 디버깅: Interface Number, IAD, Endpoint, Driver Binding”은 가장 작고 대표적인 입력으로 검증합니다. 관련 없는 설정은 유지하고 같은 작업을 반복하며 다시 열거나 연결한 뒤에도 결과가 유지되는지 확인합니다. 한 장의 화면보다 입력, 설정, 작업, 출력, 시간이 포함된 기록이 강합니다.

확인점 2: USB composite device는 편리하지만 위험합니다. 하나의 device가 HID control, CDC serial, mass storage, vend

“USB composite device는 편리하지만 위험합니다. 하나의 device가 HID control, CDC serial, mass storage, vendor-specific endpoint, audio, video, diagnostics interface를 노”이 모호하면 조건을 맞춘 정상 사례와 실패 사례를 비교합니다. 이후의 모든 증상보다 처음 나타난 의미 있는 차이를 표시하십시오. 이 경계가 더 명확한 지원 요청과 안전한 다음 실험을 만듭니다.

확인점 3: Composite Device에는 일관된 Configuration이 필요합니다

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

확인점 4: IAD는 관련 Interface를 묶는 데 도움이 됩니다

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

확인점 5: Endpoint Address 충돌은 놓치기 쉽습니다

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

확인점 6: Driver Binding도 증거입니다

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

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

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

확인점 8: “USB Composite Device 디버깅: Interface Number, IAD, Endpoint, Driver Binding”의 USB 계약 시험

““USB Composite Device 디버깅: Interface Number, IAD, Endpoint, Driver Binding”의 USB 계약 시험”이 모호하면 조건을 맞춘 정상 사례와 실패 사례를 비교합니다. 이후의 모든 증상보다 처음 나타난 의미 있는 차이를 표시하십시오. 이 경계가 더 명확한 지원 요청과 안전한 다음 실험을 만듭니다.

확인점 9: 인용 가능한 답

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

확인점 10: first interface number

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

인수 매트릭스

확인점	보존할 근거	통과 조건
USB Composite Device 디버깅: Interface Number, IAD, Endpoint, Driver Binding	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
USB composite device는 편리하지만 위험합니다. 하나의 device가 HID control, CDC serial, mass storage, vendor-specific endpoint, audio, v	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Composite Device에는 일관된 Configuration이 필요합니다	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
IAD는 관련 Interface를 묶는 데 도움이 됩니다	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Endpoint Address 충돌은 놓치기 쉽습니다	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Driver Binding도 증거입니다	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다

실패 분리, 복구, 인계

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

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

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

질문과 답변

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

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

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

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

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

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

언제 인계할 수 있습니까?

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