mirror of
https://github.com/dschmenk/apple2pi.git
synced 2024-05-28 16:41:36 +00:00
31 lines
2.9 KiB
Plaintext
31 lines
2.9 KiB
Plaintext
|
1.0 Introduction:
|
||
|
|
================
|
||
|
|
This documents the input devices supported by the Apple II Pi project. See the project README.md for installation instructions.
|
||
|
|
|
||
|
|
2.0 Contents:
|
||
|
|
=============
|
||
|
|
|
||
|
|
Keyboard - key mappings and special keys
|
||
|
|
Mouse - mouse and extra buttons
|
||
|
|
Joystick - joystick, joymouse, joypad
|
||
|
|
|
||
|
|
3.0 Keyboard:
|
||
|
|
=============
|
||
|
|
The keyboard is probably the input device used most with Apple II Pi. Now, Apple IIe and //c keyboards changed over the course of their lifetimes. Some were definitely better than others. If you are lucky enough to have the "clicky" //c keyboard, you will find it to be great input device for Linux. I also like some of the later IIe keyboards that aren't as "clicky" as the //c, but have a firm, positive, and smooth action. And the control key is in the proper place.
|
||
|
|
|
||
|
|
There are many keys unavailable on the Apple II keyboard that are useful in a modern computer. To fill in the gaps, the OpenApple and SolidApple keys are employed. The OpenApple key is mapped to the Left-Alt key and used to modify all other keys, just like you would excpect. The SolidApple key works as a funcion key to remap other keys. The current FN-x mappings turn the arrow keys into Home, End, Page-Up, and Page-Down. The number keys along the top row become F-1 through F-10. The DELETE key is BackSpace unless modified with Solid Apple to be a real Delete.
|
||
|
|
|
||
|
|
Three special key sequences affect the operaton of the Apple II client/server connection. SolidApple-ESCAPE will exit out of the client, returning control to the Apple II and leaving it disconnected from Linux. The Linux Apple II Pi daemon process is still running. The connection can be re-established by either running the STARTUP program, typing 'PR# a$9600', or pressing Ctrl-RESET.
|
||
|
|
|
||
|
|
Ctrl-RESET key sequence will re-establish the client/server connection and jump to the BASIC cold-start routine, assuming the client code hasn't been damaged.
|
||
|
|
|
||
|
|
Finally, OpenApple-SoldApple-ESCAPE will exit both the client and server programs. The client Apple II code can be restarted as above. The server daemon will have to be started from another computer logged in to the Raspberry Pi, or a USB keyboard connected to the Pi. Type 'sudo a2pid --daemon' to restart the server process.
|
||
|
|
|
||
|
|
4.0 Mouse:
|
||
|
|
==========
|
||
|
|
The Apple II mouse, if connected, will show up as a standard Linux mouse. The Open Apple key can modify the single mouse button to return MIDDLE_BTTN, and the Solid Apple key can modify the mouse button to return RIGHT_BTTN. If you don't have, or want to use, an Apple II mouse, any compatible USB mouse can be plugged into the Raspberry Pi. The mouse won't be available to the Apple II, but emulators will see it.
|
||
|
|
|
||
|
|
5.0 Joystick:
|
||
|
|
=============
|
||
|
|
Any Apple II gameport device can show up ad a Linux joystick with the a2joy driver. There is an additional X server rule to make sure joysticks don't get used as mouse control. It is automatically installed in /etc/rc.local but can be changed or removed.
|