Cypress Web Application Ver 02.04.3

User Help (WGRSiteID xx)

 

Welcome to the WGR Web Application. From this application the user can monitor, configure, add and delete nodes in addition to seeing all data sent from the WGR (Wireless gauge reader), WTR (Wireless Transducer reader) and WMR (Wireless Magnehelic Readers). Once the user has logged in to the application, the following screen (Figure 1) is displayed:

 

 

            Figure 1

 

The tabs across the top of the page give the user access to the various capabilities such as: Readings, Node Config, Node Status, SMS Alarms, Graph, Table and Help.  Additionally, Alarm History is available from any page by selecting the Alarm Status button.  From there the user can also reset the Alarms.

 

Readings

 

Figure 1 represents the default main page designed to summarize the latest reading of all nodes. Readings are based on a percentage of full scale determined from the “MinValue” and “MaxValue” on the Node Config page.  If the “MinValue” and “MaxValue” are not set up correctly, the “Reading” value may be incorrect. If the node is set up as a binary node, the “Reading” column will display “Off”, or “False” or “Inactive” (depending on what was set up in the Node Config Page) if the reading value is 0 and “On” or “True” or “Active” if the reading value is greater than 0. If a Node reading exceeds the user specified limit, the Alarm Status button at the top right area of the screen will turn Red.  Individual nodes may have a different status based on the reading values.

 

 

Status Column Detail

Error

Reported by WGR. Row is highlighted in red

Verify

If Node readings have not changed in past 2 days the row is highlighted in yellow. 

By default this feature is disabled. To enable this feature contact Cypress Systems field service group by sending an email to fieldservice@cypress.com

Upper Ctr Limit (UCL)

If the reading for the UCL limit exceeds the limit for the node set by the user, the row is  highlighted in orange

Lower Ctr. Limit (LCL)

If the reading for the UCL drops below the limit for the node set by the user, the row is  highlighted in orange

OK

This is the default status of the Node.  The row is not highlighted

Inactive

If a Node ID is configured on the WGR server but there no physical node with that ID is installed, the row is highlighted in gray.

 

 

 

 

 

Figure 2

 

 

 

Node Config

 

Figure 2

 
This screen (Figure 2) displays all the nodes visible to the server. This is a password protected screen and requires the Admin password to edit this page.

 

From this screen, additions and deletions can be done for individual or multiple nodes. Use the box at the top (Figure 2) of the Node list to add or delete nodes. To edit individual node information locate the node number in the NodeID column and click on Edit on the left of the node number to open “Node Config Dialog”. The Ok button must be clicked to save the newly edited fields. Select the right device type WGR or WTR by selecting appropriate radio button.  Close Cancel Button will ignore all the changes made.

 

Figure 3 shows the Node Config Dialog screen during an edit.

 

Check box to set SMS alarms

 
 

Figure 3

 

Node Config Dialog Detail

NodeID

NodeID of the Device

Device ID

This column displays a unique identifier for a WTR device.  If the user does not input a value, the default is the NodeID number

Description

A basic description of the node.

Unit

Unit of measurement for each Gauge. The user will either specify the type of measurement such as PSI, H2O, Inch, LBS, or a binary type (TRUE/FALSE, ON/OFF or ACTIVE/INACTIVE).  In case of Binary unit type the Unit column display is empty in the Readings page.

MinValue

This value is the minimum number on the gauge

MaxValue

This value is the maximum number on the gauge

Lower Control Limit (LCL)

This is a specified lowest allowable value.  If the node reading drops below this number, an alarm condition is created.

 

Upper Control Limit (UCL)

This is a specified highest allowable value.  If the node reading rises above this number, an alarm condition is created.

SMS Alarm

This field must be checked for the SMS alarm to be activated for the node.  If a limit is exceeded, and the SMS Alarm box is checked for the node, an SMS Text message and/or email will be sent to all SMS Alarm recipients.

Alarm Control Limit

This is the number of consecutive times the node data limit has is exceeded  before an SMS and/or Email notification is sent. (Only works when SMS Alarm is checked)

Precision

Precision is used to set the number of decimal places to display on the readings page.  If no precision is used, decimal places will be displayed depending on how large or small the reading value is at the time.

 

Node Detail

If a binary value was used in the “Unit” column, the type of binary is displayed in this column.  Additionally, in applications requiring a delta reading between two existing nodes a virtual delta node can be configured. Values for the delta nodes are computed based on the delta logic specified and are updated whenever the existing nodes change.  In Figure 2, NodeID 13 is a delta node of NodeID 11 and NodeID 12. The Min and Max value for the Delta node will computed automatically based on previous nodes.

 

WTR  Configuration – Log Scale

Select this check box if the engineering reading needs to be calculated in Log scale

WTR Type

Select the proper WTR type for the device

Node Math function

Select this for the Steam Trap node. Enter Node1 and Node2 that will be used to calculated reading for new node. E.g. Node3 = Node1-Node2

Sensor Responsivity -

Volts or mA1, Volts or mA2, Value1, Value2

Select this to calculate slope and intercept values in y= mx+B

Enter these readings for calculating the slope and intercept. This will be used later to calculate the Min and Max values and engineering reading. These can be either noted down from the data sheet or the actual reading from the device. E.g. For WTR type 0-10 V, Volts1 = 0, Volts2 =10.35, Value1 = 0.0001, Value2 = 1000

Volts or mA2

 

One Point Calibration – Value Measured ,

Value desired, Cold junction

Use this to apply the offset correction value to the ADC readings. . e.g. Temp measured might be 40 C. And user might say the right temp is 45C. Then enter the inputs here to calculate the gain constant (correction factor) that is used internally for the correction

Close

Don’t save any data, just close dialog

Enable Verify

Check this box if want to enable the Verify Status for the Node. If Node data is not changed in last two days then Node status is displayed as Verify.

Sensor Type

Select this for  to specify the right sensor type. Based on the readings select the sensor type. E.g. in case of Freezer WTR, reading1 is current sensor1 and sensor type is OPT1-2, Reading2 is current sensor2 and the sensor type is OPT1-2, Reading3 is Thermocouple and sensor type is Thermocouple Type-K, Reading4 is Door switch, can be set to OPT1-2. For Binary unit type sensor type is ignored.

 

 

 

Click on  to see the Log of changes in Node Config page.

 

 

Node Status

 

This read-only screen (Figure 4) displays the status conditions of nodes configured on this server and can be used to view the battery status.  Nodes that do not use batteries, will also be displayed showing a battery status, but this value can be ignored.

 

Figure 4

 

Figure 4

 

SMS Alarm

 

Once the box “SMS Alarm” is checked for one or more nodes on the Node Configuration page, the user can configure which devices will receive those alarms using this page (Figure 5).

 

            Figure 5

 

These alarms can be sent to any device capable of receiving an SMS message or email.  This screen allows the user to specify any and all devices that will be receiving the alarm notification. Based on these settings, when an alarm condition occurs, an alarm SMS message is sent to the listed cell numbers, and an email is sent to the listed email addresses.

 

Alarms must be reset after they are triggered.  This mechanism is designed so that recipients do not receive constant alarm messages.  Clicking on the red “Alarm Status” tab from any screen takes the user to the WGR Alarm History page.  The alarm is reset from here by clicking on the green “Alarm Reset” button.

 

To add a recipient’s SMS capable device, enter the phone number (e.g. 15554443333) and select “Add” button. Area codes and the “1” prefix are required on all phone numbers.  Click on “Edit” to edit the name, number, or email of the recipient. Then click on “Update” to save the values. To add an email only for a recipient, a “1” must be entered into the “Phone#” field.

 

To use SMTP server for sending email notification, click Edit on the “WGR cell phone SMS Alarms configuration” table. Specify the SMTP Server name (e.g. mailhost.mis.mycompany.com), SMTP port (e.g. 25). Only if Credential’s are required to access the SMTP server then specify the UserID, Password and Domain name. Then click on “Update” to save the data. (Figure 5a)

 

Figure 5a

 

SMS commands. 

 

From an authorized text messaging device enter the SMS phone # 32075.  From there the user can enter any one of the commands listed below to query the server remotely.  An authorized text messaging device is one that has been added to the SMS Alarm page for the specific site.

 

 

Command

Function

CYWGR ?AS?SiteID#,NodeID

Find Node status for specified NodeID

CYWGR ?TR?SiteID#,NodeID

 

Get Node reading for specified NodeID

CYWGR ?AR? SiteID#,NodeID 

 

Reset Alarm for specified NodeID

CYWGR ?TH? SiteID#,NodeID,hh

 

Get Node history for specified NodeID in Last hh Hour

CYWGR ??SiteID

SMS command Help

 

 

Always remember to have site ID in the SMS command.

Click on  to see log of changes in the SMS page.

 

If  AT&T 875U cell modem is connected to the Blue box server for SMS communication then use the SMS command as listed below -

Command

Function

?AS?NodeID

Find Node status for specified NodeID

?TR?NodeID

 

Get Node reading for specified NodeID

?AR?NodeID 

 

Reset Alarm for specified NodeID

?TH?NodeID,hh

 

Get Node history for specified NodeID in Last hh Hour

??

SMS command Help

 

 

 

 

 

Graph

 

This screen (Figure 6) is used to display WGR nodes data in graphical format. Here users can view nodes data between “Start Date” and “End Date”.  The date format is both date and time expressed as “m/dd/yyyy hh:mm:ss: AM or PM”. User specifies which Node ID(s) to be displayed. User can select any node from the dropdown list or enter node id(s)  in “Node ID for Graph” field. E.g. 1 or 1,2,5,9 or 1-5,9,20 Check “select All Nodes” to load all the node ids into the “Node ID for Graph” field.  To graph click “Show Graph”.

 

Graphing options include:

Auto Scale

The graph will automatically scale based on values.  By default, this is selected.  To turn off auto scale, uncheck the checkbox, and the “Min” and “Max fields will enable

Min

If auto scale is turned off, the user must specify the min Y value on the graph

Max

If the auto scale is turned off, the user must specify the max Y value on the graph

Y-Axis Zoom

Allows the user to zoom into data on both the x and y axis.  By default all zooming occurs only on the x axis

Tooltip

This allows the user to see the actual reading value on the graph by hovering the mouse pointer over a point on the graph. By default this option is turned off to speed up graphing time

Update

If graphing options have change, the user may click the “Update” button for the changes to take effect on the graph

Reset Zoom

Resets the graph back to the default view (no zoom)

Log

Check this for log scale on y-Axis

 

When graphing multiple nodes, nodes will be from highest reading value to lowest readings value in the legend.  To improve graphing performance, values may be removed for very large sets of data e.g. several months worth of data.  To ensure all points are graphed, the user may need to adjust Start Date and End Date.  To zoom into data on the graph, using the mouse pointer, left click and drag the desired zooming area.  By default, zooming occurs in the x direction only.  To zoom in on the y axis as well, the user must select “Y-Axis Zoom”

 

6a – Multi channel graph

 

Figure 6b – Muti channel graph

 

 

 

 

6c – One channel graph

Table

 

This screen (Figure 7) will display node data in table format with the following parameters.

Timestamp:  Timestamp of data reading

Node ID:  The unique ID number of the WGR node

Description: The name of the node

Reading:  The value read by the WGR. In case of WTR device data is converted to volt.

Units:  The units of the gauge (e.g. PSI)

Above UCL:  Indicates if an over-limit alarm occurred

Below LCL:  Indicates if a below-limit alarm occurred

LCL:  The lower control limit (LCL) value

UCL:  The upper control limit (UCL) value

Battery status:  The battery voltage

 

User can export data using “ExportToExcel” option and save it in a local machine as .xls format.

Figure 7

 

Alarm History Page

Here the user can see a list of all past alarms (Figure 8). Click on “Alarm Status” button in the upper right section of any page  to bring up the Alarm History page.  This page will provide the user with a list of all past alarms for the node(s) specified, within the time specified.

 

Figure 8

 

Alarm Reset

When a limit has been exceeded the amount of times specified in the “Excursion Limit” field on the Node Config page, and SMS Alarm has been enabled for that node, the alarm will trigger and send an SMS Text alarm or email alarm to specified recipients.  Once this occurs, the specified SMS/Email recipients will no longer receive alarm notices for these particular nodes.  In order to start receiving alarm notifications again, the user must reset the alarm via the Alarm Reset Page (Figure 9) by clicking on the “Alarm Reset” Button from the “Alarm Status” page. Click on “Reset all” button to reset all the node alerts. To reset alarms for individual nodes, find the node in the list, click “Edit” then uncheck the box for the alarm that triggered, then click “Update” to save changes.

Figure 9

 

Technical Support

 

Cypress Systems

198 Champion Court, San Jose, CA 95134.

 

Jim Davis – (408) 529-1945

Robert Brill – (310) 869-8677

 

fieldservice@cypress.com