Apple-2-HW
/
Apple2-IO-RPi
mirror of https://github.com/tjboldt/Apple2-IO-RPi.git
2
0
Fork 1
Code Issues Projects Releases Wiki Activity

Update setup instructions for newest version of Go

This commit is contained in:
Terence Boldt 2021-10-11 08:47:35 -04:00
parent 2778b50b1e
commit 229daea2e1
1 changed files with 43 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
README.md
View File

@ -37,14 +37,27 @@ 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`
11. Install Golang (note that `sudo apt install golang` will install an older version that doesn't work with this code)
1. `sudo apt install git`
2. `sudo apt remove golang`
3. `export GOLANG="$(curl https://golang.org/dl/|grep linux-armv6l|grep -v beta|head -1|awk -F\> {'print $3'}|awk -F\< {'print $1'})"`
4. `wget https://golang.org/dl/$GOLANG`
5. `sudo tar -C /usr/local -xzf $GOLANG`
6. Edit `~/.profile` with your favourite editor and add the following:
1. `PATH=$PATH:/usr/local/go/bin`
2. `GOPATH=$HOME/golang`
12. `git clone https://github.com/tjboldt/ProDOS-Utilities.git`
13. `cd ProDOS-Utilities`
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`)
16. `cd ~`
17. `git clone https://github.com/tjboldt/Apple2-IO-RPi.git`
18. `cd Apple2-IO-RPi/RaspberryPi/apple2driver`
19. `go get`
21. `go build`
22. `./apple2driver`
23. 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`
24. 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)
@ -62,11 +75,30 @@ So far, this is a project and not a finished product. The current prototype is o
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
5. `cd RaspberryPi/apple2driver`
6. `go build`
7. `sudo reboot`
8. Restart Apple II
9. Select boot
10. `-UPDATE.FIRMWARE`
11. Enter slot number the card is in
12. Wait for firmware update to complete all four pages
### Additional steps if your were set up before October 11, 2021 to upgrade Golang and use new command line parameters for the service
This must be done via ssh directly into the RPi:
1. `sudo apt remove golang`
2. `export GOLANG="$(curl https://golang.org/dl/|grep linux-armv6l|grep -v beta|head -1|awk -F\> {'print $3'}|awk -F\< {'print $1'})"`
3. `wget https://golang.org/dl/$GOLANG`
4. `sudo tar -C /usr/local -xzf $GOLANG`
5. Edit `~/.profile` with your favourite editor and add the following:
1. `PATH=$PATH:/usr/local/go/bin`
2. `GOPATH=$HOME/golang`
6. `cd ~/`
7. `git clone https://github.com/tjboldt/ProDOS-Utilities.git`
8. `cd ProDOS-Utilities`
9. `cd ~/Apple2-IO-RPi/RaspberryPi/apple2driver`
10. `go build`
11. Edit the Driver autostart via cronjob (`crontab -e` then edit the line to be `@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`) or simply `@reboot /home/pi/Apple2-IO-RPi/RaspberryPi/apple2driver/apple2driver > /home/pi/Apple2-IO-RPi/RaspberryPi/Apple2-IO-RPi.log` if you don't need your own drive image.
## 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.