/eq3btsmart

Primary LanguagePython

"Buy Me A Coffee" hacs_badge

EQ3 Bluetooth Smart Thermostat

A modernized temporary replacement for the native Home Assistant component.

image

Home Assistant Forum Post

Installation

Option 1: HACS

  1. HACS > Integrations > ⋮ > Custom Repositories
  2. Repository: paste the url of this repo
  3. Category: Integration
  4. Click Add
  5. Close Custom Repositories modal
  6. Click + EXPLORE & DOWNLOAD REPOSITORIES
  7. Search for dbuezas_eq3btsmart
  8. Click Download
  9. Restart Home Assistant

Option 2: Manual copy

  1. Copy the dbuezas_eq3btsmart folder inside custom_components of this repo to /config/custom_components in your Home Assistant instance
  2. Restart Home Assistant

Adding devices

  1. Go to Settings > Integrations
  2. Either wait for automatic discovery, or click + ADD INTEGRATION and search for dbuezas_eq3btsmart
  3. Addition will succeed immediately, so give the entity some minutes to connect to the thermostat

Pairing issues

See here https://github.com/rytilahti/python-eq3bt#pairing

Differences with the original component:

  • It works in HA version > 2022.7
  • [x] Supports ESP32 Bluetooth proxies Maybe if you have EQ3 firmware v1.20 (doesn't require pairing)
  • Supports auto discovery
  • Supports adding via config flow (UI)
  • Fixes setting operation mode
  • Allows to turn off by setting temp to 4.5°
  • Retries (10 times) when you change a thermostat attribute.
  • [x] Push instead of Pull. It updates on bluetooth advertisement instead of polling every x minutes (seems to generate less unsuccessful tries)
  • Connections are persistent (this may or may not reduce the battery life, but it makes the thermostats more responsive)
  • Fully uses asyncio (less resource intensive)
  • Current Temperature updates immediately, regardless of when the bluetooth connection is made. The component will apply the change as soon as it can connect with the device.
  • Service to fetch heating schedules and serial inside the thermostat
  • Only one concurrent request per thermostat
  • Service to set the heating schedules (Work in progress)
  • Removed support for installing via yaml
  • Support pairing while adding entity

Credits

This is heavily based on https://github.com/rytilahti/python-eq3bt and https://github.com/home-assistant/core/tree/dev/homeassistant/components/eq3btsmart and it should ideally be two PRs instead. Unfortunately, the changes go too deep and remove support for the CLI and other backends. Therefore, here's a self contained custom component instead.