diff --git a/source/_integrations/eq3btsmart.markdown b/source/_integrations/eq3btsmart.markdown index 7ba58443c1b..35d5f49acbd 100644 --- a/source/_integrations/eq3btsmart.markdown +++ b/source/_integrations/eq3btsmart.markdown @@ -23,16 +23,46 @@ As the device doesn't contain a temperature sensor ([read more](https://forum.fh ### Pairing -Pairing is only required with firmware versions above 120 and when not using ESPHome Bluetooth proxies. +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](https://esphome.io/components/bluetooth_proxy.html) + +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: + +```yaml +esp32_ble: + io_capability: keyboard_only + +ble_client: + - mac_address: + id: my_eq3_thermostat + auto_connect: true + on_passkey_request: + then: + - ble_client.passkey_reply: + id: my_eq3_thermostat + passkey: +``` + +For further information see the [ESPHome documentation](https://esphome.io/components/ble_client.html#on-passkey-request). + +#### 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`. ```bash 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 - +# Hold down the main button on the thermostat to display the PIN +# Enter the displayed PIN when prompted trust disconnect exit