Apple2-IO-RPi/README.md

# Apple2-IO-RPi
Apple II expansion card using a Raspberry Pi for I/O

![Image of Board](/Hardware/Apple2IORPi.jpg)

## Purpose
The purpose of this project is to provide I/O for an Apple II series 8 bit computer via a Raspberry Pi Zero W which is powered by the Apple II expansion bus. This includes using the attached RPi Zero W for it's storage, network and processor to provide new functionality for the Apple II.

## Project Status
So far, this is a project and not a finished product. The current prototype is on the fifth revision and a few have been assembled and tested. It is now possible for the Apple II to boot from and write to a virutal hard drive image stored on the RPi in any slot and execute simple commands on the RPi via the Apple II. The code has no error handling or tests yet and is incomplete. Note that currently the firmware assumes an 80 column card is in slot 3 and than you have lowercase support. If you have a problem or idea for enhancement, log an issue [here](https://github.com/tjboldt/Apple2-IO-RPi/issues). I recommend starring/watching the project for updates on GitHub. You are welcome to fork the project and submit pull requests which I will review.

## Features
1. Boot menu which waits for RPi to be ready
2. ProDOS bootable drive from image stored on RPi
3. Execute Linux commands on the RPi from the Apple II
4. Load binary files directly from the RPi to the II
5. Update Apple II firmware in place from image on RPi
6. Supports two drive images at the same time (Note: backward compatible with previous firmware but requires firmware update in order to work with two drives)

## Roadmap
1. Proper ProDOS clock driver (currently just directly sets values on block reads)
2. Support for direct file read/write without drive image
3. Image conversion on download
4. Web service call support
5. Full terminal emulation
6. Remote code execution 
7. Proxy VNC connection, rendering as Apple II compatible graphics

## Setup starting from scratch
1. Have PCBs made from the gerber and drill files in the Hardware folder or email me for a blank or fully assembled board
2. Solder chips, header and capacitors in place
3. Attach Raspberry Pi Zero W facing outward from the card
4. Install Raspberry Pi OS on microSD card https://www.raspberrypi.org/software/
5. Configure wifi in boot/wpa_supplicant.conf https://howtoraspberrypi.com/how-to-raspberry-pi-headless-setup/
6. Add empty ssh file boot (for ssh access over wifi)
7. Put microSD card in the RPi
8. Install the expansion card into the Apple II
9. Power on the Apple II
10. Update firmware with utility (can be found on Apple2-IO-RPi.hdv drive image) or use EPROM programmer
11. `sudo apt install git golang`
12. `git clone https://github.com/tjboldt/Apple2-IO-RPi.git`
13. `cd Apple2-IO-RPi/RaspberryPi/apple2driver`
14. `go get`
15. `go build`
16. `./apple2driver`
17. Optional to step above, `./apple2driver -d1 YOUR_DRIVE.hdv` (Apple2-IO-RPi.hdv is automatically selected as drive 2), or `./apple2driver -d1 YOUR_DRIVE.hdv -d2 YOUR_SECOND_DRIVE.hdv`
18. Setup the Driver as a service or to autostart via cronjob (`crontab -e` then add the line `@reboot /home/pi/Apple2-IO-RPi/RaspberryPi/apple2driver/apple2driver -d1 YOUR_DRIVE.hdv -d2 /home/pi/Apple2-IO-RPi/RaspberryPi/Apple2-IO-RPi.hdv > /home/pi/Apple2-IO-RPi/RaspberryPi/Apple2-IO-RPi.log`)

## Setup if you received a complete board from me
1. Put in any slot (slot 7 preferred as it is the first to boot)
2. Turn on your Apple II
3. Wait for the RPi to start up (will show ... until it connects)
4. Select `2` from the menu to run a command
5. Type `a2wifi list` to check that you have a wireless network in range
6. Type `a2wifi select YOUR_SSID YOUR_PASSWORD` to connect the RPi to your network
7. Once connected, you should be able to ssh to the RPi from any computer if you want. From a Mac or Linux (or Windows with Bash) shell, type `ssh pi@raspberrypi`. The default password is `raspberry`. 
8. Rebooting the Apple II, you can then select `1` from the menu and it will boot to ProDOS 2.4.2 and you will have a mostly blank 32 MB drive with a couple of utilities for updating firmware and such.
9. Star and Watch this repo on GitHub for the latest updates

## Update
1. Restart Apple II
2. Select run command
3. `cd /home/pi/Apple2-IO-RPi`
4. `git pull`
5. Restart Apple II
6. Select boot
7. `-UPDATE.FIRMWARE`
8. Enter slot number the card is in
9. Wait for firmware update to complete all four pages

## Similar Project
If you prefer having Apple II peripherals control a Raspberry Pi rather than simply using the Raspberry Pi to provide storage, network access and processing to the Apple II, have a look at David Schmenk's excellent [Apple2Pi](https://github.com/dschmenk/apple2pi) project.
Initial commit 2020-11-03 02:02:52 +00:00			`# Apple2-IO-RPi`
			`Apple II expansion card using a Raspberry Pi for I/O`
Update initial readme 2020-11-03 02:46:28 +00:00
Update README.md 2020-11-17 00:25:02 +00:00			`![Image of Board](/Hardware/Apple2IORPi.jpg)`

Update schematic/PCB to work with more EPROM types 2020-12-14 03:19:04 +00:00			`## Purpose`
Update README.md 2021-03-29 12:47:21 +00:00			`The purpose of this project is to provide I/O for an Apple II series 8 bit computer via a Raspberry Pi Zero W which is powered by the Apple II expansion bus. This includes using the attached RPi Zero W for it's storage, network and processor to provide new functionality for the Apple II.`
Update schematic/PCB to work with more EPROM types 2020-12-14 03:19:04 +00:00
Update initial readme 2020-11-03 02:46:28 +00:00			`## Project Status`
Update README for fifth revision of board 2021-07-22 12:56:19 +00:00			So far, this is a project and not a finished product. The current prototype is on the fifth revision and a few have been assembled and tested. It is now possible for the Apple II to boot from and write to a virutal hard drive image stored on the RPi in any slot and execute simple commands on the RPi via the Apple II. The code has no error handling or tests yet and is incomplete. Note that currently the firmware assumes an 80 column card is in slot 3 and than you have lowercase support. If you have a problem or idea for enhancement, log an issue [here](https://github.com/tjboldt/Apple2-IO-RPi/issues). I recommend starring/watching the project for updates on GitHub. You are welcome to fork the project and submit pull requests which I will review.
Update initial readme 2020-11-03 02:46:28 +00:00
Update README.md 2021-06-01 00:46:55 +00:00			`## Features`
			`1. Boot menu which waits for RPi to be ready`
			`2. ProDOS bootable drive from image stored on RPi`
			`3. Execute Linux commands on the RPi from the Apple II`
			`4. Load binary files directly from the RPi to the II`
			`5. Update Apple II firmware in place from image on RPi`
Update features and setup instructions 2021-10-07 00:39:08 +00:00			`6. Supports two drive images at the same time (Note: backward compatible with previous firmware but requires firmware update in order to work with two drives)`
Update README.md 2021-06-01 00:46:55 +00:00
Update schematic/PCB to work with more EPROM types 2020-12-14 03:19:04 +00:00			`## Roadmap`
Update README.md 2021-06-01 00:46:55 +00:00			`1. Proper ProDOS clock driver (currently just directly sets values on block reads)`
			`2. Support for direct file read/write without drive image`
			`3. Image conversion on download`
			`4. Web service call support`
			`5. Full terminal emulation`
			`6. Remote code execution`
			`7. Proxy VNC connection, rendering as Apple II compatible graphics`
Update initial readme 2020-11-03 02:46:28 +00:00
Update README for fifth revision of board 2021-07-22 12:56:19 +00:00			`## Setup starting from scratch`
Update roadmap and project status 2021-03-29 12:18:58 +00:00			`1. Have PCBs made from the gerber and drill files in the Hardware folder or email me for a blank or fully assembled board`
Add non-functional server code for RPi 2020-12-04 00:28:10 +00:00			`2. Solder chips, header and capacitors in place`
			`3. Attach Raspberry Pi Zero W facing outward from the card`
Update setup instructions 2021-03-28 21:00:08 +00:00			`4. Install Raspberry Pi OS on microSD card https://www.raspberrypi.org/software/`
			`5. Configure wifi in boot/wpa_supplicant.conf https://howtoraspberrypi.com/how-to-raspberry-pi-headless-setup/`
Add non-functional server code for RPi 2020-12-04 00:28:10 +00:00			`6. Add empty ssh file boot (for ssh access over wifi)`
			`7. Put microSD card in the RPi`
			`8. Install the expansion card into the Apple II`
			`9. Power on the Apple II`
Update README.md 2021-06-01 10:54:34 +00:00			`10. Update firmware with utility (can be found on Apple2-IO-RPi.hdv drive image) or use EPROM programmer`
Update features and setup instructions 2021-10-07 00:39:08 +00:00			11. `sudo apt install git golang`
			12. `git clone https://github.com/tjboldt/Apple2-IO-RPi.git`
			13. `cd Apple2-IO-RPi/RaspberryPi/apple2driver`
			14. `go get`
			15. `go build`
			16. `./apple2driver`
			17. Optional to step above, `./apple2driver -d1 YOUR_DRIVE.hdv` (Apple2-IO-RPi.hdv is automatically selected as drive 2), or `./apple2driver -d1 YOUR_DRIVE.hdv -d2 YOUR_SECOND_DRIVE.hdv`
			18. Setup the Driver as a service or to autostart via cronjob (`crontab -e` then add the line `@reboot /home/pi/Apple2-IO-RPi/RaspberryPi/apple2driver/apple2driver -d1 YOUR_DRIVE.hdv -d2 /home/pi/Apple2-IO-RPi/RaspberryPi/Apple2-IO-RPi.hdv > /home/pi/Apple2-IO-RPi/RaspberryPi/Apple2-IO-RPi.log`)
Add non-functional server code for RPi 2020-12-04 00:28:10 +00:00
Update README for fifth revision of board 2021-07-22 12:56:19 +00:00			`## Setup if you received a complete board from me`
			`1. Put in any slot (slot 7 preferred as it is the first to boot)`
			`2. Turn on your Apple II`
			`3. Wait for the RPi to start up (will show ... until it connects)`
Update features and setup instructions 2021-10-07 00:39:08 +00:00			4. Select `2` from the menu to run a command
			5. Type `a2wifi list` to check that you have a wireless network in range
			6. Type `a2wifi select YOUR_SSID YOUR_PASSWORD` to connect the RPi to your network
			7. Once connected, you should be able to ssh to the RPi from any computer if you want. From a Mac or Linux (or Windows with Bash) shell, type `ssh pi@raspberrypi`. The default password is `raspberry`.
			8. Rebooting the Apple II, you can then select `1` from the menu and it will boot to ProDOS 2.4.2 and you will have a mostly blank 32 MB drive with a couple of utilities for updating firmware and such.
Update README for fifth revision of board 2021-07-22 12:56:19 +00:00			`9. Star and Watch this repo on GitHub for the latest updates`

Update README.md 2021-06-01 00:46:55 +00:00			`## Update`
			`1. Restart Apple II`
			`2. Select run command`
Update features and setup instructions 2021-10-07 00:39:08 +00:00			3. `cd /home/pi/Apple2-IO-RPi`
			4. `git pull`
Update README.md 2021-06-01 10:54:34 +00:00			`5. Restart Apple II`
			`6. Select boot`
Update features and setup instructions 2021-10-07 00:39:08 +00:00			7. `-UPDATE.FIRMWARE`
Update README.md 2021-06-01 10:54:34 +00:00			`8. Enter slot number the card is in`
			`9. Wait for firmware update to complete all four pages`
Update README.md 2021-06-01 00:46:55 +00:00
Update initial readme 2020-11-03 02:46:28 +00:00			`## Similar Project`
Add bootable hard drive image 2021-03-28 21:16:31 +00:00			`If you prefer having Apple II peripherals control a Raspberry Pi rather than simply using the Raspberry Pi to provide storage, network access and processing to the Apple II, have a look at David Schmenk's excellent [Apple2Pi](https://github.com/dschmenk/apple2pi) project.`