aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorbalrog <balrog@c046a42c-6fe2-441c-8c8c-71466251a162>2008-01-17 22:22:45 +0000
committerbalrog <balrog@c046a42c-6fe2-441c-8c8c-71466251a162>2008-01-17 22:22:45 +0000
commitdb380c066db9ddbc2b57ac2e394aaa3a170d08ab (patch)
tree271f0d68997edc0b9a0d863963fbf101c83d0d65
parent26463dbc1b97cbb5bac3fb48e4947cf1198c3b57 (diff)
Documentation piece explaining "usb_add serial" by Samuel Thibault.
Minor style change. git-svn-id: svn://svn.savannah.nongnu.org/qemu/trunk@3926 c046a42c-6fe2-441c-8c8c-71466251a162
-rw-r--r--qemu-doc.texi30
1 files changed, 22 insertions, 8 deletions
diff --git a/qemu-doc.texi b/qemu-doc.texi
index fba69a7821..6fe7945486 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -528,6 +528,10 @@ Pass through the host device identified by bus.addr (Linux only).
@item host:vendor_id:product_id
Pass through the host device identified by vendor_id:product_id (Linux only).
+@item serial:[vendorid=@var{vendor_id}][,productid=@var{product_id}]:@var{dev}
+Serial converter to host character device @var{dev}, see @code{-serial} for the
+available devices.
+
@end table
@end table
@@ -1565,27 +1569,37 @@ as necessary to connect multiple USB devices.
USB devices can be connected with the @option{-usbdevice} commandline option
or the @code{usb_add} monitor command. Available devices are:
-@table @var
-@item @code{mouse}
+@table @code
+@item mouse
Virtual Mouse. This will override the PS/2 mouse emulation when activated.
-@item @code{tablet}
+@item tablet
Pointer device that uses absolute coordinates (like a touchscreen).
This means qemu is able to report the mouse position without having
to grab the mouse. Also overrides the PS/2 mouse emulation when activated.
-@item @code{disk:@var{file}}
+@item disk:@var{file}
Mass storage device based on @var{file} (@pxref{disk_images})
-@item @code{host:@var{bus.addr}}
+@item host:@var{bus.addr}
Pass through the host device identified by @var{bus.addr}
(Linux only)
-@item @code{host:@var{vendor_id:product_id}}
+@item host:@var{vendor_id:product_id}
Pass through the host device identified by @var{vendor_id:product_id}
(Linux only)
-@item @code{wacom-tablet}
+@item wacom-tablet
Virtual Wacom PenPartner tablet. This device is similar to the @code{tablet}
above but it can be used with the tslib library because in addition to touch
coordinates it reports touch pressure.
-@item @code{keyboard}
+@item keyboard
Standard USB keyboard. Will override the PS/2 keyboard (if present).
+@item serial:[vendorid=@var{vendor_id}][,product_id=@var{product_id}]:@var{dev}
+Serial converter. This emulates an FTDI FT232BM chip connected to host character
+device @var{dev}. The available character devices are the same as for the
+@code{-serial} option. The @code{vendorid} and @code{productid} options can be
+used to override the default 0403:FF00. For instance,
+@example
+usb_add serial:productid=FA00:tcp:192.168.0.2:4444
+@end example
+will connect to tcp port 4444 of ip 192.168.0.2, and plug that to the virtual
+serial converter, faking a Matrix Orbital LCD Display (USB ID 0403:FA00).
@end table
@node host_usb_devices