mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-10 23:22:02 +01:00
65 lines
3.4 KiB
Markdown
65 lines
3.4 KiB
Markdown
# 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
|
|
|
|
```java
|
|
Thing liquidcheck:liquidCheckDevice:myDevice "Label" @ "Location" [hostname="XXX.XXX.XXX.XXX", maxContent=9265, refreshInterval=600, connectionTimeout=5]
|
|
```
|
|
|
|
### Items
|
|
|
|
```java
|
|
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}
|
|
```
|