The PS2Driver module provides support for PS 2 mice and keyboards as documented within PRM 5a-229. The driver has been extended to support the 'scroll wheel' and '5 button' mice commonly in use. This extension is documented within the PointerDevices document.
From RISC OS 4, a number of additional keys have been returned by the PS 2 Driver (and other keyboard drivers). The following keys are now provided through the internal interfaces :
low level key internal (decimal) HID Windows left &68 125 &700E4 Windows right &69 126 &700E7 Menu &6A 127 &70065 No convert &6B 109 &7008B Convert &6C 110 &7008A Kana &6D 111 &70088 Yen/Bar &1D 46 &70089 \ _ &6E 95 &70087 ASPI Power - - &10081 ASPI Sleep - - &10082 ASPI Wake - - &10083 Scan next track - - &C00B5 Scan previous track - - &C00B6 Stop - - &C00B7 Play/pause - - &C00CD Mute - - &C00E2 Vol+ - - &C00E9 Vol- - - &C00EA Media select - - &C0183 Mail - - &C018A Calculator - - &C0192 My computer - - &C0194 Browser search - - &C0221 Browser home - - &C0223 Browser back - - &C0224 Browser forward - - &C0225 Browser stop - - &C0226 Browser refresh - - &C0227 Browser favourites - - &C0228
The Yen/Bar key is to the left of backspace (ie where the £ sign was on Archimedes keyboards). It hence resurrects the old &1D low level code.
The \ _ key is to the left of the right shift key (analogous to the \ | key on UK keyboards).
HID values can be used through the KeyInput interfaces. Multimedia keys have not been exposed to the regular keyboard interfaces, for example, the wimp key processing.
Within the desktop environment, the following key codes will be returned for the additional keys :
Shift- Ctrl- Shift-Ctrl Key code key code key code key code Windows left &1C0 &1D0 &1E0 &1F0 Windows right &1D0 &1C0 &1F0 &1E0 Menu &1C1 &1D1 &1E1 &1F1 No convert &1C2 &1D2 &1E2 &1F2 Convert &1C3 &1D3 &1E3 &1F3 Kana &1C4 &1D4 &1E4 &1F4
'Windows' and 'Menu' keys
In order to be consistent, the Windows and Menu keys should operate in the following manner :
Key Domain Effect Windows-alone OS-specific Display a system menu * Windows-Shift/Ctrl OS-specific Reserved Windows-0-9 Hardware Reserved Windows-<nonshift> User User expansion Menu-alone OS-specific Display a context menu * Menu-Shift/Ctrl Application Application expansion Menu-<nonshift> Reserved Reserved
* Not presently implemented
Left and right Windows keys should be treated identically, but may be distinguished by user-expansion software where necessary. This behaviour is consistent with the recommended behaviour on other systems and should ensure that the users expectations are met when transferring between environments.
This documentation is copyright 3QD Developments Ltd 2013 and may not be reproduced or published in any form without the copyright holders permission. RISC OS is subject to continuous development and improvement as such all information is reproduced by 3QD Developments Ltd in good faith and is believed to be correct at the time of publication E&OE. 3QD Developments Ltd cannot accept any liability for any loss or damage arising from the use of any information provided as part of the RISC OS Documentation.
HTML document version 1.03 3rd November 2015