Connecting to a USB Device¶
Remote Windows hosts using the PCoIP Standard Agent or the PCoIP Graphics Agent can use USB devices that are attached to the client. When you connect a local USB device to your remote host it will be disabled on the client machine.
USB device connections do not persist across multiple PCoIP sessions. You must connect your USB device each time you connect.
PCoIP Agent needs to be configured to enable USB redirection
The USB menu will only show up if the PCoIP Agent has been configured to enable USB redirection and a USB device has been detected by the PCoIP Client.
One-time PCoIP Software Client for macOS login
The first time you connect after a Mac installation, you must enter a Mac administrator user name and password. You only need to do this when you install a new client.
ePadLink Signature Pad and some Wacom tablets are connected via local termination
If you are using an ePadLink Signature Pad and certain Wacom tablets they can be connected via local termination. You do not need to carry out any other steps to establish this connection. For information on which Wacom tablets are locally terminated, see Wacom Tablets.
NoMachine USB Driver Compatibility
PCoIP Clients are not compatible with NoMachine and No Machine USB drivers. For information on how to uninstall NoMachine USB drivers, see here.
The following section outlines how to connect a USB device:
- Attach the USB device you want to connect.
-
Select Connection > USB Devices from the PCoIP Software Client menu.
A list of USB devices connected to your client machine appears. Integrated USB devices, such as built-in cameras on laptops, will appear in this list along with devices you have plugged in yourself.
Some devices will identify themselves only as USB Device.
-
Click Connect beside the USB device you want to use.
Connecting to Human Interface Devices
Most Human Interface Devices (HIDs), such as keyboards and mice, are automatically handled by the PCoIP Software Client and don't appear on in this list even if they use a USB connection.
If you need to connect a Human Interface Device that can't be locally processed, like a 3D mouse or a Wacom tablet, enable the Show Human Interface Devices checkbox to reveal the device in the USB device list and click its Connect button.
You may also have to complete additional configuration steps or install drivers on the host machine.
Disconnecting a USB Device¶
- Select Connection > USB Devices from the PCoIP Software Client menu.
- Click Disconnect beside the USB device you want to disconnect.
USB Auto-Forward for Non-HID Devices¶
A HID is a device class definition that enables a generic USB driver to support devices such as keyboards, mice, tablets, controllers, etc. Non-HID devices primarily run on the PS/2 port transport. Automatic bridging enables you to auto bridge all non-HID USB devices by using the usb-auto-forward
command line parameter.
USB Vendor ID/Product ID Auto-Forward¶
You can automatically forward up to 20 USB devices to the host at the start of the
session by calling the PCoIP client executable with vidpid-auto-forward
and the
required VID/PID pairs.
VID/PID Pairs
You can locate the VID/PID pairs from the PCoIP Client logs which are placed in ~/Library/Logs/Teradici/PCoIPClient. When getting the VID/PID pairs from the log you need to strip 0x from the IDs, and use the rest of the ID when running the vidpid-auto-forward
command. As outlined in the following example:
2040-12-12T20:36:46.117Z e0f9e9e9e-866f-1038-test-ac87a3007abc LVL:2 RC: 0 MGMT_USB :Device 0x00010001 VID=0x**18a5**PID=0x**0302** 2040-12-12T20:36:46.117Z e0f9e9e9e-866f-1038-test-ac87a3007abc LVL:2 RC: 0 MGMT_USB :Device 0x00010001 Name=TEST Serial=012345ABCDE pp=000222222
USB VID/PID Auto-forwarding workflow
Devices that are auto-forwarded will appear in the USB Devices dialog box, enabling users to connect or disconnect them from the host. The PCoIP Client application is located at PCoIPClient.app/Contents/MacOS. The following is an example of how this command would look with the VID/PID values:
./PCoIPClient --vidpid-auto-forward "1234,5678 abcd,efgh"
The following rules apply to VID and PID values:
- VID/PID values are comma-separated:
xxx
,yyy
- VID/PID pairs are space-separated:
aaa,bbb
ccc,ddd
- VID/PID pairs with invalid values will be discarded. Discarded rules appear in the event log.
- Up to 20 devices will be passed; if more than 20 are attempted, the first 20 will be accepted and rest ignored. Ignored rules appear in the event log.