From 05486907485c75033f01785d3a32d797cac918da Mon Sep 17 00:00:00 2001 From: RichardG867 Date: Fri, 13 Oct 2023 23:23:56 -0300 Subject: [PATCH] Add keyboard notes page --- hardware/keyboard.rst | 139 +++++++++++++++++++++++++++++++++++ hardware/machinespecific.rst | 45 ------------ index.rst | 1 + 3 files changed, 140 insertions(+), 45 deletions(-) create mode 100644 hardware/keyboard.rst diff --git a/hardware/keyboard.rst b/hardware/keyboard.rst new file mode 100644 index 0000000..0f4754e --- /dev/null +++ b/hardware/keyboard.rst @@ -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 `_ 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 diff --git a/hardware/machinespecific.rst b/hardware/machinespecific.rst index be950f9..c2217b7 100644 --- a/hardware/machinespecific.rst +++ b/hardware/machinespecific.rst @@ -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 ` 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 ----- diff --git a/index.rst b/index.rst index 34c38e5..923b4a7 100644 --- a/index.rst +++ b/index.rst @@ -44,6 +44,7 @@ Contents :caption: Emulated hardware hardware/machinespecific + hardware/keyboard hardware/diskimages hardware/ideterqua hardware/network