Add keyboard notes page

This commit is contained in:
RichardG867
2023-10-13 23:23:56 -03:00
parent ee1ac203a2
commit 0548690748
3 changed files with 140 additions and 45 deletions

139
hardware/keyboard.rst Normal file
View File

@@ -0,0 +1,139 @@
Keyboard
========
This page outlines keyboard behavior specific to different host operating systems, real keyboards and emulated machines.
Host systems
------------
Windows
^^^^^^^
* Multimedia keys such as **Volume Up/Down** cannot be passed through to the emulated machine due to a Windows limitation.
* System-wide key remapping through the **Scancode Map** registry key (as performed by applications such as SharpKeys) is fully supported.
macOS
^^^^^
* Apple keyboards with **European or other ISO layouts** may have *the key below Esc* and *the key to the right of Left Shift* switch places in the emulated machine, due to a hardware quirk in many of those keyboards (both internal and external) and a limitation in the way macOS corrects it.
* The **Num =** key is only usable in operating systems which recognize that key on Microsoft PS/2 multimedia keyboards.
* Mac special keys are mapped to their PC equivalents where possible:
.. list-table::
:header-rows: 1
:widths: 1 999
* - Emulated key
- Host key
* - Windows
- Command
* - Alt
- Option
* - Print Screen
- F13
* - Scroll Lock
- F14
* - Pause
- F15
* - Insert
- Command + Fn + Delete (MacBook and tenkeyless keyboards)
Command + Forward Delete (full size keyboards)
* - Num Lock
- Clear
Linux
^^^^^
* The `xkbcommon <https://xkbcommon.org>`_ library is used to accurately map physical keys to the emulated keyboard on both X11 and Wayland. When compiling 86Box from source, make sure the development files for ``libxkbcommon`` and ``libxkbcommon-x11`` are installed, as this is an optional build component.
Special keys
------------
Some machines provide additional function or otherwise special keys on top of the standard PC layout. Those keys are mapped to ones present on modern keyboards within reason.
Olivetti
^^^^^^^^
The Olivetti M series special keys are mapped as such:
.. list-table::
:header-rows: 1
:widths: 1 999
* - Emulated key
- Host key
* - CLEAR
- Page Up
* - BREAK
- Page Down
* - SCR PRT
- Print Screen
* - HELP
- Menu
* - 00
- Left Windows
* - F13
- Insert
* - F14
- Home
* - F15
- Del
* - F16
- End
* - F17
- Right Alt
* - F18
- Right Win
Toshiba
^^^^^^^
The Toshiba T1000 series function keys can be accessed by holding Right Alt or Right Ctrl:
.. list-table::
:header-rows: 1
* - Function
- Right Alt/Ctrl +
* - Show/hide numeric keypad overlay
- Num Lock
* - Change internal display font
- Right
* - Use internal display
- Home
* - Use external display
- End
* - Turbo mode on (T1200)
- Page Up
* - Turbo mode off (T1200)
- Page Down
* - Show/hide pop-up window (T1200)
- Print Screen

View File

@@ -5,51 +5,6 @@ This page contains important notes related to specific machine models emulated b
----
8088
----
.. _t1000:
.. rubric:: Toshiba T1000
The function keys can be accessed by holding Right Alt or Right Ctrl:
* ``Right Alt/Ctrl + Num Lock``: Show/hide numeric keypad overlay
* ``Right Alt/Ctrl + Right``: Change internal display font
* ``Right Alt/Ctrl + Home``: Use internal display
* ``Right Alt/Ctrl + End``: Use external display
8086
----
.. _m24:
.. rubric:: Olivetti M21/24/24SP
The special keys on Olivetti keyboards are mapped as such:
* ``Page Up``: CLEAR
* ``Page Down``: BREAK
* ``Print Screen``: SCR PRT
* ``Menu``: HELP
* ``Left Windows``: 00
* ``Insert``: F13
* ``Home``: F14
* ``Del``: F15
* ``End``: F16
* ``Right Alt``: F17
* ``Right Win``: F18
.. rubric:: Olivetti M240
See: :ref:`m24`
.. rubric:: Toshiba T1200
All function keys from the :ref:`T1000 <t1000>` are present, plus:
* ``Right Alt/Ctrl + Page Up``: Turbo mode on
* ``Right Alt/Ctrl + Page Down``: Turbo mode off
* ``Right Alt/Ctrl + Print Screen``: Show/hide pop-up window
80286
-----

View File

@@ -44,6 +44,7 @@ Contents
:caption: Emulated hardware
hardware/machinespecific
hardware/keyboard
hardware/diskimages
hardware/ideterqua
hardware/network