Tutorial: Querx and ScadaBR

SCADA (supervisory control and data acquisition) is an industrial control system for remote data acquisition and process controlling. ScadaBR is an open source software for SCADA and can be downloaded free of charge. In this tutorial we are going to set up a graphical control interface that will let us monitor temperature and humidity using Querx TH. Other egnite sensors can be set up in a similar fashion.

Step 1:
Installing ScadaBR and Logging in

Tutorial: Querx and ScadaBR

1: Download the ScadaBR installer from SourceForge.
2: Start the installer and follow the on-screen instructions.
3: Open a web browser and enter the following URL: http://localhost:8080/ScadaBR/.
4: Now log in to ScadaBR. Both the default User-ID and Password are admin.

Tutorial: Querx and ScadaBR

After you have logged in, a page called Watch list will open.

Step 2:
Setting up a Data Source and Data Points

Creating a New Data Source
Tutorial: Querx and ScadaBR

A data point needs to be added, in order to read measured values. The temperature value returned by Querx TH is a 2 byte signed integer with the offset-address 10. Thus, the following data needs to be entered into the Point locator test section:

1. Register range: Input register
2. Modbus data type: 2 byte signed integer
3. Offset (0-based): 10
4. Click Read, in order to check if your configuration is valid.

ScadaBR will display a number in the lower left corner of the Point locator test section. This is the current temperature in degrees Centigrade, multiplied by 10.

5. If everything works as expected, click Add point.

Now you need to connect Querx TH to ScadaBR. To do so, a data source representing the unit and data points represent the specific measurements need to be added. ScadaBR supports a multitude of interfaces, while Querx TH supports SNMP and Modbus/TCP. As ScadaBR only supports SNMP on a very basic level, we will use Modbus/TCP for the sake of this tutorial.

Tutorial: Querx and ScadaBR

1. Open the page Data sources.
2. Choose Modbus IP from the drop down menu.
3. Click the Add icon to the right of the drop down menu.

Tutorial: Querx and ScadaBR

1. Enter a Name for your device.
2. Enter your device's IP address. The default values for all other settings do not need to be changed.
3. Finally, click the Save icon.

Tutorial: Querx and ScadaBR

You will be notified that your data source was saved.

Adding Data Points

A new form that serves to set up the new data point is now displayed.

Tutorial: Querx and ScadaBR

1. Enter a Name for the data point, in this case Temperature.
2. Set a custom Multiplier. To avoid commas, the transmitted values are ten times higher than the actual value. Therefore, the multiplier needs to be set to 0.1.
3. Finally, save the new data point.

Now add another data point for the humidity sensor.

Tutorial: Querx and ScadaBR

1. Enter the following settings in the section Point locator test:
Register range: Input register
Modbus data type: 2 byte signed integer
Offset (0-based): 11
2. Add the point and enter the following data in the section Point details:
A Name for the sensor, here Humidity.
A Multiplier of 1, since the humidity is transmitted as it is.
3. Save your changes.

The next step is activating the data source and data point.

Tutorial: Querx and ScadaBR

1. Activate the data point for Humidity by clicking the building block, making it turn green.
2. Activate the data point for Temperature by clicking the building block, making it turn green.
3. Activate the data source by clicking the data base symbol, making it turn green as well.
4. Do not forget to save the device afterwards.

Step 3:
Visualizing the Data

Creating a New Dash Board

We will now set up a dash board that can visualize the data provided by Querx TH.

Tutorial: Querx and ScadaBR

1. Click Graphical views.
2. Click New view.

Tutorial: Querx and ScadaBR

1. Enter a Name for the new view.
2. Select Dynamic graphic from the drop down menu.
3. Click Add component to view.
4. Now click Edit point component settings.

Adding Dials for Temperature and Humidity
Tutorial: Querx and ScadaBR

1. Now click Edit graphical renderer.
2. Enter the value range that you want to display.
3. Select SmallDial from the drop down menu Dynamic image.
4. Click Save.

A small dial will now be added to your dash board.

Tutorial: Querx and ScadaBR

Now repeat the procedure for the temperature sensor.

querx_scadabr_14_second_dial_element_added
Adding Charts for Temperature and Humidity
Tutorial: Querx and ScadaBR

1. Choose Image chart from the drop down menu.
2. Click Add component to view.

Tutorial: Querx and ScadaBR

1. Click Edit point component settings.
2. Enter a Name for the chart.
3. Set the chart's Width and Height.
4. Set the time period that will be displayed in the chart.
5. Select the humidity sensor as Point 1.
6. Click Save.

Repeat the procedure for the temperature sensor. The result will look like this:

Tutorial: Querx and ScadaBR

Click Save.

Step 4:
Adjusting the Data Format

You may have noticed that the displayed values occasionally look odd. We can fix this by adjusting the text rendering template.

Tutorial: Querx and ScadaBR
Tutorial: Querx and ScadaBR

1. Click Data sources.
2. Click Show data points.
3. Click Edit data point, next to the humidity sensor.

Tutorial: Querx and ScadaBR

1. Select Analog from the drop down menu Type.
2. Enter 00.00 in the field Format, in order to set the display to include 2 digits before and 2 digits after the decimal point.
3. Enter %rH as the suffix.
4. Save your changes.

Tutorial: Querx and ScadaBR

The format in which the humidity values are displayed has now been changed. Repeat the procedure for the temperature sensor.

Further Information

The Modbus registers that can be used with ScadaBR can be found in each device’s manual. For more information on ScadaBR, visit the project web site.