aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStefan Hajnoczi <stefanha@redhat.com>2022-09-06 08:31:24 -0400
committerStefan Hajnoczi <stefanha@redhat.com>2022-09-06 08:31:24 -0400
commit946e9bccf12f2bcc3ca471b820738fb22d14fc80 (patch)
tree7864fe2d5f21d4a016f2b96388a5b048141896a8
parentb34b42f1b6a33c455dccce6ceb49962dddbb7a8a (diff)
parent3e01455edd5fce06c14e2926b6ef408d9a94c9fb (diff)
downloadqemu-946e9bccf12f2bcc3ca471b820738fb22d14fc80.zip
qemu-946e9bccf12f2bcc3ca471b820738fb22d14fc80.tar.gz
qemu-946e9bccf12f2bcc3ca471b820738fb22d14fc80.tar.bz2
Merge tag 'samuel-thibault' of https://people.debian.org/~sthibault/qemu into staging
baum: better document usb-braille configuration Samuel Thibault (1): usb-braille: Better explain that one also has to create a chardev backend # -----BEGIN PGP SIGNATURE----- # # iQIzBAABCgAdFiEEZTSF1IMOAGwT71n/aHTOWK4tfj8FAmMWdVUACgkQaHTOWK4t # fj9dyQ/+PqiwRQktcbZ3/o4rvd0jCGRXduaJe/UD/AkVg1P2d6o6baViSMaiBry2 # 3t0Hmz+5CnSVQpYJqv0r+QARJUmYZSssrliekaPJ2Vi3KwaWgShw3t9vNO/xnTA4 # aesTtlnw2PvbNeqGZZyuNSqFkvMVKxItl01H7O8LfvqMsY7NBxOUqpLoOfBhr4EC # ncJ8tTyhTJLxly/RrS0S4LGasazmm3rlhkV/yhwX0/1rGfdZKoQDLPkOSjs+isrs # C6HmAyixarCKAgse3vJG322H459jFj/fkrmS+298HpFFQDIH0EH1VZbqYtkH7HBA # 0fGCaOHwVNBOzrx3KYCN7Aq0TwnzqfGhFuRwMj7lWVC3zppC52bxw8miVuZkhFfT # YyPxxZTlNfVYOJmpSQOtRpOFSJlBmVYux4Wdk5jmpEgGtX7q0ce6ysk/fyvVCItu # cGuKh//or3zrLJxy2BIfn9sl0/1Z1/gsD1sitsdrKJGTL2CDxq/vBvS9JH6FbwtN # JySiO90lj12WlhqtQWO6dtfHqdLwM1Rnl3YG//Trc82yssqdp6N2O5PJjEV1HATd # 6G6BONDSJgixqrKDCo4+FY4OCFhHvqw+VxeKYFlbD0Cc9aOOHx6IrOmRYDFR/svo # N/942smJJ+a9DW1IJoHmIa3LAtBO8Vd1LJysGcfz94Zj1i7RuqY= # =7mD0 # -----END PGP SIGNATURE----- # gpg: Signature made Mon 05 Sep 2022 18:16:53 EDT # gpg: using RSA key 653485D4830E006C13EF59FF6874CE58AE2D7E3F # gpg: Good signature from "Samuel Thibault <samuel.thibault@ens-lyon.org>" [full] # gpg: aka "Samuel Thibault <sthibault@debian.org>" [full] # gpg: aka "Samuel Thibault <samuel.thibault@gnu.org>" [unknown] # gpg: aka "Samuel Thibault <samuel.thibault@inria.fr>" [full] # gpg: aka "Samuel Thibault <samuel.thibault@labri.fr>" [full] # gpg: aka "Samuel Thibault <samuel.thibault@u-bordeaux.fr>" [unknown] # gpg: aka "Samuel Thibault <samuel.thibault@aquilenet.fr>" [unknown] # gpg: aka "Samuel Thibault <sthibault@hypra.fr>" [unknown] # Primary key fingerprint: 900C B024 B679 31D4 0F82 304B D017 8C76 7D06 9EE6 # Subkey fingerprint: 6534 85D4 830E 006C 13EF 59FF 6874 CE58 AE2D 7E3F * tag 'samuel-thibault' of https://people.debian.org/~sthibault/qemu: usb-braille: Better explain that one also has to create a chardev backend Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
-rw-r--r--docs/system/devices/usb.rst16
1 files changed, 14 insertions, 2 deletions
diff --git a/docs/system/devices/usb.rst b/docs/system/devices/usb.rst
index f39a88f..37cb9b3 100644
--- a/docs/system/devices/usb.rst
+++ b/docs/system/devices/usb.rst
@@ -178,8 +178,20 @@ option or the ``device_add`` monitor command. Available devices are:
host character device id.
``usb-braille,chardev=id``
- Braille device. This will use BrlAPI to display the braille output on
- a real or fake device referenced by id.
+ Braille device. This emulates a Baum Braille device USB port. id has to
+ specify a character device defined with ``-chardev …,id=id``. One will
+ normally use BrlAPI to display the braille output on a BRLTTY-supported
+ device with
+
+ .. parsed-literal::
+
+ |qemu_system| [...] -chardev braille,id=brl -device usb-braille,chardev=brl
+
+ or alternatively, use the following equivalent shortcut:
+
+ .. parsed-literal::
+
+ |qemu_system| [...] -usbdevice braille
``usb-net[,netdev=id]``
Network adapter that supports CDC ethernet and RNDIS protocols. id