This page is part of archived documentation for openHAB 4.1. Go to the current stable version

# LiquidCheck Binding

This binding is for the Liquid-Check device from SI-Elektronik GmbH which can be used to measure level and content of tanks.

# Supported Things

liquidCheckDevice:

The Liquid-Check device in Hardwareversion B and Firmwareversion 1.60 has been tested and is working. You can access the measured data, raw data, the settings as properties and command a measurement.

# Discovery

This binding discovers the devices via a ping and request method. It uses every Ethernet/WLAN interface that is connected to the openHAB server. Therefore the discovery has to be manually triggered.

# Thing Configuration

You only need to set the IP address of the device or use the discovery method. If the maximum content has not been set the fill-indicator channel will not contain valid values.

# liquidCheckDevice Thing Configuration

Name Type Description Default Required Advanced
hostname text Hostname or IP address of the device N/A yes no
maxContent integer Maximal content of the container 1 no no
refreshInterval integer Interval the device is polled in seconds 60 no yes
connectionTimeout integer Timeout after a request has been sent 5 no yes

# Channels

Channel Type Read/Write Description
content Number:Volume R This is the measured content
level Number:Length R This is the measured level
raw-content Number:Volume R This is the measured raw content data
raw-level Number:Length R This is the measured raw level data
fill-indicator Number:Dimensionless R This is the fill level in percentage
measure Switch W This starts a measurement
pump-runs Number R This is the total runs number
pump-runtime Number:Time R This is the total runtime in sec.

# Full Example

# Thing

Thing liquidcheck:liquidCheckDevice:myDevice "Label" @ "Location" [hostname="XXX.XXX.XXX.XXX", maxContent=9265, refreshInterval=600, connectionTimeout=5]

# Items

Number:Volume ContentLiquidCheck "Content" {liquidcheck:liquidCheckDevice:myDevice:content}
Number:Length LevelLiquidCheck "Level" {liquidcheck:liquidCheckDevice:myDevice:level}
Number:Volume RawContentLiquidCheck "Raw Content" {liquidcheck:liquidCheckDevice:myDevice:raw-content}
Number:Length RawLevelLiquidCheck "Raw Level" {liquidcheck:liquidCheckDevice:myDevice:raw-level}
Number:Dimensionless FillIndicator "Fill Indicator" {liquidcheck:liquidCheckDevice:myDevice:fill-indicator}
Switch MeasureLiquidCheck "Measure" {liquidcheck:liquidCheckDevice:myDevice:measure}
Number PumpRuns "Pump runs" {liquidcheck:liquidCheckDevice:myDevice:pump-runs}
Number PumpRuntime "Pump runtime" {liquidcheck:liquidCheckDevice:myDevice:pump-runtime}