Quick start guide

Quick start guide

• Plug in the module
• Configure the module
• Testing the module

Pre-requires

The following things are needed to setup your bGeigieCast for first time use

• Fully working bGeigieNano kit
• bGeigieCast module
• A mobile phone or laptop that can connect to a WiFi access point
• A Safecast API Key
  • Get your API key from api.safecast.org
  • (Login -> Dashboard -> Retrieve your API key)

Plug in the module

The module is designed to be plug and play, so simply plug on the module on the XBee socket on the bGeigieNano. If you use a BLEBee bluetooth module, the bGeigieCast module will replace this.

(Image: bGeigieCast plugged on the bGeigieNano)

Configure the module

The following steps will guide you through the configuration process

---

Step 1: Turn on the bGeigieNano

Now with the module on the bGeigieNano, switch on the device. This will also start up the bGeigieCast. The LED will blink (white color) to show the module is initializing.

Note: make sure the module is also powered on.

(Image: bGeigieCast white LED, blinking when initializing)

---

Step 2: Go into config mode

Once the LED stops blinking (solid white color), press the button to enter configuration mode. There is a 3 seconds time window to do this. After pressing the button, the LED should change to a solid purple color.

(Image: bGeigieCast purple LED, now in configuration mode)

---

Step 3: Connect to the module

Open your mobile phone or laptop and open the list of available WiFi networks. In here, a new network will show up with the name bgeigie1346 (where 1346 is your unique bGeigie ID). Connect to this network, the default password is safecast.

Note: by connecting to this endpoint, internet connection will no longer be available on your phone / laptop while connected to the bGeigieCast.

(Image: List of available WiFi networks, the bGeigieCast network marked with red)

---

Step 4: Configure the module for fixed mode

Open your browser and connect directly to 192.168.5.1. This page will show a landing page. From here, go to Configure -> Connection settings. Then fill in the following settings required for fixed mode:

• WiFi network name
  • Your home WiFi network
• WiFi password
  • Your home WiFi network password
• API Key
  • API key for the Safecast API

!! Important !!

The configuration server will try to connect to the wifi network before starting its own access point. After configuring the WiFi credentials, restarting the bGeigieCase and entering configuration mode again, it will not be reachable at 192.168.5.1, but instead you have to use http://bgeigie1346.local/ (where 1346 is your bGeigieNano ID).

(Image: The connection settings page)

---

Step 5: Other configurations (optional)

For more information about the settings and their description, see the User manual.

Testing the module

Optional

To test the WiFi connection, the API key and publishing the measurements to the API, follow these steps:

1. Go to connection settings
2. Set Safecast server to Development
3. Set frequency to 30 seconds (Optional, but faster for testing)
4. Go to fixed mode
   1. Press the button to leave configuration mode, this will bring you to your last used mode (default mobile mode, blue LED)
   2. If in mobile mode, press the button to go to fixed mode (Yellow-ish LED)
5. The LED will turn green after 5 minutes (or 30 seconds if you changed the frequency)
6. Go to Safecast Grafana
   1. On the top left it should say "DRE". If not, open the dashboard menu and select General -> DRE.
7. Enter your device ID in the device input field. Your bGeigieCast ID is 6 + your bGeigieNano ID
   1. So bGeigie id 1346 would be 61346 as a fixed sensor!
8. Select the current date on the top-left or select "last 1 hour". You should see your measurements in a graph now!
9. Everything is working! You can change the configuration back to Production

(Image: Grafana)

Help! I don't see measurements

Please check the following:

1. bGeigieCast LED is Green:
   1. Double check the bgeigiecast ID on grafana
2. bGeigieCast LED is Yellow
   1. The device is still gathering measurements, make sure the device has a GPS lock!
3. bGeigieCast LED is RED
   1. There might be a problem with the WiFi credential
   2. More troubleshooting coming soon...

Prepare for long time fixed sensor

...