Keyrah V2

From IndividualComputers
Jump to: navigation, search
(thumbnail)
Keyrah V2

Keyrah V2 lets you use keyboards and joysticks of classic computers on the USB port of a modern PC, Mac or Raspberry Pi. It is the successor to the popular Keyrah interface.

Before installing Keyrah V2 in the case of a C64, VIC-20 or C-16, please remove the mainboard of the old computer. Use the screws of the mainboard to mount Keyrah V2. Older "breadbox“ models of the C64 and the VIC-20 also have a metal bracket on the side of the mainboard that should be mounted on Keyrah V2.

For mounting inside an Amiga case, you should use double-sided duct tape or Velcro® tape. Both can be found in the DIY-store of your choice. Keyrah's mounting holes are aligned for installation in a Commodore 8-bit computer, and cannot be used in an Amiga without drilling new holes.

Keyrah V2 should not be used without a case. If you want to use it outside a case anyway, you should at least protect the solder side (bottom) of the board from short circuit.

Connect the keyboard to the corresponding connector of Keyrah V2 and set the jumper to the layout you intend to use. The correct jumper setting is printed directly on Keyrah V2. Do not remove the jumper group next to the key map jumper!


Contents

LED connection

(thumbnail)
A1200 LED connection
(thumbnail)
C64 LED connection

The power LED of a C64, VIC-20 or C16 should be connected to the 3-pin header right above the C64 keyboard. It will show the switch position: For position „down“ (emulator-layout), the LED will be on. If your computer has a thin (black) connector for the LED, you can also flip the connector around and the power LED will show the NumLock status.

The A1200 LED connector shares the middle pin of the C64 LED connector. The Power-LED will show the switch position: on = numeric keypad mapped into main keyboard block and multimedia keys in main keyboard activated.

The Floppy-LED shows scroll lock status (labelled „F.Disk“ on A1200) and the H.Disk-LED shows numlock status (labelled „Disk“ on A600). Never connect power to the A600 LED connector!

The caps LED which is embedded into the caps lock key of the A1200 and A600 keyboards will act exactly like the caps lock LED of a normal keyboard.

Please note that all LEDs of all keyboards that are connected to the host computer will light up at the same time. There is only one caps lock status, only one NumLock status and one Scroll lock status, and they're all equal for all keyboards. If you press caps lock on one keyboard, it will be shown equally on all keyboards at the same time.

Switch settings

For 8-bit keyboards, the switch chooses between two key mappings: „down“ for emulators like Vice (C64) and Yape (plus/4, C16, C116), and the „middle“ position for everyday use. The emulator mapping is as easy as it can get: Every keypress will cause the exact thing that you'd expect the original machine to do when you press that key. For everyday use, the exact key mapping is described further down.

The third non-latching switch position „up“ will send the ACPI-sleep signal to the computer. To make sure that you really want to execute this, you must hold this position for at least one second. Please note that at the time of writing this manual, a lot of Linux kernels have a bug that does not let you use the ACPI-sleep key to initiate actions like shutting down or going into a power-saving mode. In these cases, the signal will be ignored by the computer.


C64 key mapping

C64-key Windows-effect (US layout) Windows-effect (Deutsch)
Z Z Y
Y Y Z
C= (Commodore key) left ALT ALT links
RUN/STOP TAB TAB
RESTORE ` and ~ < und >
Inst/del backspace Rückschritt
@ \ and | Ü
 : / [ [ and { Ö
 ; / ] ] and } Ä
+ = and + ß und ?
*  : and ; + und *
= ' and " # und '
, / < , and < , und ;
. / > . and > . und :
arrow left ESC ESC
pound page up Bild hoch
arrow up page down Bild runter
CLR/HOME home Pos 1
/ ? / and ? - und _
F3 insert Einfügen
F5 delete forward Entfernen
F7 F4 F4

C16 key mapping

The following table applies to C16, C116 and plus/4 keyboards:

C16-key Windows-effect (US layout) Windows-effect (Deutsch)
Z Z Y
Y Y Z
C= (Commodore key) left ALT ALT links
RUN/STOP TAB TAB
CLR/HOME home < und >
Inst/del backspace Rückschritt
@  ; and : Ü
 : / [ [ and { Ö
 ; / ] ] and } Ä
+ = and + + und *
* ' and " # und '
/ ? / and ? ß und ?
, / < , and < , und ;
. / > . and > . und :
pound ` and ~ ^ und °
= \ and | F4
F1 page up Bild hoch
F2 page down Bild runter
F3 insert Einfügen
HELP F1 F1

Since the 8-bit keyboards lack the right ALT key (sometimes labelled ALT Gr), the third meaning of some international keys can only be reached by pressing CTRL and C= (the Commodore key) at the same time with the key you want to press with the right ALT key. For example, if you want to generate the €-sign, please press and hold CTRL and the Commodore-key, then press and release the E-key, then release the two other keys. This is of course only possible if you have chosen a keyboard layout in your operating system that has the €-sign on ALT-Gr and E!

Amiga key mapping

For Amiga keyboards, the switch position „middle“ will use mostly intuitive key mapping. Since the Amiga keyboard is still lacking a few keys compared to a standard 104-key keyboard, switch setting „down“ will re-map the right part (quick cursor navigation and keypad) into the main keyboard block. In addition to that, some keys in the left half of the main keyboard are changed into multimedia keys. This altered key map will let you use an A600 keyboard as full 104-key multimedia keyboard, despite the missing numeric key pad.

The Amiga-keys become Windows-keys, and HELP sends the „insert“ key code. In switch position "down", the following keys become multimedia keys, which may have to be assigned with a driver or program that individual Computers does not provide:

key USB consumer page 0x0c code function in Windows(tm)
T Application launch "local machine browser" opens "my computer"
E Application launch "Email reader" opens your default mailer
W Application launch "audio player" opens the media player
D Application launch "command line processor" opens the dialogue box "Run..."
F Application launch "internet browser" opens the internet browser
C Application launch "calculator" opens the calculator
Q OOC "mute" mutes the audio output
1 RTC "Volume increment" increases audio volume
A RTC "Volume decrement" decreases audio volume
2 OSC "play/pause" starts/pauses media playback
S OSC "stop" stops media playback
F1 OSC "scan previous track" changes to the previous track
F2 OSC "rewind" rewind playback
F3 OSC "fast forward" fast forward playback
F4 OSC "scan next track" changes to the next track

In addition to these multimedia keys, switch position "down" will also map a numeric keypad into the main keyboard block of your Amiga keyboard, turning it into a full 104/105-keys keyboard:

Amiga (US keyboard) Amiga (deutsche Tastatur) function in target computer
+ / = ´ / ` page up
] / } + / * page down
- / _ ß / ? home
[ / { Ü end
F5 F5 Numlock
/ ? - / _ Keypad /
0 0 Keypad *
P P Keypad -
7 7 Keypad 7
8 8 Keypad 8
9 9 Keypad 9
 ; / : Ö Keypad +
U U Keypad 4
I I Keypad 5
O O Keypad 6
J J Keypad 1
K K Keypad 2
L L Keypad 3
M M Keypad 0
. / > . / : Keypad , (comma)
F6 F6 F11
F7 F7 F12
F8 F8 print screen
F9 F9 scroll lock
F10 F10 pause/break
Return Return Keypad enter


Resellers

Please shop locally. Our partners are listed in alphabetical order.

Personal tools