From 384fb146123e314504343e99737d9382635d5358 Mon Sep 17 00:00:00 2001
From: Lenn <78048721+LennP@users.noreply.github.com>
Date: Tue, 26 Mar 2024 10:27:57 +0100
Subject: [PATCH] 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>
---
 CODEOWNERS                                    |  1 +
 .../_integrations/motionblinds_ble.markdown   | 51 +++++++++++++++++++
 2 files changed, 52 insertions(+)
 create mode 100644 source/_integrations/motionblinds_ble.markdown

diff --git a/CODEOWNERS b/CODEOWNERS
index 3338d899c8c..e71a16e1dab 100644
--- a/CODEOWNERS
+++ b/CODEOWNERS
@@ -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
diff --git a/source/_integrations/motionblinds_ble.markdown b/source/_integrations/motionblinds_ble.markdown
new file mode 100644
index 00000000000..cbad03e2efe
--- /dev/null
+++ b/source/_integrations/motionblinds_ble.markdown
@@ -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
+```