4 ‐ Configuration Web Server

DO NOT EDIT HERE. MOVED OVER TO GOOGLE DOC:

https://docs.google.com/document/d/1dL5jwEKXLMV9gy2V1ZsIVTf527sxFkMO4g-TruKSTp0

Your Zen has many operating modes and options configurable with the built-in Web server. From the Settings screen, you may launch the server on the local WiFi network or, if no network is available, on its own WiFi access point. Settings critical to measurements are saved in the SAFEZEN.TXT file, while non-critical usability settings are saved to the controller's memory (non-volatile RAM).

Note: the device ID may not be changed from the Web configuration server.

4.1 - WiFi networking

The Zen can join a local WiFi network or start its own access point.

4.1.1 - Set up the WiFi access point

This option is available at all times, even before setting the Internet access WiFi parameters.

• Press the Menu button
• Navigate to Settings and press Enter
• Press Options
• Navigate to Start Access Point and press Enter

Your Zen's built-in configuration server will appear in a new WiFi network. The parameters as shown on the controller screen. Connect from your computer or smartphone. If your browser flags the pages are not secure, ignore the warning and connect anyway. This is a captive web server and there is no connection to the Internet.

4.1.2 - Join an existing WiFi network

To use this method, you must first configure the parameters to join an existing WiFi network by editing the SAFEZEN.TXT file or through the access point (see above).

• Press the Menu button
• Navigate to Settings and press Enter
• Press Options
• Navigate to Start on local and press Enter

Your Zen's built-in configuration server will appear on the WiFi network. The parameters as shown on the controller screen. Connect from your computer or smartphone. If your browser flags the pages are not secure, ignore the warning and connect anyway. This is a captive web server that will not forward anything to the Internet.

4.2 - Configuration server pages

4.2.1 - Device

• CPM Alert threshold: In fixed mode, upload data more frequently when the counts per minute (CPM) value is above this value.

• Screen saver timing: the TFT display in the controller can suffer from image persistence (burn-in) when the same image is displayed for long periods. The screen saver dims the display, then blanks it. While blanked, you have the option of showing an animated screensaver message.

  • Screen dims after... (in seconds). Set to 0 to disable screen dimming.
  • Screen turns off after... (in seconds). Set to 0 to disable turning the screen turning off.
  • Screen when off is completely off, or shows an animated screensaver.

• Big radiation value on display: In Drive and Survey modes, the screen shows the radiation dose in microsieverts per hour (uSv/h) and the counts per unit time (per minute in Drive, per 5 seconds in Survey). This option determines which of the two is displayed in large characters.

• Logging options: When entering the Drive or Survey modes, this setting determines if the logging starts automatically, or if it must be started manually with the Start Logging button. Safecast recommends the automatic setting to avoid inadvertently missing measurements. (?? HOW TO DESCRIBE THAT IT'S ALRIGHT TO MAKE MEASUREMENTS BEFORE GPS FIRST FIX BECAUSE THE DATABASE WON'T RECORD MEASUREMENTS WITHOUT A POSITION ??)

• Create journal logs: Optionally create and add to a journal log file. The journal is a separate file that will contain all measurement lines regardless of the current operating mode. The journal is meant for verifying correct device operation or troubleshooting measurement errors.

• Don't add invalid lines to log files: Optionally log all measurements even without time or position information, or no radiation counts. The default for the gGeigie Nano is to wait until the GPS receiver provides time and location. (?? HOW TO DESCRIBE THAT IT'S ALRIGHT TO MAKE MEASUREMENTS BEFORE GPS FIRST FIX BECAUSE THE DATABASE WON'T RECORD MEASUREMENTS WITHOUT A POSITION ??)

4.2.2 - Connection

Update the network connection parameters to use the built-in access point or to log measurements directly over the Internet.

• bGeigieZen password: The password for the WiFi access point when starting the bGeigieZen configuration server. Keep the default "safecast". The network name of your bGeigie Zen access point is based on its ID number: bgeigiezen-5nnn .
• WiFi network name: your local WiFi network name. This is the network that your Zen would use to log measurements over the Internet.
• WiFi password: the password to connect to the WiFI network
• API key: The unique ID key to submit measurements directly to the Safecast database. Get your API key from api.safecast.org. After logging in, navigate to Dashboard > Retrieve your API key.

4.2.3 - Location

Enter the latitude and longitude that will be reported for measurements made in Fixed mode. The numbers are in decimal degrees with up to 6 decimals.

• Fixed mode latitude, as +-DD.dddddd in the range +-90. Positive numbers are north of the equator.
• Fixed mode longitude, as +-DDD.dddddd in the range +-180. Positive numbers are east of the prime meridian.
• Last known location shows the current or last known location from the GPS module. Click the Apply link to transfer this location to the Fixed mode position.

4.2.4 - Update firmware

Update the firmware in the controller. This option is not yet available.

4.2.5 - Github

This link will redirect your browser to the Safecast bGeigie Zen project on the GitHub.com source code repository.