Apple_II_Keyboard/README.md

59 lines
2.7 KiB
Markdown
Raw Normal View History

2019-05-10 14:34:25 +00:00
# USB Apple II Keyboard
2019-05-10 14:44:48 +00:00
Arduino Sketch to use a USB keyboard with an Apple II as ASCII keyboard.
Features:
- Upper and Lowercase (Shift and Caps work), for older Models and full compatibility use caps.
- Selectable Layout (Currently DE and US) toggle via WIN + SPACE.
- Providing reset to the Apple II. Used via CTRL + ALT + DEL
- Bash like backscroll capability. Use up and down arrow keys to scroll through your last commands.
2019-05-09 13:55:02 +00:00
2019-05-10 14:34:25 +00:00
![Apple II USB Keyboard Interface](https://github.com/mafrmt00/Apple_II_Keyboard/blob/master/pictures/Keyb_Adapter.jpg "The assembled interface")
### Needed Hardware and Software
2019-05-09 13:55:02 +00:00
Hardware:
2019-05-10 08:12:12 +00:00
- [Arduino Uno](https://en.wikipedia.org/wiki/Arduino_Uno)
2019-05-09 13:55:02 +00:00
- [Arduino USB Host Shield](https://www.elecrow.com/wiki/index.php?title=USB_Host_Shield_for_Arduino
)
2019-05-10 08:12:12 +00:00
- optional [Arduino Proto Board](https://store.arduino.cc/proto-shield-rev3-uno-size) with DIP Socket
2019-05-10 14:34:25 +00:00
- Compatible USB keyboard. Tested with a Logitech K120.
Software:
- Arduino IDE
2019-05-10 14:39:17 +00:00
- USB Host Shield Library 2.0 (The modified Version included in this repo!)
2019-05-10 14:34:25 +00:00
### Installation
2019-05-10 14:39:17 +00:00
- Create a folder "Apple_II_Keyboard" under your sketches dir and copy all files from the root dir of this repo there (The dir where the .ino lies).
2019-05-10 14:34:25 +00:00
- Copy the "USB_Host_Shield_Library_2.0" dir to you libraries dir.
- Select Uno as board in the Arduino IDE
- Use Upload in the Arduino IDE. If you can see some output in the serial monitor as you type everythin works.
2019-05-09 13:55:02 +00:00
2019-05-10 14:34:25 +00:00
### Connecting the Arduino to the Apple II
This Table shows how to connect the Apple II Keyboard Connector (A7) to the Arduino. The Pin definitions can also be changed in II_Encoder.h
2019-05-10 08:12:12 +00:00
| APPLE II DIP Pin| Function | Arduino Pin |
| --------------- | -------- | ----------- |
| 1 | +5V | 5V |
| 2 | Strobe | 4 |
| 3 | Reset | 5 |
| 4 | NC | NC |
| 5 | DATA 5 | 6 |
| 6 | DATA 4 | 7 |
| 7 | DATA 6 | 8 |
| 8 | GND | GND |
| 9 | NC | NC |
| 10 | DATA 2 | A0 |
| 11 | DATA 3 | A1 |
| 12 | DATA 0 | A2 |
| 13 | DATA 1 | A3 |
| 14 | NC | NC |
| 15 | -12V | NC |
| 16 | NC | NC |
2019-05-10 14:34:25 +00:00
2019-05-10 14:39:17 +00:00
### Setting the Arduino USB Host Shield for 5V operation
![Correctly jumpered Host Shield](https://github.com/mafrmt00/Apple_II_Keyboard/blob/master/pictures/USB_Host_Shield.jpg "Correctly jumpered Host Shield")
Make sure to set the solder jumpers as shoen in the picture. The Apple II and the UNO operate at 5V.