From 332ba777d15b5041ceeadc924af07c64b092107c Mon Sep 17 00:00:00 2001
From: Brett <Bre77@users.noreply.github.com>
Date: Wed, 21 Oct 2020 10:06:06 +1000
Subject: [PATCH] Advantage Air Documentation (#14525)

Co-authored-by: Franck Nijhof <git@frenck.dev>
---
 source/_integrations/advantage_air.markdown | 61 +++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 source/_integrations/advantage_air.markdown

diff --git a/source/_integrations/advantage_air.markdown b/source/_integrations/advantage_air.markdown
new file mode 100644
index 00000000000..c3a737ce378
--- /dev/null
+++ b/source/_integrations/advantage_air.markdown
@@ -0,0 +1,61 @@
+---
+title: Advantage Air
+description: Instructions on how to integrate Advantage Air A/C controller into Home Assistant.
+ha_category: Climate
+ha_release: 0.117
+ha_iot_class: Local Polling
+ha_config_flow: true
+ha_codeowners:
+  - '@Bre77'
+ha_domain: advantage_air
+---
+
+The Advantage Air integration allows you to control [Advantage Air](https://www.advantageair.com.au/) Air Conditioning controllers into Home Assistant.
+
+## Configuration
+
+The wall-mounted Android table running the [MyPlace](https://play.google.com/store/apps/details?id=com.air.advantage.myair5), [e-zone](https://play.google.com/store/apps/details?id=com.air.advantage.ezone), or [zone10e](https://play.google.com/store/apps/details?id=com.air.advantage.zone10) must have a static IP, which you will enter on the integrations page in Home Assistant.
+
+Menu: **Configuration** -> **Integrations**.
+
+Click on the `+` sign to add an integration and click on **Advantage Air** (use typeahead if necessary).
+Enter the IP address, and leave the port as the default value.
+After completing the configuration flow, the Advantage Air integration will dynamically add relevant entities for each Air Conditioning system and controlled zones.
+
+## Entities
+
+### Climate
+
+The integration will create a climate entity for each air conditioning system found and for each zone that is temperature-controlled.
+
+### Cover
+
+The integration will create a cover entity for each zone that is not temperature controlled, allowing you to adjust the opening level manually from 0% to 100% in 5% increments.
+
+### Sensor
+
+The integration will create sensor entities for a variety of aspects:
+
+- The air filter sensor shows if it needs to be replaced.
+- Two sensor entities will be created for the 'time to on' and 'time to off' features. Use the `advantage_air.set_time_to` service to change these.
+- Each zone that is temperature-controlled will have a sensor to show how open the damper is.
+- Each zone with a wireless temperature or motion sensor will have a sensor that reports its wireless RSSI.
+
+### Binary Sensor
+
+The `advantage_air` binary sensor platform will create a binary sensor for each zone that has a motion sensor.
+
+### Switch
+
+The `advantage_air` switch platform will create a switch entity to toggle fresh air mode, if it is supported.
+
+## Services
+
+### Service `advantage_air.set_time_to`
+
+Set the On/Off Timer using the relevant sensor entity.
+
+| Service data attribute | Optional | Description |
+| ---------------------- | -------- | ----------- |
+| `entity_id` | yes | `sensor.[name]_time_to_on` or `sensor.[name]_time_to_off`
+| `minutes` | no | Number of minutes between `0` and `720`.