qemu/docs/system/devices
Henrik Carlqvist 6b90a4cdc0 escc: emulate dip switch language layout settings on SUN keyboard
SUN Type 4, 5 and 5c keyboards have dip switches to choose the language layout
of the keyboard. Solaris makes an ioctl to query the value of the dipswitches
and uses that value to select keyboard layout.  Also the SUN bios like the one
in the file ss5.bin uses this value to support at least some keyboard layouts.
However, the OpenBIOS provided with qemu is hardcoded to always use an US
keyboard layout.

Before this patch, qemu allways gave dip switch value 0x21 (US keyboard),
this patch uses a command line switch like
"-global escc.chnA-sunkbd-layout=de" to select dip switch value. A table is
used to lookup values from arguments like:

-global escc.chnA-sunkbd-layout=fr
-global escc.chnA-sunkbd-layout=es

But the patch also accepts numeric dip switch values directly:

-global escc.chnA-sunkbd-layout=0x2b
-global escc.chnA-sunkbd-layout=43

Both values above are the same and select swedish keyboard as explained in
table 3-15 at
https://docs.oracle.com/cd/E19683-01/806-6642/new-43/index.html

Unless you want to do a full Solaris installation but happen to have
access to a Sun bios file, the easiest way to test that the patch works
is to:

qemu-system-sparc -global escc.chnA-sunkbd-layout=sv -bios /path/to/ss5.bin

If you already happen to have a Solaris installation in a qemu disk image
file you can easily try different keyboard layouts after this patch is
applied.

Signed-off-by: Henrik Carlqvist <hc1245@poolhem.se>
Message-Id: <20230623203007.56d3d182.hc981@poolhem.se>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
[MCA edit: update unsigned char to uint8_t, fix spacing issues]
Signed-off-by: Mark Cave-Ayland <mark.cave-ayland@ilande.co.uk>
2023-06-28 10:54:25 +01:00
..
can.rst Fix several typos in documentation (found by codespell) 2022-11-11 09:39:25 +01:00
canokey.rst Fix some typos in documentation (most of them found by codespell) 2022-08-12 11:20:42 +01:00
ccid.rst docs/ccid: convert to restructuredText 2022-04-20 09:25:10 +02:00
cxl.rst hw/cxl: Multi-Region CXL Type-3 Devices (Volatile and Persistent) 2023-05-19 01:36:09 -04:00
igb.rst docs/system/devices/igb: Note igb is tested for DPDK 2023-05-23 15:20:15 +08:00
ivshmem.rst docs: Remove unused weirdly-named cross-reference targets 2023-05-12 15:43:38 +01:00
keyboard.rst escc: emulate dip switch language layout settings on SUN keyboard 2023-06-28 10:54:25 +01:00
net.rst docs: Remove unused weirdly-named cross-reference targets 2023-05-12 15:43:38 +01:00
nvme.rst hw/nvme: fix example serial in documentation 2022-07-15 10:40:33 +02:00
usb-u2f.rst docs: Convert u2f.txt to rST 2023-05-18 11:40:32 +01:00
usb.rst docs: Convert u2f.txt to rST 2023-05-18 11:40:32 +01:00
vhost-user-rng.rst docs: Add documentation for vhost based RNG implementation 2021-10-20 04:37:55 -04:00
vhost-user.rst docs: Fix trivial typos in vhost-user.rst 2023-06-09 23:38:16 +03:00
virtio-pmem.rst