Updated external content (Jenkins build 1809)
openHAB Build Server
parent
be82cd0693
commit
5df8b1ce72
File diff suppressed because one or more lines are too long
|
|
@ -0,0 +1,63 @@
|
|||
---
|
||||
id: bluetooth.grundfosalpha
|
||||
label: GrundfosAlpha
|
||||
title: GrundfosAlpha - Bindings
|
||||
type: binding
|
||||
description: "This adds support for reading out the data of Grundfos Alpha Pumps with a [Grundfos Alpha Reader](https://product-selection.grundfos.com/products/alpha-reader)"
|
||||
since: 3x
|
||||
install: manual
|
||||
---
|
||||
|
||||
<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->
|
||||
|
||||
{% include base.html %}
|
||||
|
||||
# GrundfosAlpha Binding
|
||||
|
||||
This adds support for reading out the data of Grundfos Alpha Pumps with a [Grundfos Alpha Reader](https://product-selection.grundfos.com/products/alpha-reader)
|
||||
|
||||
The reverse engineering of the protocol was taken from [https://github.com/JsBergbau/AlphaDecoder](https://github.com/JsBergbau/AlphaDecoder).
|
||||
|
||||
## Supported Things
|
||||
|
||||
- `mi401`: The Grundfos MI401 ALPHA Reader
|
||||
|
||||
## Discovery
|
||||
|
||||
All readers are auto-detected as soon as Bluetooth is configured in openHAB and the MI401 device is powered on.
|
||||
|
||||
## Thing Configuration
|
||||
|
||||
### `mi401` Thing Configuration
|
||||
|
||||
| Name | Type | Description | Default | Required | Advanced |
|
||||
|---------|------|-----------------------------------------------|---------|----------|----------|
|
||||
| address | text | Bluetooth address in XX:XX:XX:XX:XX:XX format | N/A | yes | no |
|
||||
|
||||
## Channels
|
||||
|
||||
| Channel | Type | Read/Write | Description |
|
||||
|------------------|---------------------------|------------|------------------------------------|
|
||||
| rssi | Number | R | Received Signal Strength Indicator |
|
||||
| flow-rate | Number:VolumetricFlowRate | R | The flow rate of the pump |
|
||||
| pump-head | Number:Length | R | The water head above the pump |
|
||||
| pump-temperature | Number:Temperature | R | The temperature of the pump |
|
||||
| battery-level | Number:Dimensionless | R | The battery level of the reader |
|
||||
|
||||
## Full Example
|
||||
|
||||
grundfos_alpha.things (assuming you have a Bluetooth bridge with the ID `bluetooth:bluegiga:adapter1`:
|
||||
|
||||
```java
|
||||
bluetooth:mi401:hci0:sensor1 "Grundfos Alpha Reader 1" (bluetooth:bluegiga:adapter1) [ address="12:34:56:78:9A:BC" ]
|
||||
```
|
||||
|
||||
grundfos_alpha.items:
|
||||
|
||||
```java
|
||||
Number RSSI "RSSI [%.1f dBm]" <QualityOfService> { channel="bluetooth:mi401:hci0:sensor1:rssi" }
|
||||
Number:VolumetricFlowRate Flow_rate "Flowrate [%.1f %unit%]" <flow> { channel="bluetooth:mi401:hci0:sensor1:flow-rate" }
|
||||
Number:Length Pump_Head "Pump head [%.1f %unit%]" <water> { channel="bluetooth:mi401:hci0:sensor1:pump-head" }
|
||||
Number:Temperature Pump_Temperature "Temperature [%.1f %unit%]" <temperature> { channel="bluetooth:mi401:hci0:sensor1:pump-temperature" }
|
||||
Number:Dimensionless Battery_Level "Battery Level [%d %%]" <battery> { channel="bluetooth:mi401:hci0:sensor1:battery-level" }
|
||||
```
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<thing:thing-descriptions bindingId="bluetooth"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xmlns:thing="https://openhab.org/schemas/thing-description/v1.0.0"
|
||||
xsi:schemaLocation="https://openhab.org/schemas/thing-description/v1.0.0 https://openhab.org/schemas/thing-description-1.0.0.xsd">
|
||||
|
||||
<channel-type id="grundfos-flow">
|
||||
<item-type>Number:VolumetricFlowRate</item-type>
|
||||
<label>Current Flow</label>
|
||||
<description>Current flow</description>
|
||||
<category>Flow</category>
|
||||
<state readOnly="true" pattern="%.2f %unit%"/>
|
||||
</channel-type>
|
||||
|
||||
<channel-type id="grundfos-head">
|
||||
<item-type>Number:Length</item-type>
|
||||
<label>Current Head</label>
|
||||
<description>Current head</description>
|
||||
<category>Water</category>
|
||||
<state readOnly="true" pattern="%.2f %unit%"/>
|
||||
</channel-type>
|
||||
|
||||
<channel-type id="grundfos-temperature">
|
||||
<item-type>Number:Temperature</item-type>
|
||||
<label>Current Pump Temperature</label>
|
||||
<description>Current pump temperature</description>
|
||||
<category>Temperature</category>
|
||||
<tags>
|
||||
<tag>Measurement</tag>
|
||||
<tag>Temperature</tag>
|
||||
</tags>
|
||||
<state readOnly="true" pattern="%.2f %unit%"/>
|
||||
</channel-type>
|
||||
|
||||
<thing-type id="mi401">
|
||||
<supported-bridge-type-refs>
|
||||
<bridge-type-ref id="roaming"/>
|
||||
<bridge-type-ref id="bluegiga"/>
|
||||
<bridge-type-ref id="bluez"/>
|
||||
</supported-bridge-type-refs>
|
||||
|
||||
<label>Grundfos Alpha Reader MI401</label>
|
||||
<description>A Grundfos Alpha Reader MI401</description>
|
||||
<category>Pump</category>
|
||||
|
||||
<channels>
|
||||
<channel id="rssi" typeId="rssi"/>
|
||||
<channel id="flow-rate" typeId="grundfos-flow"/>
|
||||
<channel id="pump-head" typeId="grundfos-head"/>
|
||||
<channel id="pump-temperature" typeId="grundfos-temperature"/>
|
||||
<channel id="battery-level" typeId="system.battery-level"/>
|
||||
</channels>
|
||||
|
||||
<config-description>
|
||||
<parameter name="address" type="text">
|
||||
<label>Address</label>
|
||||
<description>Bluetooth address in XX:XX:XX:XX:XX:XX format</description>
|
||||
</parameter>
|
||||
</config-description>
|
||||
|
||||
</thing-type>
|
||||
</thing:thing-descriptions>
|
||||
Loading…
Reference in New Issue