From a509dc6edff579b74834a25461673ec031e448ae Mon Sep 17 00:00:00 2001
From: Lennard Beers <l.beers@outlook.de>
Date: Fri, 29 Mar 2024 02:21:27 +0100
Subject: [PATCH] Add eq3btsmart integration page (#31202)

Co-authored-by: J. Nick Koston <nick@koston.org>
---
 source/_integrations/eq3btsmart.markdown | 37 ++++++++++++++++++++++++
 source/_redirects                        |  1 -
 2 files changed, 37 insertions(+), 1 deletion(-)
 create mode 100644 source/_integrations/eq3btsmart.markdown

diff --git a/source/_integrations/eq3btsmart.markdown b/source/_integrations/eq3btsmart.markdown
new file mode 100644
index 00000000000..741e986f326
--- /dev/null
+++ b/source/_integrations/eq3btsmart.markdown
@@ -0,0 +1,37 @@
+---
+title: eQ-3 Bluetooth Smart Thermostats
+description: Instructions on how to integrate eQ-3 Bluetooth Smart Thermostats into Home Assistant.
+ha_category: Climate
+ha_iot_class: Local Polling
+ha_release: 2024.5
+ha_config_flow: true
+ha_codeowners:
+  - '@eulemitkeule'
+  - '@dbuezas'
+ha_domain: eq3btsmart
+ha_integration_type: integration
+---
+
+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](https://github.com/eulemitkeule/eq3btsmart) library.
+As the device doesn't contain a temperature sensor ([read more](https://forum.fhem.de/index.php/topic,39308.15.html)), we report target temperature also as current one.
+
+### Pairing
+
+Pairing is only required with firmware versions above 120 and when not using ESPHome Bluetooth proxies.
+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>
+scan off
+pair <MAC>
+<Input the PIN displayed on the thermostat. To display the PIN hold down the main button.>
+trust <MAC>
+disconnect <MAC>
+exit
+```
+
+{% include integrations/config_flow.md %}
diff --git a/source/_redirects b/source/_redirects
index efbc3b90f83..e0320acb707 100644
--- a/source/_redirects
+++ b/source/_redirects
@@ -508,7 +508,6 @@ layout: null
 /integrations/ee_brightbox /more-info/removed-integration 301
 /integrations/eight_sleep /more-info/removed-integration 301
 /integrations/envirophat /more-info/removed-integration 301
-/integrations/eq3btsmart /more-info/removed-integration 301
 /integrations/essent /more-info/removed-integration 301
 /integrations/facebox /more-info/removed-integration 301
 /integrations/fedex /more-info/removed-integration 301