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

  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.

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

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 rangeInput register
  2. Modbus data type2 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.

5If 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.

  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.
  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.

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.

  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.

  1. Enter the following settings in the section Point locator test:
    Register rangeInput register
    Modbus data type2 byte signed integer
    Offset (0-based)11
  2. Add the point and enter the following data in the section Point details:
    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.

  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.

  1. Click Graphical views.
  2. Click New view.
  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

  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.

Now repeat the procedure for the temperature sensor.

Adding Charts for Temperature and Humidity

  1. Choose Image chart from the drop down menu.
  2. Click Add component to view.
  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:

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.

  1. Click Data sources.
  2. Click Show data points.
  3. Click Edit data point, next to the humidity sensor.
  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.

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.