1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic
PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en-us" id="settings-usb">
<title>USB Settings</title>
<body>
<p>The <b outputclass="bold">USB</b> section in a virtual machine's <b
outputclass="bold">Settings</b> window enables you to configure <ph
conkeyref="vbox-conkeyref-phrases/product-name"/>'s sophisticated USB support. </p>
<p><ph conkeyref="vbox-conkeyref-phrases/product-name"/> can enable virtual
machines to access the USB devices on your host directly. To achieve this, <ph
conkeyref="vbox-conkeyref-phrases/product-name"/> presents the guest OS with a virtual USB
controller. </p>
<p>
<note id="note_bzl_prv_qbc" type="caution">
<p>As soon as the guest system starts using a USB device, it will be disconnected from the
host without a proper shutdown. This may cause data loss.</p>
</note>
</p>
<note>
<p>Oracle Solaris hosts have a few known limitations regarding USB support. See <xref
href="KnownIssues.dita">Known Limitations</xref>. </p>
</note>
<p><ph conkeyref="vbox-conkeyref-phrases/product-name"/> also enables your guests
to connect to remote USB devices by use of the VirtualBox Remote Desktop Extension (VRDE). See
<xref href="usb-over-rdp.dita">Remote USB</xref>. </p>
<section id="section_pfm_vsv_qbc">
<title>Enable USB for a VM</title>
</section>
<ol id="ol_fpr_wsv_qbc">
<li>Ensure the VM is not running.</li>
<li>Select the VM in the machine list, and then click <b outputclass="bold"
>Settings</b>.</li>
<li>On the USB tab, select <b outputclass="bold">Enable USB Controller</b> and choose the
USB Controller you need for your guest OS. In most cases this will be xHCI. Only use OHCI or
EHCI if your guest OS does not support xHCI. For some legacy Windows guests you'll need to
install third party drivers for xHCI support. <p>
<ul id="ul_rzz_l5v_qbc">
<li>OHCI supports USB 1.1 </li>
<li>EHCI supports USB 2.0. This also enables OHCI.</li>
<li>xHCI supports all USB speeds up to USB 3.0</li>
</ul>
</p></li>
<li>Specify which devices can be attached to the guest by adding <b
outputclass="bold">USB Device Filters</b>. USB devices with a matching filter will be
automatically passed to the guest once they are attached to the host. USB devices without a
matching filter can be passed manually to the guest, for example by using the <b
outputclass="bold">Devices</b>, <b outputclass="bold">USB</b> menu. <ul
id="ul_jjz_cxv_qbc">
<li>Click the <b>USB filter</b> button to create a new filter with blank fields, and then
complete the fields. </li>
<li>Or, click the <b>Add USB filter</b> button to create a filter with the fields
completed for the selected USB device. </li>
</ul><p>Give the filter a name, for later reference, and specify the filter criteria. The
more criteria you specify, the more precisely devices will be selected. For instance, if
you specify only a vendor ID of 046d, all devices produced by Logitech will be available
to the guest. If you fill in all fields, on the other hand, the filter will only apply to
a particular device model from a particular vendor, and not even to other devices of the
same type with a different revision and serial number. </p><p>The following criteria are
available: </p><ul id="ul_av4_41w_qbc">
<li>
<p><b outputclass="bold">Vendor and Product ID.</b> With USB, each vendor of USB
products carries an identification number that is unique world-wide, called the
<i>vendor ID</i>. Similarly, each line of products is assigned a <i>product ID</i>
number. Both numbers are commonly written in hexadecimal, and a colon separates the
vendor from the product ID. For example, <codeph>046d:c016</codeph> stands for
Logitech as a vendor, and the M-UV69a Optical Wheel Mouse product. </p>
<p>Alternatively, you can also specify <b outputclass="bold">Manufacturer</b> and <b
outputclass="bold">Product</b> by name. </p>
<p>To list all the USB devices that are connected to your host machine with their
respective vendor IDs and product IDs, use the following command: </p>
<pre xml:space="preserve" id="pre_bv4_41w_qbc">VBoxManage list usbhost</pre>
<p>On Windows, you can also see all USB devices that are attached to your system in the
Device Manager. On Linux, you can use the <userinput>lsusb</userinput> command. </p>
</li>
<li>
<p><b outputclass="bold">Serial Number.</b> While vendor ID and product ID are quite
specific to identify USB devices, if you have two identical devices of the same brand
and product line, you will also need their serial numbers to filter them out
correctly. </p>
</li>
<li>
<p><b outputclass="bold">Remote.</b> This setting specifies whether the device will be
local only, remote only, such as over VRDP, or either. </p>
</li>
</ul><p>As an example, you could create a new USB filter and specify a vendor ID of 046d for
Logitech, Inc, a manufacturer index of 1, and <i>not remote</i>. Then any USB devices on
the host system produced by Logitech, Inc with a manufacturer index of 1 will be visible
to the guest system. </p><p>Several filters can select a single device. For example, a
filter which selects all Logitech devices, and one which selects a particular webcam.
</p></li>
<li>
<p>On a Windows host, you will need to unplug and reconnect a USB device to use it after
creating a filter for it. </p>
</li>
<li>
<p>Ensure the filters you need immediately are selected in the list. Selected filters will
be attached automatically when the VM starts.</p>
</li></ol>
</body>
</topic>
|
