Skip to content

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.

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.

USB Bridging of Webcams

USB Webcams can be redirected to a remote PCoIP Agent for Windows from PCoIP Software Clients for Windows and/or Linux. You need to ensure that the upstream bandwidth of the connection is sufficient to support streaming video. This feature works with a limited set of USB cameras, including the Logitech C920. It is limited to video resolutions of less than 480p.

The following section outlines how to connect a USB device:

  1. Attach the USB device you want to connect.

  2. 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.

  3. Click Connect beside the USB device you want to use. Alt Text

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

  1. Select Connection > USB Devices from the PCoIP Software Client menu.
  2. Click Disconnect beside the USB device you want to disconnect. Alt Text

USB Auto-Forward with 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 /tmp/Teradici//logs/. 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
The VID/PID pair in this scenario would be 18a5,0302.

USB VID/PID Auto-forwarding workflow

Alt Text

Devices that are auto-forwarded will appear in the USB Devices dialog box, enabling users to connect or disconnect them from the host. The following is an example of how this command would look with the VID/PID values: 

pcoip-client --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.