安装 USB 客户端模式
要在电脑上以 USB 客户端模式安装 USB Redirector for Linux,请先下载并解压安装包,然后执行以下命令:
$ ./installer.sh install-client
安装成功后,名为 usbsrvd 的守护进程将在系统中运行,它负责实际的重定向工作。您需要使用 usbclnt 命令行工具来连接/断开 USB 设备。所有后续操作都通过该工具执行。
命令行语法
usbclnt 工具的通用命令行语法为:
usbclnt <command>
其中 <command> 可以是以下命令之一:
| 命令 | 说明 |
-a, -add-server <addr:port> | 将 USB 服务器添加到配置中 |
-r, -remove-server <addr:port> | 从配置中移除远程 USB 服务器并断开其所有设备 |
-c, -connect <server> <device> | 从指定服务器连接指定设备 |
-u, -disconnect <server> <device> | 断开来自指定服务器的指定设备 |
-add-exclusion <server> <device> | 将指定设备添加到排除列表 |
-remove-exclusion <server> <device> | 将指定设备从排除列表中移除 |
-auto-connect on|off <server> <device> | 启用/禁用单个设备的自动连接 |
-auto-connect on|off <server> | 启用/禁用指定服务器上所有设备的自动连接 |
-l, -list-devices | 列出所有 USB 服务器及其设备 |
-i, -info | 显示此 USB 客户端的信息 |
-version | 显示程序版本号 |
参数说明
<deviceid> — 由 -list-devices 命令显示的设备 ID 编号。
<serverid> — 由 -list-devices 命令显示的服务器 ID 编号。
<device> — 以下参数的组合,用于标识 USB 设备:
-deviceid <id> | 设备 ID 编号 |
-vid <vendorid> | USB 设备供应商 ID |
-pid <productid> | USB 设备产品 ID |
-serial <serial> | USB 设备序列号 |
-usb-port <port> | USB 端口号 |
-device-name "<name>" | USB 设备名称(需用双引号括起来) |
<server> — 以下参数之一,用于标识远程 USB 服务器:
-serverid <id> | 服务器 ID 编号 |
-server <addr:port> | 远程 USB 服务器地址和端口号 |
连接到 USB 服务器
要连接到远程 USB 服务器,需要先将其添加到配置中。USB Redirector 会自动维护与配置中所有 USB 服务器的连接。这意味着如果连接因某种原因断开,USB Redirector 将自动重新连接。
要将 USB 服务器添加到配置中,执行以下命令:
$ usbclnt -add-server 192.168.1.2:32032
user@linux-vm:~$ usbclnt -add-server 192.168.1.2:32032
====================== OPERATION SUCCESSFUL =====================
USB server has been added
===================== ======================= ===================
user@linux-vm:~$
获取 USB 服务器和设备列表
要查看 USB 服务器及其 USB 设备列表,执行:
$ usbclnt -list-devices
您将看到以下输出:
user@linux-vm:~$ usbclnt -list-devices
================== LIST OF REMOTE USB DEVICES ===================
1: USB server at 192.168.1.2:32032
Mode: manual-connect Status: connected
|
|- 1: Flash Disk USB - USB Mass Storage Device
| Vid: 0ea0 Pid: 2168 Serial: 611041F0886000B9
| Mode: manual-connect Status: available for connection
|
`- 19: FM1083 FORTEMEDIA - Composite USB Device
Vid: 138c Pid: 0001 Port: 2-2
Mode: manual-connect Status: available for connection
===================== ======================= ===================
user@linux-vm:~$
USB Redirector 中的所有设备和服务器都会分配唯一的 ID 编号,这些 ID 可方便地用于连接/断开设备或管理配置中的服务器。
每个 USB 服务器会显示以下状态之一:
- connected — USB 客户端已连接到远程 USB 服务器
- disconnected — USB 客户端无法连接到远程 USB 服务器
- version conflict — 远程电脑上的 USB 服务器版本不兼容
每个 USB 设备会显示以下状态之一:
- available for connection — 远程 USB 设备可供连接
- not available — 远程 USB 设备不可连接
- connected — 远程 USB 设备已连接到此电脑
- in exclusion list — 远程 USB 设备在排除列表中,无法被连接
通过 ID 连接 USB 设备
例如,要从服务器 "1: USB Server at 192.168.1.2" 连接设备 "19: FM1083 FORTEMEDIA - Composite USB Device",执行以下命令:
$ usbclnt -connect 1-19
user@linux-vm:~$ usbclnt -connect 1-19
====================== OPERATION SUCCESSFUL =====================
USB device connected
===================== ======================= ===================
user@linux-vm:~$
通过 VID 和 PID 连接 USB 设备
也可以通过 VID 和 PID 连接 USB 设备。要从服务器 "1: USB Server at 192.168.1.2" 连接设备 "19: FM1083 FORTEMEDIA",执行:
$ usbclnt -connect -server 192.168.1.2:32032 -vid 138c -pid 0001 -usb-port 2-2
user@linux-vm:~$ usbclnt -connect \
-server 192.168.1.2:32032 -vid 138c -pid 0001 -usb-port 2-2
====================== OPERATION SUCCESSFUL =====================
USB device connected
===================== ======================= ===================
user@linux-vm:~$
断开 USB 设备
要断开设备 "19: FM1083 FORTEMEDIA - Composite USB Device" 与服务器 "1: USB Server at 192.168.1.2" 的连接,执行:
$ usbclnt -disconnect 1-19
user@linux-vm:~$ usbclnt -disconnect 1-19
====================== OPERATION SUCCESSFUL =====================
USB device disconnected
===================== ======================= ===================
user@linux-vm:~$