From 48b4145c982ae9d996780b4fdf950743e42a05e2 Mon Sep 17 00:00:00 2001
From: Brian Egge <brianegge@gmail.com>
Date: Wed, 29 Sep 2021 14:59:01 -0400
Subject: [PATCH] proposed binary_sensor group (#19297)

---
 .../binary_sensor.group.markdown              | 53 +++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 source/_integrations/binary_sensor.group.markdown

diff --git a/source/_integrations/binary_sensor.group.markdown b/source/_integrations/binary_sensor.group.markdown
new file mode 100644
index 00000000000..2061b560596
--- /dev/null
+++ b/source/_integrations/binary_sensor.group.markdown
@@ -0,0 +1,53 @@
+---
+title: "Binary Sensor Group"
+description: "Instructions for how to setup binary_sensor groups within Home Assistant."
+ha_category:
+  - Binary Sensor
+ha_release: 2021.10
+ha_iot_class: Local Push
+ha_quality_scale: internal
+ha_domain: group
+---
+
+The group binary_sensor platform lets you combine multiple binary_sensors into one entity. This integration presents itself as a single binary sensor in the UI. This allows the UI to use the text and icon of the type of sensor you are grouping. The sensor doesn't know what device class it should be, so this should be set to match the device class of the items in the group.
+
+## Group behavior
+
+By default when any member of a group is `on` then the group will also be `on`. If you set the `all` option to `true` though, this behavior is inverted and all members of the group have to be `on` for the group to turn on as well.
+
+To enable this platform in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+binary_sensor:
+    - platform: group
+      name: Patio Doors
+      device_class: opening
+      entities:
+        - binary_sensor.door_left_contact
+        - binary_sensor.door_right_contact
+```
+
+{% configuration %}
+entities:
+  description: A list of entities to be included in the group.
+  required: true
+  type: [string, list]
+name:
+  description: The name of the group. Defaults to "Binary Sensor Group".
+  required: false
+  type: string
+unique_id:
+  description: An ID that uniquely identifies this group. If two binary_sensors have the same unique ID, Home Assistant will raise an error.
+  required: false
+  type: string
+all:
+  description: Set this to `true` if the group state should only turn *on* if **all** grouped entities are *on*.
+  required: false
+  type: boolean
+  default: false
+device_class:
+  description: The type of the group (/integrations/binary_sensor).
+  required: true
+  type: string
+{% endconfiguration %}
+