User Tools

Site Tools


web:webclient

SatSCADA Web Client

The Web Client is used to access information from SAT1xx terminals using a smartphone or any computer with a browser. To connect to the SatSCADA Server:

  • Click this link https://satscada.com or enter it in the browser address bar.
  • Enter the username and password provided to you by Bentek.
  • Click the 'login' button.

A device list of all terminals in your account will be shown. Click a device list entry to get more information about it.

Click the Bentek logo in the upper left to go back to the home page that has a list of all terminals in your account. This is equivalent to selecting Device List from the menu.

In the upper right is an icon that will display a drop down menu. This is a context sensitive menu that will have different commands depending on the web page you are on. The menu items are:

Alarm Summary Shows the current alarm state of all tags for a selected terminal or for all tags in your set of terminals.
Alarm History Shows the transitions in alarm state of all tags for a selected terminal or for all tags in your set of terminals.
Map Displays the location of a selected terminal or the locations for all terminals in your account on a Google map.
Device List Lists the status and name of all the terminals in your account. This is equivalent to clicking the logo.
Email/SMS/Phone Opens the Email/SMS/Phone alarm notification management page. You need permissions to use any of these. Anyone in your company can be notified of alarms.
Tag View A list of all the tags configured in the terminal and the time the tag values were last sampled.
Trends Displays a chart consisting of a set of one or more tags.
Export Writes (time,value) pairs to a CSV file for one or more tags.
Diagnostics Displays a list of essential terminal parameters.
Demand Scan Forces an immediate call out from the terminal resulting in all tag values being updated.
Help Navigates to and opens this web page
Logout Exits the web client and returns to the login form

Device List

Lists the status, site name and device number of all terminals in your account. This is what is shown when you first log in. :!: The site name is what your company uses to refer to the terminal (e.g. name of truck or trailer it is mounted, or the name of the geographic location where it is installed, etc). You need to provide this to Bentek support and they will enter it into the satscada database. Click the site name to get details for the terminal.

The terminal status is a disc or square. A square is used for a terminal at a fixed location whereas a disc is used for mobile terminals. If the terminal has satellite enabled then a satellite icon is shown. If the terminal has cell enabled then a cell tower icon is shown with the RSSI next to it. The radio wave icon highlights whether the last transaction was via satellite or cell.

Hover over any of the icons to display a tool tip clarifying what the icon state is. The icons can have the colours in the following table.

Terminal Status

The circle and square icons have these colours and tool tips.

modem No tags configured on terminal, operating as a modem.
stale Tag data has not been updated recently.
no alarms The terminal has tags, but no alarms configured.
was alarm Comm are interrupted, but the last known state of the device was Alarming.
alarm The terminal is currently Alarming.
was ok Comm are interrupted, but the last known state of the device was OK.
ok The terminal is operating normally and no tags are in an alarm state.

Communication Status

The sat and cell icons have these colours and tool tips.

bypass No data can be transferred to or from the terminal.
bandwidth The daily or monthly bandwidth quota for the terminal has been exceeded. No operations are permitted until the permitted quota is updated by support or the next quota period occurs.
comm The communications channel to the terminal is broken. The network or the terminal is unavailable.
scan No data can be sent to the terminal but call outs can be received.
alarm The terminal is operating normally but at least one of the tags is in an alarm state.
ok The terminal is operating normally and no tags are in an alarm state.

Reset Data Limit (Bandwidth)

The sat and cell icons will become purple when a terminal reaches its data cap. A button to reset the data limit will also show up, which will clear the bandwidth flag and allow the terminal to communicate again.

:!: Note: additional charges may apply if you exceed the maximum pooled data for you account (sum of all terminals). This function may also be denied if the overage bytes requested exceeds the maximum allowed overage (equal to twice the total allowable data for the account). In this case, you will need to contact Bentek Support.

Email/SMS/Phone

Manage Email, SMS and Phone Notification lists. You can add as many of each as you need. Each entry is editable, can be enabled/disabled, and all include a Test function.

To test a notification, the Test button will send a single message to that recipient (Email, SMS or Phone). The time is recorded and the result will be shown when you refresh the page. For Email and SMS tests, a verification link is sent which the recipient can click to automatically validate the test. For Phone tests, a message is played prompting the user to press '2'.

Email

Enter an email address using Add Email button, or edit an existing one using Edit button at the left of the row. Copy can be TO, CC or BCC on the email notification.

These can be enabled/disabled with the Enable checkbox. Send-on-Alarm and Send-on-OK checkboxes determine if a notification is sent only on Alarm or on All-Clear as well. These are the same for SMS and Phone below.

SMS

This requires a Phone Number, and the Mobile Carrier. If the carrier isn't listed in the drop down, you may look up their email-to-sms address and append it to the phone number in the Address field.

Phone

The list of Phone numbers is a queue. Each number will be called in the order listed top to bottom, until the notification is acknowledged. The order can be rearranged using the Sequence number up/down arrows. Phone numbers that are not enabled will be skipped.

Enter a 10 digit phone number. If an extension is used, enter it in the Extension field. Description is simply used to identify the number in the list (typically name of recipient, but can be anything). Tries is the number of attempts to dial before moving on to the next number in the queue. Always-Call can be set to make sure this number is called every time there is an Alarm (or all-clear).

Tag View

A list of all the tags configured in the terminal and the time the tag values were last sampled (Tag Update Time, corresponds to the last callout). The Device Update Time indicates when the last time the Device either communicated successfully or failed to respond to a request. The Location of the device is also given with it's timestamp and details.

There are three columns: tag name, tag value, tag status. If the tag is digital the tag value will be a text string. This is usually ON or OFF but can be configured on the terminal. If the tag is analog then the tag value will be a number with units. The units are configurable on the terminal and may be blank. The tag status has one of the following values and colour:

<blank> The tag alarm has been disabled.
bypass The tag alarm is enabled but has been suppressed. That means the alarm value is calculated but not used to generate a call out from the terminal.
alarm The tag has alarm on.
stale The tag data has not been updated recently.
ok The tag has alarm off.

Alarm Summary

Shows the current alarm state of all tags for a selected terminal or for all tags in your set of terminals. The date and time of the last recorded tag alarm state is shown along with the name of the tag and the status. The status value is either alarm (red) or bypass (yellow).

Alarm History

Shows the transitions in alarm state of all tags for a selected terminal or for all tags in your set of terminals. The changes in state are over the last 24 hour period. The date and time of the tag alarm state transition is shown along with the name of the tag and the status.

The status value is the same as the tag view. Either ok (green), alarm (red), or disabled (blank).

Diagnostics

Displays a list of essential terminal parameters.

terminal # An integer number in the range 1 to 999 that uniquely identifies a terminal in your account.
device name A 32 character string that describes the location of the site or what is there.
comm check Date and time the communications to the terminal was last checked.
last callout Date and time tag values were last transferred from the device.
uptime The time duration since the terminal was last reset.
mobile id A 15 character serial number that is affixed to the bottom of each terminal.
temperature Ambient temperature of the terminal in degrees Celsius.
voltage Supply voltage of the terminal in Volts.
RSSI Cell signal strength
geo type Type of lat/lng. None, Manual, or GPS. Manual means these have been measured and entered into the SatSCADA database. GPS means these are obtained from the terminal.
lat/lng The latitude and longitude, in decimal degrees, of the site location.
grid type Type of grid coordinates. None, DLS, or BCNTS.
grid Grid coordinates.
mobile Indicates whether the terminal is mobile or in a fixed location.
alarm Current alarm state of the terminal tags. Either ok (green) or alarm (red).
comm Current status of the communications link between the terminal and the server. Either ok (green) or fail (red).
scan No data can be sent to the terminal but call outs can be received.
bandwidth The daily or monthly bandwidth quota for the terminal has been exceeded.
bypass No data can be transferred to or from the terminal.
sub-account # Call center account number sent if web service output is enabled.
serial flow thru Indicates whether the device can be accessed by the SatSCADA Client.
month max Maximum number of bytes that my be transferred to/from the terminal in a month.
month used The total number of bytes transferred to/from the terminal this month.
daily max Maximum number of bytes that my be transferred to/from the terminal in a day.
daily used The total number of bytes transferred to/from the terminal today.

A Terminal Commands section also allows you to:

  • Demand Scan to initiate a callout from the terminal.
  • Get GPS Fix to update the terminal's location.
  • Restart Terminal (software reset).
  • Restart Terminal (hardware reset).

Map

Displays the location of a selected terminal or the locations for all terminals in your account on a map.

Road or Satellite View Clicking the 'Map' or 'Satellite' buttons in the top right edge of the map changes the type of map. Those buttons and the controls on the upper left edge of the map are used as they are with any Google Map.
Marker Clicking a marker opens an info bubble. Clicking the 'x' in the upper right of the info bubble closes it.
Select a Location Clicking this drop down on the right edge of the map shows a list of locations. Clicking a location in the list opens and closes an info bubble. The number in the list is the same as the number of the corresponding marker.
Directions Clicking the 'Directions' button on the upper right edge of the map will display a dialog box with two text fields. Select a location from the drop down list or enter an address by hand. Click the Go button for turn-by-turn driving directions. A street address can be the name of a city or a full street name. For example: 'Calgary AB' or '3750 46th Ave. S.E Calgary AB'. lat,lng must be of the form 'xx.xxxxxx,-xxx.xxxxxx'. The digits after the decimal place and the decimal point are optional. The negative sign is mandatory. For example: '52.13,-113.25' or '55,-112'. To make a copy of the directions click the print icon or use your browser's print button.
Email To email the turn-by-turn driving directions select the text in the directions panel and copy to the clipboard. Paste it into an email. This can also be used to paste into a document which can then be printed. All browsers support this.

Displays a chart consisting of a set of one or more tags. Initially the first chart will be displayed and for the last quarter year. Another chart can be selected from the Chart drop down.

The length of the displayed period of time is selected from the Period drop down. The end of the displayed period is selected from the Ending drop down. Once these items have been selected click the Go button to draw the chart.

If the Tooltip check box, on the upper left of the display, is selected then hovering over a pen will show a vertical line and the values of the pens at that point.

The y-axis scales can be shared between trends in a group. A group is identified by the unit colors, and will share a single scale of the same color as the lead-trend of the group.

The three horizonal bars in the lower right are used to select a menu of print options. The chart can be output in a number of different formats.

[Figure 1:  Example Web Client Chart]

Export

Writes (time,value) pairs to a CSV file for one or more tags.

  1. Select tags to be output by clicking the check boxes. Selecting the check box next to 'Name' will select all tags.
  2. Select the start and end date.
  3. Click the 'Save to File' button and the CSV file will be generated and downloaded.

The output format will be the standard SatSCADA CSV format.

The filename is obtained by concatenating the type of terminal, the terminal number, and the datetime the file was created.

The first line contains the device type, number, serialnumber, and name. Followed by a blank line.

Tagdata will be appended sequentially with a blank line between tags. The first row of a tag section will contain the tagname, 'A' or 'D' to indicate analog/digital, and the units. If the tag is digital, state0 and state1 names will appear instead of units (in the order state0 then state1). The rows following will be (time,value) pairs. The data will be timestamped as 2011-12-03T10:15:30 (in UTC time zone).

Sat100_2_20150711T162906.csv
Sat100,2,01035527SKY8B60,demo terminal
 
Pressure,A,PSI
2015-07-11T00:00:00,-0.1567525863647461
2015-07-11T01:00:00,-0.15318584442138672
2015-07-11T02:00:00,-0.1685028076171875
2015-07-11T03:00:00,-0.1582174301147461
2015-07-11T04:00:00,-0.1551074981689453
 
Temperature,A,Degree
2015-07-11T00:00:00,24.64080810546875
2015-07-11T01:00:00,24.824462890625
2015-07-11T02:00:00,25.146026611328125
2015-07-11T03:00:00,25.699462890625
2015-07-11T04:00:00,25.715606689453125
 
Depth,A,ft
2015-07-11T00:00:00,-0.3456684648990631
2015-07-11T01:00:00,-0.3790794909000397
2015-07-11T02:00:00,-0.3720330595970154
2015-07-11T03:00:00,-0.3903118968009949
2015-07-11T04:00:00,-0.39524659514427185
web/webclient.txt · Last modified: 2017/05/29 13:37 by jmoore