mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-22 16:56:50 +00:00
Switchbot blind tilt support (#26127)
Co-authored-by: BelowAverageDeveloper <90269575+BelowAverageDev@users.noreply.github.com> Co-authored-by: J. Nick Koston <nick@koston.org>
This commit is contained in:
parent
71f65110db
commit
4e61a273bc
@ -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
|
||||
|
||||
@ -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 |
|
||||
| ------------- | ----------- |
|
||||
| 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.
|
||||
|
||||
{% 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
|
||||
```
|
||||
|
||||
{% endraw %}
|
||||
|
||||
## Error codes and troubleshooting
|
||||
|
||||
The SwitchBot integration will automatically discover devices once the [Bluetooth](/integrations/bluetooth) integration is enabled and functional.
|
||||
|
Loading…
x
Reference in New Issue
Block a user