ContactPi/README.md

# onsetswitch
Use buttons connected to a Rasberry Pi GPIO to trigger Hog 4 comment macros.

## Prep

*   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 --recurse-submodules https://git.company235.com/kevin/onsetswitch.git
cd onsetswitch
```
RaspberryRaspberry

## Configuring

### Input
Connect one side of the button to ground, the other to a GPIO pin.

![](https://gpiozero.readthedocs.io/en/stable/_images/button_bb.svg)

Configure the buttons:
```
nano buttons.cfg
```

### Output

Configure the Hog4 OSC server:
```
nano server.cfg
```

## Enabling on Boot
Link the onsetswitch service file to systemd:
```
sudo ln -s buttons.service /lib/systemd/system/buttons.service
```

Enable the service at startup:
```
sudo systemctl daemon-reload
sudo systemctl enable buttons.service
```

Reboot the Raspberry Pi:
```
sudo reboot
```