parosBox

Code deployed on paros raspbery PIs

Deployment Instructions

1. Create an SD card with Raspberry PI Imager loaded with the OS "Raspberry PI OS Lite (64 Bit)" with these options:
   1. Set hostname to name of box (this MUST be set to whatever the config name is in this repo)
   2. Enable SSH, use password authentication
   3. Set Username and Password to pi for the User, and (redacted) for the password
   4. Configure wireless lan - set this to the credentials for your phone's wireless hotspot. Also set the wireless country. This way you'll be able to make use of your hotspot during setup.
   5. Set locale settings always keep keyboard layout on US, but set time zone to wherever the box will be
   6. Uncheck enable telemetry
2. Put this SD card into the raspberry PI, connect your laptop to the ethernet port (ensure that your laptop is set to DHCP on that interface, which is the default), and power on the PI
3. After 1-2 mins you should be able to ssh pi@<hostname>.local with the password set in 1.(3)
4. For the next few steps the PI needs internet access. Since the ethernet port is full, use your phone's hotspot which you set the credentials for in 1.(4). Keep in mind that you can also change these credentials by running the sudo raspi-setup command in the SSH window after the fact.
5. Once you have internet access, run sudo apt update and sudo apt install git
6. Ensure that you are in your home directory (cd ~) and run git clone https://github.com/UmassCASA/parosBox.git parosBox.
7. Create your environment (this is custom to each deployment)
   1. cd parosBox to chdir into that directory
   2. cp .env.example .env and then run nano .env (or any text editor you want)
   3. Fill in any blank values. Defaults are usually correct except PAROS_INFLUXDB_TOKEN (InfluxDB token with write access to parosbox data store), PAROS_FRP_TOKEN which is the common frps token from mgh4.casa.umass.edu, and PAROS_FRP_OFFSET, which must be unique for each box.
   4. Create your sensor config JSON: cd sensor_configs and create a new JSON there with the sensors in the current box. Feel free to copy one that already exists to see what it should look like. Each sensor has a driver, device ID (usually serial number of the sensor), and device path, which should be /dev/serial/by-id/<something>. Use this path instead of something like /dev/ttyS0 because the S0 number might change between reboots.
8. Run the setup script. sudo ./setup.sh --new
9. Reboot the raspberry PI. On reboot, you should be able to access the SSH connection via the mgh4 server. If that is true, disconnect your ethernet cable and connect the permanent internet source to the ethernet port, and turn off your phone's hotspot.