From e2c09855b7ed0d9f364f3cf5994609b24f06086a Mon Sep 17 00:00:00 2001
From: Retha Runolfsson <137745329+zerzhang@users.noreply.github.com>
Date: Tue, 6 May 2025 14:15:05 +0800
Subject: [PATCH] Add docs for switchbot circulator fan (#38545)

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/switchbot.markdown | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/source/_integrations/switchbot.markdown b/source/_integrations/switchbot.markdown
index 613a4676e30..9a3e3e36bcf 100644
--- a/source/_integrations/switchbot.markdown
+++ b/source/_integrations/switchbot.markdown
@@ -140,6 +140,10 @@ For instructions on how to obtain the encryption key, see README in [PySwitchbot
 - [Hub 2 (WoHub2)](https://switch-bot.com/pages/switchbot-hub-2) (currently only supports retrieving sensor data, does not yet support device control)
 - [Hub Mini Matter Enabled](https://www.switch-bot.com/products/switchbot-hub-mini-matter-enabled)(currently only supports retrieving sensor data, does not yet support device control)
 
+### Fans
+
+- [Circulator Fan](https://www.switch-bot.com/products/switchbot-battery-circulator-fan)
+
 ## Supported functionality
 
 ### Common
@@ -416,6 +420,19 @@ Features:
 - get temperature
 - get humidity
 
+### Fans
+
+Fan entities are added for Circulator Fan.
+
+Features:
+
+- turn on
+- turn off
+- set speed
+- set mode
+- oscillate left and right
+
+
 ## Data updates
 
 SwitchBot devices utilize a [​​local push](/blog/2016/02/12/classifying-the-internet-of-things/#classifiers)​​ strategy to maintain real-time status updates. When devices detect state changes, they actively push updates to Home Assistant for immediate synchronization. For user-initiated actions through Home Assistant (for example, when turning a device on/off), the integration performs an additional proactive status fetch to ensure instant confirmation of the new state.