Knowledge Base

The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
 
Search the VMware Knowledge Base (KB)   View by Article ID
 

Troubleshooting USB devices using USB quirks in Fusion (1025256)

Symptoms

  • You can not connect a USB device to the virtual machine.
  • You receive an error when connecting a USB device to the virtual machine.
  • The USB device disconnects itself after a period of time.

 

Resolution

These issues can occur because the USB devices do not implement the USB protocol as expected by Fusion.
 
To resolve this issue, you can instruct Fusion to use certain "quirks" in its interactions with the USB device. These quirks add special characteristics to the way Fusion connects and communicates with the device.

To add quirks:
  1. Open the vmware.log file from within the virtual machine bundle. For more information, see Locating a virtual machine bundle in VMware Fusion (1007599).

  2. In the Filter box at the top of the Console window, enter the name of the device manufacturer.

    For example, if you enter the name Apple, you see a line that looks similar to:

    vmx | USB: Found device [name:Apple\ IR\ Receiver vid:05ac pid:8240 path:13/7/2 speed:full family:hid]

    The line has the name of the USB device and its vid and pid information. Make a note of the vid and pid values.

  3. Locate and open the .vmx file using a text editor. For more information, see Editing the .vmx file for your Fusion virtual machine (1014782).

  4. Add this line to the .vmx file, replacing vid and pid with the values noted in Step 2, each prefixed by the number 0 and the letter x.

    usb.quirks.device0 = "0xvid:0xpid skip-reset"

    For example, for the Apple device found in step 2, this line is:

    usb.quirks.device0 = "0x05ac:0x8240 skip-reset"

  5. Save the .vmx file.

  6. Shut down the virtual machine and quit Fusion. Caution: Do not skip this step.

  7. Re-open Fusion. The edited .vmx file is reloaded with the changes you made.

  8. Start the virtual machine, and try again to connect the device.

  9. If the issue is not resolved, replace the quirks line added in Step 4 with one of these lines, in the order provided, and repeat Steps 5 to 8:
  • usb.quirks.device0 = "vid:pid skip-refresh"
  • usb.quirks.device0 = "vid:pid skip-setconfig"
  • usb.quirks.device0 = "vid:pid skip-reset, skip-refresh, skip-setconfig"
Notes:
    • Use one of these lines at a time. If one does not work, replace it with another one in the list. Do not add more than one of these in the .vmx file at a time.
    • The last line uses all three quirks in combination. Use this only if the other three lines do not work.
If the issue continues to exist after trying the steps in this article, or if you have found a quirk that works, let us know. We need some specific information from you, so follow this process:

Fusion 2.x and 3.x
  1. Open your .vmx file for editing once more, and add this line:

    usb.analyzer.enable = "TRUE"
  2. Go to the VMware Fusion menu and select Preferences.
  3. Check the box to Enable debugging checks.
  4. Shut down your virtual machine and quit Fusion.
  5. Reopen Fusion and power on your virtual machine.
  6. Connect the USB device to your virtual machine.
  7. Collect the VMware Support Information. For more information, see Collecting diagnostic information for VMware Fusion (1003894).
  8. File a support request with VMware Support and quote this Knowledge Base article ID (1025256) in the problem description. Attach the Support Information you collected to the Support Request. For more information, see How to Submit a Support Request.

After collecting the support information, go to VMware Fusion > Preferences and disable debugging checks.

Fusion 4.x and above

  1. Shutdown the virtual machine
  2. Open your .vmx file for editing once more, and add this line:

    usb.analyzer.enable = "TRUE"

  3. From Fusion menu, go to Virtual Machine > Setting > Advance.
  4. In Advance, change Troubleshooting to Performance or Hang/Crash.

    Choose the correct option using the drop down.
    • Enable Performance when you face Performance related issue with your virtual machine.
    • Enable Hang/Crash when you face hang or crash issue with your virtual machine.

  5. Power on your virtual machine.
  6. Connect the USB device to your virtual machine.
  7. Collect the VMware Support Information. For more information, see Collecting diagnostic information for VMware Fusion (1003894).
  8. File a support request with VMware Support and quote this Knowledge Base article ID (1025256) in the problem description. Attach the Support Information you collected to the Support Request. For more information, see How to Submit a Support Request.
After collecting the support information go to Virtual Machine > Setting > Advance > Troubleshooting and change to Default. This disabled the debugging mode after collecting the information.


Additional Information

You can use quirk lines for more than one device. Number the devices in order, starting with device0 and progressing to device1, device2, etc. Do not skip any numbers.
 
Quirks are peculiar to each device, so the required quirk (if any) for each device will need to be discovered separately.

Tags

cannot-use-usb-device use-usb-device vm-configuration-file cannot-use-usb-scanner

See Also

Update History

02/22/11 - Added information about prefixing vid:pid pair with 0x, added additional information section about multiple devices. 03/22/11 - Updated process for filing a Support Request for USB-related issues.

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

  • 14 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.
What can we do to improve this information? (4000 or fewer characters)
  • 14 Ratings
Actions
KB: