Quick Start Guide

Welcome to the Raspberry Shake Community! Now it is time to get your Raspberry Shake 1D, 3D, 4D or Raspberry Jam up and running!

Click on “Table of Contents” in the left hand side menu to return to the main menu of the manual.

How to assemble your own Raspberry Shake

A Do It Yourself-er? Great! Here is how to assemble your unit for the first time:

Raspberry Shake 1D (Original):

Raspberry Shake 4D:

Some important notes:

Warning

The Raspberry Shake has a plastic enclosure. If you are going to use tools, be careful. You can easily overtighten the screws (especially the leveling feet) and strip the threads. We recommend nothing more than hand-tight.

Warning

Be careful not to pinch/ pressure the geophone cables.

Note

The Raspberry Shake board, if left uncovered, will produce some long-period wander. To ensure the highest quality signal, always operate the Raspberry Shake inside of the enclosure provided by OSOP or your own.

Geophone Polarity (vertical): If you connect the grey cable from the “+” on the geophone to the “+” on the Raspberry Shake board, the output signal will have the correct polarity.

How to install your Raspberry Shake

Raspberry Shake was designed as a personal seismograph for settings with lots of noise generated by cars passing by, people walking about, etc. You can install your Shake in almost any location- in your home, office, under your desk or even in a seismic vault but for best results, install your Raspberry Shake on the bare floor (no carpet) and not on top of your desk. A good location for the Shake would likely be on the concrete slab of the lowest floor, near a foundation wall and away from furnaces, washing machines, air conditioners and such.

Warning

The Raspberry Shake has a plastic enclosure. If you are going to use tools, be careful. You can easily overtighten the screws (especially the leveling feet) and strip the threads. We recommend nothing more than hand-tight.

Note for the Raspberry Shake 3D / 4D

As the Raspberry Shake 3D and 4D have orthogonal components of velocity and acceleration, respectively (up-down, north-south, east-west), you will have to use a compass to align the Raspberry Shake 3D or 4D towards North. We provide a North Arrow on the Raspberry Shake 3D and 4D boards.

Turning your Raspberry Shake on for the first time

First time configuration:

  1. Plug an Ethernet cable into your Raspberry Shake and connect the other end to one of the ports on the back of your Wifi router or an Ethernet jack in the wall. Do not plug the Ethernet cable from the Raspberry Shake into your computer- Unlike, say, a printer or some other device that connects to your computer, your Raspberry Shake is a full-featured computer by itself. Once it’s been properly configured, it will hum along on its merry way, acting as a seismograph 24 hours a day, seven days a week. However, the main difference between your Raspberry Shake and most other computers is that it doesn’t have a keyboard, mouse, or monitor to let you control it. Folks in the Raspberry Pi community like to call this “running headless.” As a result, in order to make any changes to your Raspberry Shake, you’ll need to access it over the Internet using another computer.

    Warning

    We do not recommend using the built-in Raspberry Shake 3 Model B’s wifi, but it is available. Be aware that using the built-in Wifi (as opposed to Ethernet or Wifi from a USB adapter) will introduce high amplitude RF noise into the Raspberry Shake, often seriously compromising the seismic signal by introducing high amplitude low-frequency spikes. This appears to be a result of the proximity of the Wifi antenna to the Raspberry Shake board itself. External/ USB wifi solutions are not as problematic because the wifi antenna is further from the Raspberry Shake board. The Raspberry Pi Zero “W” does not appear to suffer from this same problem and can be safely used in native wifi mode.

  2. Once the Ethernet cable is connected to the router, plug the unit in and power it on. A blue LED should light up on the Raspberry Shake card. If you assembled your own unit and a blue LED does not come on, check that the Raspberry Shake card is aligned correctly (see position of Raspberry Shake with respect to the Raspberry Pi header in the video above).

    Note

    When running your Raspberry Shake for the first time, you must be connected to the Internet to allow the software to automatically update. Depending on your bandwidth, the update could take seconds or minutes.

  3. Open a browser on your phone, tablet, desktop computer or laptop and navigate to http://raspberryshake.local

    Note

    Web elements are currently only activately supported on Google Chrome. Internet Explorer is not actively supported but this and other browsers may work as well.

    Note

    If you do not see the web configuration screen after entering http://raspberryshake.local into your browser, you might need to discover the actual IP of your Raspberry Shake and navigate instead to http://<put_IP_here>. You can easily accomplish this with the app Find your Raspberry Shake’s IP with Fing. If you do not own a smart phone or tablet and you are a Window’s user, please see: Special Note for Windows users: http://raspberryshake.local Work Around.

    Note

    If you have more than one Raspberry Shake on the same network, they will appear as raspberryshake.local, raspberryshake-2.local, ... , raspberryshake-n.local

  4. Open the menu, choose the Settings icon and configure your Raspberry Shake. After enabling data forwarding, please take a minute to zoom in and to select exactly where your Raspberry Shake lives, down to the building and not just the city or town. This is critical for accurate earthquake locations. You can update this information at any time. We have been testing this feature by traveling around with Raspberry Shake in our backpacks and reconfiguring it everywhere we go! Please also note that this information will only be used by the automatic earthquake processing system and will not be exposed to the broader community. On the StationView map, for example, we have implemented an algorithm for security that takes your Shake’s location and randomizes it to another location within 1 mile of its actual location.

  5. After you have answered all of the data forwarding questions and selected your Raspberry Shake’s geolocation, hit the “Save and Restart” button. Wait a few minutes and then check out StationView. Search for your Raspberry Shake on the station map (If you already had stationView open before configuring your Raspberry Shake, then hit Crtl+F5 first to refresh the page!). For more information see The Raspberry Shake Worldwide Seismic Network.

  6. To view and interpret the live data feed coming from your Raspberry Shake, please download “Swarm”. Swarm is a software package that runs on your laptop or Desktop computer, displays a live data stream from your Raspberry Shake and allows for numerous methods of data interpretation and interaction. To download Swarm navigate to “Actions” and hit the download Swarm button. See How to visualize the waveforms for more details.

Now that you are up and running, secure your Raspberry Shake

Before you do anything else, it’s essential that you change the password on your Raspberry Shake in order to keep it secure. The basic anti-hacking measures that you can take to keep your Raspberry Shake safe are described at Ready, Set, Get Hacked! Security and Raspberry Shake