GO SYSTEMELEKTRONIK Modbus Tool.exe for GO Modbus Sensors Instruction Manual

June 4, 2024
GO SYSTEMELEKTRONIK

GO SYSTEMELEKTRONIK Modbus Tool.exe for GO Modbus Sensors

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.

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

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.

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 table Each 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|

References

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals