Add Motionblinds BLE integration documentation (#31224)

* Add MotionBlinds BLE integration documentation

* Update CODEOWNERS

* Update release

* Update Motionblinds name

* Update release

* tiny tweaks

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Lenn 2024-03-26 10:27:57 +01:00 committed by GitHub
parent a11fe537cb
commit 384fb14612
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 52 additions and 0 deletions

View File

@ -490,6 +490,7 @@ source/_integrations/monoprice.markdown @etsinko @OnFreund
source/_integrations/moon.markdown @fabaff @frenck
source/_integrations/mopeka.markdown @bdraco
source/_integrations/motion_blinds.markdown @starkillerOG
source/_integrations/motionblinds_ble.markdown @LennP @jerrybboy
source/_integrations/motioneye.markdown @dermotduffy
source/_integrations/mqtt.markdown @emontnemery @jbouwh
source/_integrations/msteams.markdown @peroyvind

View File

@ -0,0 +1,51 @@
---
title: Motionblinds BLE
description: Instructions on how to integrate Motionblinds Bluetooth motors into Home Assistant.
ha_category:
- Cover
ha_iot_class: Assumed State
ha_release: 2024.04
ha_domain: motionblinds_ble
ha_codeowners:
- '@LennP'
- '@jerrybboy'
ha_config_flow: true
ha_platforms:
- cover
ha_integration_type: integration
---
The Motionblinds BLE {% term integration %} adds support for [Motionblinds](https://motionblinds.com/) Bluetooth motors. Beware that this integration does not work with *Eve Motionblinds* motors. *Eve Motionblinds* can be added to Home Assistant using the [HomeKit Device](https://www.home-assistant.io/integrations/homekit_controller/) integration.
{% include integrations/config_flow.md %}
## Setup
During the setup of a Motionblinds BLE device, you will be asked what kind of blind your Motionblind is. There are 8 different blind types:
- **Roller blind**: has the ability to change position and speed.
- **Honeycomb blind**: has the ability to change position and speed.
- **Roman blind**: has the ability to change position and speed.
- **Venetian blind**: has the ability to change position, tilt, and speed.
- **Venetian blind (tilt-only)**: has the ability to change tilt and speed.
- **Double Roller blind**: has the ability to change position, tilt, and speed.
- **Curtain blind**: has the ability to change position. May need to be calibrated if the end positions are lost, which can be done by using the open/close cover button or the set cover position slider. This will trigger a calibration which will first make the curtain find the end positions after which it will run to the position as indicated by the command that was given.
- **Vertical blind**: has the ability to change position and tilt. May need to be calibrated if the end positions are lost, which has to be done using the Motionblinds BLE mobile app.
## Services
Since Motionblinds BLE motors require a Bluetooth connection to control them, Home Assistant does not get automatic updates of the motor's state by default. Therefore, you can use the [homeassistant.update_entity](https://www.home-assistant.io/docs/scripts/service-calls/#homeassistant-services) service on a Motionblinds BLE entity which will connect to your Motionblind and update the state of all entities belonging to the device. **However, be aware that doing so may impact battery life.**
This can also be automated using a YAML automation. For instance, the following automation connects to your Motionblind every 24 hours to update it's state in Home Assistant:
```yaml
alias: Motionblinds BLE polling automation
mode: single
trigger:
- platform: time_pattern
hours: "/24"
action:
- service: homeassistant.update_entity
target:
entity_id: cover.motion_shade
```