Files
server/usr/share/doc/qemu-system-common/system/devices/keyboard.html
2026-01-07 20:52:11 +01:00

338 lines
15 KiB
HTML

<!DOCTYPE html>
<html class="writer-html5" lang="en" data-content_root="../../">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Sparc32 keyboard &mdash; QEMU Debian 1:8.2.2+ds-0ubuntu1.11 documentation</title>
<link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=86f27845" />
<link rel="stylesheet" type="text/css" href="../../_static/theme_overrides.css?v=08e6c168" />
<link rel="shortcut icon" href="../../_static/qemu_32x32.png"/>
<script src="../../_static/jquery.js?v=8dae8fb0"></script>
<script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="../../_static/documentation_options.js?v=802af9f6"></script>
<script src="../../_static/doctools.js?v=888ff710"></script>
<script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../_static/custom.js?v=2ab9f71d"></script>
<script src="../../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../../genindex.html" />
<link rel="search" title="Search" href="../../search.html" />
<link rel="next" title="Network emulation" href="net.html" />
<link rel="prev" title="Inter-VM Shared Memory device" href="ivshmem.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" style="background: #802400" >
<a href="../../index.html" class="icon icon-home">
QEMU
<img src="../../_static/qemu_128x128.png" class="logo" alt="Logo"/>
</a>
<div class="version">
8.2.2
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../about/index.html">About QEMU</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../index.html">System Emulation</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../introduction.html">Introduction</a></li>
<li class="toctree-l2"><a class="reference internal" href="../invocation.html">Invocation</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="../device-emulation.html">Device Emulation</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="../device-emulation.html#common-terms">Common Terms</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="../device-emulation.html#emulated-devices">Emulated Devices</a><ul class="current">
<li class="toctree-l4"><a class="reference internal" href="can.html">CAN Bus Emulation Support</a></li>
<li class="toctree-l4"><a class="reference internal" href="ccid.html">Chip Card Interface Device (CCID)</a></li>
<li class="toctree-l4"><a class="reference internal" href="cxl.html">Compute Express Link (CXL)</a></li>
<li class="toctree-l4"><a class="reference internal" href="ivshmem.html">Inter-VM Shared Memory device</a></li>
<li class="toctree-l4 current"><a class="current reference internal" href="#">Sparc32 keyboard</a></li>
<li class="toctree-l4"><a class="reference internal" href="net.html">Network emulation</a></li>
<li class="toctree-l4"><a class="reference internal" href="nvme.html">NVMe Emulation</a></li>
<li class="toctree-l4"><a class="reference internal" href="usb.html">USB emulation</a></li>
<li class="toctree-l4"><a class="reference internal" href="vhost-user.html">vhost-user back ends</a></li>
<li class="toctree-l4"><a class="reference internal" href="virtio-gpu.html">virtio-gpu</a></li>
<li class="toctree-l4"><a class="reference internal" href="virtio-pmem.html">virtio pmem</a></li>
<li class="toctree-l4"><a class="reference internal" href="virtio-snd.html">virtio sound</a></li>
<li class="toctree-l4"><a class="reference internal" href="vhost-user-rng.html">QEMU vhost-user-rng - RNG emulation</a></li>
<li class="toctree-l4"><a class="reference internal" href="canokey.html">CanoKey QEMU</a></li>
<li class="toctree-l4"><a class="reference internal" href="usb-u2f.html">Universal Second Factor (U2F) USB Key Device</a></li>
<li class="toctree-l4"><a class="reference internal" href="igb.html">igb</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../keys.html">Keys in the graphical frontends</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mux-chardev.html">Keys in the character backend multiplexer</a></li>
<li class="toctree-l2"><a class="reference internal" href="../monitor.html">QEMU Monitor</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images.html">Disk Images</a></li>
<li class="toctree-l2"><a class="reference internal" href="../virtio-net-failover.html">QEMU virtio-net standby (net_failover)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../linuxboot.html">Direct Linux Boot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../generic-loader.html">Generic Loader</a></li>
<li class="toctree-l2"><a class="reference internal" href="../guest-loader.html">Guest Loader</a></li>
<li class="toctree-l2"><a class="reference internal" href="../barrier.html">QEMU Barrier Client</a></li>
<li class="toctree-l2"><a class="reference internal" href="../vnc-security.html">VNC security</a></li>
<li class="toctree-l2"><a class="reference internal" href="../tls.html">TLS setup for network services</a></li>
<li class="toctree-l2"><a class="reference internal" href="../secrets.html">Providing secret data to QEMU</a></li>
<li class="toctree-l2"><a class="reference internal" href="../authz.html">Client authorization</a></li>
<li class="toctree-l2"><a class="reference internal" href="../gdb.html">GDB usage</a></li>
<li class="toctree-l2"><a class="reference internal" href="../replay.html">Record/replay</a></li>
<li class="toctree-l2"><a class="reference internal" href="../managed-startup.html">Managed start up options</a></li>
<li class="toctree-l2"><a class="reference internal" href="../bootindex.html">Managing device boot order with bootindex properties</a></li>
<li class="toctree-l2"><a class="reference internal" href="../cpu-hotplug.html">Virtual CPU hotplug</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pr-manager.html">Persistent reservation managers</a></li>
<li class="toctree-l2"><a class="reference internal" href="../targets.html">QEMU System Emulator Targets</a></li>
<li class="toctree-l2"><a class="reference internal" href="../security.html">Security</a></li>
<li class="toctree-l2"><a class="reference internal" href="../multi-process.html">Multi-process QEMU</a></li>
<li class="toctree-l2"><a class="reference internal" href="../confidential-guest-support.html">Confidential Guest Support</a></li>
<li class="toctree-l2"><a class="reference internal" href="../vm-templating.html">QEMU VM templating</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../user/index.html">User Mode Emulation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../tools/index.html">Tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../interop/index.html">System Emulation Management and Interoperability</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../specs/index.html">System Emulation Guest Hardware Specifications</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../devel/index.html">Developer Information</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" style="background: #802400" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../../index.html">QEMU</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item"><a href="../index.html">System Emulation</a></li>
<li class="breadcrumb-item"><a href="../device-emulation.html">Device Emulation</a></li>
<li class="breadcrumb-item active">Sparc32 keyboard</li>
<li class="wy-breadcrumbs-aside">
<a href="https://gitlab.com/qemu-project/qemu/blob/master/docs/system/devices/keyboard.rst" class="fa fa-gitlab"> Edit on GitLab</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="sparc32-keyboard">
<span id="keyboard"></span><h1>Sparc32 keyboard<a class="headerlink" href="#sparc32-keyboard" title="Link to this heading"></a></h1>
<p>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.</p>
<p>With the escc.chnA-sunkbd-layout driver property it is possible to select
keyboard layout. Example:</p>
<p>-global escc.chnA-sunkbd-layout=de</p>
<p>Depending on type of keyboard, the keyboard can have 6 or 5 dip-switches to
select keyboard layout, giving up to 64 different layouts. Not all
combinations are supported by Solaris and even less by Sun OpenBoot BIOS.</p>
<p>The dip switch settings can be given as hexadecimal number, decimal number
or in some cases as a language string. Examples:</p>
<p>-global escc.chnA-sunkbd-layout=0x2b</p>
<p>-global escc.chnA-sunkbd-layout=43</p>
<p>-global escc.chnA-sunkbd-layout=sv</p>
<p>The above 3 examples all select a swedish keyboard layout. Table 3-15 at
<a class="reference external" href="https://docs.oracle.com/cd/E19683-01/806-6642/new-43/index.html">https://docs.oracle.com/cd/E19683-01/806-6642/new-43/index.html</a> explains which
keytable file is used for different dip switch settings. The information
in that table can be summarized in this table:</p>
<table class="docutils align-default" id="id1">
<caption><span class="caption-text">Language selection values for escc.chnA-sunkbd-layout</span><a class="headerlink" href="#id1" title="Link to this table"></a></caption>
<colgroup>
<col style="width: 33.3%" />
<col style="width: 33.3%" />
<col style="width: 33.3%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Hexadecimal value</p></th>
<th class="head"><p>Decimal value</p></th>
<th class="head"><p>Language code</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>0x21</p></td>
<td><p>33</p></td>
<td><p>en-us</p></td>
</tr>
<tr class="row-odd"><td><p>0x23</p></td>
<td><p>35</p></td>
<td><p>fr</p></td>
</tr>
<tr class="row-even"><td><p>0x24</p></td>
<td><p>36</p></td>
<td><p>da</p></td>
</tr>
<tr class="row-odd"><td><p>0x25</p></td>
<td><p>37</p></td>
<td><p>de</p></td>
</tr>
<tr class="row-even"><td><p>0x26</p></td>
<td><p>38</p></td>
<td><p>it</p></td>
</tr>
<tr class="row-odd"><td><p>0x27</p></td>
<td><p>39</p></td>
<td><p>nl</p></td>
</tr>
<tr class="row-even"><td><p>0x28</p></td>
<td><p>40</p></td>
<td><p>no</p></td>
</tr>
<tr class="row-odd"><td><p>0x29</p></td>
<td><p>41</p></td>
<td><p>pt</p></td>
</tr>
<tr class="row-even"><td><p>0x2a</p></td>
<td><p>42</p></td>
<td><p>es</p></td>
</tr>
<tr class="row-odd"><td><p>0x2b</p></td>
<td><p>43</p></td>
<td><p>sv</p></td>
</tr>
<tr class="row-even"><td><p>0x2c</p></td>
<td><p>44</p></td>
<td><p>fr-ch</p></td>
</tr>
<tr class="row-odd"><td><p>0x2d</p></td>
<td><p>45</p></td>
<td><p>de-ch</p></td>
</tr>
<tr class="row-even"><td><p>0x2e</p></td>
<td><p>46</p></td>
<td><p>en-gb</p></td>
</tr>
<tr class="row-odd"><td><p>0x2f</p></td>
<td><p>47</p></td>
<td><p>ko</p></td>
</tr>
<tr class="row-even"><td><p>0x30</p></td>
<td><p>48</p></td>
<td><p>tw</p></td>
</tr>
<tr class="row-odd"><td><p>0x31</p></td>
<td><p>49</p></td>
<td><p>ja</p></td>
</tr>
<tr class="row-even"><td><p>0x32</p></td>
<td><p>50</p></td>
<td><p>fr-ca</p></td>
</tr>
<tr class="row-odd"><td><p>0x33</p></td>
<td><p>51</p></td>
<td><p>hu</p></td>
</tr>
<tr class="row-even"><td><p>0x34</p></td>
<td><p>52</p></td>
<td><p>pl</p></td>
</tr>
<tr class="row-odd"><td><p>0x35</p></td>
<td><p>53</p></td>
<td><p>cz</p></td>
</tr>
<tr class="row-even"><td><p>0x36</p></td>
<td><p>54</p></td>
<td><p>ru</p></td>
</tr>
<tr class="row-odd"><td><p>0x37</p></td>
<td><p>55</p></td>
<td><p>lv</p></td>
</tr>
<tr class="row-even"><td><p>0x38</p></td>
<td><p>56</p></td>
<td><p>tr</p></td>
</tr>
<tr class="row-odd"><td><p>0x39</p></td>
<td><p>57</p></td>
<td><p>gr</p></td>
</tr>
<tr class="row-even"><td><p>0x3a</p></td>
<td><p>58</p></td>
<td><p>ar</p></td>
</tr>
<tr class="row-odd"><td><p>0x3b</p></td>
<td><p>59</p></td>
<td><p>lt</p></td>
</tr>
<tr class="row-even"><td><p>0x3c</p></td>
<td><p>60</p></td>
<td><p>nl-be</p></td>
</tr>
<tr class="row-odd"><td><p>0x3c</p></td>
<td><p>60</p></td>
<td><p>be</p></td>
</tr>
</tbody>
</table>
<p>Not all dip switch values have a corresponding language code and both “be” and
“nl-be” correspond to the same dip switch value. By default, if no value is
given to escc.chnA-sunkbd-layout 0x21 (en-us) will be used.</p>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="ivshmem.html" class="btn btn-neutral float-left" title="Inter-VM Shared Memory device" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="net.html" class="btn btn-neutral float-right" title="Network emulation" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2025, The QEMU Project Developers.</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
<!-- Empty para to force a blank line after "Built with Sphinx ..." -->
<p></p>
<p>This documentation is for QEMU version 8.2.2.</p>
<p><a href="../../about/license.html">QEMU and this manual are released under the
GNU General Public License, version 2.</a></p>
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>