USB Device Tree Viewer(UsbTreeView)는 Windows PC의 USB 컨트롤러·허브·장치를 트리로 보여 주는 무료 도구입니다. 개발 보드가 어느 포트에 연결됐는지, VID·PID가 무엇인지, USB 카메라가 기대한 속도로 연결됐는지 확인할 때 유용합니다. 이 글은 장치를 연결한 뒤 관찰값을 기록하고 케이블·허브 교체 전후를 비교하는 실습입니다.
확인 기준: 2026년 9월 13일, 정식 배포판 4.7.4(2026년 8월 22일 공개). 첨부한 UsbTreeView_x64.zip은 개발자 사이트에서 받은 Windows x64용 원본 ZIP이며, UsbTreeView-4.7.4-guide-ko.zip은 별도로 작성한 한국어 설명서·실습 자료입니다. 공식 소개·현재 버전·배포 조건
1. 다운로드와 설치·실행
- Windows 설정의 시스템 → 정보 → 시스템 종류에서 PC 아키텍처를 확인합니다. 일반적인 Intel·AMD 64비트 Windows PC에는 첨부 x64 ZIP을 사용합니다.
- ZIP을 사용자 문서 아래
UsbTreeView같은 쓰기 가능한 폴더에 전체 압축 해제합니다. 원본 ZIP에는UsbTreeView.exe가 들어 있습니다. UsbTreeView.exe를 실행합니다. 설치 마법사 없이 사용할 수 있습니다. 도움말 메뉴에서 프로그램 설명과 버전을 확인합니다.- 현재 4.7 계열의 공식 지원 기준은 Windows 8 이상입니다. 이 실습은 Windows 10·11을 기준으로 설명합니다. Windows on ARM은 공식 ARM64 ZIP, 32비트 Windows는 공식 Win32 ZIP을 선택합니다.
UsbTreeView는 USB 장치 정보를 조회하는 도구이며 USB-UART 드라이버 설치 기능을 제공하지 않습니다. COM 포트가 필요한 보드는 해당 칩·보드 제조사의 드라이버도 필요할 수 있습니다.
첨부 x64 원본의 크기는 533,531바이트입니다. 다음 SHA-256은 내려받은 파일에서 직접 계산한 값입니다. 공식 다운로드 페이지에는 게시된 체크섬을 찾지 못했으므로 개발자 체크섬과의 대조 완료를 뜻하지 않습니다.
ec8e8e973f6f3e35e0188294c530e5ff584fd7a004f01d6c0f6adfbf46d543ebWindows PowerShell에서 첨부파일을 저장한 폴더를 열고 비교할 수 있습니다.
Get-FileHash -Algorithm SHA256 -LiteralPath '.\UsbTreeView_x64.zip'2. 준비물과 화면에서 확인할 항목
Windows PC, 데이터 통신이 가능한 USB 케이블, 시험할 개발 보드 또는 USB 장치 한 개를 준비합니다. 허브 문제를 비교하려면 평소 사용하던 허브도 준비합니다. 장비가 없으면 4절의 동봉 CSV 비교부터 진행할 수 있습니다.
왼쪽 트리에서 대상 장치를 선택하고 오른쪽 상세 정보를 읽습니다. USB 컨트롤러나 상위 허브를 선택하면 다른 정보가 표시되므로 대상 장치 노드를 선택했는지 먼저 확인합니다.
| 확인 항목 | 읽는 방법 |
|---|---|
| VID·PID | 디바이스 디스크립터의 idVendor·idProduct 또는 장치 ID의 VID·PID를 기록합니다. 같은 모델 여러 개를 VID·PID만으로 구분할 수는 없습니다. |
| 연결 속도 | 현재 장치 연결 속도를 읽습니다. Full-Speed는 12 Mbit/s, High-Speed는 480 Mbit/s, SuperSpeed는 5 Gbit/s 등급입니다. 애플리케이션의 실측 전송률과는 다릅니다. |
| USB 버전 | bcdUSB는 장치가 따르는 USB 규격 버전입니다. 0x0200만 보고 현재 480 Mbit/s로 동작한다고 판단하지 않습니다. |
| 상위 허브·포트 | 트리의 부모 노드와 포트 번호를 기록합니다. 비교할 때는 PC의 물리적 커넥터에도 A·B 같은 라벨을 붙이면 좋습니다. |
| 하위 장치·COM 포트 | USB-UART 또는 복합 장치는 하위 장치도 확인합니다. COM 번호가 표시되면 장치 관리자의 포트 항목과 대조합니다. |
필드 의미는 Microsoft의 USB 디바이스 디스크립터 설명, 속도 구분은 Windows USB FAQ를 참고할 수 있습니다.
3. 실습: 개발 보드의 USB 연결 경로 확인
- 보드에서 진행 중인 쓰기·업로드를 종료합니다. 보드를 분리한 상태에서 UsbTreeView를 열고, 사용할 PC 포트에 보드를 연결합니다.
- 추가된 장치 노드를 선택합니다. 비슷한 장치가 여러 개면 보드 한 개만 분리·재연결하며 해당 노드를 찾습니다.
- 장치 이름, VID·PID, 현재 연결 속도, 상위 허브·포트, COM 번호를
observation-template.csv에 적습니다.bench_id는 직접 정한 라벨입니다. 실제 장치 일련번호를 입력할 필요는 없습니다. - Windows에서
Win + R을 누르고devmgmt.msc를 실행합니다. 해당 장치의 속성 → 자세히 → 하드웨어 ID를 열어 VID·PID가 같은지 확인합니다. - 보드를 허브에 옮겨 연결하고 같은 항목을 다시 기록합니다. 한 번에는 케이블 또는 허브 중 한 가지 조건만 바꿉니다.
- 보드가 Full-Speed 장치라면 PC의 USB 3 포트에 꽂아도 Full-Speed인 것이 정상일 수 있습니다. 보드 데이터시트의 지원 속도와 함께 해석합니다.
확인 목표: 같은 보드를 트리에서 다시 찾을 수 있고, 제조사 정보와 VID·PID가 일치하며, 허브를 옮겼을 때 연결 경로의 변화를 설명할 수 있으면 됩니다. COM 포트가 보이는 것만으로 UART 통신이나 펌웨어 업로드 성공까지 확인된 것은 아닙니다. Microsoft의 USB 정보·장치 관리자 확인 절차
4. 실습: 케이블 교체 전후 관찰값 비교
첨부 CSV는 직접 만든 가상의 학습용 관찰 기록입니다. UsbTreeView가 내보낸 원본 보고서나 실제 측정 결과가 아닙니다. VID·PID도 설명용 값이며 실제 장비의 설정·펌웨어에 복사하면 안 됩니다. 프로그램으로 가져오는 형식도 아니므로 CSV는 텍스트 편집기로 열어 비교합니다.
observations-before.csv와observations-after.csv를 엽니다.UART-A는 두 파일 모두 Full-Speed이고 기록값이 동일합니다.CAM-A는 연결 경로가PC/HubA/Port3에서PC/Port4로, 속도는 High-Speed에서 SuperSpeed로 바뀌어 있습니다.- 이는 교체 후 연결 등급이 달라졌다는 연습용 사례입니다. 원인이 케이블인지 허브인지 판별하려면 각각 하나씩 바꾸는 추가 시험이 필요합니다.
Python 3이 설치되어 있다면 설명서 압축을 푼 폴더에서 아래 명령으로 같은 차이를 확인할 수 있습니다. 추가 패키지는 필요 없으며 CSV만 읽습니다. Python은 UsbTreeView 실행 자체에는 필요하지 않습니다.
python compare_observations.pyWindows에서 python이 인식되지 않고 Python 런처가 설치돼 있다면 py -3 compare_observations.py를 사용합니다. 기대 결과는 다음 두 줄입니다.
CAM-A: hub_path: PC/HubA/Port3 -> PC/Port4
CAM-A: speed: High-Speed -> SuperSpeed실제 시험에는 양식에 직접 기록한 두 CSV를 준비하고 파일명을 인수로 넘깁니다. 비교할 같은 장치는 두 파일에서 같은 bench_id를 사용합니다.
python compare_observations.py my-before.csv my-after.csv5. 보고서 보관과 결과 정리
UsbTreeView는 텍스트·XML 보고서를 저장할 수 있습니다. 다음은 실행 파일이 있는 폴더에서 PowerShell로 현재 PC의 보고서를 파일로 저장하는 예입니다. 같은 이름의 기존 보고서가 없는지 확인하고 실행합니다.
.\UsbTreeView.exe -R=usb-before.txt
.\UsbTreeView.exe -X=usb-before.xml케이블을 바꾼 뒤에는 usb-after.txt처럼 다른 이름을 사용합니다. 이 보고서는 전체 PC의 장치 정보를 담을 수 있으므로 외부 공유 전 컴퓨터 이름·장치 일련번호·경로 등을 확인해 필요한 대상 부분만 전달합니다. 동봉 CSV 비교기는 이 텍스트·XML 보고서를 직접 읽지 않습니다.
문제를 재현한 시각, PC 포트, 케이블 라벨, 허브 사용 여부, 예상 속도와 관찰 속도를 함께 남기면 다른 개발자가 같은 조건으로 다시 시험하기 쉽습니다.
6. 자주 생기는 문제
- 연결해도 트리에 변화가 없음: 충전 전용 케이블인지 확인하고, 확인된 데이터 케이블과 PC 직결 포트로 시험합니다. 보드 전원·커넥터 상태도 점검합니다.
- 장치는 보이지만 COM 포트가 없음: 그 장치가 USB-UART/CDC 기능을 제공하는지 먼저 확인합니다. 장치 관리자 오류와 제조사 드라이버 설치 상태를 확인합니다. USB 카메라·HID 장치에 COM 포트가 없는 것은 정상입니다.
- SuperSpeed 장치가 High-Speed로 연결됨: 장치·케이블·허브·PC 포트가 모두 목표 속도를 지원하는지 확인합니다. USB-C 커넥터 모양만으로 속도를 단정하지 말고, 직결 상태부터 비교합니다.
- Unknown Device 또는 코드 43: 장치 관리자 상태를 함께 읽습니다. 장치 디스크립터를 받지 못한 경우 표시되는 임시 VID·PID는 실제 제조사 ID로 해석하지 않습니다. 정상 케이블·다른 포트·다른 PC 순서로 원인을 좁힙니다.
- XML을 열지 못함: 4.7.4에는 4.7.2 이후 발생한 XML 보고서 읽기 오류 수정이 포함됩니다. 도움말의 버전과 파일 형식을 확인합니다. UsbTreeView XML과 Microsoft USBView 보고서는 서로 호환되는 형식이 아닙니다.
- 관찰 중 연결이 끊김: 우선 전원·케이블 접촉을 확인합니다. 관찰 실습 중에는 장치 재시작·포트 재시작·제거 메뉴를 사용하지 않습니다. 같은 허브의 다른 작업도 끊길 수 있습니다.
7. 첨부 구성과 배포 조건
- UsbTreeView_x64.zip: 개발자 Uwe Sieber의 4.7.4 x64 원본 프로그램 ZIP. 파일명과 내부 실행 파일을 변경하지 않았습니다.
- UsbTreeView-4.7.4-guide-ko.zip: 한국어
README.html·README.txt, 공식 링크, 설치·관찰 확인표, 학습용 CSV 두 개, 빈 기록 양식, 비교 스크립트와 기대 결과, 배포 조건 요약이 들어 있습니다.
UsbTreeView는 자체 조건의 프리웨어이며 상업 환경 사용과 소프트웨어 제품에 포함한 배포 등을 허용합니다. 원본 파일 변경과 별도 다운로드 프로그램을 통한 제공은 금지됩니다. 이 자료실에서는 원본 ZIP을 직접 내려받도록 제공하며 한국어 설명서는 별도 ZIP으로 제공합니다. 개발자 공식 배포 조건 · 공식 x64 다운로드
검증 범위: 공식 원본의 버전 리소스, ZIP CRC, SHA-256 및 동봉 CSV 비교 예제의 결과를 확인했습니다. 예시 관찰값은 실제 장비 측정값이 아니며, 독자의 개별 개발 보드에서 연결 속도나 동작을 보증하지 않습니다. 첨부 실습 자료에는 장비용 펌웨어가 없습니다.