mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-14 21:06:50 +00:00
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:
parent
20646ab69a
commit
7c24ed0fa7
@ -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
|
||||
|
Loading…
x
Reference in New Issue
Block a user