From 7c24ed0fa7514c03e980838043a268eb1b93a122 Mon Sep 17 00:00:00 2001 From: Teemu R Date: Wed, 18 Jan 2017 08:24:02 +0100 Subject: [PATCH] Update eq3btsmart doc for new features (#1618) * WIP: Update eq3btsmart for new features This is WIP as it requires a revamped backend library, and should not be merged before the changes to the backend are done. See https://github.com/bimbar/bluepy_devices/pull/6 for details. * Update climate.eq3btsmart.markdown simplify the documentation, there is no need to pair the device. --- .../_components/climate.eq3btsmart.markdown | 50 ++++++------------- 1 file changed, 16 insertions(+), 34 deletions(-) diff --git a/source/_components/climate.eq3btsmart.markdown b/source/_components/climate.eq3btsmart.markdown index 127f32edb59..39915d97238 100644 --- a/source/_components/climate.eq3btsmart.markdown +++ b/source/_components/climate.eq3btsmart.markdown @@ -12,47 +12,29 @@ ha_category: Climate ha_iot_class: "Local Poll" --- - The `eq3btsmart` climate platform allows you to integrate EQ3 Bluetooth Smart Thermostats. -The only functionality is to set the temperature, there doesn't seem to be any way to query the temperature sensor or battery level ([read more](https://forum.fhem.de/index.php/topic,39308.15.html)). +The current functionality allows setting the temperature as well as controlling the supported modes with help of [python-eq3bt](https://github.com/rytilahti/python-eq3bt) library. +As the device doesn't contain a temperature sensor ([read more](https://forum.fhem.de/index.php/topic,39308.15.html)), +we report target temperature also as current one. -Setup is a bit more cumbersome than for most other thermostats. It has to be paired first: +### Testing the connectivity ### +Before configuring Home Assistant you should check that connectivity with the thermostat is working, which can can be done with the eq3cli tool: ```bash -bluetoothctl -scan on - -scan off - -pair -trust -disconnect -exit -``` +eq3cli --mac 00:11:22:33:44:55 -Then check with gatttool if the connection works as expected: - -```bash -gatttool -b 00:11:22:33:44:55 -I -[00:11:22:33:44:55][LE]> connect -Attempting to connect to 00:11:22:33:44:55 -Connection successful -[00:11:22:33:44:55][LE]> char-write-req 0x0411 03 -Characteristic value was written successfully -Notification handle = 0x0421 value: 02 01 09 14 04 2d -[00:11:22:33:44:55][LE]> disconnect -[00:11:22:33:44:55][LE]> exit -``` - -Important: For gatttool or homeassistant to work, the thermostat needs to be disconnected from bluetoothd, so I found it best to modify the hass-daemon startscript by adding: - -```bash -/usr/bin/bt-device -d CC-RT-BLE -``` - -to the start function of /etc/init.d/hass-daemon. +[00:1A:22:XX:XX:XX] Target 17.0 (mode: auto dst, away: no) +Locked: False +Batter low: False +Window open: False +Boost: False +Current target temp: 21.0 +Current mode: auto dst +Valve: 0 +``` +### Configuration ### ```yaml # Example configuration.yaml entry