openhab-addons/bundles/org.openhab.binding.bluetooth.grundfosalpha
Jacob Laursen f4596f581e
Update license headers to 2024 (#16168)
* Update copyright year in configuration
* Update license headers
* Manually update nibeheatpump headers (.cpp/.h/.ino)
* Manually update smsmodem header
* Manually update hueemulation header
* Manually update addon-header.xml header

Signed-off-by: Jacob Laursen <jacob-github@vindvejr.dk>
2024-01-01 18:14:57 +01:00
..
src Update license headers to 2024 (#16168) 2024-01-01 18:14:57 +01:00
NOTICE [grundfosalpha] Initial contribution (#15907) 2023-12-04 11:10:10 +01:00
pom.xml Apply spotless after release (#16097) 2023-12-22 23:30:38 +01:00
README.md [grundfosalpha] Initial contribution (#15907) 2023-12-04 11:10:10 +01:00

GrundfosAlpha Binding

This adds support for reading out the data of Grundfos Alpha Pumps with a Grundfos Alpha Reader

The reverse engineering of the protocol was taken from 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:

bluetooth:mi401:hci0:sensor1 "Grundfos Alpha Reader 1" (bluetooth:bluegiga:adapter1) [ address="12:34:56:78:9A:BC" ]

grundfos_alpha.items:

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" }