Marown/quickemu
1
0
Fork 0
mirror of https://github.com/quickemu-project/quickemu.git synced 2024-07-02 03:25:52 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add support for braille terminal (#310)

Browse Source 
* Add support for braille terminal

fixes #307

* Add braille to Readme

* quote tidying

* currently requires sdl display

noted in the docs rather than forcing so if Qemu and/or brtty provide
a solution we will get immediate or easy benefit.

* add needed sdl to braille examples
This commit is contained in:
Phil Clifford 2022-02-17 10:35:40 +00:00 committed by GitHub
parent 949dff275f
commit ace017236c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 34 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
README.md
View File

@ -424,6 +424,19 @@ SPICE ports the VM is connected to.
```bash
cat ubuntu-focal/ubuntu-focal.ports
```
# Accessibility
Qemu provides support for using BrlAPI to display braille output on a real or fake device.
```bash
quickemu --vm ubuntu-impish.conf --accessibility braille --display sdl
```
or even
```bash
quickemu --vm ubuntu-impish.conf --acc brl --display sdl
```
# BIOS and EFI
@ -562,6 +575,7 @@ Usage
quickemu --vm ubuntu.conf
You can also pass optional parameters
--accessible : Select accessible facilitation. 'braille' (default - currently requires --display sdl )"
--delete-disk : Delete the disk image and EFI variables
--delete-vm : Delete the entire VM and it's configuration
--display : Select display backend. 'sdl' (default), 'gtk', 'none', or 'spice'

20
quickemu
View File

@ -907,6 +907,12 @@ function vm_boot() {
-monitor none
-serial mon:stdio)
if [[ "${ACCESSIBLE}" == "braille" ]] || [[ "${ACCESSIBLE}" == "brl" ]]; then
# shellcheck disable=SC2054
args+=(-chardev braille,id=brltty
-device usb-braille,id=usbbrl,chardev=brltty)
fi
if [ -n "${bridge}" ]; then
# Enable bridge mode networking
# shellcheck disable=SC2054,SC2206
@ -1049,6 +1055,7 @@ function usage() {
echo " ${LAUNCHER} --vm ubuntu.conf"
echo
echo "You can also pass optional parameters"
echo " --accessible : Select accessible facilitation. 'braille' (default - currently requires --display sdl )"
echo " --delete-disk : Delete the disk image and EFI variables"
echo " --delete-vm : Delete the entire VM and it's configuration"
echo " --display : Select display backend. 'sdl' (default), 'gtk', 'none', or 'spice'"
@ -1065,6 +1072,14 @@ function usage() {
exit 1
}
#
function accessible_param_check() {
if [ "${ACCESSIBLE}" != "braille" ] && [ "${ACCESSIBLE}" != "brl" ] ; then
echo "ERROR! Requested accessiblility '${ACCESSIBLE}' is not recognised."
exit 1
# TODO can we check the device/API is available
fi
}
function display_param_check() {
if [ "${OUTPUT}" != "gtk" ] && [ "${OUTPUT}" != "none" ] && [ "${OUTPUT}" != "sdl" ] && [ "${OUTPUT}" != "spice" ]; then
echo "ERROR! Requested output '${OUTPUT}' is not recognised."
@ -1155,6 +1170,11 @@ if [ $# -lt 1 ]; then
else
while [ $# -gt 0 ]; do
case "${1}" in
-acc|--acc|-accessible|--accessible|-accessibility|--accessibility)
ACCESSIBLE="${2}"
accessible_param_check
shift
shift;;
-delete|--delete|-delete-disk|--delete-disk)
DELETE_DISK=1
shift;;