Levelmaster® H8-C

Utility User’s Guide

Revision
2006-Aug-30_551

KSM 756_1303

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
 LEVELMASTER® H8 KSM 756_1303

General
The Levelmaster® H8 utility driver is a versatile tool for working with the H8 electro-
pneumatic pressure gauging cabinets. It can be used as a stand-alone application
during service and commissioning, but also function well as a background driver
under normal runtime conditions. In this case it is used for supervision of connected
H8 units and as a communication bridge serving other applications with pressures
and status in a computer network environment.

Levelmaster® H8 Utility driver

 Acting as a client on a MODBUS RTU RS485 line
 Acting as a server on a MODBUS TCP network

RS485 PC work station I Intranet /

MODBUS Internet
RTU MODBUS
TCP
H8
Utility Request
Levelmaster® H8
RS485 driver pressure
cabinet
Modbus slave unit COMX data for
01 H8 unit xx

RS485 PC work station II

COM2
Application
Levelmaster® H8 running
cabinet MODBUS
Modbus slave unit TCP
02

RS485
COM2

Getting started with USB Connection between PC and H8 Sensor and Control
Unit, SCU

For detailed instructions to get started with a USB connection between a Laptop PC
and the Levelmaster® H8 cabinet, please see the section in Appendix B.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
2 (30)
 LEVELMASTER® H8 KSM 756_1303

Startup form

When the program starts, the Communication setup form below is normally shown.
Enter the COM-port settings and press the button Connect. The program will then try
to connect to the COM-port.

Check Auto connect at startup to automatically connect to the COM port at startup.
Uncheck Show this form at startup to always start up directly in the main form.

To automatically start the application at power up of the PC, add a shortcut in the
Startup folder and check the checkbox Auto connect at startup.

Maximum size for the communication log can be set. When the limit is reached
logging stops.

The LEVELMASTER® H8 Utility program form below shows the connected units and
their status. The button is used to switch between the full information
window, or only show a small window with the status led information. The status line
at the bottom shows the status of the Modbus RTU Client and the Modbus TCP
Server.

If the LEVELMASTER® H8 utility is minimized or closed with the button, it will

not be terminated, only minimized to an icon in the task tray area.

To close the H8 utility application, use the command File-Exit, or right-click with the
mouse on the task tray icon and choose exit.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
3 (30)
 LEVELMASTER® H8 KSM 756_1303

This window is trying to communicate

with the H8 cabinet with slave address
02, but cannot get any response.

The reason for this can be that the

cabinet is powered off, or there is no
slave 02 cabinet, or error in cable
installation, or error in H8 sensor unit.

This window is communicating with

the H8 cabinet with slave address 01.

The contact is established.

The number of small windows inside the main window shall correspond to the actual
number of H8 cabinets connected on the serial line. If this is not, follow below
instructions:

 Disconnect the serial communication with the H8 Cabinets before any

changes can be made to the number of small H8 Unit windows.
o Choose: Interface – Modbus RTU Client – Disconnect
 Add a Levelmaster H8 Unit
o Choose: File – Add modbus slave – Add Levelmaster H8 Unit
 Remove a Levelmaster H8 Unit
o Press the close button “x”, on the window you wish to remove.
 Set the Slave id of the H8 window.
 Reconnect the communication
o Choose: Interface – Modbus RTU Client – Connect
o Enter the communication parameters and press OK.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
4 (30)
 LEVELMASTER® H8 KSM 756_1303

H8 Utility program showing two connected Levelmaster Units, slave id 01 and

slave id 02.

The H8 Utility TCP server is

enabled on port 502.
Levelmaster cabinets
connected to the serial This server is used by KSL450
program to fetch Levelmaster
line COM5
data.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
5 (30)
 LEVELMASTER® H8 KSM 756_1303

Popup menu

Press the right mouse button in the form to get a popup menu.

Select slave id Enter the slave id for the H8 cabinet you wish to connect to.
Show/Modify setup data Modify the setup data for the selected slave, see below.
Enter measurement mode The connected unit will switch to measurement mode, default
mode.
Enter service mode The connected unit will switch to service mode, see below.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
6 (30)
 LEVELMASTER® H8 KSM 756_1303

Pressure tab

The form below shows pressures as mmH2O.

The two option buttons marked below, is used to switch between the total pressures
and the compensated hydrostatic pressure.

The total pressure is the sum of hydrostatic pressure and dynamic pressure drop.

The master SCU is responsible for the pressures 1 to 4, slave 1 SCU 5 to 8, slave 2
SCU 9 to 12 and slave 3 SCU 13 to 16.

To log the pressures, press the Start log function key and enter the desired log
interval in seconds.

Logging is done to an ordinary text file, which can be imported to an Excel sheet for
analyzing and plotting.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
7 (30)
 LEVELMASTER® H8 KSM 756_1303

Levelmaster H8-C configurations

Levelmaster H8 Sensor and Control Unit, SCU, Left side panel

The SCU has 2 COM ports, COM2 and COM1. COM1 may be accessed via two
different ports: USB or RS-485. When the USB port is used, the RS-485 port is
disabled, shutting off any communcation with external devices on this port.

COM2 is used for internal communication between the mounted sensor units. One of
the SCU’s is the Master SCU, and the rest are slaves with slave id = 1, 2, 3, …

The figure below shows how to connect internal SCU’s. This configuration has a total
of 20 measurement points, and 5 COM ports available for external communication or
for controlling 4-20 mA output units. The COM1 port can be used as a MODBUS
slave, or a MASTER for an analog output unit.

The Master SCU collects data from the slave units, calculates hydrostatic pressures,
levels and currents for 4-20mA output units. The Master then broadcasts calculated
data to all connected slave units. In this way, all SCU’s will know all relevant data and
may function as external communication devices.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
8 (30)
 LEVELMASTER® H8 KSM 756_1303

Modify setup data for the connected SCU

Select Show/Modify setup data from the popup menu.

To be able to see/modify all setup data, than those shown below, press Show all
setup data and enter the correct password.

Note! Instead of having to enter password each time, enter admin mode from Go
Admin menu item.

Press Read setup data from unit to refresh the data in the form.

Press Write setup data to unit to write the entered data to the unit.

Press Save setup data to file to save the setup data in the form to a text file.

Press Read setup data from file to read setup data from a file and show in the form.

Software version: The current version of the loaded H8 SCU program.

Serial number is the serial number for the unit assigned at the factory.

Protocol COM1: See available options below.

Slave id is the Modbus identity for the unit: 1 to 254

Protocol COM2: See available options below.

Slave id is the Modbus identity for the unit: 1 to 254

Note COM1 and COM2 can have different slave id. COM2 is used for connection of
Internal Master SCU with slave SCU.

Enable pressure and air quality guard: Set this checkbox to enable pressure guard
and air quality sensors. This checkbox should only be set for the Master SCU.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
9 (30)
 LEVELMASTER® H8 KSM 756_1303

After you press Show all setup data the form will look like below. Note, in this mode,
it is possible to change all data.

Mech offset: Offset in mm from tank bottom to pipe outlet. This offset is used to
calculate level.
Default densities: Start-up density. Density is used to transform the hydrostatic
pressure to a level.
Level 20mA: mmH2O or mm corresponding to 20 mA
Dyn press offset: Dynamic pressure drop (mmH2O) from sensor to tank outlet for
an empty tank. The sensor unit will compensate the pressure for this dynamic
pressure drop before calculating a level.

The protocols available for COM1:

Slave Modbus protocol or various master 4-20mA protocol.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
10 (30)
 LEVELMASTER® H8 KSM 756_1303

The protocols available for COM2:

Slave Modbus protocol or internal master protocol.

Dynamic pressure drop calibration

The from below shows setup data tab for Dyn press offset calibration.
This data is entered in the master SCU, and used for calculation of hydrostatic
pressure and level. The data should be entered for empty tank. If the tanks have
some liquid, the fields in the bottom section may be used to transform a measured
pressure drop for a tank with liquid level to an empty tank.

How to measure and calibrate pressure drop:

1. Run in service mode, see below.
2. Select total pressures and start logging
3. Wait some minutes to store some logging.
4. Close the main supply valve
5. Continue logging for some minutes (this pressure is now the static pressure)
6. Take the difference in pressure before and after (4) above.
7. Enter (5) in the field Tank pressure and (6) in the field Measured drop.
Calculate Drop for empty tank and enter in outlet field.

Logging total pressures with air supply valve on.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
11 (30)
 LEVELMASTER® H8 KSM 756_1303

Logging total pressures with air supply valve off.

To enter pressure drop for empty tank, specify total pressure with and without air flow
and press the “=” button to calculate the corresponding pressure drop for empty tank.

Mapping of outlets to mA channels

For a Master analog protocol, the analog channels may be mapped to the outlet
ports.

The example below maps:

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
12 (30)
 LEVELMASTER® H8 KSM 756_1303

Outlet 8 to analog channel 1

Outlet 9 to analog channel 2
Outlet 10 to analog channel 3
Outlet 11 to analog channel 4

All other outlets are disabled.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
13 (30)
 LEVELMASTER® H8 KSM 756_1303

Service mode

Right-click with the mouse and choose Enter service mode from the pop-up menu.

In service mode you may operate the main valves manually.

Open / Close the main sensor calibration valve to switch the sensors between tank
pressures and ATM pressure. In this way it is easy to check the function of all
individual calibration valves and sensors.

Open / Close the main air supply valve to check leakage in piping, and dynamic
pressure drop.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
14 (30)
 LEVELMASTER® H8 KSM 756_1303

Level calculation

The Levelmaster H8 cabinet can be setup to do level calculations based on

measured pressures. The formula used by the program:

Level = (Mech Offset) + (Pressure mmH2O)/(Relative density to H2O)

For a tank, the mechanical offset is the distance from the tank bottom to the pipe
outlet.
For a draught reading, it is the distance from the keel, (extreme draught) to the hull
penetration for the air pipe.

Default density is the startup.

The density used in runtime, can be set from the Density tab in the H8 window.

It is also possible for a Modbus Master to read levels and densities and write the
density through the Modbus interface directly. For addresses, please se the Modbus
Map in the appendix.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
15 (30)
 LEVELMASTER® H8 KSM 756_1303

Analog output of Level/Pressure data

The Levelmaster H8 system has an option to send out the measured pressures, or
the calculated levels as a 4-20 mA signal. The analog output controller is connected
to the COM1 port of the H8 sensor unit.

The following protocol can be specified:

 MB-RTU slave and KSA-ASCII

o This is the default protocol used, where the cabinet is acting as a
Modbus slave unit.
 Pressure 4-20mA, ICP M-7024
o This protocol sends out a 4-20mA pressure signal to an ICP M-7024
controller.
 Level 4-20mA, ICP M-7024
o This protocol sends out a 4-20mA level signal to an ICP M-7024
controller.
 Pressure 4-20mA, Wago
o This protocol sends out a 4-20mA pressure signal to a Wago 750-312
controller.
 Level 4-20mA, Wago
o This protocol sends out a 4-20mA level signal to a Wago 750-312
controller.
 Pressure 4-20mA, KSAO8
o This protocol sends out a 4-20mA pressure signal to a Kockum Sonics
Analog Output controller.
 Level 4-20mA, KSAO8
o This protocol sends out a 4-20mA level signal to a Kockum Sonics
Analog Output controller.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
16 (30)
 LEVELMASTER® H8 KSM 756_1303

Leak testing

Enter service mode:

1. Fill up the pipes to a steady pressure. The higher the pressure in the pipes,
the more effective the leak test will be. For best result, plug the pipe at the
outlet in the tank, (optionally install an outlet valve in the tank which can be
closed during leak testing.)
2. Start logging of pressures.
3. Close the Main supply valve.
4. Watch the pressure for outlets if they show signs of leakage.
5. Save the log and import to Excel for graphing.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
17 (30)
 LEVELMASTER® H8 KSM 756_1303

Communication tab

Press Update comm counters to fetch the communication counters from the
connected unit.

Press Clear comm counters in slave to clear the communication counters in the
connected unit.

Press Show comm log to view the communication log.

The field Bus msg count shows the total number of messages the unit has detected.

The field Slave msg count shows the total number of messages addressed to the
unit.

The field Slave no response count shows the total number of messages received,
which was not answered. The reason for this may be a broadcast message was
received or the CRC check sum was wrong.

The field Slave CRC error count shows the total number of detected CRC errors.

The field Slave NAK count shows the total number of messages, which was sent
back with negative acknowledge.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
18 (30)
 LEVELMASTER® H8 KSM 756_1303

System status tab

The LED indications:

Sys ok Indication that the system is ok and running in measurement mode
Sys err System error can have the following reasons:
o Flash memory error
o Ram memory error
o Communication error
o Watch dog error
Pressure Pressure below 3bar -> Pressure guard alarm.
Liquid accumulated in the middle filter cup -> Air quality alarm.
Request The H8 utility driver sends a request to the connected unit.
Ack/Err The unit returns an answer to the H8 utility driver or the message time-
out timer expires.

Note! It the system is restarted many times within a short period of time, the Watch
dog error can go on. After 1 minute with stable power the error is reset to normal.

Press Show system error log to view the logged system information.
Normally the system log will contain changes made in the mode of operation of the
unit, and also changes made between normal and error states.
As an option it is also possible to log every pressure guard check, offset calibration
and leak test check. Choose these options from the menu File – Options.

Press Show detailed block status to display the form below.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
19 (30)
 LEVELMASTER® H8 KSM 756_1303

Level tab

Press read levels to read the calculated levels from the sensor unit. The levels are
shown in mm and based on the mechanical offsets entered in setup data, and on the
densities given in the Densities tab.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
20 (30)
 LEVELMASTER® H8 KSM 756_1303

Densities tab

Press read densities to read the used densities in the sensor unit.

To change the density, modify the density value, and press Send densities to the
sensor unit.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
21 (30)
 LEVELMASTER® H8 KSM 756_1303

Options setup window

The window below is shown when File – Options is selected from the menu.
From this window the user may setup the behavior of the system log and the
communication log.
There is also a section describing how the program shall react on events when the
H8 Utility program is minimized as an icon in the system tray.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
22 (30)
 LEVELMASTER® H8 KSM 756_1303

Logging and storage of log files

There are two types of log files: Always active and user activated log files.

Always-active log files are created when the program starts and a connection to the
Levelmaster® H8 unit is established. User activated log files are created on request
from the operator.

The always-active log files are: System log and Communication log
The user activated log files are: Pressure log, Pulse time log and Leak test report.

When a log file is active and used by the program, the extension is changed to ‘.tx_’.
When a log file is saved and no longer active, the extension is replaced by the
normal text file extension ‘.txt’.

To view an active log file, use the built in functions to view the log file.
To work with a data in a log file, first use the function save log file. This will create a
copy of the current log file with the extension ‘.txt’. This log file may then be imported
to an Excel worksheet for analyzing and plotting.

All logging is done to the folder: ‘(Installation directory)\H-xxxx\’, where xxxx is the
serial number of the sensor and control unit.

Events window

All events in the connected Modbus units are reported to an event log together with a
time stamp. The event window is normally hidden. In the Options window the event
window may be setup to show automatically when an event occurs.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
23 (30)
 LEVELMASTER® H8 KSM 756_1303

MODBUS TCP server

The LEVELMASTER® H8 Utility program can act as a server on a Modbus TCP

network.

Choose Interface – Modbus TCP server – Enable server to enable the server.
Set the listening port, normally set to 502 for Modbus.
If a connected client does not use a connection for the specified timeout time, the
connection will automatically be closed.
To enable the server automatically at start up, check the Auto connect modbus
TCP at startup.

For details regarding the Modbus map for the TCP server, please view the
specification in Appendix A.

Program Boot mode

If the power is turned on when the mode switch is in stop position, the Sensor Unit
will enter Program Boot Mode. All error led’s will then turn on indicating boot position.

To go back to normal run mode, move the mode switch to run position and cycle
power on and off once again.

Program Boot mode:

All error leds on.

Mode switch:
Up - Run mode
Down - Stop mode

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
24 (30)
 LEVELMASTER® H8 KSM 756_1303

Redundant piping - Pressure list (Optional function)

When operating as part of a wholly redundant system, some or all of the tanks may
be sounded by lines from differing cabinets. The H8 utility allows the user to define
and control what reading, primary or redundant is to be used by the system. This also
acts as an early indicative tool should any of the sounding pipes lose accuracy.

The figure below shows a typical arrangement using redundant measurements in a

Levelmaster® H8 system.

PC
Workstation
Fetch Fetch status and
status pressures for slave 2
and
pressures H8 Cabinet H8 Cabinet
for slave Slave 1 Slave 2
1

Pipe I Pipe II

In order to compare raw pressure readings, the pipes should be located in the same
position in the tank, (all three coordinates).

If only one cabinet is used to measure both pressures it is also desirable that the
pressures are measured at the same time. This can be accomplished by connecting
the pipes to different blocks, but with the same relative outlet within the blocks, for
example: A1-B1, C4-D4).

If these two conditions are fulfilled, the pressures should be the same at each
measurement. If the pressures differ by more than a preset limit, this will indicate a
fault in the piping or the measurement unit.

Below is an extraction from the DNV rules regarding redundant measurements:

Pt.4 Ch.6 Sec.4 K
507. Remote sounding system of approved type may replace ordinary sounding
pipes or gauges as follows:
a) For tanks easily accessible for checking of level through for example manholes,
one remote sounding system may be accepted.
b) For tanks not always accessible for checking of level, two independent remote
sounding systems are required. In the case of remote sounding based on the air-

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
25 (30)
 LEVELMASTER® H8 KSM 756_1303

bubble principle, two air bubble lines per tank may be accepted provided sufficient
redundancy in the central unit is provided.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
26 (30)
 LEVELMASTER® H8 KSM 756_1303

Pressure list

The pressure list shows all measured pressures organized in tank and draft order. To
view this window, select from the menu: View – Pressure list. This list will give an
exact view of all pressure measurements organized in tank and draft order. When
redundant pipes are present, both readings together with current error status will be
displayed.

Column Description
Location Shows where the pipe is located
Pipe function How is this pipe used: Level, Density, Inert gas, …
Selected pipe Address of the selected pipe: (Cabinet Id) : (Outlet)
Selected reading Reading of selected pipe
Pipe A outlet Pipe A address: (Cabinet Id) : (Outlet)
Pipe A reading Pressure reading for pipe A
Pipe B outlet Pipe B address: (Cabinet Id) : (Outlet)
Pipe B reading Pressure reading for pipe B
Diff Filtered pressure difference
Alarm limit Diff alarm is generated when the filtered diff outside (-limit,
limit)
Function Description
Alarm beep Turn on/off alarm beep for unaccepted alarms
Use sea state filter for Turn on/off a low pass filter for the pressure difference
pressure difference calculation. This will prevent false alarms due to movements
in the tanks in rough seas. It is possible to use four different
filter settings depending on weather conditions.
Reset filter This function will reset the filtered difference values to the
momentary difference.
Show tank pressures Select this checkbox to show pressures in tanks
Show draft pressures Select this checkbox to show draft pressures
Show pressures Pressures measured with only one pipe will be included in
without redundant the list.
pipe
Show pressures with Pressures measured with two pipes (A, B) will be included in
redundant pipe the list.
Accept all visible All unaccepted alarms visible in the list are acknowledged.
alarms Short-cut key: Alt-A.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
27 (30)
 LEVELMASTER® H8 KSM 756_1303

Note! Unaccepted alarms will always be visible in the list regardless of the selection
above. This means, that if you uncheck both tank and draft pressures, only
unaccepted alarms will show up in the list, and for normal conditions the list will be
empty.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
28 (30)
 LEVELMASTER® H8 KSM 756_1303

Pressure details form

When a row is selected in the list, details will be shown in the form below.
In this form you may select a pipe, alter the alarm limit and accept an alarm.

Diff alarm

Diff alarm is shown with red background color. This alarm signals that the pressure
difference between the two pipes is outside the allowed limit. The user must select
the ‘good’ pipe and confirm that this is ok in the checkbox above, and then press the
Apply/Accept button. Then the alarm for the used pressure will be removed, but the
diff value will still indicate the present alarm condition. When the diff reading comes
within limits again, the condition will return to normal.

If a ‘good’ pipe cannot be selected and confirmed, the alarm condition will remain.
Alarm/Accept button will then only accept the alarm.

Diff
Alarm
accepted

Limit
Limit - deadband

Alarm Normal

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
29 (30)
 LEVELMASTER® H8 KSM 756_1303

Sensor alarm

Sensor alarm is shown with yellow background color. This alarm signals that
something is wrong with the sensor cabinet. To find out more details about this error,
check the status information for the corresponding cabinet, please see below.
If the pressure reading has two sensors, choose a sensor without sensor failure. The
Diff field will also be marked yellow to indicate that this reading is affected by the
sensor failure.

Example below.
The Fore Peak Tk has sensor failure for sensor B, which is marked with yellow
background. The selected pipe is 1:1, which is ok, and therefore shown with normal
background color.
The Diff figure cannot be trusted, and is therefore marked with yellow.

Below, the Status tab for cabinet 1. All indications are green. Cabinet is Ok.

Cabinet 2 is offline, therefore all readings for this cabinet will indicate sensor failure.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden.  Kockum Sonics AB, all rights reserved.
30 (30)
 LEVELMASTER® H8 KSM 756_1303

Appendix A

Levelmaster® H8 Modbus mapping

Kockum Sonics AB
 LEVELMASTER® H8-C UTV11003_A5

LEVELMASTER® H8-C, MODBUS MAPPING

A LEVELMASTER® H8 unit may function as a Modbus RTU server on two separate
communication channels: COM1 (RS-485) and COM2 (RS-485).

The LEVELMASTER® H8 can be configured to measure pressures in up to 24

points.

Tank pressures and status information are fetched with the MODBUS function code
3, (READ HOLDING REGISTERS).

The H8 sensor unit can calculate levels based on measured pressures.

In this case, mechanical pipe offsets and densities must also be entered in the unit.
Default values for offsets are 50 mm, and for densities 1025 Kg/m3.
Pipe offsets and initial densities are written to the unit using H8 Utility software.
Densities may also be written to the unit via the MODBUS map using function code
16.

Table 1. Request message, Function Code 03:

Byte 1 Slave address 1 to 254
Byte 2 03
Byte 3 Starting address Hi, see table below
Byte 4 Starting address Lo, see table below
Byte 5 Number of points Hi
Byte 6 Number of points Lo
Byte 7 CRC first byte
Byte 8 CRC second byte

Response message, Function Code 03, Ok:

Byte 1 Slave address
Byte 2 03
Byte 3 Byte count
Byte 4 Register data Hi for the first requested register
Byte 5 Register data Lo for the first requested register
……
Byte x Register data Hi for the last requested register
Byte x+1 Register data Lo for the last requested register
Byte x+2 CRC first byte
Byte x+3 CRC second byte

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden. © Kockum Sonics AB, all rights reserved.
1 (3)
 LEVELMASTER® H8-C UTV11003_A5

Table 2. Modbus map, Sensor unit slave Id 1-254

Register Equivalent Function

Address Modicon Function code 03, Fetch holding registers
Address
0 40001 Summary status, 16 bits
1 40002 Press-01 mmH2O, hydro static pressure
2 40003 Press-02 mmH2O, hydro static pressure
… … …
6 40007 Press-06 mmH2O, hydro static pressure
7 40008 Press-07 mmH2O, hydro static pressure
… … …
24 40025 Press-24 mmH2O, hydro static pressure

250 40251 Summary status, 16 bits

251 40252 Level based on press-01, pipe offset and density
252 40253 Level based on press-02, pipe offset and density
… … …
274 40275 Level based on press-24, pipe offset and density

301 40302 Density for Level 1

… … …
324 40324 Density for Level 24

Register Equivalent Function

Address Modicon Function code 16, Write multiple registers
Address
301 40302 Density for Level 1
… … …
324 40324 Density for Level 24

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden. © Kockum Sonics AB, all rights reserved.
2 (3)
 LEVELMASTER® H8-C UTV11003_A5

Table 3. Summary status register for slave units

Bit Value Meaning
0–2 0 Stop mode
1 Normal mode, continuous measure mode
2 NA
3 NA
4 NA
5 NA
7 Service mode
3 1 System Ok
4 1 System fail alarm
5 1 Sensor fail alarm
6 1 Pressure guard + air quality alarm
7 1 Main power supply alarm (used when the unit has two
independent supplies)
8 1 System fail watch dog
9 1 System fail flash memory error
10 1 System fail ram memory error
11 1 System fail communication error
12 1 NA
13 1 NA
14 1 NA
15 1 NA

To fetch the status register and all 24 raw pressures:

Starting address = 0 (40001)
Number of registers = 25

To decide if the pressure signals can be used or not, the different bits in the summary
status register may be examined. The easiest way is to check the bit System Ok. If
this bit is =1, then all pressure readings are considered to be ok.
If more detailed error information should be given to the user, more status bits could
be checked according to the table above.

Pressures
The pressure is given as mm water gauge (mmH2O), ranging from 0 to 65535.
The pressure is compensated for dynamic pressure drop from cabinet to tank outlet.

We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to
third parties without express authority is strictly forbidden. © Kockum Sonics AB, all rights reserved.
3 (3)
 LEVELMASTER® H8 KSM 756_1303

Appendix B

Getting started with USB connection PC – Levelmaster® H8

Kockum Sonics AB
 Levelmaster® H8 2010-03-16

Getting started with USB connection to H8 system

List of necessary items

1. Laptop with Windows operating system
2. USB cable: Type A-B
3. Levelmaster® Utility CD

Program installation

Insert the CD delivered with the first H8 cabinet. Wait for autorun to start, or explore the
CD and run the autorun.exe program on the CD.

Choose Program Installation – Levelmaster®:

Do the installation in the following order:

1. H8 Utility setup
2. H8 USB driver setup
3. USB driver preinstallation

Note! DU350 parameter program, install only if you have a DU350 local display unit, and
wish to change the configuration file for this unit.

1 of 6
 Levelmaster® H8 2010-03-16

After pressing H8 Utility setup:

Press Next and follow the given instructions.

After pressing H8 USB driver setup:

Press Next and follow the given instructions.

2 of 6
 Levelmaster® H8 2010-03-16

After pressing H8 USB driver preinstallation:

Press Install.

Select Continue anyway:

3 of 6
 Levelmaster® H8 2010-03-16

Connecting the H8 unit for the first time

When the H8 unit is connected to the USB port on the PC for the first time, Windows will
finalize the COM port installation.

This Plug and play installation will be done in two steps: First the USB Composite device
will be installed, then the USB bridge controller.

1. Select No, not this time, and press Next.

2. Install software automatically
3. Continue anyway
4. Finish

Repeat the steps above for the CP210x USB Bridge Controller as well.

4 of 6
 Levelmaster® H8 2010-03-16

Checking which COM port number is used in device manager

When the H8 system is connected with an USB cable, a COM port is added to the PC. In
order to find out the used COM port number, go to the device manager and check the
H8 COM port number. See the instructions below.

Note! It is important that the H8 system is connected. When the USB cable is removed,
the COM port will disappear from the PC.

Right-Click on My Computer and choose Properties:

Select Hardware and Device Manager

5 of 6
 Levelmaster® H8 2010-03-16

Expand Ports and lookup the CP210x USB row. In this case we use COM4

Start-up the H8 Utility program and use COM-port 4 to connect to H8 system. Note! In
this case it is COM4, but this can vary from installation to installation, please check the
correct COM port according to the above instructions.

Important note!
The communication on the USB cable must be terminated before the cable is removed.

6 of 6