Loading

×Sorry to interrupt
CSS Error

Refresh

My Subscriptions

Loading

Knowledge Base

USB support in ESXi/ESX 4.1, ESXi 5.x, and ESXi 6.x (1022290)

Last Updated: 3/20/2024Categories: How toTotal Views: 37431Language:
Chinese (Simplified)Portuguese (European)JapaneseSpanishEnglish

28 like this article

Subscribe to get an email
newsletter with new updates

28 people found this helpful Please provide article feedback:

Learn how VMware Skyline Advisor and Skyline Health Diagnostics work together to provide proactive intelligence and self-service log analysis.

Use Skyline Advisor to avoid issues before they occur across VCF, vSphere, vSAN, NSX, vROps & Horizon. Skyline Findings are based on top KBs, VMSAs/CVEs and design best practices.

Use Skyline Health Diagnostics to root cause vSphere & vSAN logs when an issue occurs. Skyline Health Diagnostic Findings are based on top KBs and VMSA/CVEs. You can use the Skyline Health Diagnostics tool in online or offline mode.

If you require additional help from technical support, please use Skyline Advisor to initiate a Log Assist to reduce time to upload logs. TSEs can also initiate logs to reduce effort.

Purpose

ESXi/ESX 4.1, ESXi 5.x and ESXi 6.x support USB device passthrough from an ESXi/ESX host to a virtual machine.

This article provides information on:

USB device passthrough requirements and limitations

How to add a USB controller and a USB device

Resolution

Requirements

USB device passthrough requires:

Virtual hardware version 7 or higher

A USB controller

A USB device or device hub

With the release of vSphere 5.0, there are now two types of USB passthrough available:

Host-Connected: This has been available since vSphere 4.1, and allows a USB device plugged directly into the ESXi/ESX host to be passed through to a virtual machine.

Client-Connected: This feature became available with the release of vSphere 5.0, and allows a USB device plugged into a user’s workstation to be passed through to a virtual machine via the vSphere Client.

There are also now two types of USB controller available for virtual machines to utilize:

EHCI+UHCI controller: This is the classic USB controller allowing the usage of USB 2.0 and USB 1.1 devices.

xHCI controller: This is the newer controller type allowing the usage of faster USB 3.0 devices. Virtual hardware version 8 is required to use this controller.

Common limitations

The USB Controller has these limitations:

A minimum of virtual hardware version 7 is required.

Only one USB controller of each type can be added to a virtual machine.

The USB arbitrator can monitor a maximum of 15 USB controllers. If your system includes more than 15 controllers and you connect USB devices to these controllers, the devices are not available to be passed through to a virtual machine.

You must add a USB controller to a virtual machine before you can add a USB device.

You must remove all USB devices from a virtual machine before you can remove the controller.

USB devices have these limitations:

A virtual machine may have up to 20 USB devices attached to it, however each unique USB device can only be attached to one virtual machine at a time.

Unsupported USB devices may not interact as expected with other ESXi/ESX features. For a list of supported USB devices, see Supported USB device models for passthrough from an ESX or ESXi host to a virtual machine (1021345).

Before you hot add memory, CPU, or PCI devices, you must remove any USB devices. Hot adding these resources disconnects USB devices, which may result in data loss.

When you suspend and resume a virtual machine, USB devices behave as if they have been disconnected, then reconnected.

The virtual machine cannot boot from the attached USB device.

Host-Connected USB Passthrough:

Limitations:

USB controller hardware and modules that support USB 2.0 and USB 1.1 devices must be present on the physical host.

It is not possible to utilize a USB 3.0 device connected to the physical ESXi hosts prior to ESXi 5.5 Patch 3; the device will be ignored. (Use client-connected USB passthrough instead.)

Client-Connected USB Passthrough:

The vSphere Client 5.0+ allows the usage of this type of passthrough on ESXi 5.x/6.x hosts.

Both EHCI+UHCI as well as the xHCI USB controller are compatible with client-connected USB passthrough.

Limitations:

Passthrough of a USB 3.0 device using an xHCI controller (with virtual hardware version 8) requires that the guest operating system have a functioning xHCI driver. Without a driver installed in the guest operating system, you cannot use USB 3.0 devices. For more details on USB 3.0 support, see the VMware vSphere 5.0 Release Notes.

For undetected USB devices, set the xHCI option to Disabled or Auto if the BIOS provides these options. Otherwise, check with the hardware vendor for details.

At the time of writing of this article, there is currently no known working xHCI driver for Windows.

Closing the vSphere Client which initiated the client-side USB connection disconnects the USB device from the virtual machine.

This table provides a summary of compatible configurations:

Version

ESXi/ESX 4.1

ESXi 5.0

ESXi 5.1

ESXi 5.5

ESXi 6.0

ESXi 6.5

USB 2.0/1.1 Host-Connected

Yes

Yes

Yes

Yes

Yes

Yes

USB 2.0/1.1 Client-Connected

No

Yes

Yes

Yes

Yes

Yes

USB 3.0 Host-Connected

No

No

No

Yes*

Yes

Yes

USB 3.0 Client-Connected

No

Yes (with xHCI driver)

Yes (with xHCI driver)

Yes (with xHCI driver)

Yes (with xHCI driver)

Yes (with xHCI driver)

* Requires ESXi 5.5 Patch 3. For more information, see VMware ESXi 5.5, Patch Release ESXi550-201410001 (2087358).

Enabling the xHCI module on ESXi 5.x/6.x hosts

Connect to the host with an SSH session. For more information, see Enabling root SSH login on an ESX host (8375637).

Run the following commands to enable to xHCI module:

esxcfg-module -e xhci
echo "vmkload_mod xhci" >> /etc/rc.local.d/local.sh

Adding a USB controller and a USB device

To add a USB controller in a virtual machine running Windows:

Right-click the virtual machine and click Edit Settings.

Click Add.

Click USB Controller and click Next.

Click OK.

To add a Host-Connected USB device:

Right-click the virtual machine and click Edit Settings.

Click Add.

Click the desired USB device and click Next.

Click OK.

Note: To support vMotion for Host-Connected devices, select Support vMotion while device is connected. For more information, see the Configuring USB Passthrough Devices for vMotion section in the vSphere Virtual Machine Administration Guide.

To add a Client-Connected USB device:

Click (or open a console to) the virtual machine using the vSphere Client (5.0 or newer).

In the vSphere Client toolbar, click the icon (similar to a USB device with a wrench) to connect/disconnect the USB devices to the virtual machine.

Select the desired USB device to connect.

Click OK.

Note: vMotion is supported by default for Client-Connected USB devices.

Related Information

For more information, see:

Virtual Machine Administration Guide

vSphere Virtual Machine Administration guide

For translated versions of this article, see:

Español: Soporte USB para ESXi/ESX 4.1 y ESXi 5.0 (2033118)

Português: Suporte USB para ESXi/ESX 4.1 e ESXi 5.0 (2032932)

日本語: ESXi/ESX 4.1 の USB サポート (1033087)

Supported USB device models for passthrough from an ESX or ESXi host to a virtual machine
ESXi/ESX 4.1 および ESXi 5.x における USB サポート
Suporte USB para ESX/ESXi 4.1 e ESXi 5.0
Soporte USB para ESX/ESXi 4.1 y ESXi 5.0
ESXi/ESX 4.1、ESXi 5.x 和 ESXi 6.x 对 USB 的支持
VMware ESXi 5.5, Patch Release ESXi550-201410001
Enabling root SSH login on an ESX host

Detectable by VMware SkylineTM

Actions

Copy

link to clipboard
copied!

Print

Language:
Chinese (Simplified)Portuguese (European)JapaneseSpanishEnglish

Attachments

Additional Resources

KB
•
End Of General Availability of the Free vSphere Hypervisor (ESXi 7.x and 8.x) (2107518)

Result 1 of 1

Ask The Community

Get answers quickly from VMware experts in the community

Post Subject

CONTINUE IN COMMUNITIES

Related Products:

VMware vSphere ESXi

Related Versions:

VMware vSphere ESXi 7.0.0

Take Our Survey

Cookie Preference Center

General Information on cookies

General Information on cookies

When you visit our website, we use cookies to ensure that we give you the best experience. This information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies by clicking on the different category headings to find out more and change your settings. However, blocking some types of cookies may impact your experience on the site and the services we are able to offer. Further information can be found in our

Cookie Policy.

Strictly Necessary

Strictly Necessary

Always Active

Strictly Necessary

Strictly necessary cookies are always enabled since they are essential for our website to function. They enable core functionality such as security, network management, and website accessibility. You can set your browser to block or alert you about these cookies, but this may affect how the website functions. For more information please visit www.aboutcookies.org or www.allaboutcookies.org.

Cookie Details‎

Performance

Performance

Performance

Performance cookies are used to analyze the user experience to improve our website by collecting and reporting information on how you use it. They allow us to know which pages are the most and least popular, see how visitors move around the site, optimize our website and make it easier to navigate.

Cookie Details‎

Please confirm your settings by refreshing the page.

Functional

Functional

Functional

Functional cookies help us keep track of your past browsing choices so we can improve usability and customize your experience. These cookies enable the website to remember your preferred settings, language preferences, location and other customizable elements such as font or text size. If you do not allow these cookies, then some or all of these services may not function properly.

Cookie Details‎

Please confirm your settings by refreshing the page.

Advertising

Advertising

Advertising

Advertising cookies are used to send you relevant advertising and promotional information. They may be set through our site by third parties to build a profile of your interests and show you relevant advertisements on other sites. These cookies do not directly store personal information, but their function is based on uniquely identifying your browser and internet device.

Cookie Details‎

Please confirm your settings by refreshing the page.

Advertising Cookies

Consent Leg.Interest

Select All Vendors

Select All Vendors

Select All Hosts

Select All

Clear Filters

Information storage and access

Apply

Confirm My Choices Reject All Allow All

Support Assistant