openhab-addons/bundles/org.openhab.binding.liquidcheck
lsiepel 71a208b91b
Apply Spotless after release (#17016)
* Spotless

Signed-off-by: Leo Siepel <leosiepel@gmail.com>
2024-07-07 23:20:16 +02:00
..
src Update license headers to 2024 (#16168) 2024-01-01 18:14:57 +01:00
NOTICE [liquidcheck] Initial contribution (#13287) 2023-05-14 00:19:56 +02:00
pom.xml Apply Spotless after release (#17016) 2024-07-07 23:20:16 +02:00
README.md [liquidcheck] Initial contribution (#13287) 2023-05-14 00:19:56 +02:00

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}