2026-06-02

USB Interface Association Descriptor(IAD)와 복합 장치 디버깅

USB composite device는 하나의 물리 USB 장치 안에서 여러 기능을 노출합니다.

USB composite device는 하나의 물리 USB 장치 안에서 여러 기능을 노출합니다. 한 장치가 HID 컨트롤, CDC serial, mass storage, vendor 진단, audio, video, firmware update interface를 동시에 제공할 수 있습니다. driver binding이 잘못되면 사용자는 "USB Composite Device driver error", "This device cannot start Code 10", "Code 43", "interface not working", "COM port missing", "one function works but another does not" 같은 증상을 보게 됩니다.

"USB composite device wrong driver", "Windows usbccgp Code 10", "USB interface driver not binding", "IAD descriptor debugging" 같은 문제는 대부분 bus-level evidence가 필요합니다. Windows의 driver 상태만으로는 descriptor가 각 기능을 올바르게 설명하는지 확인할 수 없습니다.

Bus Scope가 도움이 되는 이유는 composite binding이 descriptor에 의해 결정되기 때문입니다.

Composite device의 구조

Composite device에는 하나의 device descriptor와 하나 이상의 configuration이 있습니다. configuration 안에는 여러 interface가 있고, 각 interface는 class/subclass/protocol 값과 endpoint를 갖습니다.

예시 기능:

Interface 0: HID
Interface 1: CDC control
Interface 2: CDC data
Interface 3: Vendor-specific diagnostics

Windows는 USB generic parent driver인 usbccgp.sys를 사용해 child function을 열거하고 적절한 driver를 binding합니다.

Interface Association Descriptor(IAD) 확인

IAD는 여러 interface를 하나의 function으로 묶습니다. CDC ACM은 보통 control interface와 data interface를 함께 사용합니다. IAD가 올바르지 않으면 OS가 두 interface를 잘못 binding하거나 서로 무관한 interface로 취급할 수 있습니다.

잘못된 IAD 증상:

CDC serial COM port가 보이지 않습니다.
Audio function이 일부만 나타납니다.
UVC camera는 enumerate되지만 video interface가 실패합니다.
Vendor interface가 엉뚱한 driver를 가져갑니다.
하나의 subfunction만 동작합니다.

interface number와 IAD range를 꼼꼼히 확인해야 합니다.

Class code와 driver 선택

Driver binding은 device 또는 interface level의 class/subclass/protocol code에 따라 달라집니다. device-level class가 0x00이면 class가 interface별로 정의된다는 뜻입니다. device-level class 0xEF는 IAD를 사용하는 miscellaneous composite device에서 자주 쓰입니다.

firmware가 잘못된 class code를 선언하면 Windows가 잘못된 driver를 선택할 수 있습니다.

Custom device에서는 의도적으로 설계해야 합니다.

HID interface는 HID를 정확히 설명해야 합니다.
CDC interface는 CDC 기대값과 맞아야 합니다.
Vendor-specific interface는 vendor class를 사용해야 합니다.
WinUSB interface에는 Microsoft OS descriptor가 필요할 수 있습니다.

Code 10과 Code 43

Code 10과 Code 43은 OS가 보여주는 증상이지 root cause가 아닙니다. USB trace는 다음을 드러낼 수 있습니다.

Device descriptor가 읽혔는지.
Configuration descriptor가 유효한지.
Interface descriptor가 서로 일관적인지.
Endpoint descriptor가 interface 기대와 맞는지.
Class-specific descriptor가 malformed인지.
driver가 보낸 class request가 STALL되었는지.
binding 중 device가 reset되었는지.

enumeration은 성공했지만 class request가 실패했다면 문제는 기본 descriptor read 이후 단계에 있습니다.

부분적인 device failure

Composite device는 일부만 동작할 수 있습니다. 예를 들어 HID button은 동작하지만 CDC serial은 동작하지 않을 수 있습니다. 이는 장치가 단순히 "죽었다"는 뜻이 아닙니다. 특정 interface path가 실패했다는 뜻입니다.

보존해야 할 evidence:

모든 interface descriptor.
Class-specific descriptor.
Interface number.
driver class request.
실패한 interface의 endpoint traffic.

디버그 체크리스트

다음 workflow를 사용하십시오.

plug-in 시점부터 capture합니다.
device-level class/subclass/protocol을 확인합니다.
configuration total length와 interface count를 확인합니다.
모든 interface descriptor를 확인합니다.
IAD descriptor와 interface range를 확인합니다.
class-specific descriptor를 확인합니다.
어떤 interface가 binding에 실패하는지 식별합니다.
STALL된 class request를 찾습니다.
필요하면 Windows, Linux, 다른 Windows machine을 비교합니다.
capture를 편집하기 전에 descriptor를 보존합니다.

최종 진단

USB composite driver binding failure는 대개 descriptor contract에서 시작됩니다. class code, interface number, IAD grouping, class-specific descriptor, Microsoft OS descriptor, driver startup 중 class request가 핵심입니다.

Bus Scope는 이러한 contract를 드러내어 "USB Composite Device driver error"를 정확한 interface와 descriptor evidence까지 추적할 수 있게 합니다.

“USB Interface Association Descriptor(IAD)와 복합 장치 디버깅”의 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 Interface Association Descriptor(IAD)와 복합 장치 디버깅”에 대한 짧은 답은 다음과 같습니다. USB composite device는 하나의 물리 USB 장치 안에서 여러 기능을 노출합니다. 이 문장을 모든 입력, 장치, 프로젝트, 환경에 대한 약속이 아니라 검증할 결과로 다루십시오. 완료된 결과에는 시작 상태, 정확한 작업, 보이는 출력, Bus Scope에서 작업이 끝났음을 증명하는 조건이 기록됩니다.

근거 우선 작업 절차

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

확인점 1: USB Interface Association Descriptor(IAD)와 복합 장치 디버깅

“USB Interface Association Descriptor(IAD)와 복합 장치 디버깅”에서는 제품의 판단과 운영체제, 하드웨어, 원본 파일, 권한, 작업 흐름의 경계를 구분합니다. 원인을 지정하기 전에 어느 계층이 근거를 제공했는지 확인하십시오. 가까운 증상을 입증된 근본 원인으로 보고하지 않기 위해서입니다.

확인점 2: USB composite device는 하나의 물리 USB 장치 안에서 여러 기능을 노출합니다.

“USB composite device는 하나의 물리 USB 장치 안에서 여러 기능을 노출합니다.”은 저장, 내보내기 또는 다시 연 결과가 관찰한 상태와 계속 일치할 때만 종료합니다. 일시적인 UI 반응도 유용하지만 지속 가능한 근거가 더 강합니다. 남은 제한을 다음 담당자를 위해 기록합니다.

확인점 3: Composite device의 구조

“Composite device의 구조”에서는 제품의 판단과 운영체제, 하드웨어, 원본 파일, 권한, 작업 흐름의 경계를 구분합니다. 원인을 지정하기 전에 어느 계층이 근거를 제공했는지 확인하십시오. 가까운 증상을 입증된 근본 원인으로 보고하지 않기 위해서입니다.

확인점 4: Interface Association Descriptor(IAD) 확인

“Interface Association Descriptor(IAD) 확인”은 저장, 내보내기 또는 다시 연 결과가 관찰한 상태와 계속 일치할 때만 종료합니다. 일시적인 UI 반응도 유용하지만 지속 가능한 근거가 더 강합니다. 남은 제한을 다음 담당자를 위해 기록합니다.

확인점 5: Class code와 driver 선택

“Class code와 driver 선택”에서는 제품의 판단과 운영체제, 하드웨어, 원본 파일, 권한, 작업 흐름의 경계를 구분합니다. 원인을 지정하기 전에 어느 계층이 근거를 제공했는지 확인하십시오. 가까운 증상을 입증된 근본 원인으로 보고하지 않기 위해서입니다.

확인점 6: Code 10과 Code 43

“Code 10과 Code 43”은 저장, 내보내기 또는 다시 연 결과가 관찰한 상태와 계속 일치할 때만 종료합니다. 일시적인 UI 반응도 유용하지만 지속 가능한 근거가 더 강합니다. 남은 제한을 다음 담당자를 위해 기록합니다.

확인점 7: 부분적인 device failure

“부분적인 device failure”에서는 제품의 판단과 운영체제, 하드웨어, 원본 파일, 권한, 작업 흐름의 경계를 구분합니다. 원인을 지정하기 전에 어느 계층이 근거를 제공했는지 확인하십시오. 가까운 증상을 입증된 근본 원인으로 보고하지 않기 위해서입니다.

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

“디버그 체크리스트”은 저장, 내보내기 또는 다시 연 결과가 관찰한 상태와 계속 일치할 때만 종료합니다. 일시적인 UI 반응도 유용하지만 지속 가능한 근거가 더 강합니다. 남은 제한을 다음 담당자를 위해 기록합니다.

확인점 9: 최종 진단

“최종 진단”에서는 제품의 판단과 운영체제, 하드웨어, 원본 파일, 권한, 작업 흐름의 경계를 구분합니다. 원인을 지정하기 전에 어느 계층이 근거를 제공했는지 확인하십시오. 가까운 증상을 입증된 근본 원인으로 보고하지 않기 위해서입니다.

확인점 10: “USB Interface Association Descriptor(IAD)와 복합 장치 디버깅”의 USB 계약 시험

““USB Interface Association Descriptor(IAD)와 복합 장치 디버깅”의 USB 계약 시험”은 저장, 내보내기 또는 다시 연 결과가 관찰한 상태와 계속 일치할 때만 종료합니다. 일시적인 UI 반응도 유용하지만 지속 가능한 근거가 더 강합니다. 남은 제한을 다음 담당자를 위해 기록합니다.

인수 매트릭스

확인점	보존할 근거	통과 조건
USB Interface Association Descriptor(IAD)와 복합 장치 디버깅	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
USB composite device는 하나의 물리 USB 장치 안에서 여러 기능을 노출합니다.	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Composite device의 구조	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Interface Association Descriptor(IAD) 확인	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Class code와 driver 선택	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Code 10과 Code 43	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다

실패 분리, 복구, 인계

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

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

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

질문과 답변

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

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

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

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

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

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

언제 인계할 수 있습니까?

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