On Aug 8, 2015, at 8:48 AM, Programmingkid wrote:
On Aug 8, 2015, at 2:04 AM, Markus Armbruster wrote:
USB devices can be connected with the @option{-usbdevice} commandline option
-or the @code{usb_add} monitor command. Available devices are:
+or the @code{usb_add} monitor command. Note: some devices may only work if
+added like this: -usb -device usb device. Available devices are:
I'm afraid may only work is a bit misleading. All of them work with
-device. Old ones are also supported by -usbdevice for backward
compatibility. The whole section should be rewritten to point to
-device instead of legacy -usbdevice, but that's no reason to hold up
your patch.
I did not know -usbdevice was considered legacy. If that is the case, then it
should probably
be removed from the documentation in favor for -usb -device device name.
Right now using -usb -device mouse doesn't work. Neither does -usbdevice
usb-audio.
I think we can all agree that consistency among all the USB devices is a good
thing.
Should all USB devices be added like this: -usb -device device name ?
This is an experimental patch of not how QEMU currently works, but how I think
it should work.
This documentation adds an usb_remove monitor command. This isn't available
right now,
but a patch could be made to change this. Any suggestions or additions are
welcomed.
Signed-off-by: John Arbuckle programmingk...@gmail.com
---
qemu-doc.texi | 34 ++
1 files changed, 30 insertions(+), 4 deletions(-)
diff --git a/qemu-doc.texi b/qemu-doc.texi
index 94af8c0..e265d72 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -1316,10 +1316,19 @@ monitor (@pxref{pcsys_keys}).
@section USB emulation
QEMU emulates a PCI UHCI USB controller. You can virtually plug
-virtual USB devices or real host USB devices (experimental, works only
-on Linux hosts). QEMU will automatically create and connect virtual USB hubs
+virtual USB devices or real host USB devices. QEMU will automatically
+create and connect virtual USB hubs
as necessary to connect multiple USB devices.
+@subsection USB Monitor Commands:
+@table @option
+@item usb_add device
+Adds an usb device.
+@item usb_remove device
+Removes an usb device.
+@item info usb
+Prints info on all connected usb devices.
+@end table
@menu
* usb_devices::
* host_usb_devices::
@@ -1327,8 +1336,19 @@ as necessary to connect multiple USB devices.
@node usb_devices
@subsection Connecting USB devices
-USB devices can be connected with the @option{-usbdevice} commandline option
-or the @code{usb_add} monitor command. Available devices are:
+
+To add an USB device from the command-line:
+-usb -device device name
+
+To add an USB device from the monitor:
+usb_add device name
+
+Examples:
+@example
+usb_add mouse
+-usb -device mouse -device keyboard -device usb-audio
+@end example
+*note: the -usb option only needs to be used once.
@table @code
@item mouse
@@ -1381,8 +1401,14 @@ usage:
@example
qemu-system-i386 [...OPTIONS...] -usbdevice bt:hci,vlan=3 -bt
device:keyboard,vlan=3
@end example
+@item usb-audio
+USB sound card.
@end table
+Legacy note:
+USB devices use to be connected with the @option{-usbdevice} command-line
option.
+Not all usb devices work with this option now.
+
@node host_usb_devices
@subsection Using host USB devices on a Linux host
--
1.7.5.4