jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-13 12:26:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

Improve eq3btsmart pairing explanation after new firmware release (#35764)

Browse Source
This commit is contained in:
Lennard Beers 2024-11-15 10:40:00 +01:00 committed by GitHub
parent b08194d2de
commit cb6b5e9acf
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 33 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
source/_integrations/eq3btsmart.markdown
View File

@ -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: <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](https://esphome.io/components/ble_client.html#on-passkey-request).
#### Other
Pairing is only required with firmware versions above 120.<br>
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 the MAC address. It will look something like this: [NEW] Device 00:1A:23:27:F8:4E CC-RT-BLE>
# 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>
<Input the PIN displayed on the thermostat. To display the PIN hold down the main button.>
# Hold down the main button on the thermostat to display the PIN
# Enter the displayed PIN when prompted
trust <MAC>
disconnect <MAC>
exit