2026-06-02

USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터

USB CDC ACM device는 virtual serial port, device console, firmware tool, telemetry, test fixture, embedded diagnostics에 사용됩니다. application 쪽에서는 단순해 보입니다.

USB CDC ACM device는 virtual serial port, device console, firmware tool, telemetry, test fixture, embedded diagnostics에 사용됩니다. application 쪽에서는 단순해 보입니다. COM port 또는 /dev/ttyACM*를 열고, baud rate를 설정하고, byte를 읽고 씁니다. 하지만 그 아래에서는 host와 device가 여전히 class-specific USB request와 bulk transfer를 주고받습니다.

CDC device가 enumeration되지만 data가 움직이지 않을 때, capture는 문제가 descriptor layout, line coding, control line state, endpoint traffic, firmware buffering 중 어디에 있는지 보여줄 수 있습니다.

CDC ACM에는 Control Interface와 Data Interface가 있습니다

일반적인 CDC ACM device는 communication interface와 data interface를 노출합니다. host는 data transfer가 시작되기 전에 class-specific request를 보낼 수 있습니다.

중요한 증거:

communication interface descriptor
data interface descriptor
CDC functional descriptor
notification endpoint
bulk IN endpoint
bulk OUT endpoint
SET_LINE_CODING
GET_LINE_CODING
SET_CONTROL_LINE_STATE

이 request가 전혀 도착하지 않는다면 host가 기대한 CDC driver를 bind하지 않았을 수 있습니다.

Baud Rate는 물리 UART가 아니라 Signal인 경우가 많습니다

많은 USB CDC device에서 baud rate는 UART에서처럼 물리적으로 의미가 있지 않습니다. 그래도 host는 line coding을 보냅니다. firmware는 이를 bridge 구성에 사용하거나, 무시하거나, validation할 수 있습니다.

capture 질문:

host가 SET_LINE_CODING을 보냈는가?
어떤 baud rate, parity, stop bit, data bit를 요청했는가?
firmware가 request를 accept했는가?
host가 SET_CONTROL_LINE_STATE로 DTR 또는 RTS를 설정했는가?
firmware가 전송 전에 DTR을 기다리는가?

많은 "serial output 없음" 문제는 실제로 "firmware가 DTR을 기다리는데 host가 assert하지 않음" 또는 "application이 port를 열었지만 예상대로 configure하지 않음"입니다.

Bulk Endpoint가 Data Movement를 증명합니다

setup 이후 CDC data는 보통 bulk endpoint로 이동합니다. host의 write가 bulk OUT에 보이지만 bulk IN response가 없다면 firmware가 전송하지 않는 것일 수 있습니다. bulk IN data가 보이는데 application이 표시하지 않는다면 host application 동작 문제일 수 있습니다.

inspect할 것:

endpoint direction
transfer length
반복 NAK/timeout 동작
실제 payload byte
transfer status
line-state request와의 ordering

이 지점에서 USB capture는 terminal screenshot보다 훨씬 유용해집니다.

Bus Scope가 들어맞는 위치

Bus Scope는 firmware team이 descriptor, class request, raw endpoint data를 하나의 session 안에 유지하도록 도와야 합니다. CDC ACM 디버깅에서는 다음 질문에 답해야 합니다.

host가 CDC를 bind했는가?
어떤 line coding을 보냈는가?
DTR/RTS가 바뀌었는가?
bulk OUT이 command를 실었는가?
bulk IN이 response를 실었는가?
문제는 serial-style traffic이 시작되기 전인가 후인가?

"USB CDC ACM no data", "virtual COM port no output", "SET_CONTROL_LINE_STATE DTR" 같은 검색어의 증거는 terminal 안에만 있지 않습니다. USB class request와 endpoint transfer 안에 있습니다.

“USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터”의 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 CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터”에 대한 짧은 답은 다음과 같습니다. USB CDC ACM device는 virtual serial port, device console, firmware tool, telemetry, test fixture, embedded diagnostics에 사용됩니다. application 쪽에서는 단순해 보입니다. 이 문장을 모든 입력, 장치, 프로젝트, 환경에 대한 약속이 아니라 검증할 결과로 다루십시오. 완료된 결과에는 시작 상태, 정확한 작업, 보이는 출력, Bus Scope에서 작업이 끝났음을 증명하는 조건이 기록됩니다.

근거 우선 작업 절차

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

확인점 1: USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터

“USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터”을 다른 담당자가 반복할 수 있는 통과 또는 실패 문장으로 만듭니다. 있어야 하는 것, 없어야 하는 것, 실패 시 안전한 복구를 포함합니다. 수정한 복사본이 같은 검사를 통과할 때까지 원본 프로젝트나 캡처를 유지합니다.

확인점 2: USB CDC ACM device는 virtual serial port, device console, firmware tool, telemetry, test fi

“USB CDC ACM device는 virtual serial port, device console, firmware tool, telemetry, test fixture, embedded diagnostics에 사용됩니다. application 쪽에서는 단순해 보입니”을 “USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터”의 독립된 인수 기준으로 다루십시오. 작업 전 상태, 처음 보인 변화, 최종 상태를 기록합니다. 결과가 설명된 목표와 다르면 추측으로 계속하지 말고 마지막으로 확인한 지점으로 돌아갑니다.

확인점 3: CDC ACM에는 Control Interface와 Data Interface가 있습니다

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

확인점 4: Baud Rate는 물리 UART가 아니라 Signal인 경우가 많습니다

“Baud Rate는 물리 UART가 아니라 Signal인 경우가 많습니다”을 “USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터”의 독립된 인수 기준으로 다루십시오. 작업 전 상태, 처음 보인 변화, 최종 상태를 기록합니다. 결과가 설명된 목표와 다르면 추측으로 계속하지 말고 마지막으로 확인한 지점으로 돌아갑니다.

확인점 5: Bulk Endpoint가 Data Movement를 증명합니다

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

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

“Bus Scope가 들어맞는 위치”을 “USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터”의 독립된 인수 기준으로 다루십시오. 작업 전 상태, 처음 보인 변화, 최종 상태를 기록합니다. 결과가 설명된 목표와 다르면 추측으로 계속하지 말고 마지막으로 확인한 지점으로 돌아갑니다.

확인점 7: “USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터”의 USB 계약 시험

““USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터”의 USB 계약 시험”을 다른 담당자가 반복할 수 있는 통과 또는 실패 문장으로 만듭니다. 있어야 하는 것, 없어야 하는 것, 실패 시 안전한 복구를 포함합니다. 수정한 복사본이 같은 검사를 통과할 때까지 원본 프로젝트나 캡처를 유지합니다.

확인점 8: 인용 가능한 답

“인용 가능한 답”을 “USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터”의 독립된 인수 기준으로 다루십시오. 작업 전 상태, 처음 보인 변화, 최종 상태를 기록합니다. 결과가 설명된 목표와 다르면 추측으로 계속하지 말고 마지막으로 확인한 지점으로 돌아갑니다.

확인점 9: communication interface descriptor

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

확인점 10: data interface descriptor

“data interface descriptor”을 “USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터”의 독립된 인수 기준으로 다루십시오. 작업 전 상태, 처음 보인 변화, 최종 상태를 기록합니다. 결과가 설명된 목표와 다르면 추측으로 계속하지 말고 마지막으로 확인한 지점으로 돌아갑니다.

인수 매트릭스

확인점	보존할 근거	통과 조건
USB CDC ACM Serial 디버깅: Line Coding, Control Line State, 누락 데이터	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
USB CDC ACM device는 virtual serial port, device console, firmware tool, telemetry, test fixture, embedded diagnostics에 사	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
CDC ACM에는 Control Interface와 Data Interface가 있습니다	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Baud Rate는 물리 UART가 아니라 Signal인 경우가 많습니다	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Bulk Endpoint가 Data Movement를 증명합니다	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
Bus Scope가 들어맞는 위치	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다

실패 분리, 복구, 인계

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

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

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

질문과 답변

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

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

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

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

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

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

언제 인계할 수 있습니까?

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