Tutorial: Querx and ScadaBR for industrial applications

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 freely be downloaded. In this tutorial we are going to set up a graphical control cockpit for monitoring temperature and humidity using Querx TH. Set up for other egnite Smart Sensors can be carried out similarly.

Step 1: Install ScadaBR and log in

Querx and ScadaBR: Log In

1: Download the ScadaBR installer from http://www.scadabr.com.br/?q=download
2: Start the installer and follow the instructions on the screen
3: Open a web browser and enter the following URL: http://localhost:8080/ScadaBR/
No log in to ScadaBr. In the default configuration User-ID and Password are admin.



Querx and ScadaBR: Watch List

After having logged in you will see a page called "Watch list".


Step 2: Setting up data source and data points

Create a new data source 

Querx and ScadaBR: Test data point

To read measured values, we need to add data point. The temperature value returned by the Querx TH is a 2 byte signed integer, which can be addressed over the offset 10. So please enter following data in the Point Locator Test section:
1. Register range: Input register
2. Modbus data type: 2 byte signed integer
3. Offset (0-based): 10

To test, if your configuration is valid,
4. click on Read

ScadaBR will display a number in the lower left corner of the Point locator test section. This is the currently amount of degrees in Celsius, multiplied with 10.

5. If everything works as expected, click on Add Point.


Now, you need to connect Querx TH to ScadaBR. To do so, you need to add a data source, which is a representation of the unit and data points, which represent the particular measured values. ScadaBR supports a multitude of interfaces. For Querx, you can use SNMP or Modbus/TCP. As ScadaBR's SNMP support is on a very basic level, Modbus/TCP is used in this tutorial.

Querx and ScadaBR: Add data source

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



Querx and ScadaBR: Configure Modbus interface
1. Enter a name for your device
2. Enter the IP address of your device For all other settings, you can keep the default values.
3. Finally, click on the save icon.



Querx and ScadaBr: Data Source added

You will get a notification, that your data source was saved.



Add data points

A new form is being display for sepcifying the new data point.

Querx and ScadaBr: Specify new data point

1. Provide 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. So set the multiplier to 0.1.
3. Finally save the new data point


Now add another data point for the humidity sensor.

Querx and ScadaBr: Datapoint for the humidity sensor


1. In the section Point locator test enter
Register range: Input register
Modbus data type: 2 byte signed integer
Offset: 11

2. Add the point and enter following data in section Point details
A name for the sensor, here Humidity
multiplier of 1, as the humidity is transmitted as it is.

3. Save your changes.


Now, you need to activate your data source an the data point.

Querx and ScadaBr: Activate data points

1. Activate the data point for Humidity by clicking on the building block, so it turn green.
2. Activate the data point for Temperature by clicking on the building block, so it turns green.
3. Activate the data data source by clicking on the data base symbol, so it turns green as well.
4. Don't forget to save the device afterward.

Step 3: Visualization of data

Create a new Dash Board

For visualization of data, we set up so called dash boards.

Querx and ScadaBR: Set up a new dash board

1. Click on Graphical View
2. Click on New View


Querx and ScadaBR: Set up dynamic view

1. Choose a name for the new view
2. From the drop down menu, select Dynamic Graphic
3. Click on Add component to View
4. Now click on Edit point component settings


Add dials for Temperature and Humidity

Querx and ScadaBr: Graphical Renderer

1. Now click on Edit graphical renderer.
2. Enter the value range, that you want to display
3. Choose Small Dial from Dynamic Image
4. Click on save afterward.


You can see a small dial added to you dashboard.

Querx and ScadaBr: Humidity dial


Now repeat the procedure for the temperature sensor.

Querx and ScadaBr: Both dials



Add charts for temperature and humidity

Querx and ScadaBr: Add Chart

1. From the drop down menu, choose Image Chart.
2. Click on Add component to view.



Querx and ScadaBr: Configure chart


1. Click on Edit point component settings
2. Enter a name for the chart
3. Set width and height of the chart
4. Select the period which you want to display in the chart
5. Choose the humidity sensors as Point 1
6. Click on save after you have finished.


Repeat the procedure for the temperature sensor, and the result will look like this:

Querx and Scadabr: Save your final Dashboard

 Click on save after you have finished.

Step 4: Adjust number format

Maybe you have noticed, that the displayed values ocassionally look odd. We can change that by adjusting the text rendering template.

Querx and ScadaBr: Strange numbers



Querx and ScadaBr: Change text rendering template

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


Querx and ScadaBr: Text rendering template


1. Choose Analog from Type
2. Insert 00.00 in Format for 2 digits before and 2 digits aber the decimal point.
3. Enter %rH as suffix
4. Save
your changes




The display of the number has changed. Repeat the procedure for the temperature sensor.

More information

In the manual of every device, you can find the Modbus registers, that you can use with ScadaBR. For more information on ScadaBR, visit the project web site and the English wiki on Sourceforge.

Leave a Reply

Your email address will not be published. Required fields are marked *