Skip to content

Quick start guide

Jump to bottom
Jelle Bouwhuis edited this page Jun 7, 2019 · 17 revisions

Quick start guide

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: Available WiFi networks

(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: Initialized led

(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: Config mode LED

(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: Available WiFi networks

(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: Connection settings

(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. Check your measurements on WHERE_DO_WE_LINK_HERE_URL
  7. Everything is working! You can change the configuration back to Production

Help! The LED turned red!

Please check the following:

  • The bGeigieNano has

Prepare for long time fixed sensor

...

Pages on this wiki

Clone this wiki locally