Python library and a command line tool for EQ3 Bluetooth smart thermostats, uses bluepy for BTLE communication.
This library is a simplified version of bluepy_devices from Markus Peter (https://github.com/bimbar/bluepy_devices.git) with support for more features and better device handling.
- Reading device status: locked, low battery, valve state, window open, target temperature, active mode
- Writing settings: target temperature, auto mode presets, temperature offset
- Setting the active mode: auto, manual, boost, away
- Reading the device serial number and firmware version
- Reading presets and temperature offset in more recent firmware versions.
Not (yet) supported)
- No easy-to-use interface for setting schedules.
pip install python-eq3bt
Notice: The device in question has to be disconnected from bluetoothd, since BTLE devices can only hold one connection at a time.
from eq3bt import Thermostat thermostat = Thermostat('AB:CD:EF:12:23:45') thermostat.update() # fetches data from the thermostat print(thermostat)
The library will try to connect to the device second time in case it wasn't successful in the first time, which can happen if you are running other applications connecting to the same thermostat.
The schedule is queried per day basis and the cached information can be
from eq3bt import Thermostat thermostat = Thermostat('AB:CD:EF:12:34:45') thermostat.query_schedule(0) print(thermostat.schedule)
The schedule can be set on a per day basis like follows:
from datetime import time from eq3bt import Thermostat from eq3bt import HOUR_24_PLACEHOLDER as END_OF_DAY thermostat = Thermostat('12:34:56:78:9A:BC') thermostat.set_schedule( dict( cmd="write", day="sun", base_temp=18, next_change_at=time(8, 0), hours=[ dict(target_temp=23, next_change_at=time(20, 0)), dict(target_temp=18, next_change_at=END_OF_DAY), dict(target_temp=23, next_change_at=END_OF_DAY), dict(target_temp=23, next_change_at=END_OF_DAY), dict(target_temp=23, next_change_at=END_OF_DAY), dict(target_temp=23, next_change_at=END_OF_DAY) ] ) )
To test all available functionality a cli tool inside utils can be used.
EQ3_MAC environment variable can be used to define mac to avoid typing it:
Without parameters current state of the device is printed out.
eq3cli [00:1A:22:XX:XX:XX] Target 17.0 (mode: auto dst, away: no) Locked: False Batter low: False Window open: False Window open temp: 12.0 Window open time: 0:15:00 Boost: False Current target temp: 17.0 Current comfort temp: 20.0 Current eco temp: 17.0 Current mode: auto dst locked Valve: 0
Getting & setting values.
eq3cli temp Current target temp: 17.0 eq3cli temp --target 20 Current target temp: 17.0 Setting target temp: 20.0
For help, use --help