The Motheter project records images and SQM light sensor readings at field stations to track moth populations. This repository aims to simplify the data collection process by allowing remote access to the light sensor data. This version does not include the ability to transfer image data.
There are two options for the sensor setup:
-
A host computer connects to an RPi over WiFi, which is directly connected to the SQM sensor.
-
A host computer connects to an RPi over WiFi, which uses a radio module to communicate with the RPi that's connected to the SQM sensor.
Cellular compatibility has not yet been implemented. Existing code could be adapted for Ethernet, but this has not been tested.
All code relating to SQM sensor communication was copied from the Py3SQM project and has been extensively modified (bastardized). If you find yourself needing to debug or rework anything in that area, I recommend checking that project for assistance.
This code suite was only tested on an SQM-LU device. The framework for an SQM-LE exists, but you will have to debug it yourself (sorry, not much I could do on that front without the actual device). I recommend looking at the original PY3SQM project to see how their version works.
To prevent your host/RPi IP address from changing, you can either request a static IP through your institution or get a DDNS address.
configs: all values that the user might want to change. Accessed by all other files.ui_commands: runs on host computer. Terminal-based user interface to generate and send commands.parse_response: runs on host computer. Formats responses from sensor and prints to terminal.host_to_client: runs on the host computer (a server at your institution). Handles user input, outgoing communication, and basic data storage.rpi_wifi: runs on main rpi. Uses socket to maintain a connection to the host computer.lora_parent: called by rpi_handler. Uses serial to communicate with accessory RPi via LoRa radio.lora_client: runs on accessory RPi, if it exists. Uses serial to communicate with main RPi via LoRa radio.sensor: runs on main RPI, or accessory RPi if using a LoRa setup. Uses serial to communicate with the SQM sensor./scripts/runradio.sh: bash script to automatically run the radio program (lora_child)/scripts/runrpi.sh: bash script to automatically run the RPi program (rpi_wifi)-
/scripts/runsensor.sh: bash script to automatically run the sensor module (Py3SQM)
General setup instructions can be found here, but there are a few specific steps you'll need to follow for this project.
Go to the Raspberry Pi OS page and download the imager that corresponds to your computer's operating system. Install the imager and try running it. Clicking on Storage should show an empty window, because we haven't given it a volume to write to yet.
Remove the SD card from your RPi and connect it to your computer via an SD card adapter. You should now see a volume to write to in the Storage window. Under Device, select the model of Raspberry Pi you're using. Under Operating System, select Raspberry Pi OS (64-bit).
On the next window, click the Edit Settings button. Set the hostname to something unique (rp1, rp2, rp3, etc.). I recommend making the username the same as the hostname, for simplicity. Set a password, and write it down somewhere. Configure the Wireless LAN (WiFi) by providing the network's name and password. If you're using an institution's WiFi, you might have to select Hidden SSID (it doesn't hurt to select this by default). Select your country code in the Wireless LAN Country menu. Finally, set your time zone and keyboard layout.
In the Services menu, enable SSH with password authentication, then save your changes and click Yes twice. You may need to provide your password (for your computer, not the one you just made). After a few minutes, the install will finish and you can eject the SD card.
Connect your RPi to power using the provided power cable. Connect a mouse and keyboard with USB cables, and connect a monitor with a microHDMI cable. You should now be able to use the RPi as a computer!
Your host computer needs a reliable connection to the RPi. The two options to achieve this are Ethernet and WiFi. Ethernet hasn't been thoroughly tested for this project, so WiFi is recommended. For either connection option, setting up SSH key sharing is strongly recommended.
If your device will be connected to the host computer via Ethernet, follow the instructions in this section. Otherwise, continue to the WiFi section below.
Plug an Ethernet cable into your device, then find the network connection icon on the taskbar (when connected to WiFi, this looks like a fan. When connected to Ethernet, it looks like two arrows). Mousing over this icon will show your IP address(es), and clicking on it will show you the available LAN networks. Select Advanced Options > Connection Information to view more information about all active connections.
Connect your computer to Ethernet. It's important to note that your computer will try to use one connection by default for everything, so you can't easily use Ethernet to connect to the RPi and WiFi for everything else. In your computer's network settings, change the service order to put the Ethernet LAN first, ahead of any wireless options; alternatively, you can turn off WiFi just to test the Ethernet connection. Do the same on the RPi (it's easier to just disable WiFi in this case).
In a terminal, run the command ssh [email protected] and provide RPi's password to log in. You can now run commands on the RPi. Use Ctrl-D to exit the RPi.
Mouse over the WiFi symbol on the RPi to view its IP. On your computer, run the command ssh rp1@<IP> and provide RPi's password to log in. You can now run commands on the RPi. Use Ctrl-D to exit the RPi.
If we want to use SSH for automated communication, we don't want our programs to sit around and wait for us to put the password in. We can make this automatic by creating and sharing an SSH key pair.
Your computer should already have an SSH key. You can check this by running ls -al ~/.ssh. If you get an error saying that /.ssh doesn't exist, run ssh-keygen to create a new ssh key.
Run the command ls -al ~/.ssh. There should be a file called id_ed_25519 (it might be called something different, like DSA, RSA, or ECDSA depending on which encryption scheme was used to generate it). Copy this SSH key to the RPi with the command:
ssh-copy-id -i ~/.ssh/id_ed25519 [email protected]Now try ssh [email protected] again; you shouldn't have to use the RPi's password to log in. You can repeat this process in reverse to make your computer accessible via the RPi, although you may have to change the remote login settings on your computer to allow incoming SSH connections.
If you get an error saying the remote host identification has changed, you need to remove any existing keys that might be associated with your RPi (this is why your computers should all be named differently: it's a pain to redo SSH keys between three computers all named "rpi"). Run the following command to remove it:
ssh-keygen -R rp1.localIn the RPi's start menu, go to Preferences > Raspberry Pi Configuration. In the System tab, enable Auto Login. In the Interfaces tab enable the serial port and serial console (you can enable everything else while you're at it; it won't hurt). In the Display tab, turn screen blanking off.
We need to make sure we can always connect to the sensor, even if the RPi reboots or it gets plugged into a different USB port.
Unplug and replug the sensor, then run dmesg. The last batch of messages should be about a FTDI USB Serial Device; record its idVendor and idProduct. Run the command sudo nano /etc/udev/rules.d/10-usb-serial.rules. Write the following line with the device's attributes:
SUBSYSTEM=="tty", ATTRS{idProduct}=="6001", ATTRS{idVendor}=="0403", SYMLINK+="ttyUSB_SQMsensor"Save and exit, then run sudo udevadm trigger, and check with ls -l /dev/ttyUSB*.
Open a terminal and run the command dmesg. It prints all diagnostic messages, which there are a ton of because things have been happening to your RPi since it booted up. To clear these messages, run sudo dmesg -c, which prints all the messages and then clears them. Running dmesg now shouldn’t print anything.
Unplug and replug your mouse, then run dmesg again. You should see a USB message about a disconnect, then a bunch about new device details. The orange text on the left will tell you where the diagnostic message originated: usb 1-1.2, for example. Find the line that contains the fields idVendor and idProduct. Write these numbers down, along with the USB number in orange.
Repeat this process for all of your USB equipment, including your sensor (but not the HDMI connection, that’s a different system!). Be on the lookout for anything with a ttyUSB or ttyACM port number, and record that if you see it. You can also run dmesg | grep tty to isolate just the tty information.
| Device | USB port | idVendor | id Product | tty |
|---|---|---|---|---|
| SQM sensor | 1-1.1 | 0403 | 6001 | ttyUSB0 |
| LoRa device | 1-1.3 | 1a86 | 55d3 | ttyACM0 |
| Keyboard | 1-1.4 | 04d9 | 0024 | |
| Mouse | 1-1.3 | 413c | 301a |
Note that plugging things into different USB ports can change the USB number, so don't worry if there's overlap in that column.
The idVendor and idProduct are coded into each device and can't be changed. If you have two tty devices with the same idVendor and idProduct values (such as two LoRa radios), you'll need to use other attributes to distinguish them. Run the command
udevadm info --name=/dev/<tty_port> --attribute-walk for both devices. Write down the ID_USB_SERIAL_SHORT value for each and use them as attributes in the next step.
Now we get to actually write our rules for the ports. Run the command:
sudo nano /etc/udev/rules.d/10-usb-serial.rulesEach line we write here will correspond to one device, so we only need one line for the sensor. Come up with a good name for the sensor ("SQMsensor", for example) that will differentiate it from any other devices we could attach.
SUBSYSTEM=="tty", ATTRS{idProduct}=="6001", ATTRS{idVendor}=="0403", SYMLINK+="ttyUSB_SQMsensor"
SUBSYSTEM=="tty", ATTRS{idProduct}=="55d3", ATTRS{idVendor}=="1a86", SYMLINK+="ttyUSB_LORA"If you have multiple versions of the same device, you can add them as shown:
SUBSYSTEM=="tty", ATTRS{idProduct}=="55d3", ATTRS{idVendor}=="1a86", ATTRS{ID_SERIAL_SHORT}=="578E023173", SYMLINK+="ttyUSB_LORA0"
SUBSYSTEM=="tty", ATTRS{idProduct}=="55d3", ATTRS{idVendor}=="1a86", ATTRS{ID_SERIAL_SHORT}=="578E023029", SYMLINK+="ttyUSB_LORA1"Save your changes and exit. Load these changes with sudo udevadm trigger, and check that it worked with ls -l /dev/tty*
If it worked, /dev/ttyUSB_SQMsensor will show up in light blue. If it didn’t work, go back to that file you wrote and check for typos (like ATRS instead of ATTRS or =+ instead of ==).
The Py3SQM module is what we'll use to actually collect data. It's included in the MotheterRemote repo, so you don't need to install it separately. Run the following commands to install a few dependencies:
sudo apt install python3-ephem
sudo apt install python3-matplotlibRead the README.txt to get a sense of what this all does. Then start following their instructions to modify config.py, elaborated here:
- Observatory
- name = MacLeish
- latitude = 42.449183
- longitude = 72.679909 (for testing purposes, you can put in 150 and pretend you’re in Australia, where it’s night)
- altitude = 52 (it's in meters)
- Device
- type = SQM_LU
- location_name = "Smith College - MacLeish Field Station"
- data_supplier = "Mariana Abarca / Smith College Biology Department"
- addr = "/dev/ttyUSB_SQMsensor"
- Time
- local timezone = -4 (the UTC where the sensor is located)
- computer timezone = -4 (the UTC where the computer running this code is located)
- Directories
- monthly data directory = “/var/tmp/sqm_macleish”
- daily_data_directory = monthly_data_directory_+“/daily_data/”
- daily_graph_directory = monthly_data_directory_+“/daily_graphs/”
To run the module, navigate to the Py3SQM directory and run python -m pysqm.
You can also work from a separate installation of Py3SQM.
The USB stick that came with the SQM sensor has Py3SQM on it, but you can also access it through this webpage. Select RPi, then download Py3SQM.zip. Extract it by right-clicking and select Extract Here. You’ll get a bunch of files in a folder called Py3SQM; keep this on the desktop for easy access. It should contain a folder called pysqm containing the following: common.py, __init__.py, __main__.py, main.py, plot.py, read.py, settings.py. They may have been moved outside the pysqm folder when you extracted them; just remake the folder and put them back in.
You’ll also need to manually fix a bug. In the pysqm folder, open plot.py. At the top of the method window_smooth, write the following (be sure to only use spaces, NOT tabs):
if isinstance(x,list):
x = np.array(x)Note that some combinations of longitude and local/computer timezone can cause unexpected behaviors. Running it during the day (or giving it a position/timezone that implies it’s day) will make it wait until night, which is useless for testing.
One possible error is “unsupported operand type(s) for +: ‘NoneType’ and ‘datetime.timedelta’”, which happens if the program can’t resolve when “night” should be and defaults to “None”. Try resetting to the original values long=-70, local time =-4, computer time = -4.
You might also see “Warning, < 10 points in astronomical night, using the whole night data instead”. This has to do with the plotting program, so you can try messing with the plotting variables in config.py (but we’re not worried about the graphing part of this program, just data collection, so don’t worry about this).
If you’re still getting errors about missing packages or python versions, wipe the SD card and start from the beginning. Seriously, it’s easier than messing with versions of Python and pip.
Clone this repository into your home directory so that the repo will be accessible via ~/MotheterRemote.
git clone https://github.com/SWorster/MotheterRemoteYou'll need to edit the configs file with the appropriate data for your setup. Change the info for the host computer, main RPi, radio RPi (if applicable), sensor, and socket connection. It's not recommended to change values in the text formatting, timing, and miscellaneous sections.
We'll need to set up new cron jobs for the Raspberry Pi (or both, if using a radio setup). Read the scripts/cronjobs.txt file to see which jobs to add where. In a terminal, type crontab -e to add a new cron job.
If you try to perform a git merge (like git pull) and your edits include changes to the shell scripts, git may require you to commit or stash your changes before merging. The simplest way to resolve this is git reset --hard. Warning: this will discard any uncommited changes on the RPi. I recommend making all code changes on a non-RPi computer for this reason, as you'll never need to keep track of what to save.
There's no need to run anything on the RPis directly, as those programs will run automatically. Simply run host_to_client.py on the host computer.