GeoNet Acquisition
Agent
User’s Manual
No part of this instruction manual may be reproduced, by any means, without the written consent of Geokon, Inc.
The information contained herein is believed to be accurate and reliable. However, Geokon, Inc. assumes no responsibility
for errors, omissions or misinterpretation. The information herein is subject to change without notification.
Copyright © 2016 by Geokon, Inc.
(Doc Rev B, 11/3/2016)
Warranty Statement
Geokon, Inc. warrants its products to be free of defects in materials and workmanship, under normal use
and service for a period of 13 months from date of purchase. If the unit should malfunction, it must be
returned to the factory for evaluation, freight prepaid. Upon examination by Geokon, if the unit is found
to be defective, it will be repaired or replaced at no charge. However, the WARRANTY is VOID if the
unit shows evidence of having been tampered with or shows evidence of being damaged as a result of
excessive corrosion or current, heat, moisture or vibration, improper specification, misapplication, misuse
or other operating conditions outside of Geokon's control. Components which wear or which are damaged
by misuse are not warranted. This includes fuses and batteries.
Geokon manufactures scientific instruments whose misuse is potentially dangerous. The instruments are
intended to be installed and used only by qualified personnel. There are no warranties except as stated
herein. There are no other warranties, expressed or implied, including but not limited to the implied
warranties of merchantability and of fitness for a particular purpose. Geokon, Inc. is not responsible for
any damages or losses caused to other equipment, whether direct, indirect, incidental, special or
consequential which the purchaser may experience as a result of the installation or use of the product. The
buyer's sole remedy for any breach of this agreement by Geokon, Inc. or any breach of any warranty by
Geokon, Inc. shall not exceed the purchase price paid by the purchaser to Geokon, Inc. for the unit or
units, or equipment directly affected by such breach. Under no circumstances will Geokon reimburse the
claimant for loss incurred in removing and/or reinstalling equipment.
Every precaution for accuracy has been taken in the preparation of manuals and/or software, however,
Geokon, Inc. neither assumes responsibility for any omissions or errors that may appear nor assumes
liability for any damages or losses that result from the use of the products in accordance with the
information contained in the manual or software.
TABLE OF CONTENTS
1. INTRODUCTION..................................................................................................................... 1 2. SOFTWARE INSTALLATION AND SETUP ...................................................................... 1 2.1 MINIMUM SYSTEM REQUIREMENTS ........................................................................................ 1 2.2 PROGRAM DOWNLOAD........................................................................................................... 1 2.3 AGENT SOFTWARE INSTALLATION ......................................................................................... 1 3. NETWORKS ............................................................................................................................. 2 3.1 ENTERING A NETWORK ADDRESS .......................................................................................... 2 3.1.1 Direct Connection Using a USB or RS232 Cable ......................................................... 2 3.1.2 Connecting Wirelessly via a Networked Device ............................................................ 4 3.2 MAKING THE CONNECTION ..................................................................................................... 5 3.3 NETWORK SETTINGS .............................................................................................................. 6 3.4 ADVANCED NETWORK SETTINGS ........................................................................................... 9 3.5 ADDING NETWORKS ............................................................................................................. 11 3.6 NETWORK DOWNLOAD ........................................................................................................ 12 3.6.1 Data Storage ................................................................................................................ 12 3.6.2 Automatic Download ................................................................................................... 13 3.6.3 Manual Download ....................................................................................................... 13 3.7 DELETING A NETWORK ........................................................................................................ 13 3.8 TRANSFERRING NETWORK DATA ......................................................................................... 14 4. DEVICES ................................................................................................................................. 15 4.1 DEVICE SETTINGS ................................................................................................................ 17 5. CHARTS .................................................................................................................................. 18 5.1 ADDING CHARTS .................................................................................................................. 18 5.2 REMOVING CHARTS ............................................................................................................. 19 5.3 SENSORS .............................................................................................................................. 19 5.3.1 Adding Sensors............................................................................................................. 19 5.3.2 Deleting Sensors .......................................................................................................... 19 5.3.3 Sensor Settings ............................................................................................................. 20 5.4 ALERTS TAB......................................................................................................................... 23 5.5 VIEWING CHARTS ................................................................................................................ 23 5.6 LIVE CHARTS ....................................................................................................................... 26 5.6.1 Adding Alerts ............................................................................................................... 27 5.6.2 Alert Settings ................................................................................................................ 28 5.6.3 Clearing Alerts ............................................................................................................. 30 5.7 CHART SUMMARY ................................................................................................................ 30 6. EXPORTING DATA .............................................................................................................. 31 6.1 AUTOMATIC EXPORT ........................................................................................................... 31 6.2 MANUAL EXPORT ................................................................................................................ 32
APPENDIX A. TROUBLE SHOOTING.................................................................................. 33 A.1 UNIT WILL NOT RESPOND TO COMMUNICATIONS. ................................................................ 33 A.2 NO DATA FOR VIBRATING WIRE GAGE ................................................................................. 33 A.3 VIBRATING WIRE GAGE READING IS UNSTABLE ................................................................... 33 A.4 THERMISTOR MEASUREMENT SHOWS -273.15 DEGREES CELSIUS ........................................ 33 A.5 NODE HAS WEAK COMMUNICATION..................................................................................... 33 A.6 NODE WILL NOT SYNCHRONIZE WITH NETWORK.................................................................. 34 A.7 NOT RETRIEVING DATA WHEN CLICKING “DOWNLOAD NOW” BUTTON ............................... 34 A.8 WHEN IN THE SETTINGS THE “CURRENT NETWORK TIME” SAYS “CANNOT CONNECT”....... 34 A.9 CLICKING “GET NETWORK SETTINGS” BUTTON RESULTS IN “THE OPERATION HAS TIMED
OUT” OR “ACCESS IS DENIED” MESSAGE. ................................................................................... 34 A.10 CANNOT NAVIGATE IN THE USER INTERFACE ..................................................................... 34 APPENDIX B. CEFSHARP LICENSE .................................................................................... 35 TABLES
TABLE 1 - DESCRIPTION OF NETWORK SETTINGS BOX ..................................................................... 7 TABLE 2 - DESCRIPTION OF NETWORK TIME BOX ............................................................................ 7 TABLE 3 - DESCRIPTION OF AUTOMATIC DOWNLOAD BOX.............................................................. 8 TABLE 4 - NETWORK LIST .............................................................................................................. 11 TABLE 5 - ARRAYS PER DAY AT EACH SAMPLE INTERVAL ............................................................ 12 TABLE 6 - DEVICE LIST DETAILS ................................................................................................... 16 TABLE 7 - SENSOR BANNER OPTIONS ............................................................................................ 20 TABLE 8 - SENSOR SETTING UNDER THE INFO TAB ........................................................................ 21 TABLE 9 - CALIBRATION SETTINGS UNDER THE INFO TAB............................................................. 22 TABLE 10 - CHARTS SCREEN DETAILS ........................................................................................... 24 TABLE 11 - ALERT SETTINGS ......................................................................................................... 28 TABLE 12 - CHART SUMMARY SETTINGS ....................................................................................... 30 TABLE 13 - AUTOMATIC DOWNLOAD SETTINGS ............................................................................ 32 FIGURES
FIGURE 1 - ADD NEW NETWORK...................................................................................................... 2 FIGURE 2 - ENTERING COM PORT .................................................................................................... 3 FIGURE 3 - COM PORT LIST ............................................................................................................ 3 FIGURE 4 - USB PORT EXAMPLE...................................................................................................... 3 FIGURE 5 - ADD NEW NETWORK...................................................................................................... 4 FIGURE 6 - ENTERING AN IP ADDRESS ............................................................................................. 4 FIGURE 7 - POPULATED SERIAL NUMBER ......................................................................................... 5 FIGURE 8 - NETWORK LIST............................................................................................................... 6 FIGURE 9 - NETWORK SETTINGS ...................................................................................................... 6 FIGURE 10 - NETWORK SETTINGS BOX ............................................................................................ 7 FIGURE 11 - NETWORK TIME BOX ................................................................................................... 7 FIGURE 12 - AUTOMATIC DOWNLOAD BOX ..................................................................................... 8 FIGURE 13 - PASSWORD DIALOG ...................................................................................................... 9 FIGURE 14 - ADVANCED SETTINGS .................................................................................................. 9 FIGURE 15 - NETWORK LIST........................................................................................................... 11 FIGURE 16 - MANUAL DOWNLOAD ................................................................................................ 13 FIGURE 17 - DELETE NETWORK ..................................................................................................... 13 FIGURE 18 - TRANSFERRING A NETWORK ....................................................................................... 14 FIGURE 19 - SELECTING A NETWORK ............................................................................................. 15 FIGURE 20 - DEVICE LIST ............................................................................................................... 15 FIGURE 21 - COLUMN SORTING OF THE DEVICE LIST ..................................................................... 16 FIGURE 22 - DEVICE SETTINGS ...................................................................................................... 17 FIGURE 23 - NODE TYPE OPTIONS.................................................................................................. 17 FIGURE 24 – CHART SETTINGS ....................................................................................................... 18 FIGURE 25 - SENSOR LIST ............................................................................................................... 18 FIGURE 26 - EDIT SENSOR NAME ................................................................................................... 19 FIGURE 27 - SELECT SENSOR TO BE DELETED ................................................................................ 19 FIGURE 28 - SENSOR SETTINGS ...................................................................................................... 20 FIGURE 29 - LINEAR EQUATION ..................................................................................................... 22 FIGURE 30 - POLYNOMIAL EQUATION ............................................................................................ 22 FIGURE 31 - CHARTS SCREEN ........................................................................................................ 23 FIGURE 32 – CHART OPTIONS ........................................................................................................ 24 FIGURE 33 - SENSOR HISTORY ....................................................................................................... 25 FIGURE 34 – LIVE CHARTS ............................................................................................................. 26 FIGURE 35- SINGLE DATA POINT VIEWER ..................................................................................... 27 FIGURE 36 – ALERT TAB ................................................................................................................ 27 FIGURE 37 - TYPE CHOICES............................................................................................................ 27 FIGURE 38 - ALERT SETTINGS ........................................................................................................ 28 FIGURE 39- ALERT EXAMPLE ......................................................................................................... 28 FIGURE 40 - ACTIVE ALERTS ......................................................................................................... 29 FIGURE 41 – ALERT DETAIL........................................................................................................... 29 FIGURE 42 – CHART SUMMARY ..................................................................................................... 30 FIGURE 43 - EXPORT PAGE............................................................................................................. 31 1
1. INTRODUCTION
GeoNet Acquisition Agent is a software program designed specifically for use with Geokon’s
GeoNet wireless sensor network. It is used to configure GeoNet networks, as well as to collect,
display, and manage data. Throughout this manual the program will be referred to as “Agent.”
2. SOFTWARE INSTALLATION AND SETUP
2.1 Minimum System requirements
Before installing Agent, verify the computer meets these minimum system requirements:
-Microsoft Windows® 7, 8, or 10, running a 32 or 64 bit operating system.
-1 GB of free RAM (physical memory) available during runtime.
-.NET Framework 4.0 installed. (If this is not currently installed in Windows, perform a
Windows update to ensure there are no problems during software installation.)
2.2 Program Download
The program installer can be downloaded from: http://www.geokon.com/Software
Select the appropriate installer based on the operating system of the computer to which Agent
will be downloaded1:
8800 GeoNet Agent Software (x64) for a 64-bit system
8800 GeoNet Agent Software (x86) for a 32-bit system
2.3 Agent Software Installation
Once the Agent file has been downloaded onto the computer, click on the file to begin the
installation. Read the License Agreement in its entirety. If you agree to the terms put forth in the
License Agreement check the box next to “I accept the terms in the License Agreement”.
(Note: This box must be checked to continue with the installation.)
Click
.
A status bar will appear. It may take several moments to install the program onto the computer.
Click
to complete the installation and exit the Setup Wizard.
To determine whether a computer is running a 32-bit or 64-bit version of Windows, use a web browser
to navigate to the following address: https://support.microsoft.com/en-us/kb/827218 or navigate from
the start menu to Computer->System Properties
1
2
3. NETWORKS
A network consists of a certain number of Nodes, as well as one Supervisor, all communicating
on the same channel. There is no set limit to the amount of networks which Agent can
communicate with.
It is assumed that all relevant GeoNet hardware has already been installed, and that
communication has been established between the Nodes and the network Supervisor. For
information regarding installation of GeoNet Nodes and Supervisors please consult the GeoNet
System manual. (GeoNet user manuals may be accessed from agent via the internet by clicking
on the
in the top right hand corner of the screen.)
3.1 Entering a Network Address
On initial startup there will be a notification banner stating that no networks have been defined.
In order to add a network, agent must be linked with the Supervisor of that network. There are
two options for connecting a GeoNet Supervisor to a computer:


For a direct cable connection using a USB or RS-232 cable, see Section 3.1.1
To connect through a networked device such as a serial server or cellular modem, see
Section 3.1.2.
3.1.1 Direct Connection Using a USB or RS232 Cable
Connect the cable to the Supervisor and to the computer; allow the device drivers to
install (if applicable). Click
(Figure 1).
Figure 1 - Add New Network
3
Enter “COM” into the Network Address field. Agent will provide a list of available COM
ports. Choose the correct port from the list (Figure 2) or type in the full name of the
desired COM port. Once the network address had been entered continue to Section 3.2. If
unsure of which COM port the Supervisor is utilizing see below.
Figure 2 - Entering COM port
To determine which COM port the cable is plugged into:

For RS-232:
In most instances the network address will be COM1.

For USB:
1) Unplug the USB cable from the computer.
2) On the PC, go to “Control Panel” then “Device Manager”.
3) Click on the triangle to the left of “Ports (COM & LPT)” to expand the list (Figure 3).
Figure 3 - COM Port List
4) Plug the USB cable into the computer.
5) A new port will appear on the list. The network address will be shown in parentheses.
In the example below the network address is COM9.
Figure 4 - USB Port Example
4
3.1.2 Connecting Wirelessly via a Networked Device
Click
(Figure 5).
Figure 5 - Add New Network
Enter the device URL or IP address into the “Network Address” field (Figure 6). An IP
address must contain a colon after the address, followed by the port. (I.e.
192.168.1.1:5555).
Figure 6 - Entering an IP Address
(If connecting wirelessly to the computer with a serial server or cellular modem, it may
be necessary for the network administrator to set the IP address for local networks.
Cellular modems will usually have a static IP address designated by the carrier.)
5
3.2 Making the connection
Once the network address has been entered, click
. Agent will now
attempt to connect to the Supervisor of the network. Once a connection has been established the
“serial number” field will be populated with the serial number of the Supervisor (Figure 7).
Figure 7 - Populated Serial Number
Click
. Agent will apply the current settings and navigate to the “Device List” screen.
(For information regarding the Device List see Section 4.) Once the network settings have been
saved the network time will be automatically set and the network will begin collecting data.
If Agent fails to establish a connection, a message will appear indicating this, and give the reason
for the failure if available. Should this occur, make sure the network address is correct, the
device is powered, and the cable connection is secure, then try again.
6
3.3 Network Settings
To edit network settings, navigate to the “Network List” screen by clicking on
the GeoNet logo at the top of the screen (Figure 8).
under
Figure 8 - Network List
Next, click on the
which corresponds to the name of the network to be edited. Or, if the
network is already selected, click
on the left side of the screen (Figure 9).
Figure 9 - Network Settings
Refer to Figure 10 through Figure 12 and the accompanying tables for information on the various
network settings available.
7
Figure 10 - Network Settings Box
Label
Name
Network Address
Serial Number
Scan Rate
Deploy Period
Description/Notes
Description
Optional field to name the network.
COM port or IP/URL with port number. See Section 3.1.
Loads Serial Number, Scan Rate, Deploy Period, and Current Network
Time from Supervisor.
Static field showing the serial number of the Supervisor.
The interval at which the Supervisor collects data.
How long the network will remain in deployment mode. For
information on deployment mode see the GeoNet System manual.
Optional field for any other network information.
Saves current settings within the “Network Settings” box.
Table 1 - Description of Network Settings Box
Figure 11 - Network Time Box
Current Network
Time
Read only field. Displays after pressing the “set network time” or “get
network settings” buttons.
Forces the current PC time and time zone to be written to the network.
See Section 3.4.
Table 2 - Description of Network Time Box
8
Figure 12 - Automatic Download Box
Automatically
download data from
this network
Download at a
scheduled interval
Download at
specified Times
Uncheck the box to disable automatic download. Data will only be
downloaded upon Manual download. See Section 3.6 for more
information.
Select this option to have data downloaded at a regular interval. The first
download will occur at the specified “Start time:” and will recur at the
interval entered in the “Download data every __ minutes” field.
Select this option to set specific times of the day for the data to be
downloaded. Click inside the box next to the left of the
symbol, select
a time, and then click on the
symbol to add it to the list of “Download
times”. To remove a download time from the list click on the
next to
the time to be removed.
Saves Automatic Download information only.
Returns Automatic Download settings to their previously saved
configuration.
Table 3 - Description of Automatic Download Box
9
3.4 Advanced Network Settings
The Advanced Settings button in the Network Settings screen allows the user to edit the internal
settings of the Agent program. These options will affect the entire program; they cannot be set
for individual networks.
Access to the settings is password protected. Click
password dialog (Figure 13).
to bring up the
Figure 13 - Password Dialog
The Administrator password is the current date in six digit format: day/month/last two digits of
the year. For example, if the current day is the third of August 2016, then the Administrator
password would be: 030816
Once the correct password has been entered the Advanced Settings window will open (Figure
14).
Figure 14 - Advanced Settings
10
The “Owner” column refers to a specific part of the agent service, while the “Setting” column
contains settings that are applied to the owner. The “Value” column displays the value of the
current setting. Values can be numbers, text, or in some cases are selected from a drop down
box. If a setting is not allowed to be edited it will be displayed without a white box surrounding
it.
Saves any settings which have been changed to the database. No changes take effect
until the Save button is pressed.
Restores all settings to their default values. The
be pressed in order to save the default values to the database.
button must
Closes the Advanced Settings screen without saving any of the changes made.
For more information about the functions of the various advanced settings, contact Geokon.
11
3.5 Adding Networks
Once Agent has successfully connected to a network, that network will be added to the Network
List. This list can be accessed at any time by clicking on
under the GeoNet logo at
the top of the screen (Figure 15). For more information about the network list refer to Table 4.
To add a network, navigate to the network list and then follow the instructions in Sections 3.1
through 3.2.
Figure 15 - Network List
Column
Heading
Name
Settings
Description
Clicking on the name of the network will bring up the Device List. See Section
4.
Click on the
to bring up the settings for that network. See Section 3.3.
Download
Now
Click on the
to manually download data from the network. See Section
3.6.3.
Supervisor SN Static field showing the serial number of the Supervisor.
Address
COM port or IP/URL with port number. See Section 3.1.
The interval at which the network collects data. May be edited in Network
Scan Rate
Settings.
Download
Displays the frequency of data collection from the Supervisor. May be edited in
Rate
Network Settings.
Clicking on the will delete the corresponding network. Deleting a network
Delete
will erase ALL the data related to that network; use with caution.
Table 4 - Network List
12
3.6 Network Download
3.6.1 Data Storage
Data is stored in the Supervisor in a persistent “ring buffer”. The flash memory is very
large and will store approximately one million arrays, however, when the memory is full
the oldest data will start to be overwritten. If automatic download is turned off, data
should be collected on a consistent basis to prevent this from happening. To determine
how often data must be collected the following formula may be used:
1,040,000
∗
Where Days is the maximum number of days before data must be collected to prevent
loss. The Arrays per Day value is provided in Table 5.
Scan Rate in Minutes Arrays per Day
10
144
12
120
15
96
20
72
30
48
Scan Rate in Hours Arrays per Day
1
24
2
12
3
8
4
6
6
4
8
3
12
2
24
1
Table 5 - Arrays per Day at Each Sample Interval
13
3.6.2 Automatic Download
Data from the network will be automatically downloaded based on the interval set by the
“Automatic Download” field in the network settings. (See Section 3.3.)
3.6.3 Manual Download
To manually download data, navigate to the Network List (Figure 15) by clicking on
at the top of the screen.
Click on the arrow in the “download now” column which corresponds with the network
to be downloaded (Figure 16).
Figure 16 - Manual Download
Once the download has begun, a status bar will provide the number of readings available
from the Supervisor, as well as a percentage of completion. Only one network can be
downloaded at a time. It is not necessary to remain on this screen, the download will
continue regardless.
3.7 Deleting a Network
To delete a network, navigate to the Networks List (Figure 15) by clicking on
top of the screen.
at the
Click on the in the “delete” column which corresponds to the network to be deleted. Deleting a
network will erase ALL the data related to that network; use with caution.
Figure 17 - Delete Network
14
3.8 Transferring Network Data
Transferring a network moves all of the data for a single network from one GeoNet database to
another. This feature also allows the combining of multiple networks into the same GeoNet
database.
To Transfer a network, navigate to the networks screen by clicking on
GeoNet logo at the top of the screen. Then click on
(Figure 18).
under the
Figure 18 - Transferring a network
Choose the network to be transferred from the dropdown list under “Select Network”, then
click
. In the following screen select a location to save the network data.
(IMPORTANT NOTE: Transferred files must be saved to local drives only. This feature does
not support the uploading of files from network drives.)
Once a location is selected it will populate into the “Output Directory” field. Lastly, click
.
The name of the output file is automatically generated, and includes the network name, as well
as the date and time the file was created. The process of saving the network may take several
minutes, depending on the amount of data being saved
To load network data from a transferred file click the
button under the “Load
network from file” heading. Locate and select the file to be imported, then click
.
Confirm the transfer by clicking OK in the dialogue box that follows. As with saving, the load
process may take several minutes, depending on the amount of data contained in the file. Once
the file has been loaded enter the network address to set the network time and begin collecting
new data.
15
4. DEVICES
To view the list of Devices associated with a given network, click on
at the top of
the screen. Next, click on the name of the desired network in the Network List (Figure 19).
Figure 19 - Selecting a Network
This will bring up the Device List (Figure 20).
Figure 20 - Device List
16
Nodes are automatically detected and added to the network. The list may be sorted by clicking
on any of the column headers. Figure 21 shows the device list screen sorted by Signal Strength.
Refer to Table 6 for more information about the Device List.
(If a Node has been properly synchronized with the Supervisor, but does not appear in the
Device List, refer APPENDIX A. TROUBLE SHOOTING)
Figure 21 - Column Sorting of the Device List
Column Heading
Description
Node Type
Displays the type of device selected in Device Settings. See Section 4.1.
All devices are named “(Not Set)” by default. Clicking on the name of a
Name
node or supervisor will cause Agent to navigate to the settings for that
device. See Section 4.1.
Serial Number
Static field showing the factory installed serial number.
Displays the amount of time which has elapsed since the unit last
Last Reading
communicated with the network. Devices which have not communicated
within three times the set scan rate period will trigger an alert.
Battery Level
Shows the most recent data from each device both numerically and as a bar
And
graph. Devices with low battery or signal strength will trigger an alert.
Signal Strength
Charts
Displays how many charts have been created for that device.
Clicking on will remove the corresponding device. This will only hide the
device from being viewed. It will not remove the device from the network
Remove
or stop it from collecting data. If the device was deleted by accident it can
be rediscovered by either restarting the computer or restarting the Agent
service.
Indicated by a red box around the data which triggered the alert and a
message above the device list. Devices which have not communicated
within three times the set scan rate period will trigger a “Stale Data” alert.
Alerts
Devices with low battery or signal strength will trigger a “Battery” or
“Signal” alert.
Table 6 - Device List Details
17
4.1 Device Settings
Navigate to the Device List by following the instructions in Section 4. Click on the name of the
device to be edited. A new screen will open, defaulting to the “Charts” section. If no charts have
been created for the device, a yellow banner will be displayed across the screen stating this fact.
If the device has a chart(s) associated with it, it/they will be displayed in this screen.
Next click on
(Figure 22).
Figure 22 - Device Settings
The “Name” field is used to enter a descriptive name for the selected device, such as a number, a
geographical location, or the serial number of the unit.
The “Type” dropdown box works differently with Supervisors than Nodes. Supervisors do not
have any additional options for Type. Nodes have several options to choose from; as shown in
Figure 23.
Figure 23 - Node Type Options
Once the desired information has been entered click
20). Clicking on
to return to the Device List (Figure
will erase any changes made to the device settings since the last save.
18
5. CHARTS
Charts display data from sensors attached to an individual device. The device type will determine
the data that is available to be displayed. Data is displayed in a line graph with time as the X
axis.
5.1 Adding Charts
Choose a network then choose a device. Once a device has been selected click on
(Figure 24).
Figure 24 – Chart Settings
To create a chart click
. This will create a chart with the default name of “chart 1”.
The second time a chart is added it will be “chart 2” the third, “chart 3” and so on.
Clicking on the name of a chart will list the sensors associated with that particular chart (Figure
25).
Figure 25 - Sensor list
19
Once the sensor list has been opened the chart name can be modified by clicking
26).
(Figure
Figure 26 - Edit Sensor Name
5.2 Removing Charts
To remove a chart, select the chart to be deleted and then click
.
5.3 Sensors
Each sensor represents a line on the chart. Multiple sensors can be displayed on one chart.
5.3.1 Adding Sensors
Charts default with one sensor. To add more sensors click
.
5.3.2 Deleting Sensors
To remove a sensor from a chart, first click on the sensor to be deleted (Figure 27).
Figure 27 - Select Sensor to be Deleted
Then click
.
20
5.3.3 Sensor Settings
The settings of a sensor determine what information will be displayed on the chart. Click
on the desired sensor to bring up its settings (Figure 28).
Figure 28 - Sensor Settings
Refer to Table 7, Table 8, and Table 9 for information on the various sensor settings
available.
Label
Description
Save the current configuration. Current changes will be lost if this
is not pressed before leaving sensor settings.
Disregard all changes since last save.
Start/End Date
Series Color
Determines the date range of the data displayed on the chart. Leave
the end data empty until a sensor is removed from a device.
Choose a color to represent the sensor on the completed chart.
Table 7 - Sensor Banner Options
21
The Sensor portion of the
tab contains the following:
(Note: Hovering over a field in this section with the cursor will show additional
information.)
Label
Name
Serial Number
Mapping
Unit Category
Output Units
Description/Notes
Description
Optional friendly name for the sensor.
The serial number of the sensor. This is not necessary but is good
practice.
Determines the sensor data to be displayed. The available mappings
depend on the type of device selected.
Nodes which have been set to “8-CH Multiplexer” in device type
(refer to Section 4.1) will have multiple Reading and Thermistor
mappings, each with a number suffix assigned to them. These
numbers coincide with the channel to which the gage has been
connected.
The Units Category will control the output units available for
labelling the chart series. For all mapping categories except
“Reading”, there is a standard Unit Category which cannot be
changed. When mapping a reading the options are as follows: Default,
Pressure, Load, Distance, Strain, Temperature, and Tilt.
Controls the label used for the data on the chart and should match the
units given in the calibration sheet, unless the multiplier (C) is being
used to convert.
Enter any additional information if desired
Table 8 - Sensor Setting Under the Info Tab
22
The Calibration portion of the
tab is only available if the sensor Mapping is
set to “Reading” or “Thermistor.” It contains the following:
(Note: Hovering over a field in this section with the cursor will show additional
information.)
Label
Description
Applied after linear or polynomial calculation. Can be used to convert
Multiplier
units. Represented as CF in Figure 29 and Figure 30.
Applied after linear or polynomial calculations. Used to adjust for
Offset
offset. Represented as O in Figure 29 and Figure 30.
Temperature
Check this box to include “Thermal Factor” and “Zero Temperature”
Correction
in the selected equation.
Set to apply a temperature correction value. Represented as K in
Thermal Factor
Figure 29 and Figure 30.
When using the factory zero reading enter the temperature listed on
the bottom of the Geokon Calibration Report. When using an onsite
Zero Temperature
zero reading enter the temperature at which the field zero reading was
taken. Represented as T0 in Figure 29 and Figure 30.
Linear
Select to utilize the linear calibration formula (Figure 29).
Found on the Geokon Calibration Report provided with the
Linear Gage
instrument. Required for output in engineering units. See the
Factor
calibration report for the sensor or consult the sensor manual.
Represented as G in Figure 29.
The initial onsite zero reading or the factory zero reading if desired.
Zero Reading
Consult the sensor manual to perform a field zero. Represented as R0
in Figure 29.
Polynomial
Select to utilize the polynomial calibration formula (Figure 30).
Required for output in engineering units. Found on the Geokon
Polynomial Factor
Calibration Report provided with the instrument. Represented as A in
A
Figure 30.
Required for output in engineering units. Found on the Geokon
Polynomial Factor
Calibration Report provided with the instrument. Represented as B in
B
Figure 30.
Polynomial Factor Calculate by setting P=0 and R1= initial field zero reading into the
C
polynomial equation. Represented as C in Figure 30.
Table 9 - Calibration Settings Under the Info Tab
∗
∗
∗
Figure 29 - Linear Equation
∗
2
∗
∗
Figure 30 - Polynomial Equation
∗
23
5.4 Alerts Tab
The
tab is used to set alerts which will be displayed in Live Charts. For more
information on setting alerts see Section 5.6.1, Adding Alerts.
5.5 Viewing Charts
To view a chart, choose the desired device from the Device List (Figure 20) then click
(Figure 31).
Figure 31 - Charts Screen
(Note: The information in this screen will refresh only upon entering the screen. If more data has
been collected while viewing the screen, leave the Charts screen and return, this will update the
graph with the latest information. For continuously updated information see Section 5.6 Live
Charts.)
24
Refer to Figure 32 and Table 10 for more information on Charts.
Figure 32 – Chart Options
Arrow #
1
2
3
4
5
6
7
Description
Clicking on the chart name will list the sensors associated with that
chart. Clicking on the sensor name will open the History screen for
that sensor (Figure 33). The history screen has the same functions as
the charts screen but only displays data for one particular sensor.
Clicking allows the chart to be saved as one of three different file
types: PNG, JPEG, or SVG.
The date, time, and reading of any data point may be viewed by
holding the cursor over it.
Clicking on the sensor name will turn off the graph for that particular
sensor. Clicking on the sensor name once more will turn the graph
back on. In Figure 32, the sensor for Signal Strength, (which was
displayed as a red line in Figure 31) has been turned off. The sensor
name has been grayed out as a result.
Sliders which may be used to zoom in on a particular area of the
graph.
Start and stop time currently being diplayed by the graph. (These are
changed by moving the sliders described in 7.)
Sliders which determine the start date and time for the data displayed.
Table 10 - Charts Screen Details
25
Figure 33 - Sensor History
26
5.6 Live Charts
To open the Live Charts: Click on the name of the network at the top of the screen or select it
from the Network list (Figure 15). Next click on
(Figure 34).
Figure 34 – Live Charts
Live Charts displays data for all charts and sensors associated with a particular network. Unlike
the Chart and Sensor History screens, (Figure 31, Figure 32, and Figure 33) which do not update
while being viewed, Live Charts will update at regular intervals according to the automatic
download time assigned in Network Settings. If the automatic download is disabled, the live
charts will be static. (For information on Network Settings see Section 3.3.)
By default six hours of data will be displayed. To change the range of time displayed, use the
slider at the bottom of the screen. To zoom in on a particular area of the chart, use the sliders
directly below the graph. The area highlighted in blue will be displayed on the graph.
The date, time, and reading of any data point may be viewed by holding the cursor over it, as
seen in Figure 35.
27
Figure 35- Single Data Point Viewer
5.6.1 Adding Alerts
To create an alert to be displayed in Live Charts, navigate to the Device List (Figure 20),
then select the desired device. Next click
in the navigation pane on the
left side of the screen. Select the chart and sensor the alert will be created for, then click
on the
tab on the right side of the screen (Figure 36).
Figure 36 – Alert Tab
The “Type” dropdown box determines what will cause an alert to activate; there are
several options to choose from. (Figure 37) After selecting a type click on
alert.
Figure 37 - Type Choices
to add the
28
5.6.2 Alert Settings
Once an alert has been added the alert settings can be changed. Refer to Figure 38 and
Table 11.
Figure 38 - Alert Settings
Label
Value:
Sound an
Alarm
Custom
Message
Description
An alert will become active once the data has passed the threshold set by the value
field. The unit of the value is determined by the type of alarm selected.
Check this box to turn on an audible alarm for the alert. The alarm will sound when
a new alert is generated while viewing Live Charts.
Press to hear an example of the audible alarm.
Click to delete the current alarm
If desired, enter a message to be displayed when the alert has been activated. This
message, as well as the date, time, and value of the data which caused the alert,
may be viewed by holding the cursor over the yellow alert triangle in Live Charts.
(As seen in Figure 41.)
Table 11 - Alert Settings
Figure 39 is an example of a signal strength sensor with an alert set to activate if the
reading drops below 30 percent. The subsequent alerts in Live Charts are shown in Figure
40 and Figure 41.
Figure 39- Alert Example
29
Figure 40 - Active Alerts
Figure 41 – Alert Detail
30
5.6.3 Clearing Alerts
To clear an alert, click the
button located on the bottom left corner of the affected
chart. This will clear the alerts for that particular chart. Clearing all current alerts will
cause the red alert bar on the left side of the screen to turn green.
Exiting Live Charts will cause previously cleared alerts to reactivate.
5.7 Chart Summary
The Chart Summary screen controls which charts will be displayed on the Charts Screen (Figure
31) as well as in Live Charts (Figure 34). It can also be used to create templates which can be
used to copy the chart settings from one device to another. Chart settings can only be copied
between devices of the same Type. (See Section 4.1 for information on device type settings.)
To open the Chart Summary, select the desired device from the Device List (Figure 20), then
click
(Figure 42). Refer to Table 12 for more information on the Chart Summary.
Figure 42 – Chart Summary
Column Heading
Template Name
Apply Template
Attach
Chart
Sensor
Serial Number
Mapping
Description
Friendly name for the template.
Create a template to copy chart settings from one device to another.
(Device type must match.)
Apply a template created from another device to the one currently selected.
(Only available for templates created on devices with matching device
type.)
Check or uncheck the box to show or hide the corresponding chart in both
the Charts and the Live Charts screens.
Displays the chart name.
Displays the sensor types associated with the chart.
Displays the serial number of the sensors.
Displays the mapping type.
Table 12 - Chart Summary Settings
31
6. EXPORTING DATA
Exporting data can be done either manually or automatically. To export data, first navigate to the
network to be exported by clicking on the name of the network at the top of the screen, or by
choosing it from the Networks List (Figure 15). Next click
in the navigation pane on the
left side of the screen (Figure 43).
Figure 43 - Export Page
6.1 Automatic Export
The automatic export feature of Agent is designed to work with programs such as Vista Data
Vision®. The exported data file will be saved with a “.dat” extension; most computers will
require the user to choose a program with which to open the file. Data will be continuously
rewritten to the same .dat file except after adding or removing a Node, chart, or sensor; or
changing the sensor mapping, in such cases the previously written file will be updated with the
extension “.bad”. This is done to maintain the historical structure of the previous data. A new
.dat file will be created during the export cycle following the creation of the .bad file.
Fields for Automatic Exporting are explained in Table 13.
32
Label
Description
Applies the current settings to the network.
Disregards any changes not currently saved.
Include
Quotes
Interval
Units
Output
Directory
Contains everything between the delimiters with quotes. Regions that use
alternate date formats or commas as decimal points may require this for import
of the file into other programs.
This number, in combination with “Units”, determines how often the data is
exported.
Selects the unit of time to correspond with the number entered in interval.
Determines where the file will be saved. To set the Output Directory click
.
Table 13 - Automatic Download Settings
6.2 Manual Export
Manual exporting data causes an immediate, one time download of all data for a given date
range. The “Start Date” and “End Date” fields determine which dates will be exported.
To initiate the download, click
.
A progress bar will appear. Once the file has been exported choose a location to save the .csv file
and then click
.
The data for each Node or Supervisor will be displayed in the .csv file in sequential columns as
follows:
Chart 1 -> Sensor 1
Chart 1 -> Sensor 2
Chart 1 -> Sensor 3
Etc…
Chart 2 -> Sensor 1
Chart 2 -> Sensor 2
Chart 2 -> Sensor 3
Etc…
All columns have a header which lists the serial number of the corresponding device, followed
by identification of the sensor. For sensors mapping “Reading” or “Thermistor” the sensor
identification will be the sensor name, e.g., “1438029_VW Strain”. For all other types of mapping
the sensor identification will be the type of mapping selected, e.g., “1438029_Battery”.
33
APPENDIX A. TROUBLE SHOOTING
Listed below are a few commonly experienced problems and remedial action. Contact the factory
should a problem arise not explained herein, or if additional information is needed.
A.1 Unit will not respond to communications.
Wrong connection type or port specified in Agent.
The internal batteries of the Supervisor may be dead. Replace the batteries.
A.2 No data for vibrating wire gage
Using an ohmmeter, check the connections to the vibrating wire gage leads. Consult the
instrument manual for expected resistance between the gage leads. Remember to correct
for cable resistance (approximately 15 /1000' or 50 /km, double for both directions).
If resistance reads less than 100  the cable is probably shorted. If resistance reads
infinite or in the megohms range the cable is probably cut.
Check for a faulty or misconnected gage.
A.3 Vibrating wire gage reading is unstable
Is there a source of electrical noise nearby? Likely candidates are generators, motors,
arc welding equipment, high voltage lines, etc. If possible, move the transducer cable
away from power lines or electrical equipment.
A.4 Thermistor measurement shows -273.15 degrees Celsius
Indicates an open circuit to the thermistor leads. Check the connections from the
datalogger to thermistor leads. If okay, check the thermistor with an ohmmeter. It should
read between 10K ohms and 2.4K ohms (0 to +30 Celsius). If the thermistor reads
correctly, contact the factory to schedule the unit for repair.
A.5 Node has weak communication
If the signal indicated is consistently weak (red and green lights) but not intermittently red,
proceed with the installation. If the signal is frequently lost (red flash) it will be necessary to
improve it. Try to get the Node as high as possible with clear space around the antenna. Adding
cable to the sensor will enable moving the Node to a better location. A higher gain directional
antenna may be necessary. Contact Geokon for help.
34
A.6 Node will not synchronize with network
If the Node status light upon power up flashes red at one second intervals for more than three
minutes, the Node is not receiving a signal from the Supervisor. Make sure the Node is set to the
same radio channel as the rest of the network. Consult the GeoNet System Manual for
information about setting the channel. Reset the Node by holding down the status button for 10+
seconds until both lights turn on. Older Node versions require the batteries to be removed and
replaced for a reset.
A.7 Not retrieving data when clicking “Download Now” button
Verify that the network address is correct. If connected to a COM port, verify that the cable is
securely plugged into your computer and the Supervisor. If using a network connection, verify
that you can connect to the address by bringing up CMD prompt in windows. Then type “ping
address”, replacing address with the address of the network, then hit enter. If it returns responses
the connection should be stable.
A.8 When in the settings the “Current Network Time” says “Cannot Connect”.
Please repeat the same troubleshooting steps for sub Section A.7
A.9 Clicking “get network settings” button results in “The operation has timed
out” or “Access is denied” message.
Please repeat the same troubleshooting steps for sub Section A.7
A.10 Cannot navigate in the user interface
This is a known issue in the client user interface. Press the “ALT” key on the computer.
35
APPENDIX B. CEFSHARP LICENSE
Copyright © 2010-2016 The CefSharp Authors
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following disclaimer
in the documentation and/or other materials provided with the
distribution.
* Neither the name of Google Inc. nor the name Chromium Embedded
Framework nor the name CefSharp nor the names of its contributors
may be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.