Skip to content

Commit fda68be

Browse files
rytilahtifabaff
authored andcommitted
Update eq3btsmart doc for new features (home-assistant#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 bimbar/bluepy_devices#6 for details. * Update climate.eq3btsmart.markdown simplify the documentation, there is no need to pair the device.
1 parent b37fb0a commit fda68be

File tree

1 file changed

+18
-36
lines changed

1 file changed

+18
-36
lines changed

source/_components/climate.eq3btsmart.markdown

Lines changed: 18 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -12,47 +12,29 @@ ha_category: Climate
1212
ha_iot_class: "Local Poll"
1313
---
1414

15-
1615
The `eq3btsmart` climate platform allows you to integrate EQ3 Bluetooth Smart Thermostats.
1716

18-
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)).
19-
20-
Setup is a bit more cumbersome than for most other thermostats. It has to be paired first:
21-
22-
```bash
23-
bluetoothctl
24-
scan on
25-
<Wait for the thermostat to be found, which looks like this: [NEW] Device 00:11:22:33:44:55 CC-RT-BLE>
26-
scan off
27-
<Set the thermostat to pairing mode.>
28-
pair <MAC>
29-
trust <MAC>
30-
disconnect <MAC>
31-
exit
32-
```
33-
34-
Then check with gatttool if the connection works as expected:
17+
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.
18+
As the device doesn't contain a temperature sensor ([read more](https://forum.fhem.de/index.php/topic,39308.15.html)),
19+
we report target temperature also as current one.
3520

36-
```bash
37-
gatttool -b 00:11:22:33:44:55 -I
38-
[00:11:22:33:44:55][LE]> connect
39-
Attempting to connect to 00:11:22:33:44:55
40-
Connection successful
41-
[00:11:22:33:44:55][LE]> char-write-req 0x0411 03
42-
Characteristic value was written successfully
43-
Notification handle = 0x0421 value: 02 01 09 14 04 2d
44-
[00:11:22:33:44:55][LE]> disconnect
45-
[00:11:22:33:44:55][LE]> exit
46-
```
47-
48-
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:
21+
### Testing the connectivity ###
22+
Before configuring Home Assistant you should check that connectivity with the thermostat is working, which can can be done with the eq3cli tool:
4923

5024
```bash
51-
/usr/bin/bt-device -d CC-RT-BLE
52-
```
53-
54-
to the start function of /etc/init.d/hass-daemon.
55-
25+
eq3cli --mac 00:11:22:33:44:55
26+
27+
[00:1A:22:XX:XX:XX] Target 17.0 (mode: auto dst, away: no)
28+
Locked: False
29+
Batter low: False
30+
Window open: False
31+
Boost: False
32+
Current target temp: 21.0
33+
Current mode: auto dst
34+
Valve: 0
35+
```
36+
37+
### Configuration ###
5638

5739
```yaml
5840
# Example configuration.yaml entry

0 commit comments

Comments
 (0)