Update features and setup instructions

This commit is contained in:
Terence Boldt 2021-10-06 20:39:08 -04:00
parent 7e56516acc
commit 49f99c6c51

View File

@ -15,6 +15,7 @@ So far, this is a project and not a finished product. The current prototype is o
3. Execute Linux commands on the RPi from the Apple II 3. Execute Linux commands on the RPi from the Apple II
4. Load binary files directly from the RPi to the II 4. Load binary files directly from the RPi to the II
5. Update Apple II firmware in place from image on RPi 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 ## Roadmap
1. Proper ProDOS clock driver (currently just directly sets values on block reads) 1. Proper ProDOS clock driver (currently just directly sets values on block reads)
@ -36,33 +37,34 @@ So far, this is a project and not a finished product. The current prototype is o
8. Install the expansion card into the Apple II 8. Install the expansion card into the Apple II
9. Power on 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 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 11. `sudo apt install git golang`
12. git clone https://github.com/tjboldt/Apple2-IO-RPi.git 12. `git clone https://github.com/tjboldt/Apple2-IO-RPi.git`
13. cd Apple2-IO-RPi/RaspberryPi/apple2driver 13. `cd Apple2-IO-RPi/RaspberryPi/apple2driver`
14. go get 14. `go get`
15. go build 15. `go build`
16. ./apple2driver ../Apple2-IO-RPi.hdv 16. `./apple2driver`
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 /home/pi/Apple2-IO-RPi/RaspberryPi/Apple2-IO-RPi.hdv > /home/pi/Apple2-IO-RPi/RaspberryPi/Apple2-IO-RPi.log) 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 ## Setup if you received a complete board from me
1. Put in any slot (slot 7 preferred as it is the first to boot) 1. Put in any slot (slot 7 preferred as it is the first to boot)
2. Turn on your Apple II 2. Turn on your Apple II
3. Wait for the RPi to start up (will show ... until it connects) 3. Wait for the RPi to start up (will show ... until it connects)
4. Select "2" from the menu to run a command 4. Select `2` from the menu to run a command
5. Type "a2wifi list" to check that you have a wireless network in range 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 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". 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. 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 9. Star and Watch this repo on GitHub for the latest updates
## Update ## Update
1. Restart Apple II 1. Restart Apple II
2. Select run command 2. Select run command
3. cd /home/pi/Apple2-IO-RPi 3. `cd /home/pi/Apple2-IO-RPi`
4. git pull 4. `git pull`
5. Restart Apple II 5. Restart Apple II
6. Select boot 6. Select boot
7. -UPDATE.FIRMWARE 7. `-UPDATE.FIRMWARE`
8. Enter slot number the card is in 8. Enter slot number the card is in
9. Wait for firmware update to complete all four pages 9. Wait for firmware update to complete all four pages