From 49f99c6c51f21ad231c1fb1c701141bce5572baa Mon Sep 17 00:00:00 2001 From: Terence Boldt Date: Wed, 6 Oct 2021 20:39:08 -0400 Subject: [PATCH] Update features and setup instructions --- README.md | 32 +++++++++++++++++--------------- 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 04f9f85..9cfc521 100644 --- a/README.md +++ b/README.md @@ -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 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) @@ -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 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 ../Apple2-IO-RPi.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 /home/pi/Apple2-IO-RPi/RaspberryPi/Apple2-IO-RPi.hdv > /home/pi/Apple2-IO-RPi/RaspberryPi/Apple2-IO-RPi.log) +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. +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 +3. `cd /home/pi/Apple2-IO-RPi` +4. `git pull` 5. Restart Apple II 6. Select boot -7. -UPDATE.FIRMWARE +7. `-UPDATE.FIRMWARE` 8. Enter slot number the card is in 9. Wait for firmware update to complete all four pages