Troubleshooting USB Devices

The following sections outline potential issues and workarounds that may occur with USB Devices on the PCoIP Software Client for macOS.

USB Kernel Extension¶

If the USB kernel extension file, usb-mediator.kext, fails to load, run the following commands to resolve the issue:

1. Open a terminal shell and run:

   sudo chmod -R 755 /Applications/PCoIPClient.app/Contents/MacOS/usb-mediator.kext
   

2. Then run the following command:

   sudo chown -R root:wheel /Applications/PCoIPClient.app/Contents/MacOS/usb-mediator.kext
   

3. Finally clear the kextcache by running the following command:

   sudo kextcache --clear-staging
   

USB Device Pressure Sensitivity¶

The PCoIP Software Client for macOS may encounter issues with Wacom pressure sensitivity. This is as a USB handling restriction on macOS Catalina. It occurs when you want to load the USB Kernel Extension at session start up. The following workaround can be used on OSX Catalina to enable kext (Kernel extension) specifically:

1. Run the following command:

   sudo kextload /Applications/PCoIPClient.app/Contents/MacOS/usb-mediator.kext
   

2. You will receive the following error:

   /Applications/PCoIPClient.app/Contents/MacOS/usb-mediator.kext failed to load - (libkern/kext) system policy prevents loading; check the system/kernel logs for errors or try kextutil(8)`
   

3. Open your System Preferences.
4. Select Security and Privacy.
5. Select the General tab and you will be asked to approve the kext from Teradici.
6. Approve the kext and the device will be visible and available as a connection in the client.