Skip to content
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
51 changes: 51 additions & 0 deletions source/_integrations/switchbot.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@ Please note, device names configured in the SwitchBot app are not transferred in
- Motion Sensor (WoPresence)
- Plug Mini (WoPlug), both the original (model W1901400) and HomeKit-enabled (model W1901401)
- Lock (WoLock)
- Blind Tilt (WoBlindTilt)

## SwitchBot Entity

Expand Down Expand Up @@ -107,6 +108,56 @@ Encryption key:

For instructions on how to obtain the locks encryption key, see README in [PySwitchbot](https://github.com/Danielhiversen/pySwitchbot#obtaining-locks-encryption-key) project.

## SwitchBot Blind Tilt

The blind tilt is exposed as a cover entity with control of the tilt position only:

| Tilt Position | Blind State |
Comment thread
bdraco marked this conversation as resolved.
| ------------- | ----------- |
| 100% | Closed Up |
| 50% | Fully Open |
| 0% | Closed Down |

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 service call will still work and open the blind to 50%.

### Simple cover template entity

Some integrations may expose your SwitchBot Blind Tilt to other services 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.

Comment thread
bdraco marked this conversation as resolved.
{% raw %}

```yaml
# Example configuration.yaml entry
cover:
- platform: template
covers:
example_blinds_simple:
device_class: blind
friendly_name: Example Blinds (Simple Down)
open_cover:
service: cover.set_cover_tilt_position
data:
tilt_position: 50
target:
entity_id: cover.example_blinds
close_cover:
service: cover.set_cover_tilt_position
data:
tilt_position: 0
target:
entity_id: cover.example_blinds
position_template: >
{{ int(states.cover.example_blinds.attributes.current_tilt_position)*2 }}
set_cover_position:
service: cover.set_cover_tilt_position
data:
tilt_position: "{{position/2}}"
target:
entity_id: cover.example_blinds
```

Comment thread
bdraco marked this conversation as resolved.
{% endraw %}

## Error codes and troubleshooting

The SwitchBot integration will automatically discover devices once the [Bluetooth](/integrations/bluetooth) integration is enabled and functional.
Expand Down