usbipd-win

By | 2026년 7월 13일
Table of Contents

usbipd-win

Windows에 연결된 USB 장치를 WSL 2(Windows Subsystem for Linux) 환경에 연결하고 제어할 수 있게 해주는 오픈소스 소프트웨어입니다

설치

# powershell
winget install --interactive --exact dorssel.usbipd-win

장치 확인

# powershell
usbipd list
BUSID  VID:PID    DEVICE                                                        STATE
2-3    0483:374e  ST-Link Debug, USB 대용량 저장 장치, STMicroelectronics S...  Not shared
2-5    046d:c077  USB 입력 장치                                                 Not shared
2-6    1a2c:2d23  USB 입력 장치                                                 Not shared
2-17   17e9:4301  USB3.0  Display, USB Audio                                    Not shared

Persisted:
GUID                                  DEVICE

bind & attach

관리자권한으로 powershell 을 실행합니다.

usbipd bind --busid 2-3
usbipd attach --wsl --busid 2-3
# usbipd attach --wsl --busid 2-3 --auto-attach

WSL 에서 확인하기

# sudo apt install usbutils
lsusb

권한설정

usbipd-win 연결된 usb 장비는 root 권한으로만 접근이 가능합니다.

임시적인 방법

# 경로 찾아서 권한 변경
sudo chmod 666 /dev/bus/usb/001/002

영구적인 방법 (NUCLEO 보드의 경우)

sudo cp ~/STMicroelectronics/STM32Cube/STM32CubeProgrammer/Drivers/rules/*.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules
sudo udevadm trigger
cat /etc/wsl.conf

# /etc/wsl.conf 에 아래 추가 (없으면 파일 생성)
sudo tee -a /etc/wsl.conf > /dev/null <<'EOF'
[boot]
systemd=true
EOF
# powershell
wsl --shutdown

WSL 을 재실행합니다.

답글 남기기