include Pi setup instructions

README.md

@@ -1,21 +1,54 @@
 # onsetswitch
 Use buttons connected to a Rasberry Pi GPIO to trigger Hog 4 comment macros.
 
-This readme assumes that you have:
-1. a working and updated Rasberry Pi,
-1. with ssh access already set up,
-1. and a static IP address on HogNet.
+## Prep
 
-Beginner users will also want:
-* Internet access on HogNet during setup.
+*   Install Raspbian [the usual way.](https://www.raspberrypi.org/documentation/installation/installing-images/README.md)
+*   Enable the ssh server.  On a mac:
+```
+touch /Volumes/boot/ssh
+```
+*   Eject the SD card and boot the Raspberry Pi.
+*   Use SSH to log into the Pi:
+```
+ssh pi@raspberrypi
+```
+*   Use raspi-config to;
+ *  set locale
+ *  set timezone
+ *  enable ssh server
+ *  enlarge the file-system to fill the SD card
+ *  reboot
+```
+sudo raspi-config
+```
+*   Update the Apt and install aptitude
+```
+sudo apt-get update
+sudo apt-get install aptitude
+```
+*   Use aptitude to upgrade the Pi.
+```
+sudo aptitude upgrade
+```
+*   Reboot the Pi.
+```
+sudo shutdown -r now
+```
+*   Logging back into the Pi, install sane set of software packages.
+```
+sudo aptitude install git python3-pip python3-gpiozero
+sudo pip3 install gpiozero antlr4-python3-runtime python-osc
+```
 
 ## Installing
 
 ```
 cd /home/pi
-git clone https://git.company235.com/kevin/onsetswitch.git
+git clone --recurse-submodules https://git.company235.com/kevin/onsetswitch.git
 cd onsetswitch
 ```
+RaspberryRaspberry
 
 ## Configuring
 
@@ -48,7 +81,7 @@ sudo systemctl daemon-reload
 sudo systemctl enable buttons.service
 ```
 
-Reboot the Rasberry Pi:
+Reboot the Raspberry Pi:
 ```
 sudo reboot
 ```