Skip to content

Commit 9ec540a

Browse files
MinshengMinsheng
committed
add new products up to July 2026
1 parent f6d1b9a commit 9ec540a

6 files changed

Lines changed: 1111 additions & 12 deletions

File tree

‎README.md‎

Lines changed: 28 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -89,13 +89,13 @@
8989
- [Curtain event example](#curtain-event-example)
9090
- [Device Specifications and Supported Features List](#device-specifications-and-supported-features-list)
9191
- [Hubs](#hubs)
92-
- [Locks \& Security](#locks--security)
93-
- [Curtains \& Blinds](#curtains--blinds)
92+
- [Locks & Security](#locks--security)
93+
- [Curtains & Blinds](#curtains--blinds)
9494
- [Sensors](#sensors)
9595
- [Lighting](#lighting)
9696
- [Robot Vacuum](#robot-vacuum)
9797
- [Climate Control](#climate-control)
98-
- [Plugs \& Switches](#plugs--switches)
98+
- [Plugs & Switches](#plugs--switches)
9999
- [Cameras](#cameras)
100100
- [Others](#others)
101101

@@ -613,6 +613,11 @@ The following table provides definitions to the terms to be frequently mentioned
613613
| Home Climate Panel | Short for SwitchBot Home Climate Panel | W7400000 | |
614614
| Smart Radiator Thermostat | Short for SwitchBot Smart Radiator Thermostat | W7830000 | |
615615
| AI Art Frame | Short for SwitchBot AI Art Frame | W8402000 and W8402010 and W8402020 | |
616+
| Permanent Outdoor Lights | Short for SwitchBot Permanent Outdoor Lights | W1702120 | |
617+
| RGBICWW Ceiling Light | Short for SwitchBot RGBICWW Ceiling Light | W10802300 and W10802310 | |
618+
| Battery Circulator Fan 2 Pro | Short for SwitchBot Battery Circulator Fan 2 Pro | W9502500, W9502501, W9502502, and W9502503 | |
619+
| Kata Friends | Short for SwitchBot Kata Friends | W7912300 | |
620+
| AI MindClip | Short for SwitchBot AI MindClip | W6902000 and W6902003 | |
616621

617622
### `Legacy` Cloud Services
618623

@@ -762,14 +767,19 @@ Physical devices refer to the following SwitchBot products,
762767
- Smart Radiator Thermostat
763768
- Pan/Tilt Cam Plus 2K
764769
- Pan/Tilt Cam Plus 3K
765-
- `new` Standing Circulator Fan
766-
- `new` AI Hub
767-
- `new` Keypad Vision Pro
768-
- `new` Candle Warmer Lamp
769-
- `new` Presence Sensor
770-
- `new` Home Climate Panel
771-
- `new` RGBIC Neon Rope Light
772-
- `new` AI Art Frame
770+
- Standing Circulator Fan
771+
- AI Hub
772+
- Keypad Vision Pro
773+
- Candle Warmer Lamp
774+
- Presence Sensor
775+
- Home Climate Panel
776+
- RGBIC Neon Rope Light
777+
- AI Art Frame
778+
- `new` [Permanent Outdoor Lights](devices/lighting/permanent-outdoor-lights.md)
779+
- `new` [RGBICWW Ceiling Light](devices/lighting/rgbicww-ceiling-light.md)
780+
- `new` [Battery Circulator Fan 2 Pro](devices/climate-control/battery-circulator-fan-2-pro.md)
781+
- `new` [Kata Friends](devices/others/kata-friends.md)
782+
- `new` [AI MindClip](devices/others/ai-mindclip.md)
773783

774784
Virtual infrared remote devices refer to virtual devices that are used to simulate infrared signals of a home appliance remote control. A SwitchBot Hub Plus, Hub Mini, Hub 2, Hub 3 or Ceiling Light is required in order to be able to create these virtual devices within the app. The types of appliances supported include,
775785

@@ -1528,6 +1538,7 @@ Webhook events are sent as POST requests in JSON format. The structure varies by
15281538
}
15291539
}
15301540
```
1541+
15311542
#### Curtain event example
15321543

15331544
```json
@@ -1612,6 +1623,8 @@ Webhook events are sent as POST requests in JSON format. The structure varies by
16121623
| [RGBICWW Strip Light](devices/lighting/rgbicww-strip-light.md) | ✓ | ✓ | ✓ | ✓ |
16131624
| [Strip Light](devices/lighting/strip-light.md) | ✓ | ✓ | ✓ | ✓ |
16141625
| [Strip Light 3](devices/lighting/strip-light-3.md) | ✓ | ✓ | ✓ | ✓ |
1626+
| [Permanent Outdoor Lights](devices/lighting/permanent-outdoor-lights.md) | ✓ | ✓ | ✓ | ✓ |
1627+
| [RGBICWW Ceiling Light](devices/lighting/rgbicww-ceiling-light.md) | ✓ | ✓ | ✓ | ✓ |
16151628

16161629
### Robot Vacuum
16171630

@@ -1643,6 +1656,7 @@ Webhook events are sent as POST requests in JSON format. The structure varies by
16431656
| [Humidifier](devices/climate-control/humidifier.md) | ✓ | ✓ | ✓ | - |
16441657
| [Smart Radiator Thermostat](devices/climate-control/smart-radiator-thermostat.md) | ✓ | ✓ | ✓ | ✓ |
16451658
| [Standing Circulator Fan](devices/climate-control/standing-circulator-fan.md) | ✓ | ✓ | ✓ | ✓ |
1659+
| [Battery Circulator Fan 2 Pro](devices/climate-control/battery-circulator-fan-2-pro.md) | ✓ | ✓ | ✓ | ✓ |
16461660

16471661
### Plugs & Switches
16481662

@@ -1676,10 +1690,12 @@ Webhook events are sent as POST requests in JSON format. The structure varies by
16761690
| [AI Art Frame](devices/others/ai-art-frame.md) | ✓ | ✓ | ✓ | ✓ |
16771691
| [Weather Station](devices/others/weather-station.md) | ✓ | ✓ | ✓ | ✓ |
16781692
| [Virtual infrared remote devices](devices/others/virtual-infrared-remote-devices.md) | ✓ | - | ✓ | - |
1693+
| [Kata Friends](devices/others/kata-friends.md) | ✓ | ✓ | ✓ | ✓ |
1694+
| [AI MindClip](devices/others/ai-mindclip.md) | ✓ | ✓ | - | ✓ |
16791695

16801696

16811697
----
16821698

16831699
* [SwitchBot (Official website)](https://www.switch-bot.com/)
16841700
* [Facebook @SwitchBotRobot](https://www.facebook.com/SwitchBotRobot/)
1685-
* [Twitter @SwitchBot](https://twitter.com/switchbot)
1701+
* [Twitter @SwitchBot](https://twitter.com/switchbot)

‎devices/climate-control/battery-circulator-fan-2-pro.md‎

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
# Battery Circulator Fan 2 Pro
2+
3+
---
4+
5+
## Device List Information
6+
7+
| Key | Value Type | Description |
8+
| ------------------ | ---------- | -------------------------------------------------------------------- |
9+
| deviceId | String | device ID |
10+
| deviceName | String | device name |
11+
| deviceType | String | device type. _Battery Circulator Fan 2 Pro_ |
12+
| enableCloudService | Boolean | determines if Cloud Service is enabled or not for the current device |
13+
| hubDeviceId | String | device's parent Hub ID |
14+
15+
---
16+
17+
## Device Status
18+
19+
| Key | Value Type | Description |
20+
| ------------------- | ---------- | ------------------------------------------------------------------ |
21+
| deviceId | String | device ID |
22+
| deviceType | String | device type. _Battery Circulator Fan 2 Pro_ |
23+
| hubDeviceId | String | device's parent Hub ID |
24+
| mode | String | fan mode. _direct_, _natural_, _sleep_, _hurricane_, or _custom_ |
25+
| version | String | the current firmware version, e.g. V6.3 |
26+
| power | String | ON/OFF state. _on_ or _off_ |
27+
| onlineStatus | String | the connection status. _online_ or _offline_ |
28+
| nightStatus | String | nightlight state. _on_ or _off_ |
29+
| oscillation | String | horizontal oscillation. _on_ or _off_ |
30+
| verticalOscillation | String | vertical oscillation. _on_ or _off_ |
31+
| chargingStatus | String | battery charge status. _charging_ or _uncharged_ |
32+
| fanSpeed | Integer | fan speed. 1-100 |
33+
34+
---
35+
36+
## Control Commands
37+
38+
| deviceType | commandType | Command | command parameter | Description |
39+
| ----------------------------- | ----------- | ----------------- | -------------------------------------------- | -------------------------------------------------- |
40+
| Battery Circulator Fan 2 Pro | command | turnOff | default | set to OFF state |
41+
| Battery Circulator Fan 2 Pro | command | turnOn | default | set to ON state |
42+
| Battery Circulator Fan 2 Pro | command | setNightLightMode | `off`, `0`, or `1` | `off`, turn off; `0`, bright; `1`, soft |
43+
| Battery Circulator Fan 2 Pro | command | setWindMode | `direct`, `natural`, `sleep`, or `hurricane` | set fan mode |
44+
| Battery Circulator Fan 2 Pro | command | setWindSpeed | `{1-100}`, e.g. `10` | set fan speed |
45+
46+
---
47+
48+
## Webhook Events
49+
50+
| Key Name | Value Type | Description |
51+
| ------------------- | ---------- | ------------------------------------------------------------------ |
52+
| eventType | String | the type of events |
53+
| eventVersion | String | the current event version |
54+
| context | Object | the detail info of the event |
55+
| deviceType | String | the type of the device |
56+
| deviceMac | String | the MAC address of the device |
57+
| mode | String | fan mode. _direct_, _natural_, _sleep_, or _hurricane_ |
58+
| powerState | String | ON/OFF state |
59+
| nightStatus | String | nightlight state. _on_ or _off_ |
60+
| oscillation | String | horizontal oscillation. _on_ or _off_ |
61+
| verticalOscillation | String | vertical oscillation. _on_ or _off_ |
62+
| fanSpeed | Integer | fan speed |
63+
| timeOfSample | Long | the time stamp when the event is sent |
64+
65+
```js
66+
{
67+
"eventType": "changeReport",
68+
"eventVersion": "1",
69+
"context": {
70+
"deviceType": "Battery Circulator Fan 2 Pro",
71+
"deviceMac": DEVICE_MAC_ADDR,
72+
"mode": "direct",
73+
"powerState": "ON",
74+
"nightStatus": "off",
75+
"oscillation": "on",
76+
"verticalOscillation": "on",
77+
"fanSpeed": 3,
78+
"timeOfSample": 123456789
79+
}
80+
}
81+
```

‎devices/lighting/permanent-outdoor-lights.md‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
# Permanent Outdoor Lights
2+
3+
---
4+
5+
## Device List Information
6+
7+
| Key | Value Type | Description |
8+
| ------------------ | ---------- | -------------------------------------------------------------------- |
9+
| deviceId | String | device ID |
10+
| deviceName | String | device name |
11+
| deviceType | String | device type. _Permanent Outdoor Lights_ |
12+
| enableCloudService | Boolean | determines if Cloud Service is enabled or not for the current device |
13+
| hubDeviceId | String | device's parent Hub ID |
14+
15+
---
16+
17+
## Device Status
18+
19+
| Key | Value Type | Description |
20+
| ---------------- | ---------- | ---------------------------------------------------------- |
21+
| deviceId | String | device ID |
22+
| deviceType | String | device type. _Permanent Outdoor Lights_ |
23+
| hubDeviceId | String | device's parent Hub ID |
24+
| version | String | the current Wi-Fi firmware version, e.g. V3.1 |
25+
| power | String | ON/OFF state |
26+
| onlineStatus | String | the connection status. _online_ or _offline_ |
27+
| brightness | Integer | the brightness value, range from 0 to 100 |
28+
| color | String | the color value, RGB `"255:255:255"` |
29+
| colorTemperature | Integer | the color temperature value, range from 2700 to 6500 |
30+
31+
---
32+
33+
## Control Commands
34+
35+
| deviceType | commandType | Command | command parameter | Description |
36+
| ----------------------- | ----------- | ------------------- | --------------------------- | --------------------- |
37+
| Permanent Outdoor Lights | command | turnOn | default | set to ON state |
38+
| Permanent Outdoor Lights | command | turnOff | default | set to OFF state |
39+
| Permanent Outdoor Lights | command | toggle | default | toggle state |
40+
| Permanent Outdoor Lights | command | setBrightness | `{0-100}` | set brightness |
41+
| Permanent Outdoor Lights | command | setColorTemperature | `{2700-6500}` | set color temperature |
42+
| Permanent Outdoor Lights | command | setColor | `"{0-255}:{0-255}:{0-255}"` | set RGB color value |
43+
44+
---
45+
46+
## Webhook Events
47+
48+
| Key Name | Value Type | Description |
49+
| ---------------- | ---------- | ------------------------------------- |
50+
| eventType | String | the type of events |
51+
| eventVersion | String | the current event version |
52+
| context | Object | the detail info of the event |
53+
| deviceType | String | the type of the device |
54+
| deviceMac | String | the MAC address of the device |
55+
| powerState | String | ON/OFF state |
56+
| brightness | Integer | the brightness value |
57+
| color | String | the color value, RGB `"255:255:255"` |
58+
| colorTemperature | Integer | the color temperature value |
59+
| timeOfSample | Long | the time stamp when the event is sent |
60+
61+
```js
62+
{
63+
"eventType": "changeReport",
64+
"eventVersion": "1",
65+
"context": {
66+
"deviceType": "Permanent Outdoor Lights",
67+
"deviceMac": DEVICE_MAC_ADDR,
68+
"powerState": "ON",
69+
"brightness": 10,
70+
"color": "255:255:0",
71+
"colorTemperature": 3500,
72+
"timeOfSample": 123456789
73+
}
74+
}
75+
```

0 commit comments

Comments
 (0)