From 3eda06f3b7fae0befab1b6e2d69c99ae8ee1a646 Mon Sep 17 00:00:00 2001 From: Kevin Matz Date: Sun, 3 Nov 2019 20:29:06 -0500 Subject: [PATCH] include Pi setup instructions --- README.md | 49 +++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 41 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 3358054..550f5d4 100644 --- a/README.md +++ b/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 ```