This repo has a collection of scripts to adapt the output of different ground motion sensors to a format our server understands (the Raspberry Shake format).
If you're using a Raspberry Shake device, you probably don't need these details.
Also check out the How to set up a sensor document, which goes over setting up the networking parts.
- Select the correct script for your device.
- Set up a Raspberry PI (or other device) connected to the device directly, either via ethernet or usb (USB is currently is only for the CRISiSlab/Mithira sensor).
- Do the networking setup as described in How to set up a sensor.
- Follow the instructions in the relevant readme.md file to set up the adapter script for that device.
- Update the server IP if not using our main server hosted on Massey infra.
- Review existing adapters.
- Copy paste the one that looks closest to what you'll be doing.
- Replace the parts that read data from the sensor to work with your sensor.
- Test with first a local version of the ingest server and then the live version.
- Update the instructions if needed.
- Commit to the repo.
Fundamentally, the hard part is getting data out of a sensor. Once you have it (and have internet access) you just need to arrange it in the following format, encode it as utf-8 binary, then send it to 10.241.144.172:2098 over UDP.
{'channel', timestamp (in seconds not ms), num1, num2, num3, ..., num250}
E.g.
{'HNZ', 1722946951.674587, 1,2,3,4,5,6,7,8}
This is based on the Raspberry Shake data format. Thinks to remember:
- The channel should be 3 upper-case letters
- The timestamp is in seconds not milliseconds
- Spaces are optional
- You can have any number of readings, but around 250 is normal