Commit db380c066db9ddbc2b57ac2e394aaa3a170d08ab

Authored by balrog
1 parent 26463dbc

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
Showing 1 changed file with 22 additions and 8 deletions
qemu-doc.texi
... ... @@ -528,6 +528,10 @@ Pass through the host device identified by bus.addr (Linux only).
528 528 @item host:vendor_id:product_id
529 529 Pass through the host device identified by vendor_id:product_id (Linux only).
530 530  
  531 +@item serial:[vendorid=@var{vendor_id}][,productid=@var{product_id}]:@var{dev}
  532 +Serial converter to host character device @var{dev}, see @code{-serial} for the
  533 +available devices.
  534 +
531 535 @end table
532 536  
533 537 @end table
... ... @@ -1565,27 +1569,37 @@ as necessary to connect multiple USB devices.
1565 1569 USB devices can be connected with the @option{-usbdevice} commandline option
1566 1570 or the @code{usb_add} monitor command. Available devices are:
1567 1571  
1568   -@table @var
1569   -@item @code{mouse}
  1572 +@table @code
  1573 +@item mouse
1570 1574 Virtual Mouse. This will override the PS/2 mouse emulation when activated.
1571   -@item @code{tablet}
  1575 +@item tablet
1572 1576 Pointer device that uses absolute coordinates (like a touchscreen).
1573 1577 This means qemu is able to report the mouse position without having
1574 1578 to grab the mouse. Also overrides the PS/2 mouse emulation when activated.
1575   -@item @code{disk:@var{file}}
  1579 +@item disk:@var{file}
1576 1580 Mass storage device based on @var{file} (@pxref{disk_images})
1577   -@item @code{host:@var{bus.addr}}
  1581 +@item host:@var{bus.addr}
1578 1582 Pass through the host device identified by @var{bus.addr}
1579 1583 (Linux only)
1580   -@item @code{host:@var{vendor_id:product_id}}
  1584 +@item host:@var{vendor_id:product_id}
1581 1585 Pass through the host device identified by @var{vendor_id:product_id}
1582 1586 (Linux only)
1583   -@item @code{wacom-tablet}
  1587 +@item wacom-tablet
1584 1588 Virtual Wacom PenPartner tablet. This device is similar to the @code{tablet}
1585 1589 above but it can be used with the tslib library because in addition to touch
1586 1590 coordinates it reports touch pressure.
1587   -@item @code{keyboard}
  1591 +@item keyboard
1588 1592 Standard USB keyboard. Will override the PS/2 keyboard (if present).
  1593 +@item serial:[vendorid=@var{vendor_id}][,product_id=@var{product_id}]:@var{dev}
  1594 +Serial converter. This emulates an FTDI FT232BM chip connected to host character
  1595 +device @var{dev}. The available character devices are the same as for the
  1596 +@code{-serial} option. The @code{vendorid} and @code{productid} options can be
  1597 +used to override the default 0403:FF00. For instance,
  1598 +@example
  1599 +usb_add serial:productid=FA00:tcp:192.168.0.2:4444
  1600 +@end example
  1601 +will connect to tcp port 4444 of ip 192.168.0.2, and plug that to the virtual
  1602 +serial converter, faking a Matrix Orbital LCD Display (USB ID 0403:FA00).
1589 1603 @end table
1590 1604  
1591 1605 @node host_usb_devices
... ...