Manual ScadaBR English 3 Chapter 3

3. Operating ScadaBR

3.1. Introduction

3.1.1. Main Menu

Functionality in this application is primarily accessed using the controls in the header. Depending on the permissions granted to your user account, you will see various icons underneath the application logo. When you hover over these icons with your mouse, you will see an overlay message with a short description of what the icon is for.

Beside the header controls at the right-hand side of the header is the username of the user who is currently logged in.

When your application has an active alarm, you will see a flashing flag icon() and an associated description near the center of the header area.
The color of the icon will indicate the severity of the alarm:

• ()Information.
• ()Urgent.
• ()Critical.
• ()Life safety.

You can click on the icon or the description to go to the list of active alarms.

3.1.2. Data Types

There are five supported data types:

• Binary (aka boolean) values have only two states, referred to in the system as the zero value and the one value. You can use a text renderer to convert the display of binary values to whatever alternate labels you need, such as "on/off", "high/low", "started/stopped", etc.
• Multistate values have multiple distinct states. (Strictly speaking, the binary type is a special case of a multistate.) Values are primitively represented as integers (e.g. 0, 1, 2, 7, ...), but, like binary values, you can use a text renderer to convert these values to appropriate text representations such as "on/off/disabled", "cool/heat/off", or anything else.
• Numeric (aka analog) values are decimal values represented in the system with a floating point variable. Temperature, humidity, price, and altitude are examples of numeric values. Text renderers can be used to determine display features like how many decimals places to display, whether to separate thousands (with commas or dots), and whether a suffix should be displayed (e.g. °F, kW/h, moles, etc). Range renderers can be used to convert ranges of numeric values into text labels.
• Alphanumeric values are simply strings of characters, such as the O/S description of an SNMP source.
• Image values are binary representations of image data. They are stored in files on the host file system (i.e. not in the database) and are cached in memory as necessary for performance purposes. Renderers can be used to create scaled images - such as thumbnails - for presentation.

3.1.3. Data Sources

Data sources are fundamental to the operation of this application. A data source is a "place" from which data is received. Virtually anything can be a data source, insofar as the communications protocol is supported by the application.
Here are some examples:

• If you have a Modbus network accessible via RS232, RS485, TCP/IP, or UDP/IP, you can create a Modbus data source that will poll the network for data on an interval you can define.
• If you have equipment or an application that can send data over HTTP you can start an HTTP receiver data source that will listen for incoming connections and route the data to the appropriate points.
• For hardware that supports SNMP, start an SNMP data source. Values can be polled on an interval schedule, or traps can be received for report-on-exception.
• Data can be read and updated in a SQL data base external to the system.
• Data can be generated either randomly or predictively using a Virtual data source.

Data values that are received or collected by a data source are stored within data points.

3.1.4. Data Points

A data point is a collection of associated historical values. For example, a particular point might be a temperature reading from a room, while another point could be the humidity reading from the same room. Points can also be control values, such as a switch to turn a piece of equipment on or off.

There are many attributes that are used to control the behavior of points. Primarily, there is the concept of a point locator. Locators are used by data source to determine how to "find" the data for the particular point. For instance, a SQL data source has attributes where to find the specific database instance, point locators for the data source indicate the table and field names where to find specific values. The logical separation of data source and data point attributes depends on the communication protocol in question.

Data points attributes also determine many other aspects of the point, such as its name, how it should be logged (all data, changes in value only, or not at all), how long to keep logged data, how to format values for display, and how to chart values.

You can also configure data points with event detectors, which are used to detect conditions of interest in the point's values (eg. value has been too high for too long, is too low, changes too often, doesn't change at all, etc).

Points can be arranged into a hierarchy, or tree, to simplify management and display by using the Point Hierarchy functionality.

3.1.5. Monitoring

Monitoring of points within the system can be done in two ways. You can use the watch list to dynamically create tabular lists of points including their values, last update times, and charts of historical information (if the point is configured to support this).
Values and charts are updated in real time without having to refresh your browser window. Charts of multiple points can also be displayed on demand.

You can also create graphical views of points using drag and drop functionality to position graphical representations of points on an arbitrary background image. Animated images can be used to create highly dynamic visualization of system behavior, and, like the watch lists, values are updated in real time without a browser refresh.
These views can subsequently be marked as "public", so that they can be reused on public web sites.

3.1.6. Control

Control of external systems can also be achieved for points that can be set (aka writable or output). A settable point can be set to a user-defined value, such as a thermostat setting or equipment control switch. Both watch lists and graphical views provide simple means by which to input a value to set.
The point locator for the settable point determines how the data source sets the value within the external equipment.

3.1.7. Events

An event is the occurrence of a defined condition within the system. Both system-defined and user-defined events are available. System-defined events include data source operation errors, user log-ins, and system start-up/shutdown. User-defined events include point event detectors (see "event detectors" above), scheduled events, and compound events which detect conditions over multiple points using logical statements. There are also "audit events", which are raised when users make changes (additions, modifications, deletions) to run-time-affecting objects including data sources, data points, point event detectors, scheduled events, compound event detectors, and event handlers.

Once an event has been detected, it is acted upon by handlers. An event handler is a user-defined behavior that is to be performed upon the raising of a particular event, such as sending an email or setting the value of a settable point.

3.1.8. Application icons

• ()Data source
• ()Data point
• ()Chart
• ()Set point
• ()Watch list
• ()Graphical view
• ()Refresh
• ()Event detector
• ()Compound detector
• ()Scheduled event
• ()Event handler
• ()Alarm
• ()User
• ()User comment
• ()Report
• ()Mailing list
• ()Publisher
• ()Warning
• ()Log-out

3.1.9. Alarm Sounds

ScadaBR can play sounds when alarms are active. By default, alarm sounds are played for urgent, critical, and life safety alarms (i.e. not for information alarms), but sounds for each alarm type can be controlled individually.
To enable particular alarm sounds, valid mp3 files must exist at the following locations:

• <ScadaBR_home>/audio/information.mp3
• <ScadaBR_home>/audio/urgent.mp3
• <ScadaBR_home>/audio/critical.mp3
• <ScadaBR_home>/audio/lifesafety.mp3

To disable a sound, remove the associated sound file.

A library of sounds can be found in the <ScadaBR_home>/audio/lib folder.

3.1.10. Graphics

ScadaBR ships with a small graphics library which can be found in the <ScadaBR_home>/graphics folder. Each sub-folder represents an image set.
The contents of the sub-folder include all of the images in the image set, as well as an optional properties file called info.txt. Examples can be found in the graphics directories that ship with ScadaBR. This property file contains name/value pairs with the following names (all of which are optional):

• name: The name that will be used to describe the image set in the user interface. If not provided this will default to the folder name.
• width: The width of the images (all images are expected to be the same size). If not provided the width of the first image will be used.
• height: The height of the images (all images are expected to be the same size). If not provided the height of the first image will be used.
• text.x: The position of text relative to the left edge of the image, in pixels. If not provided this defaults to 5.
• text.y: The position of text relative to the top edge of the image, in pixels. If not provided this defaults to 5.

Warning!! Once you are using an image set in your views do not rename its folder! The folder name is used internally as the identifier of the image set.

• Image files are sorted alphabetically by name. Names are case sensitive.
• Name/value pairs are separated with '='.
• Lines beginning with '#' are considered comments.
• 'Thumbs.db' files are ignored.
• Archive files (zip, gz, tar, etc) cannot be used since the images files have to be accessible to the web server.
• Image sets are loaded upon system start-up, so any changes require a restart.

To have future versions of ScadaBR ship with your preferred graphics, please contribute them to ScadaBR Software. Please support open source software.

3.2. Adding Data Sources and Data Points

In this topic we show an example of how to create Data Sources and Data Points. In this example we will created a Data Source type Virtual Data Source, which is a simulated data source.

• From the main menu, choose Data sources().
• Select from the list Virtual Data Source and click the Add icon().
• Fill in as below and save your settings.

()

• After saving the Data source, the options for inclusion of Data points are enabled.
• Click Add() and fill in as below and save your settings.

()
()

• Add a few more different type Data points.
• Than enable all the points by clicking on the icons() and also enable the Data source().

()
()

3.3. Viewing data: Watch Lists and Charts

Now that you have configured and registered your system's data sources and data points, you can view them:

• From the main menu, choose Watch List().
• The registered data points are to the left.
• To monitor your values​​, click on each of them to add them to the Watch list.

()

You can access and edit more information about each Data point by clicking on Point details() and watch your point's numeric and graphic history and its values​​.

()
()

You can edit the properties of your Data point.

• In your watch list, click the Point details().
• On the next screen, click Edit data point().

Here you find different options. For example you can change the Text renderer properties, with the settings shown below:

()

This will change the rendering of the Data point from:

()

To:

()

3.4. Defining Events

Now we will define an event.

• In your watch list, click the Point details().
• On the next screen, click Edit data point().

()

• In the list of Event detectors, select "Low Limit" and click Add() to add a new detector.
• Fill in the fields as below and click the Save button at the bottom right of the screen to save your settings.

()

If you entered the fields as above the system will now inform you with on screen "Alarms" in the main menu, whenever the value of your data point falls below the minimum limit (22) for more than 5 seconds.

3.5. Graphical Views

3.5.1. Overview

To create more elaborate views of the data, we can build "Graphical Views".
All attributes of a graphical view and its associated points are editable in the graphical view edit page. Views contain a collection of view components, which can be static content or dynamic content based upon one or more points.

3.5.2. Graphical view attributes

All graphical views have a Name by which they are referred within lists of graphical views. This name should, but is not required to, be unique.
A view may optionally have a Background image upon which its components are superimposed. Users can use any type of image displayable within a browser for the background image, including GIF, JPEG, and PNG.
The Anonymous access attribute determines whether users who have not logged in may access the view.

• Edit means that anonymous users can set the values of settable points in the view.
• Read means that anonymous users can access the view, but not set point values.
• None means that anonymous users may not access the view.

In this example we will use a file called "powerplant.jpg".

• From the main menu, choose Graphical views().
• Next click New view().
• In View properties enter a Name.
• Next click on Choose File, select your image (powerplant.jpg), confirm and click Upload Image.

()

• In the Components list, select "simple point" and click Add component to view() to enable it.
• You will see now a new icon() added in the middle of the "Graphical view".
• Navigate with your mouse to the new icon(), and click on the second option Edit point component settings().

()
()

• In Point choose one of your Data points from the list and click on Save() to save your settings.
• Position your newly added "Component" on the screen by dragging it with your mouse.
• You can now add more "Components" to your "Graphical view".
• Finally click the Save button at the bottom of the screen to save your settings.

()