home-assistant.io/source/_integrations/eq3btsmart.markdown
2024-11-27 18:57:16 +01:00

2.4 KiB

title, description, ha_category, ha_iot_class, ha_release, ha_config_flow, ha_codeowners, ha_domain, ha_integration_type, ha_platforms
title description ha_category ha_iot_class ha_release ha_config_flow ha_codeowners ha_domain ha_integration_type ha_platforms
eQ-3 Bluetooth Smart Thermostats Instructions on how to integrate eQ-3 Bluetooth Smart Thermostats into Home Assistant.
Climate
Local Polling 2024.5 true
@eulemitkeule
@dbuezas
eq3btsmart device
binary_sensor
climate
number
sensor
switch

The eq3btsmart climate platform allows you to integrate eQ-3 Bluetooth Smart Thermostats.

The current functionality allows setting the temperature as well as controlling the supported modes with help of the eq3btsmart library. As the device doesn't contain a temperature sensor (read more), we report target temperature also as current one.

Pairing

Pairing your eQ-3 Bluetooth Smart Thermostat device works differently based on your method of connection and the device's firmware version.

ESPHome Bluetooth Proxies

For firmware versions below 148, no additional configuration is required when using ESPHome Bluetooth Proxies. Since version 148, a security flaw in the devices has been fixed that now requires entering a passkey.

To configure the passkey, add the following to your ESPHome Bluetooth Proxy's configuration:

esp32_ble:
  io_capability: keyboard_only

ble_client:
  - mac_address: <MAC>
    id: my_eq3_thermostat
    auto_connect: true
    on_passkey_request:
      then:
        - ble_client.passkey_reply:
            id: my_eq3_thermostat
            passkey: <PIN code displayed on the thermostat. To display the PIN hold down the main button.>

For further information see the ESPHome documentation.

Other

Pairing is only required with firmware versions above 120.
Before configuring Home Assistant you need to pair the thermostat to your Bluetooth adapter using bluetoothctl.

bluetoothctl
scan on
# Wait for the thermostat to show up and copy its MAC address
# Expected output: [NEW] Device 00:1A:23:27:F8:4E CC-RT-BLE
scan off
pair <MAC>
# Hold down the main button on the thermostat to display the PIN
# Enter the displayed PIN when prompted
trust <MAC>
disconnect <MAC>
exit

{% include integrations/config_flow.md %}