USB Client Mode

USB 客户端模式使用指南

了解如何在 Linux 上以 USB 客户端模式安装和使用 USB Redirector for Linux,连接远程共享的 USB 设备。

安装 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 服务器会显示以下状态之一:

每个 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:~$