USBIP-WIN 开源项目教程
usbip-win项目地址:https://gitcode.com/gh_mirrors/us/usbip-win
1. 项目的目录结构及介绍
USBIP-WIN 项目的目录结构如下:
usbip-win/
├── README.md
├── usbip.exe
├── usbipd.exe
├── usbip_stub.sys
├── usbip_stub.inx
├── usbip_vhci.sys
├── usbip_vhci.inf
├── usbip_vhci.cat
├── usbip_vhci_ude.sys
├── usbip_vhci_ude.inf
├── usbip_vhci_ude.cat
├── usbip_root.inf
├── usbip_test.pfx
├── usbip.ids
├── userspace/
│ └── usbip.c
├── driver/
│ ├── stub/
│ │ ├── usbip_stub.c
│ │ └── usbip_stub.h
│ └── vhci/
│ ├── usbip_vhci.c
│ ├── usbip_vhci.h
│ ├── usbip_vhci_ude.c
│ └── usbip_vhci_ude.h
└── scripts/
└── build.sh
目录结构介绍
README.md
: 项目说明文档。usbip.exe
和usbipd.exe
: 主要的可执行文件。usbip_stub.sys
和usbip_stub.inx
: USBIP 存根驱动文件。usbip_vhci.sys
,usbip_vhci.inf
,usbip_vhci.cat
: VHCI 驱动文件。usbip_vhci_ude.sys
,usbip_vhci_ude.inf
,usbip_vhci_ude.cat
: VHCI UDE 驱动文件。usbip_root.inf
: 根驱动文件。usbip_test.pfx
: 测试证书文件。usbip.ids
: USB 设备 ID 文件。userspace/
: 用户空间代码目录。driver/
: 驱动代码目录。scripts/
: 构建脚本目录。
2. 项目的启动文件介绍
启动文件
usbip.exe
: 用于管理 USB/IP 设备的命令行工具。usbipd.exe
: USB/IP 设备主机服务,用于管理 USB 设备的连接和断开。
启动命令示例
# 安装 USB/IP 服务
usbip.exe install
# 启动 USB/IP 服务
usbipd.exe -d -4
# 连接 USB/IP 设备
usbip.exe attach -r <usbip server ip> -b 1-59
3. 项目的配置文件介绍
配置文件
usbip_stub.inx
: 存根驱动配置文件。usbip_vhci.inf
: VHCI 驱动配置文件。usbip_vhci_ude.inf
: VHCI UDE 驱动配置文件。usbip_root.inf
: 根驱动配置文件。
配置文件示例
; usbip_vhci.inf
[Version]
Signature="$WINDOWS NT$"
Class=USB
ClassGuid={36FC9E60-C465-11CF-8056-444553540000}
Provider=%USBIP_VHCI%
CatalogFile=usbip_vhci.cat
DriverVer=12/09/2023,1.0.0.0
[DestinationDirs]
DefaultDestDir=12
[SourceDisksNames]
1=%USBIP_VHCI%,,,
[SourceDisksFiles]
usbip_vhci.sys=1
[Manufacturer]
%USBIP_VHCI%=USBIP_VHCI,NTamd64
[USBIP_VHCI.NTamd64]
%USBIP_VHCI.DeviceDesc%=USBIP_VHCI_Device, USB\VID_XXXX&PID_YYYY
[USBIP_VHCI_Device.NT]
CopyFiles=USBIP_VHCI_Device.NT, USBIP_VHCI_Device.NT.Driver
[USBIP_VHCI_Device.NT.