2 ‐ Initial Configuration

DO NOT EDIT HERE. MOVED OVER TO GOOGLE DOC: https://docs.google.com/document/d/1dL5jwEKXLMV9gy2V1ZsIVTf527sxFkMO4g-TruKSTp0

(Issues here??)

• (Is there a difference between cold start and hot start, other than for GNSS time to first fix ??)
• (Can Fixed mode work if there is no SD card loaded?? If the NVRAM is good, is that enough information for Fixed mode??)

MAX SIZE OF uSD Card in FAT32 is 4GB?-?

Your Zen needs to load its ID number and some operating parameters from the SD card inserted in the card slot of the controller module. The essential configuration information is given in the file SAFEZEN.TXT, which you must prepare before first use. The contents of the SAFEZEN.TXT file are given below.

2.1 - Startup configuration

When the Zen starts up, it attempts to load its configuration information from the SD card. If there is no card in the slot, the Zen will show "SD card notification" on screen. You have the option to continue in minimal mode (top right menu button), or to load a card and restart (top left menu button).

In minimal mode, your Zen will display a warning highlighted in red on the Drive and Survey mode screens, "NO SD CARD INSERTED". You can still measure radiation, acquire time and position from the GPS module, but logging is not possible. (Fixed mode possible??)

2.2 - Preparing the SD card

The SD card must be formatted as a FAT32 file system. You can edit the SAFEZEN.TXT file with a text editor, or use the Zen's built-in configuration Web server to create a new file.

The SD card must be formatted as a FAT32 drive, the portable DOS format. Most new SD cards are already formatted but you may need to prepare yours with your operating system's disk formatting utility. Volumes larger than 2GB may give the controller trouble and you would need to partition the high capacity SD card to restrict the size of the volume. (CHECK THIS??)

2.3 - Create or modify SAFEZEN.TXT

The file SAFEZEN.TXT is a plain text file and must be edited with a text editor. On Windows, use the standard Notepad application or try the free Notepad++ editor. On MacOS, use Textedit but make sure that you keep the file as a "plain text" document (see the top level menu Format > Make plain text). Do not use a document editor such as MS Word or Google Docs.

While it is possible to write the SAFEZEN.TXT file from the built-in Zen configuration web server, the device ID must initially be written in the file. See the separate configuration section.

2.4 - Contents of the SAFEZEN.TXT file

The SAFEZEN.TXT file provides your Zen with its basic configuration. It can be edited on a desktop or laptop computer to provide the initial configuration, or it can be written from the Zen after configuring through the access point. For the web server configuration, see configuration web server.

• version=3.1.1 The version follows the "Major”, “Minor”, “Patch” convention. In a Major revision, the device operation changes significantly over the previous major version. In a minor revision, there are minor changes to the way the device operates. In a patch, there are no visible changes, but some software defects have been corrected.

• device_id=5nnn The device identification number. Safecast bGeigie Zens are numbered 5001 to 5999. The number was assigned when your Zen kit (or completed unit) was sent to you. Please do not change the ID.

• api_key=20_CHARACTER_API_KEY Safecast API key to submit measurements directly over the network. Obtain yours from the Safecast API web pages.

• access_point_password=safecast The password to log into the Zen configuration access point (leave as default).

• wifi_ssid=MY_WIFI_NETWORK The WiFi wireless network to connect to the Internet. This is the same network name that your laptop or smartphone would use. Note: for mobile use, make this network the "hot spot" from your mobile phone.

• wifi_password=MY_SECRET The password the Zen requires to connect to the Internet through WiFi. This is the same password that your laptop or smartphone would use on this network.

• alarm_threshold=0 The threshold of counts per minute (CPM) averaged over ?? Seconds at which an alarm would sound. See the Radiation Measurements page for details.

• fixed_latitude=+-DD.dddddd Latitude of location for Fixed mode operation, as degrees and up to 6 decimals, in the range +- 90 degrees. In the web server configuration menu, you have the option of using the last known location.

• fixed_longitude=+-DDD.dddddd Longitude of location for Fixed mode operation, as degrees and up to 6 decimals, in the range +- 180 degrees. In the web server configuration menu, you have the option of using the last known location.

• fixed_range=0.500000 In Fixed mode operation, (WHAT DOES THIS MEAN IN OPERATION??)