From 229daea2e1485a5a9662c57dc2138afa9fe9c3c5 Mon Sep 17 00:00:00 2001
From: Terence Boldt <terence@boldt.ca>
Date: Mon, 11 Oct 2021 08:47:35 -0400
Subject: [PATCH] Update setup instructions for newest version of Go

---
 README.md | 54 +++++++++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 43 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 9cfc521..2a5957c 100644
--- a/README.md
+++ b/README.md
@@ -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.