Keyboard mapping¶

My philosophy was to create an Atari like experience, rather than map all the USB keys to the Atari equivalents. So the keyboard is mapped to match the standard Atari keyboard layout, as far as possible.

Of course there are no CONSOL keys (Help/Start/Select/Option/Reset) on a mini-itx case (unless you add some via GPIO) so this has to be handled on the keyboard. These are mapped to the F-keys.

Since the Atari keyboard layout is not the same as a USB keyboard layout, some keys will say one thing and do another. I highly recommend buying stickers from here: https://www.4keyboard.com/commodore/591-2840-commodore-atari-non-transparent-keyboard-stickers.html.

For an ISO keyboard:

Steve (917k) added support for ISO keyboards. It is basically the same except some of the arrow keys moved around, since there are not enough keys for the Atari style layout.

Keyboard Mapping Table:¶

If your keyboard has ; ' \ next to the enter key, you should use ISO
If your keyboard has ; ' next to the enter key and *\* above the enter key, you should use ANSI

All keys are the same as the standard Windows US keyboard, except for these exceptions

ISO Keyboard Layout Exceptions¶

Atari          Windows
Keyboard       Keyboard
F1             F1
F2             F2
F3             F3
F4             F4
Help           F5
Start          F6
Select         F7
Option         F8
Reset          F9
Cold Start     F10
Quick Select   F11
System Menu    F12
Break          Pause/Break or ` (unshifted Tilda key)
Freezer        Delete (Above Arrows)
"              Shift-2
&              Shift-6
'              Shift-7
@              Shift-8
Clear          Shift--
Insert         Shift-=
Delete Line    Shift-Backspace
<              -
>              =
Clr(ctrl-Tab)  Control-Tab
Set(Shift-Tab) Shift Tab
Tab            Tab
Up Arrow       Control-[
Down Arrow     Control-]
-              [
=              ]
_              Shift-[
|              Shift-]
Left Arrow     Control-'
Right Arrow    Control-\
+              '
*              \
\              Shift-'
^              Shift-\
[              Shift-,
]              Shift-.
Paddle Mode    Left-Alt
Atari          Right-Alt

ANSI Keyboard Layout Exceptions¶

Atari          Windows
Keyboard       Keyboard
F1             F1
F2             F2
F3             F3
F4             F4
Help           F5
Start          F6
Select         F7
Option         F8
Reset          F9
Cold Start     F10
Quick Select   F11
System Menu    F12
Break          Pause/Break or ` (unshifted Tilda key)
Freezer        Delete (Above Arrows)
"              Shift-2
&              Shift-6
'              Shift-7
@              Shift-8
Clear          Shift--
Insert         Shift-=
Delete Line    Shift-Backspace
<              -
>              =
Clr(ctrl-Tab)  Control-Tab
Set(Shift-Tab) Shift Tab
Tab            Tab
Up Arrow       Control-[
Down Arrow     Control-]
-              [
=              ]
_              Shift-[
|              Shift-]
Left Arrow     Control-;
Right Arrow    Control-'
+              ;
*              '
\              Shift-;
^              Shift-'
;              \
:              Shift-\
[              Shift-,
]              Shift-.
Paddle Mode    Left-Alt
Atari          Right-Alt