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.
This commit is contained in:
Teemu R 2017-01-18 08:24:02 +01:00 committed by Fabian Affolter
parent 20646ab69a
commit 7c24ed0fa7
No known key found for this signature in database
GPG Key ID: E23CD2DD36A4397F

View File

@ -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
<Wait for the thermostat to be found, which looks like this: [NEW] Device 00:11:22:33:44:55 CC-RT-BLE>
scan off
<Set the thermostat to pairing mode.>
pair <MAC>
trust <MAC>
disconnect <MAC>
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