GO-SYSTEMELEKTRONIK-logo

GO SYSTEMELEKTRONIK Modbus Tool.exe for GO Modbus Sensors

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-product-image

Introduction

This manual describes the operation of the Modbus configuration program Modbus Tool.exe of GO Systemelektronik in version 1.07 with the article number 420 6500 for the following sensors:

Modbus sensor Article number
BlueTrace Oil in Water 461 6200
BlueTrace Crude Oil 461 6300
BlueTrace Turbidity 461 6780
BlueEC Conductivity 461 2092

The program automatically recognises the connected Modbus sensors.
Modbus Tool.exe is included with the above-mentioned Modbus sensors of GO Systemelektronik.∗
With Modbus Tool.exe you can, for example, read out sensor information, assign a Modbus address, determine the internal amplification of the input signal, calibrate the sensor and display measurement values.
The program runs under Windows 7 and newer. An Installation is not necessary; the program starts when Modbus Tool.exe is called up.
The products of GO Systemelektronik are constantly being developed, therefore deviations between this manual and the delivered product can result. Please understand that no legal claims can be derived from the contents of this manual.

Preparation

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-1

To enable your PC to communicate with a Modbus sensor, you need a converter from RS485 to USB and driver software. Here, as an example, the Modbus USB∗ converter of GO Syste-melektronik (article number 486 S810) with the driver software at:
https://ftdichip.com/drivers/d2xx-drivers there „D2XX Drivers“ The driver software creates a virtual COM port in the Windows system – in this example “USB Serial Port (COMn)”.
A Modbus sensor is connected via the clamp socket strip in slot X1. If a Modbus sensor is to be connected to a BlueConnect module of GO Systemelektronik, the clamp socket strip from the BlueConnect module can be used at slot X1.
Exception: If a Modbus sensor is to be connected to the Blue-Sense Transducer of GO Systemelektronik, the clamp socket strip on the BlueSense Transducer can be used at slot X2.
In case of communication problems: Check the earth connection of the converter. Install the latest driver.
Earth the converter.
GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-2
This is the only way to ensure trouble-free operation. The earth connection is on the left side of the housing.

Opening the Converter Housing

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-3

  1. Turn the housing bracket to the right.
  2. Loosen the screws (Torx T20).
  3. Open housing cover to the left.

Program Properties with Connected Modbus Sensors

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-4

The Start Window (Modbus Connection)

In the start window you can

  • establish the connection with your PC via a selected COM Port,
  • automatically recognise connected Modbus sensors,
  • and change the Modbus Slave ID of detected Modbus sensors.

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-5

Modbus Slave ID: The value entered here (default value is 1 – quick selection 1 to 16 or input 1 to 230) is the start value from which the program searches for the next Modbus Slave ID of a connected sensor after clicking the <Start> button . If the program does not find a sensor with this Modbus Slave ID, the mes-sage “No Modbus sensor was found !!!” appears.
Reset to 1: The Modbus Slave ID of a detected Modbus sensor is set to 1 and the value in is set to 1.
Change ID: The Modbus Slave ID of a detected Modbus sensor is set to the entered value (1 to 230) and the value in is set to the same value.

The Info Window

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-6

The Parameter Window

BlueTrace Oil in Water > Parameter

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-7

RS485 Termination : Switches the termination of the Modbus (RS485) on and off.
Gain  : Selection of the internal gain of the input signal from 1 to 128
coefficients : Calibration coefficients, the displayed values are from the calibration function. see 3.4 The BlueTrace Calibration Window
Writes the current settings to the sensor memory. Settings that have not yet been saved are marked in red.

Blue Trace Turbidity > Parameter GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-8

BlueEC Conductivity > Parameter 

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-9

Measuring range Selection between two measurement ranges

  • RS485 Termination Switches the termination of the Modbus (RS485) on and off.
  • Temperature Correction
    Temperature: Temperature value of the temperature compensation, here 25 (default value)
    Factor: Factor of the temperature compensation, here 0,02 (default value)
  • Factor: Temperature factor calculation TDS, here 0,67 (default value)
    Writes the current settings to the sensor memory. Settings that have not yet been saved are marked in red.

Note: Decimal separator is the comma; if a dot is entered, an error message appears.

The BlueTrace Calibration Window

A calibration compares the value pairs of the measured sensor raw values∗ and allocated reference values from calibration liquids. These value pairs are taken as points in a coordinate system. The curve of a 1. to 5. Order polynomial is placed through these points as accurately as possible; this is how the calibration polyno-mial is created.
Example with a 2. Order polynomial:

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-10

Note: BlueEC Conductivity does not have a calibration window.

The Calibration Table
There are two ways to enter the raw values

  • manual input – gives the possibility to calculate hypothetical calibrations
  • measurement value transfer – current measured raw values for the actual calibration

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-11

Manual input: not activated: Measure After the first opening of the calibration window, the calibration table has only one row. Click with the cursor in the “raw value” cell and enter the first raw value, click with the cursor in the “measured value” cell and enter the first reference value, or vice versa.
Measurement value transfer: ∗activated: Measure After the first opening of the calibration window, the calibration table has only one row. Click with the cursor on the first row key : As long as the row key is active , the current measured raw value appears in the “raw value” cell. Click with the cursor in the “measured value” cell and enter the first reference value.
To create a new line, click with the cursor in the last line wit To delete a line, delete all line entries and click in another line.

  • AVG only at Oil in Water
    Progress bar for the calculation of the measurement value. A measure-ment value of the BlueTrace is the result of a moving average of 45 individual measurements. A single measurement takes place every second
  • Signal Level
    Display of the signal strength of the bright value (LED on).
    If the AD converter is overloaded, the display field is highlighted in red.
  • Order:
    Order means the order/degree of the calibration polynomial.
    Click on one of the Order buttons 1 to 5 to get the best fit.
    GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-12
The Measurement Value Window

BlueTrace Oil in Water > Measuring

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-13

BlueTrace Turbidity > Measuring

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-14

BlueEC Conductivity > Measuring 

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-15You can select five measurement values from each of the three drop-down menus. If the display is activated, the current measurement values of the selec-tion are shown every second. A BlueBox/BlueMon system receives all three selected measured values, a BlueSense Transducer only the first two. write changes Writes the selection to the sensor memory.
Note: This selection is only possible with a sensor firmware version ≥ 2.03. Otherwise, standard measurement values are used: Conductivity – Temperature – Conductivity uncomp.
Note: Salinity according to the generally valid UNESCO formula for seawater

The Measurement Value Recording Window

GO-SYSTEMELEKTRONIK-Modbus-Tool.exe-for-GO-Modbus-Sensors-16

General Modbus Specification for GO Modbus Sensors

Address Function code Data CRC
1 byte 1 byte 0 … 252 byte(s) 2 bytes

Description

  • Address:
    Sensor address (valid from 1 – 230)
    Address 0 is the broadcast address and will not be answered.
  • Function code:
    Here you define whether parameters are to be read or written.
  • Data:
    e.g. from the master: Which parameters are requested?
    e.g. from the slave: content of the requested parameters
  • CRC: CRC16

Data types

  • Standardized data types: byte (8-bit) and short integer (16-bit) According to the Modbus specification, a register always transmits the high-byte first, followed by the low-byte.
  • Extended data types: 32-bit integer and 32-bit float are transmitted as 2 consecutive 16-bit registers. The format of the float number corresponds to the IEEE standard 754.

Function codes

Function code Name Description
03 Read Hold Register Read device parameters (Integer / Float)
04 Read Input Register Read actual values (Integer / Float)
06 Write Single Register Write device parameters word by word
16 * Write Multiple Register Write several device parameters word by word

Register
Modbus provides to store the data in different registers. Each register stores 2 byte. A difference is made in the following registers:

Register number Register address Type Modbus designation Description
read / write Discrete Output Coils Discrete outputs
read only Discrete Input Contacts Discrete inputs
0x0100 – 0x0FFF write only (except IO) Input Registers Input register, Measurement values of the sensors
0x0000 – 0x00FF read / write Output Holding Registers Hold register for parameters, Device configuration, etc.

Slave tableEach slave has a parameter table and an actual value table. From these tables it can be seen which parameters can be found under which addresses. Coils should not be used, I/Os are managed via the parameter table.

BlueTrace Oil in Water 461 6200 – Modbus Address Overview

Address Parameter name Range Meaning Data type Authorization
0x00 Device ID 102 102 – BlueTrace Oil in Water Short R
0x01 Firmware Version 100 – 9999 100 = 1.00, 2410 = 24.1 Short R
0x02 Serial No. 0 – 65535 Serial number Short R
0x03 Modbus Slave ID 1 – 230 Modbus address Short R/W
0x04 Baud rate 0 – 2 0 = 9600 8N1 Short R
0x05 Production date ddmmyyyy Date Short x 2 R
Address Parameter name Range Meaning Data type Authorization
0x14 A0 0 – 0xffffffff Cal Coefficient A0 32 bit Float R/W
0x16 A1 0 – 0xffffffff Cal Coefficient A1 32 bit Float R/W
0x18 A2 0 – 0xffffffff Cal Coefficient A2 32 bit Float R/W
0x1A A3 0 – 0xffffffff Cal Coefficient A3 32 bit Float R/W
0x1C A4 0 – 0xffffffff Cal Coefficient A4 32 bit Float R/W
0x1E A5 0 – 0xffffffff Cal Coefficient A5 32 bit Float R/W
Address Parameter name Range Meaning Data type Authorization
0xD1 Gain 0 – 7 1 – 128 Short R/W
0xD3 Modbus termination 0 – 1 Termination resistor Short R/W
Address Parameter name Range Data type Authorization
0x101 Value Sensor 1 [ppm] 0 – 0xffffffff 32 bit Float R
0x104 Value Sensor 1 RAW 0 – 0xffffffff 32 bit Float R

BlueTrace Turbidity 461 6780 – Modbus Address Overview

Address Parameter name Range Meaning Data type Authorization
0x00 Device ID 109 109 – BlueTrace Turbidity Short R
0x01 Firmware Version 100 – 9999 100 = 1.00, 2410 = 24.1 Short R
0x02 Serial No. 0 – 65535 Serial number Short R
0x03 Modbus Slave ID 1 – 230 Modbus address Short R/W
0x04 Baud rate 0 – 2 0 = 9600 8N1 Short R
0x05 Production date ddmmyyyy Date Short x 2 R
Address Parameter name Range Meaning Data type Authorization
0x14 A0 0 – 0xffffffff Cal Coefficient A0 32 bit Float R/W
0x16 A1 0 – 0xffffffff Cal Coefficient A1 32 bit Float R/W
0x18 A2 0 – 0xffffffff Cal Coefficient A2 32 bit Float R/W
0x1A A3 0 – 0xffffffff Cal Coefficient A3 32 bit Float R/W
0x1C A4 0 – 0xffffffff Cal Coefficient A4 32 bit Float R/W
0x1E A5 0 – 0xffffffff Cal Coefficient A5 32 bit Float R/W
0x2A A0 0 – 0xffffffff Cal Coefficient A0 TSS 32 bit Float R/W
0x2E A1 0 – 0xffffffff Cal Coefficient A1 TSS 32 bit Float R/W
Address Parameter name Range Meaning Data type Authorization
0xD3 Modbus termination 0 – 1 Termination resistor Short R/W
Address Parameter name Range Data type Authorization
0x101 Turbidity [FNU] 0 – 0xffffffff 32 bit Float R
0x104 Temperature [°C] 0 – 0xffffffff 32 bit Float R
0x107 TSS [mg/l] 0 – 0xffffffff 32 bit Float R

BlueEC Conductivity 461 2092 – Modbus Address Overview

Address Parameter name Range Meaning Data type Authorization
0x00 Device ID 101 101 – BlueEC Conductivity Short R
0x01 Firmware Version 100 – 9999 100 = 1.00, 2410 = 24.1 Short R
0x02 Serial No. 0 – 65535 Serial number Short R
0x03 Modbus Slave ID 1 – 230 Modbus address Short R/W
0x04 Baud rate 0 – 2 0 = 9600 8N1 Short R
0x05 Production date ddmmyyyy Date Short x 2 R
Address Parameter name Range Meaning Data type Authorization
0x14 A0 0 – 0xffffffff Cal Coefficient A0 32 bit Float R/W
0x16 A1 0 – 0xffffffff Cal Coefficient A1 32 bit Float R/W
0x18 A2 0 – 0xffffffff Cal Coefficient A2 32 bit Float R/W
0x1A A3 0 – 0xffffffff Cal Coefficient A3 32 bit Float R/W
0x1C A4 0 – 0xffffffff Comp. – Temperature 32 bit Float R/W
0x1E A5 0 – 0xffffffff Comp – Correction factor 32 bit Float R/W
Address Parameter name Range Meaning Data type Authorization
0xD0 Meas. range 0 – 1 0: 0 – 3000 µS 1: 0 – 120 mS Short R/W
0xD1 Modbus termination 0 – 1 Termination resistor Short R/W
0xD3 TDS factor 0 – 100 Value/100 Short R/W
Address Parameter name                                   Standard Range Data type Authorization
0x101 Value Sensor 1 – selectable              Cond. comp. 0 – 0xffffffff 32 bit Float R
0x104 Value Sensor 2 – selectable              Temperature 0 – 0xffffffff 32 bit Float R
0x107 Value Sensor 3 – selectable              Cond. uncomp 0 – 0xffffffff 32 bit Float R
0x10A Value Sensor 4 Salinity 0 – 0xffffffff 32 bit Float R
0x10D Value Sensor 5 TDS 0 – 0xffffffff 32 bit Float R

Documents / Resources

GO SYSTEMELEKTRONIK Modbus Tool.exe for GO Modbus Sensors [pdf] Instruction Manual
Modbus Tool.exe for GO Modbus Sensors, Modbus Tool.exe, Tool.exe, GO Modbus Sensors

References

Leave a comment

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