2026-06-03

USB String Descriptor와 LANGID 디버깅

USB string descriptor는 별것 아닌 것처럼 보이지만, 잘못된 string은 driver binding, device identity, serial-port persistence, lab automation, firmware update tool, support workflow를 깨뜨릴 수 있습니다. 장치가 enumerate되지만 identity가 불안정할 때 사용자는 "USB string descriptor failed", "LANGID descriptor", "USB serial number descriptor missing", "duplicate USB serial number", "USB product string wrong", "Windows shows unknown USB device name" 같은 표현을 검색합니다.

Bus Scope가 유용한 이유는 string descriptor failure가 enumeration 중 control transfer로 발생하기 때문입니다. Host는 supported language ID를 요청한 다음 manufacturer, product, serial number string을 요청합니다. 어느 단계든 malformed data를 반환하면 OS가 계속 진행하더라도 잘못된 identity를 저장할 수 있습니다.

LANGID descriptor 확인

특정 string을 요청하기 전에 host는 string descriptor zero를 요청할 수 있습니다. 이것은 supported language ID를 반환합니다.

전형적인 evidence:

GET_DESCRIPTOR String index 0
LANGID list returned
GET_DESCRIPTOR String index 1
GET_DESCRIPTOR String index 2
GET_DESCRIPTOR String index 3

string descriptor zero가 실패하면 이후 string request가 host마다 일관되지 않게 동작할 수 있습니다.

manufacturer, product, serial string 확인

흔한 string index:

iManufacturer
iProduct
iSerialNumber

이 field는 Device Descriptor에서 참조됩니다. 장치가 nonzero string index를 advertise하면서 실제 string 반환에 실패하면 host behavior가 달라질 수 있습니다.

증상:

Device가 "Unknown Device"로 나타납니다.
Product name이 깨져 보입니다.
Serial number가 비어 있습니다.
Windows가 plug-in할 때마다 새 COM port를 만듭니다.
Linux udev rule이 안정적으로 match되지 않습니다.
Firmware update tool이 target을 식별하지 못합니다.
여러 unit이 하나의 identity로 합쳐집니다.

duplicate serial number 확인

중복 USB serial number는 심각한 production problem입니다. 같은 VID, PID, serial number를 가진 두 physical device는 같은 device instance로 취급될 수 있습니다.

결과:

잘못된 calibration data가 load됩니다.
Test station이 log를 잘못된 unit에 씁니다.
COM port assignment가 예측하기 어렵게 바뀝니다.
Licensing 또는 provisioning이 잘못된 hardware에 bind됩니다.
Field support가 device를 구분하지 못합니다.

Packet capture는 serial descriptor byte가 실제로 중복인지, 아니면 OS display layer가 더 깊은 문제를 숨기고 있는지 입증할 수 있습니다.

missing serial number 확인

일부 device는 의도적으로 serial number를 생략합니다. 단순 peripheral에서는 괜찮을 수 있지만 stable identity가 중요할 때는 문제가 됩니다.

흔한 검색어:

"USB device new COM port every time"
"USB serial number missing"
"Windows USB device instance path changes"
"Linux udev match USB serial"

Serial number가 없으면 OS는 hardware identity 대신 port topology로 device를 식별할 수 있습니다.

malformed UTF-16LE string 확인

USB string은 Unicode string으로 encoding됩니다. Firmware bug는 다음과 같습니다.

잘못된 descriptor length.
홀수 byte count.
누락된 descriptor type.
잘못된 UTF-16LE byte.
null termination expectation mismatch.
USB string format 대신 ASCII byte를 반환.
긴 serial number를 truncate.

일부 host는 이를 tolerate합니다. 다른 host는 descriptor를 reject하거나 corrupted text를 표시합니다.

String request timing과 retry

Host는 같은 string을 서로 다른 length로 여러 번 요청할 수 있습니다. Device는 짧은 probe request와 full-length request를 모두 처리해야 합니다.

Failure pattern:

Device가 처음 2 byte는 올바르게 반환하지만 full request에서 실패합니다.
Firmware가 wLength가 항상 descriptor length와 같다고 가정합니다.
Control endpoint가 반복 string request에서 stall됩니다.
Device가 reset 이후 다른 serial number를 반환합니다.
Bootloader와 application firmware가 서로 다른 identity를 보고합니다.

이 문제는 firmware update workflow에서 흔합니다.

Driver binding 영향

Driver selection은 보통 VID/PID/class에 의존하지만, string descriptor는 user-visible identity와 때로는 vendor tool에 영향을 줍니다. Composite device, CDC serial device, HID tool, DFU bootloader는 support와 automation을 위해 string에 의존하는 경우가 많습니다.

Support ticket이 "wrong USB device name"이라고 말한다고 해서 cosmetic issue로 치부하지 마세요. descriptor corruption이나 firmware state confusion의 신호일 수 있습니다.

디버그 checklist

다음 절차를 사용하세요.

plug-in부터 enumeration을 캡처합니다.
Device Descriptor string index를 검사합니다.
LANGID용 string descriptor zero를 확인합니다.
manufacturer string을 decode합니다.
product string을 decode합니다.
serial number string을 decode합니다.
두 physical unit을 비교합니다.
bootloader와 application firmware를 비교합니다.
reset 및 replug 이후 behavior를 확인합니다.
firmware fix를 위해 raw descriptor byte를 보존합니다.

최종 진단

USB string descriptor와 LANGID 문제는 device identity, serial persistence, manufacturing test, field support, driver workflow에 영향을 줍니다. 핵심 evidence는 운영체제 label이 아니라 실제 descriptor control transfer입니다.

Bus Scope는 LANGID, manufacturer, product, serial number, malformed string, duplicate serial, enumeration retry를 하나의 diagnostic view에서 보여주는 데 도움을 줍니다.

“USB String Descriptor와 LANGID 디버깅”의 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 String Descriptor와 LANGID 디버깅”에 대한 짧은 답은 다음과 같습니다. USB string descriptor는 별것 아닌 것처럼 보이지만, 잘못된 string은 driver binding, device identity, serial-port persistence, lab automation, firmware update tool, support workflow를 깨뜨릴 수 있습니다. 이 문장을 모든 입력, 장치, 프로젝트, 환경에 대한 약속이 아니라 검증할 결과로 다루십시오. 완료된 결과에는 시작 상태, 정확한 작업, 보이는 출력, Bus Scope에서 작업이 끝났음을 증명하는 조건이 기록됩니다.

근거 우선 작업 절차

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

확인점 1: USB String Descriptor와 LANGID 디버깅

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

확인점 2: USB string descriptor는 별것 아닌 것처럼 보이지만, 잘못된 string은 driver binding, device identity, serial

“USB string descriptor는 별것 아닌 것처럼 보이지만, 잘못된 string은 driver binding, device identity, serial-port persistence, lab automation, firmware update tool, sup”을 다른 담당자가 반복할 수 있는 통과 또는 실패 문장으로 만듭니다. 있어야 하는 것, 없어야 하는 것, 실패 시 안전한 복구를 포함합니다. 수정한 복사본이 같은 검사를 통과할 때까지 원본 프로젝트나 캡처를 유지합니다.

확인점 3: LANGID descriptor 확인

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

확인점 4: manufacturer, product, serial string 확인

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

확인점 5: duplicate serial number 확인

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

확인점 6: missing serial number 확인

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

확인점 7: malformed UTF-16LE string 확인

“malformed UTF-16LE string 확인”을 “USB String Descriptor와 LANGID 디버깅”의 독립된 인수 기준으로 다루십시오. 작업 전 상태, 처음 보인 변화, 최종 상태를 기록합니다. 결과가 설명된 목표와 다르면 추측으로 계속하지 말고 마지막으로 확인한 지점으로 돌아갑니다.

확인점 8: String request timing과 retry

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

확인점 9: Driver binding 영향

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

확인점 10: 디버그 checklist

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

인수 매트릭스

확인점	보존할 근거	통과 조건
USB String Descriptor와 LANGID 디버깅	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
USB string descriptor는 별것 아닌 것처럼 보이지만, 잘못된 string은 driver binding, device identity, serial-port persistence, lab automat	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
LANGID descriptor 확인	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
manufacturer, product, serial string 확인	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
duplicate serial number 확인	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다
missing serial number 확인	시작 상태, 한 작업, 결과 상태	두 번째 담당자가 같은 결과를 재현한다

실패 분리, 복구, 인계

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

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

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

질문과 답변

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

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

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

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

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

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

언제 인계할 수 있습니까?

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