OpenE2K/qemu-e2k
13
4
Fork 0
Code Issues 4 Pull Requests Projects 2 Releases Activity

Update USB documentation.

Browse Source 
git-svn-id: svn://svn.savannah.nongnu.org/qemu/trunk@1941 c046a42c-6fe2-441c-8c8c-71466251a162
This commit is contained in:
pbrook 2006-05-26 00:49:52 +00:00
parent 2e5d83bbef
commit 0aff66b5c8
1 changed files with 32 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

59
qemu-doc.texi
View File

@ -309,8 +309,7 @@ USB options:
Enable the USB driver (will be the default soon) Enable the USB driver (will be the default soon)
@item -usbdevice devname @item -usbdevice devname
Add the USB device @var{devname}. See the monitor command Add the USB device @var{devname}. @xref{usb_devices}.
@code{usb_add} to have more information.
@end table @end table
Network options: Network options:
@ -783,10 +782,8 @@ Reset the system.
@item usb_add devname @item usb_add devname
Plug the USB device devname to the QEMU virtual USB hub. @var{devname} Add the USB device @var{devname}. For details of available devices see
is either a virtual device name (for example @code{mouse}) or a host @ref{usb_devices}
USB device identifier. Host USB device identifiers have the following
syntax: @code{host:bus.addr} or @code{host:vendor_id:product_id}.
@item usb_del devname @item usb_del devname
@ -1105,31 +1102,39 @@ Lawton for the plex86 Project (@url{www.plex86.org}).
@node pcsys_usb @node pcsys_usb
@section USB emulation @section USB emulation
QEMU emulates a PCI UHCI USB controller and a 8 port USB hub connected QEMU emulates a PCI UHCI USB controller. You can virtually plug
to it. You can virtually plug to the hub virtual USB devices or real virtual USB devices or real host USB devices (experimental, works only
host USB devices (experimental, works only on Linux hosts). on Linux hosts). Qemu will automatically create and connect virtual USB hubs
as neccessary to connect multiple USB devices.
@subsection Using virtual USB devices @menu
* usb_devices::
* host_usb_devices::
@end menu
@node usb_devices
@subsection Connecting USB devices
A virtual USB mouse device is available for testing in QEMU. USB devices can be connected with the @option{-usbdevice} commandline option
or the @code{usb_add} monitor command. Available devices are:
You can try it with the following monitor commands: @table @var
@item @code{mouse}
@example Virtual Mouse. This will override the PS/2 mouse emulation when activated.
# add the mouse device @item @code{tablet}
(qemu) usb_add mouse Pointer device that uses abolsute coordinates (like a touchscreen).
This means qemu is able to report the mouse position without having
# show the virtual USB devices plugged on the QEMU Virtual USB hub to grab the mouse. Also overrides the PS/2 mouse emulation when activated.
(qemu) info usb @item @code{disk:file}
Device 0.3, speed 12 Mb/s Mass storage device based on @var{file} (@pxref{disk_images})
@item @code{host:bus.addr}
# after some time you can try to remove the mouse Pass through the host device identified by @var{bus.addr}
(qemu) usb_del 0.3 (Linux only)
@end example @item @code{host:vendor_id:product_id}
Pass through the host device identified by @var{vendor_id:product_id}
The option @option{-usbdevice} is similar to the monitor command (Linux only)
@code{usb_add}. @end table
@node host_usb_devices
@subsection Using host USB devices on a Linux host @subsection Using host USB devices on a Linux host
WARNING: this is an experimental feature. QEMU will slow down when WARNING: this is an experimental feature. QEMU will slow down when