Skip to content

Add docs for switchbot new integration roller shade and hubmini matter #38357

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions source/_integrations/switchbot.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,8 @@ Some SwitchBot devices need to be configured within the app before being control
- [Relay Switch 1PM](https://www.switch-bot.com/products/switchbot-relay-switch-1pm)
- [Water Leak Detector](https://www.switch-bot.com/products/switchbot-water-leak-detector)
- [Remote (WoRemote)](https://www.switch-bot.com/products/switchbot-remote) (currently only supports battery level monitoring)
- [Roller Shade](https://www.switch-bot.com/products/switchbot-roller-shade)
- [HubMini Matter](https://www.switch-bot.com/products/switchbot-hub-mini-matter-enabled)(currently only supports retrieving sensor data, does not yet support device control)

## SwitchBot Entity

Expand Down Expand Up @@ -128,6 +130,15 @@ The blind tilt is exposed as a cover entity with control of the tilt position on

The close button will close the blinds to the closest closed position (either 0% or 100%), and defaults to closing down if the blinds are fully open. Because Home Assistant believes 100% is open, the default cards will disable the open button when the tilt is at 100%, but the action will still work and open the blind to 50%.

## SwitchBot Roller Shade

The Roller Shade is exposed as a cover entity with control of the position only:

| Tilt position | Roller Shade state |
| ------------- | ------------------ |
| <=20% | Open |
| >20% | Close |

### Simple cover template entity

Some integrations may expose your SwitchBot Blind Tilt to other actions which expect that 100% is open and 0% is fully closed. Using a [Cover Template](/integrations/cover.template), a proxy entity can be created which will be open at 100% and closed at 0%. This template entity is limited to closing in one direction.
Expand Down