Commit db380c066db9ddbc2b57ac2e394aaa3a170d08ab
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,6 +528,10 @@ Pass through the host device identified by bus.addr (Linux only). | ||
| 528 | @item host:vendor_id:product_id | 528 | @item host:vendor_id:product_id |
| 529 | Pass through the host device identified by vendor_id:product_id (Linux only). | 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 | @end table | 535 | @end table |
| 532 | 536 | ||
| 533 | @end table | 537 | @end table |
| @@ -1565,27 +1569,37 @@ as necessary to connect multiple USB devices. | @@ -1565,27 +1569,37 @@ as necessary to connect multiple USB devices. | ||
| 1565 | USB devices can be connected with the @option{-usbdevice} commandline option | 1569 | USB devices can be connected with the @option{-usbdevice} commandline option |
| 1566 | or the @code{usb_add} monitor command. Available devices are: | 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 | Virtual Mouse. This will override the PS/2 mouse emulation when activated. | 1574 | Virtual Mouse. This will override the PS/2 mouse emulation when activated. |
| 1571 | -@item @code{tablet} | 1575 | +@item tablet |
| 1572 | Pointer device that uses absolute coordinates (like a touchscreen). | 1576 | Pointer device that uses absolute coordinates (like a touchscreen). |
| 1573 | This means qemu is able to report the mouse position without having | 1577 | This means qemu is able to report the mouse position without having |
| 1574 | to grab the mouse. Also overrides the PS/2 mouse emulation when activated. | 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 | Mass storage device based on @var{file} (@pxref{disk_images}) | 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 | Pass through the host device identified by @var{bus.addr} | 1582 | Pass through the host device identified by @var{bus.addr} |
| 1579 | (Linux only) | 1583 | (Linux only) |
| 1580 | -@item @code{host:@var{vendor_id:product_id}} | 1584 | +@item host:@var{vendor_id:product_id} |
| 1581 | Pass through the host device identified by @var{vendor_id:product_id} | 1585 | Pass through the host device identified by @var{vendor_id:product_id} |
| 1582 | (Linux only) | 1586 | (Linux only) |
| 1583 | -@item @code{wacom-tablet} | 1587 | +@item wacom-tablet |
| 1584 | Virtual Wacom PenPartner tablet. This device is similar to the @code{tablet} | 1588 | Virtual Wacom PenPartner tablet. This device is similar to the @code{tablet} |
| 1585 | above but it can be used with the tslib library because in addition to touch | 1589 | above but it can be used with the tslib library because in addition to touch |
| 1586 | coordinates it reports touch pressure. | 1590 | coordinates it reports touch pressure. |
| 1587 | -@item @code{keyboard} | 1591 | +@item keyboard |
| 1588 | Standard USB keyboard. Will override the PS/2 keyboard (if present). | 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 | @end table | 1603 | @end table |
| 1590 | 1604 | ||
| 1591 | @node host_usb_devices | 1605 | @node host_usb_devices |